diff --git a/README.md b/README.md
index 052a24f..4419fb7 100644
--- a/README.md
+++ b/README.md
@@ -1,85 +1,290 @@
+
+
# SSam B 프론트엔드
-이 레포는 **SSam B** 학원/수업 운영 플랫폼의 **프론트엔드(Next.js)** 입니다.
-강사/조교(MGMT)와 학생/학부모(SVC) 사용자를 위한 화면과 대시보드를 제공합니다.
-
-## 주요 기능(화면/라우트 기준)
-
-- 랜딩: `/`
-- 인증
- - 강사/조교: `/educators/login`, `/educators/instructor-register`, `/educators/assistant-register`
- - 학생/학부모: `/learners/login`, `/learners/register`
-- 대시보드(강사/조교): `/educators/*`
- - 강의/수강생: `/educators/lectures`, `/educators/students`
- - 일정: `/educators/schedules`
- - 시험/리포트: `/educators/exams`
- - 조교 관리: `/educators/assistants`
- - 커뮤니케이션: `/educators/communication`
- - 자료실: `/educators/materials`
- - 프로필: `/educators/profile`
-- 대시보드(학생/학부모): `/learners/*`
- - 수강/상세: `/learners/lectures`
- - 커뮤니케이션: `/learners/communication`
- - 자료실: `/learners/materials`
- - 프로필: `/learners/profile`
-- 조교 승인/서명 대기: `/pending-approval`
-
-## 권한/역할 흐름(요약)
-
-- URL 기준으로 역할을 구분합니다: `/educators/*` → `MGMT`(강사/조교), `/learners/*` → `SVC`(학생/학부모)
-- 세션은 쿠키 기반이며, API 호출은 role에 따라 서로 다른 base URL을 사용합니다(`NEXT_PUBLIC_API_BASE_URL`, `NEXT_PUBLIC_API_BASE_URL_SVC`)
-- 조교(ASSISTANT)는 가입/서명 상태(`signStatus`)가 `SIGNED`가 아니면 `/pending-approval`로 이동합니다
-
-## 기술 스택
-
-- Framework: Next.js `16.1.6` (App Router, RSC)
-- Language: TypeScript `^5`
-- UI: React `19.2.4`, Tailwind CSS `4`, shadcn/ui + Radix UI
-- Data Fetching: Axios + TanStack Query(React Query)
-- State: Zustand (화면/도메인 UI 상태)
-- Form/Validation: React Hook Form + Zod
-- 기타: Recharts, react-big-calendar, react-day-picker, TipTap, @react-pdf/renderer
-- Observability: Sentry (server/edge/client)
-- Test: Jest (일부 `src/services/**` 테스트)
-
-## 로컬 실행
-
-### 요구사항
-
-- Node.js `24.13.0` (`.nvmrc`, `package.json#engines`)
-- pnpm `10.28.0` (`package.json#packageManager`)
-
-### 설치/실행
+**학원/수업 운영을 위한 통합 플랫폼**
+
+강사/조교(MGMT)와 학생/학부모(SVC)를 위한 직관적인 대시보드와 관리 시스템
+
+[](https://nextjs.org/)
+[](https://www.typescriptlang.org/)
+[](https://reactjs.org/)
+[](https://tailwindcss.com/)
+
+
+
+
+
+---
+
+## 📋 목차
+
+- [주요 기능](#-주요-기능)
+- [기술 스택](#-기술-스택)
+- [빠른 시작](#-빠른-시작)
+- [프로젝트 구조](#-프로젝트-구조)
+- [권한 및 인증](#-권한-및-인증)
+- [사용 가능한 스크립트](#-사용-가능한-스크립트)
+- [배포 및 운영](#-배포-및-운영)
+
+---
+
+## ✨ 주요 기능
+
+### 🏠 랜딩 페이지
+
+- 메인 랜딩: `/`
+
+### 🔐 인증 시스템
+
+**강사/조교 (Educators)**
+
+- 로그인: `/educators/login`
+- 강사 회원가입: `/educators/instructor-register`
+- 조교 회원가입: `/educators/assistant-register`
+
+**학생/학부모 (Learners)**
+
+- 로그인: `/learners/login`
+- 회원가입: `/learners/register`
+
+### 👨🏫 강사/조교 대시보드 (`/educators/*`)
+
+| 기능 | 라우트 | 설명 |
+| -------------- | -------------------------- | ------------------------ |
+| 🧩 홈 | `/educators` | 메인 대시보드 |
+| 👤 프로필 | `/educators/profile` | 개인 정보 관리 |
+| 👥 학생 관리 | `/educators/students` | 수강생 정보 및 출결 관리 |
+| 📚 수업 관리 | `/educators/lectures` | 강의 생성, 수정, 조회 |
+| 📅 일정 관리 | `/educators/schedules` | 수업 일정 및 캘린더 |
+| 💬 소통 | `/educators/communication` | 공지사항 작성, 문의 답변 |
+| 🤝 조교 관리 | `/educators/assistants` | 조교 권한 및 업무 관리 |
+| 📝 시험/리포트 | `/educators/exams` | 평가 및 성적 관리 |
+| 📂 자료실 | `/educators/materials` | 학습 자료 업로드 및 공유 |
+
+### 🎓 학생/학부모 대시보드 (`/learners/*`)
+
+| 기능 | 라우트 | 설명 |
+| ---------------- | ------------------------- | --------------------------- |
+| 🧩 메인 대시보드 | `/learners` | 메인 대시보드 |
+| 👤 프로필 | `/learners/profile` | 개인 정보 관리 |
+| 📖 나의 강의 | `/learners/lectures` | 수강 중인 강의 및 상세 정보 |
+| 💬 소통 | `/learners/communication` | 공지사항 확인, 문의글 작성 |
+
+### ⏳ 기타
+
+- 조교 승인 대기: `/pending-approval`
+
+---
+
+## 🛠 기술 스택
+
+### Core
+
+- **Framework:** Next.js `16.1.6` (App Router, RSC)
+- **Language:** TypeScript `^5`
+- **Runtime:** Node.js `24.13.0`
+- **Package Manager:** pnpm `10.28.0`
+
+### UI/UX
+
+- **Library:** React `19.2.4`
+- **Styling:** Tailwind CSS `4`
+- **Component Library:** shadcn/ui + Radix UI
+- **Charts:** Recharts
+- **Calendar:** react-big-calendar, react-day-picker
+- **Editor:** TipTap
+- **PDF:** @react-pdf/renderer
+
+### State & Data Management
+
+- **Server State:** TanStack Query (React Query)
+- **Client State:** Zustand
+- **HTTP Client:** Axios
+- **Form Management:** React Hook Form
+- **Validation:** Zod
+
+### Quality & Monitoring
+
+- **Observability:** Sentry (server/edge/client)
+- **Testing:** Jest
+- **Linting:** ESLint
+- **Formatting:** Prettier
+
+---
+
+## 🚀 빠른 시작
+
+### 📦 요구사항
+
+프로젝트 실행을 위해 다음 버전이 필요합니다:
+
+| 도구 | 버전 | 설정 파일 |
+| ------- | --------- | -------------------------------- |
+| Node.js | `24.13.0` | `.nvmrc`, `package.json#engines` |
+| pnpm | `10.28.0` | `package.json#packageManager` |
+
+### 💻 설치 및 실행
```bash
+# 1. 의존성 설치
pnpm install
+
+# 2. 환경 변수 설정
cp .env.example .env.local
+
+# 3. Git hooks 설정
pnpm run prepare
+
+# 4. 개발 서버 실행
pnpm dev
```
-## 코드 구조
+개발 서버가 실행되면 [http://localhost:3000](http://localhost:3000)에서 확인할 수 있습니다.
+
+### 🔧 환경 변수 설정
+
+`.env.local` 파일에 다음 환경 변수를 설정해주세요:
+
+```bash
+# API 엔드포인트
+NEXT_PUBLIC_API_BASE_URL= # 강사/조교용 API
+NEXT_PUBLIC_API_BASE_URL_SVC= # 학생/학부모용 API
-- `src/app`: 라우팅(페이지/레이아웃/메타/에러 처리)
-- `src/components`: 공용 컴포넌트 (`src/components/ui`는 shadcn/ui)
-- `src/services`: axios client + 도메인별 API 호출 (mapper 포함)
-- `src/providers`: React Query/Auth/Modal/Breadcrumb 등 상위 Provider
-- `src/stores`: Zustand store
-- `src/hooks`: 재사용 훅
-- `src/types`, `src/validation`: 타입 정의, Zod 스키마
-- `src/utils`, `src/constants`: 유틸/상수
+# Sentry (선택사항)
+NEXT_PUBLIC_SENTRY_DSN=
+SENTRY_AUTH_TOKEN=
+```
+
+---
+
+## 📁 프로젝트 구조
+
+```
+src/
+├── app/ # Next.js App Router
+│ ├── (auth)/ # 인증 관련 라우트
+│ ├── educators/ # 강사/조교 라우트
+│ ├── learners/ # 학생/학부모 라우트
+│ └── _components/ # 페이지별 컴포넌트
+├── components/ # 공용 컴포넌트
+│ └── ui/ # shadcn/ui 컴포넌트
+├── services/ # API 클라이언트 및 도메인 로직
+├── providers/ # React Context Providers
+├── stores/ # Zustand 상태 관리
+├── hooks/ # 커스텀 훅
+├── types/ # TypeScript 타입 정의
+├── validation/ # Zod 스키마
+├── utils/ # 유틸리티 함수
+└── constants/ # 상수 정의
+```
+
+### 주요 디렉토리 설명
+
+| 디렉토리 | 역할 |
+| ---------------- | ------------------------------------------------ |
+| `src/app` | 라우팅, 페이지, 레이아웃, 메타데이터, 에러 처리 |
+| `src/components` | 재사용 가능한 UI 컴포넌트 |
+| `src/services` | Axios 클라이언트 + 도메인별 API 호출 + Mapper |
+| `src/providers` | React Query, Auth, Modal, Breadcrumb 등 Provider |
+| `src/stores` | Zustand 기반 클라이언트 상태 관리 |
+| `src/hooks` | 재사용 가능한 커스텀 훅 |
+| `src/types` | 공통 타입 정의 |
+| `src/validation` | Zod 스키마 및 폼 검증 |
+
+---
+
+## 🔒 권한 및 인증
+
+### 역할 기반 라우팅
+
+SSam B는 URL 기반으로 사용자 역할을 구분합니다:
+
+| URL 패턴 | 역할 | 설명 |
+| -------------- | ------ | ----------------------------------- |
+| `/educators/*` | `MGMT` | 강사(INSTRUCTOR) 및 조교(ASSISTANT) |
+| `/learners/*` | `SVC` | 학생(STUDENT) 및 학부모(PARENT) |
+
+### 인증 방식
+
+- **세션 관리:** 쿠키 기반 세션
+- **API 통신:** 역할별 다른 Base URL 사용
+ - 강사/조교: `NEXT_PUBLIC_API_BASE_URL`
+ - 학생/학부모: `NEXT_PUBLIC_API_BASE_URL_SVC`
+
+### 조교 승인 프로세스
+
+조교(ASSISTANT)는 가입 후 다음 조건을 만족해야 대시보드에 접근할 수 있습니다:
+
+- `signStatus`가 `SIGNED` 상태여야 함
+- 조건 미충족 시 `/pending-approval` 페이지로 자동 리다이렉트
+
+---
+
+## 📜 사용 가능한 스크립트
+
+### 개발 및 빌드
+
+```bash
+pnpm dev # 개발 서버 실행 (http://localhost:3000)
+pnpm build # 프로덕션 빌드
+pnpm start # 프로덕션 서버 실행
+```
+
+### 코드 품질
+
+```bash
+# Linting
+pnpm lint # ESLint 실행
+pnpm lint:fix # ESLint 자동 수정
+
+# Formatting
+pnpm format # Prettier 포맷팅 적용
+pnpm format:check # Prettier 체크만 수행
+
+# Type Checking
+pnpm type-check # TypeScript 타입 체크
+```
+
+### 테스트
+
+```bash
+pnpm test # Jest 테스트 실행
+```
+
+## 🚢 배포 및 운영
+
+### 배포 플랫폼
+
+이 프로젝트는 **Vercel** 배포를 전제로 구성되어 있습니다.
+
+### Sentry 설정
+
+에러 모니터링을 위해 Sentry가 통합되어 있습니다:
+
+- **설정 파일:** `next.config.ts`에서 `withSentryConfig` 사용
+- **클라이언트 초기화:** `src/instrumentation-client.ts`
+- **Tunnel Route:** `/monitoring` (광고 차단 우회)
+
+### 환경 변수 (배포 시)
+
+Vercel 대시보드에서 다음 환경 변수를 설정해주세요:
+
+```bash
+NEXT_PUBLIC_API_BASE_URL
+NEXT_PUBLIC_API_BASE_URL_SVC
+NEXT_PUBLIC_SENTRY_DSN
+SENTRY_AUTH_TOKEN
+SENTRY_ORG
+SENTRY_PROJECT
+```
-## 스크립트
+---
-- 개발/빌드: `pnpm dev`, `pnpm build`, `pnpm start`
-- 품질: `pnpm lint`, `pnpm lint:fix`, `pnpm format`, `pnpm format:check`, `pnpm type-check`
-- 테스트: `pnpm test`
-- 체크: `pnpm check:commit`(lint+format), `pnpm check:push`(type-check+test)
+
-## 배포/운영 메모
+**Made with ❤️ by SSam B Team**
-- Vercel배포를 전제로 합니다.
-- Sentry는 `next.config.ts`에서 `withSentryConfig`로 설정되어 있고, client 초기화는 `src/instrumentation-client.ts`에서 수행합니다.
- - tunnel route: `/monitoring`
+
diff --git a/assets/landing.png b/assets/landing.png
new file mode 100644
index 0000000..834620d
Binary files /dev/null and b/assets/landing.png differ