# PAGE_FEATURES.md - 페이지별 기능 명세

> 와이어프레임 작성을 위한 페이지별 기능 설명 문서
> 모든 경로는 `/{locale}` 접두어 생략 (예: `/student/home` → 실제 `/ko/student/home`)

---

## 1. 전체 페이지 맵

| # | 카테고리 | 경로 | 페이지명 | 접근 권한 |
|---|---------|------|---------|----------|
| 1 | 랜딩 | `/` | 루트 리다이렉트 | 전체 |
| 2 | 랜딩 | `/[locale]` | 랜딩 페이지 | 전체 |
| 3 | 리다이렉트 | `/home` | 역할별 홈 리다이렉트 | 로그인 |
| 4 | 학생 | `/student/home` | 학생 홈 | 학생 |
| 5 | 교사 | `/teacher/home` | 교사 홈 | 교사 |
| 6 | 교사 | `/teacher/pending-approval` | 교사 승인 대기 | 교사(미승인) |
| 7 | 관리자 | `/admin/teacher-approvals` | 교사 승인 관리 | 관리자 |
| 8 | 관리자 | `/admin/ip-whitelist` | IP 화이트리스트 | 관리자 |
| 9 | 팀 | `/team` | 내 팀 목록 | 로그인 |
| 10 | 팀 | `/team/all` | 공개 팀 탐색 | 로그인 |
| 11 | 팀 | `/team/create` | 팀 생성 | 교사 |
| 12 | 팀 | `/team/[teamId]` | 팀 상세 | 조건부 |
| 13 | 팀 | `/team/[teamId]/manage` | 팀 관리 | 팀 소유자 |
| 14 | 팀 | `/invite/[inviteId]` | 초대 수락 | 전체 |
| 15 | 글쓰기 | `/write` | 글쓰기 모드 선택 | 로그인 |
| 16 | 글쓰기 | `/write/text` | 텍스트 글쓰기 | 로그인 |
| 17 | 글쓰기 | `/write/image` | 이미지 글쓰기 | 로그인 |
| 18 | 글쓰기 | `/write/easy` | 쉬운 글쓰기 | 로그인 |
| 19 | 글쓰기 | `/write/fill-in-blank` | 빈칸 채우기 | 로그인 |
| 20 | 글쓰기 | `/write/edit/[id]` | 글 수정 | 작성자 |
| 21 | 이미지 | `/imageUpload` | 이미지 업로드 | 로그인 |
| 22 | 인터랙션 | `/interaction` | 인터랙티브 뷰어 | 로그인 |
| 23 | 커리큘럼 | `/curriculum` | 커리큘럼 목록 | 로그인 |
| 24 | 커리큘럼 | `/curriculum/[curriculumId]` | 커리큘럼 상세 | 로그인 |
| 25 | 커리큘럼 | `/lesson/[lessonId]` | 수업 상세 | 로그인 |
| 26 | 커리큘럼 | `/my-curriculums` | 내 커리큘럼 | 로그인 |
| 27 | 사용자 | `/my` | 마이페이지 | 로그인 |
| 28 | 사용자 | `/writing` | 내 글 목록 | 로그인 |
| 29 | 사용자 | `/writing/[writingId]` | 글 상세 보기 | 로그인 |
| 30 | 요금제 | `/pricing` | 요금제 안내 | 전체 |

---

## 2. 카테고리별 상세 설명

---

### 2.1 랜딩/인증

#### `/` - 루트 리다이렉트
- 브라우저 언어에 따라 `/{locale}`으로 자동 리다이렉트
- UI 없음

---

#### `/[locale]` - 랜딩 페이지

**접근 권한**: 전체 (로그인 사용자는 역할별 홈으로 자동 리다이렉트)

**조건부 동작**:
- 로그인 + 교사 → `/teacher/home` 자동 이동
- 로그인 + 학생 → `/student/home` 자동 이동
- 비로그인 → 랜딩 페이지 표시

**주요 기능**:
- 서비스 소개 (사이트명, 태그라인, 부제목)
- **"시작하기" 버튼** → Google 로그인 모달 다이얼로그 오픈
- "이렇게 사용해요" 3단계 안내:
  1. 회원가입
  2. 만들기
  3. 글쓰기
- 하단 CTA 섹션: 캐릭터 이미지(`hello.png`) + CTA 버튼

**이동 경로**: "시작하기" 버튼 → 로그인 다이얼로그 → 로그인 후 역할별 홈

---

#### `/home` - 역할별 홈 리다이렉트

**접근 권한**: 로그인 필수

**동작**: 교사 → `/teacher/home`, 학생 → `/student/home` 자동 리다이렉트

> **인증 방식**: 별도 로그인 페이지 없이 모달 다이얼로그로 Google 로그인 처리

---

### 2.2 학생 영역

#### `/student/home` - 학생 홈

**접근 권한**: 학생 역할 필수

**주요 기능**:

1. **환영 메시지**: 사용자 이름(또는 이메일 앞부분) + 부제목 표시

2. **빠른 액션 그리드** (3개 카드):
   - "새 글쓰기" → `/write` 이동
   - "내 팀" → `/team` 이동
   - "팀 참가" → `/team/all` 이동
   - 미구현 카드는 클릭 불가 + "개발 중" 오버레이

3. **팀 초대 알림** (대기 초대 있을 때만 표시):
   - 각 초대: 팀 이름, 초대자 이름 표시
   - **"수락"** / **"거절"** 버튼

4. **글쓰기 패턴 분석 바**: 클릭 시 WritingPatternDialog 오픈

5. **최근 활동 섹션**:
   - 최근 작성 글 카드 그리드 표시
   - **"전체 보기"** 버튼 → `/writing` 이동
   - 글 삭제 가능
   - **빈 상태**: "아직 작성한 글이 없어요" + **"글쓰기 시작"** 버튼 → `/write`

**다이얼로그**: 글쓰기 패턴 분석 결과

---

### 2.3 교사 영역

#### `/teacher/home` - 교사 홈

**접근 권한**: 교사 역할 필수

**주요 기능**:
- 환영 메시지 (사용자 이름 표시)
- **"내 팀 보기"** 버튼 → `/team` 이동
- **"팀 만들기"** 버튼 → `/team/create` 이동

**이동 경로**: `/team`, `/team/create`

---

#### `/teacher/pending-approval` - 교사 승인 대기

**접근 권한**: 로그인 필수 (교사 승인 전 상태)

**조건부 동작** (2가지 상태):

**승인 대기 상태** (기본):
- 시계 아이콘 + "승인 대기 중" 제목 + 설명 메시지
- **"상태 확인"** 버튼 → 서버에서 최신 승인 상태 조회 (승인되면 자동 반영)
- **"로그아웃"** 버튼

**거부 상태**:
- X 아이콘 + "거부됨" 제목 + 설명 메시지
- 거부 사유 표시 (사유가 있는 경우)
- "상태 확인" 버튼 없음 (로그아웃만 가능)
- **"로그아웃"** 버튼

---

### 2.4 관리자 영역

#### `/admin/teacher-approvals` - 교사 승인 관리

**접근 권한**: 관리자 전용 (403 시 "접근 권한 없음" 화면)

**데이터**: 승인 대기 중인 교사 목록

**주요 기능**:
- 대기 교사 테이블: 이름, 이메일, 액션 열
- 대기 교사 수 배지 표시
- **"승인"** 버튼 → 교사 승인 처리
- **"거부"** 버튼 → 거부 사유 입력 다이얼로그 → 거부 처리

---

#### `/admin/ip-whitelist` - IP 화이트리스트 관리

**접근 권한**: 관리자 전용 (403 시 "접근 권한 없음" 화면)

**주요 기능**:
- 활성화/비활성화 토글 스위치
- 현재 접속 IP 표시 + **"현재 IP 추가"** 버튼
- IP 목록 관리 (줄 단위 텍스트 입력, IP 개수 표시)
- **"저장"** 버튼

---

### 2.5 팀 관리

#### `/team` - 내 팀 목록

**접근 권한**: 로그인 필수

**데이터**: 사용자의 모든 팀 목록 → "소유 팀"과 "참여 팀"으로 분류

**주요 기능**:
- 헤더에 통계 표시: "총 {n}개, 소유 {n}, 참여 {n}"
- **"팀 만들기"** 버튼 → `/team/create` 이동
- **소유 팀 섹션** (FaCrown 아이콘): 내가 만든 팀 카드 그리드
  - 팀 카드 클릭 → `/team/{teamId}/manage` (관리 페이지)
- **참여 팀 섹션** (FaUserFriends 아이콘): 참여 중인 팀 카드 그리드
  - 팀 카드 클릭 → `/team/{teamId}` (상세 페이지)

**팀 카드 표시 정보**: 팀 이름, 커버 이미지, 멤버 수, AI 활성화 여부

---

#### `/team/all` - 공개 팀 탐색

**접근 권한**: 전체 (로그인 불필요)

**데이터**: 공개 팀 목록 (10개씩 페이지네이션)

**주요 기능**:
- 공개 팀 카드 그리드 표시
- **"새로고침"** 버튼 → 목록 다시 로드
- **"더 보기"** 버튼 → 다음 페이지 로드 (커서 기반 페이지네이션)
- 팀 카드 클릭 → `/team/{teamId}` 이동

---

#### `/team/create` - 팀 생성

**접근 권한**: 로그인 필수

**폼 필드**:
- **팀 이름** (필수): 50자 제한
- **커버 이미지** (선택): 드래그 앤 드롭 업로드, 16:9 비율

**버튼**: **"취소"** / **"만들기"**

**생성 완료 다이얼로그**:
- **"초대 링크 만들기"** → 초대 URL + **"복사"** 버튼 + QR 코드 + **"QR 다운로드"**
- **"팀 관리로 이동"** → `/team/{teamId}/manage`

#### `/team/[teamId]` - 팀 상세

**접근 권한**: 조건부 (멤버/공개팀/비공개팀에 따라 다른 뷰)

**3가지 뷰:**

**뷰 A - 멤버 뷰** (팀 멤버일 때):
- 팀 정보 헤더: 팀 이름, 멤버 수, 소유자 배지, 팀 설명
- 소유자: **"팀 관리"** 버튼 → `/team/{teamId}/manage`
- 멤버: **"팀 나가기"** 버튼 → 탈퇴 확인 다이얼로그 (소유자는 나가기 불가)
- 4개 탭:
  1. **개요**: 커리큘럼 진행 카드 + 통계 4개 (전체/주간/월간/최근 활동) + 최근 글 3개
  2. **주제**: 주제별 아코디언 (주제당 글 목록)
  3. **활동**: 내 글 현황 + 멤버 리더보드 + 팀 최근 글
  4. **멤버**: 멤버 카드 그리드

**뷰 B - 공개 뷰** (비멤버 + 공개 팀):
- 팀 정보 + **"팀 참가"** 버튼
- 공개 글 목록 (허용 시) 또는 "글이 공개되지 않습니다" 안내

**뷰 C - 비공개 뷰** (비멤버 + 비공개 팀):
- "접근 권한 없음" 메시지

#### `/team/[teamId]/manage` - 팀 관리

**접근 권한**: 팀 소유자 전용

**"뒤로가기"** → `/team`, **"멤버 페이지 보기"** → `/team/{teamId}`

**6개 탭:**

1. **개요** (LuInfo): TeamInfoCard 컴포넌트
   - 팀 기본 정보 표시/수정

   **초대 링크 관리 (InviteLinkManager)**:
   - 기존 초대 링크 목록 표시: 각 초대마다 사용 횟수, 최대 사용 횟수(설정 시), 만료일 배지
   - 각 초대: QR 코드 미리보기(클릭 시 확대 다이얼로그) + URL 표시 + **"복사"** 버튼 + **"취소"** 버튼
   - **"+ 만들기"** 버튼 → 초대 생성 폼 토글:
     - **최대 사용 횟수**: NumberInput (0 = 무제한)
     - **만료일**: DatePicker (프리셋: 없음/내일/1주/2주/4주, 또는 캘린더에서 직접 선택)
     - **"취소"** / **"만들기"** 버튼
   - 빈 상태: "아직 초대 링크가 없습니다"

   **이메일 초대 (EmailInviteSection)**

   **대량 멤버 생성 (BulkMemberCreator)** - 4단계 플로우:
   - 스텝 인디케이터 (입력 → 미리보기 → 생성 중 → 결과)
   - **Step 1 - 입력**:
     - 학생 이름 목록: 행 단위 입력 (추가/삭제 가능), 또는 CSV 파일 업로드 (드래그 앤 드롭 지원)
     - 아이디 템플릿: 기본값 `{이름}_{랜덤}` (플레이스홀더: `{이름}`, `{번호}`, `{랜덤}` 칩 클릭으로 삽입)
     - 비밀번호 템플릿: 기본값 `raon{번호}!!` (동일 플레이스홀더)
     - 라이브 미리보기: 첫 번째 학생 기준으로 생성될 아이디/비밀번호 실시간 표시
     - **"미리보기"** 버튼 (유효한 행 1개 이상일 때 활성)
   - **Step 2 - 미리보기**: 전체 학생의 생성될 아이디/비밀번호 테이블 확인 → **"돌아가기"** / **"생성"** 버튼
   - **Step 3 - 생성 중**: 진행 애니메이션
   - **Step 4 - 결과**:
     - 성공/실패 결과 테이블 (이름, 아이디, 비밀번호, 상태)
     - **"카드 출력"** 버튼 → 새 창에서 학생 로그인 카드 3열 그리드로 출력 (이름/아이디/비밀번호/팀명 포함)
     - 성공 수/실패 수 토스트 알림

2. **AI 설정** (LuBrain):
   - AI 기능 설정 (TeamAISettings)
   - 채점 설정 (TeamScoringSettings)
   - 평가 기준 설정 (TeamRubricSettings)

3. **커리큘럼** (LuBookMarked):
   - 팀 커리큘럼 관리 (TeamCurriculumManager)

4. **주제** (LuBookOpen):
   - 글쓰기 주제 CRUD 관리 (TeamTopicManager)

5. **모니터링** (LuActivity):
   - 실시간 글쓰기 모니터링 (LiveWritingMonitor)
   - 주제별/멤버별 분석 (TopicMemberAnalysisSection)

6. **멤버** (LuUsers):
   - 멤버 편집기 (TeamMemberEditor): 멤버 목록, 닉네임 수정, 소유권 이전, 멤버 제거, 글쓰기 분석, 트렌드 보기
   - **위험 구역**: 팀 삭제
     - **"팀 삭제"** 버튼 → 삭제 확인 다이얼로그

**팀 삭제 다이얼로그**:
- 경고 메시지 ("이 작업은 되돌릴 수 없습니다")
- 팀 이름 표시
- **팀 이름 확인 입력**: 정확히 일치해야 삭제 버튼 활성화
- **"취소"** / **"삭제"** 버튼 → 삭제 성공 시 `/team`으로 이동

#### `/invite/[inviteId]` - 초대 수락

**접근 권한**: 전체 (비로그인도 접근 가능)

**데이터**: 초대 정보 (팀 이름, 설명, 유효 여부, 이미 참가 여부)

**5가지 상태별 화면:**

1. **로딩**: 스피너 + "로딩 중"

2. **이미 참가한 팀**: "이미 멤버입니다" + **"팀으로 이동"** 버튼 → `/team/{teamId}`

3. **참가 완료**: "참가 완료!" + **"팀으로 이동"** 버튼 → `/team/{teamId}`

4. **유효하지 않은 초대**: "유효하지 않은 초대" + 사유 표시 + **"홈으로"** 버튼 → `/home`

5. **참가 준비** (유효한 초대):
   - 팀 이름, 설명 (있으면) 표시
   - 에러 발생 시 에러 메시지 표시
   - **로그인 상태**: **"팀 참가"** 버튼 → 참가 처리 (로딩 표시)
   - **비로그인 상태**: "로그인하여 참가하세요" + **"로그인 & 참가"** 버튼 → 로그인 다이얼로그 오픈 → 로그인 완료 후 자동 참가

---

### 2.6 글쓰기

#### `/write` - 글쓰기 모드 선택

**접근 권한**: 로그인 필수

**URL 파라미터에 의한 자동 리다이렉트**:
- `lessonId` → `/write/text` (수업 파라미터 포함)
- `topicId` + `helpLevel=ai-draft` → `/write/fill-in-blank`
- `topicId` + `helpLevel=ai-hint` → `/write/easy`
- `topicId` + `startType=image` → `/write/image`
- `topicId` (기본) → `/write/text`
- `id` → `/write/edit/{id}`
- `mode=wrt` → `/write/text`
- `mode=img` → `/write/image`

**주요 기능** (파라미터 없이 직접 진입 시):

1. **헤더 텍스트**: "모드를 선택해주세요"

2. **컴팩트 카드 행 (CompactCardsRow)**: 사용자가 속한 팀의 최근 글 3개 미리보기

3. **2단계 모드 선택 (WritingModeSelector)**:
   - **Step 1 - 시작 유형 선택** (2개 카드):
     - "그림부터 시작" (LuImage)
     - "글부터 시작" (LuFileText)
   - **Step 2 - 도움 수준 선택** (3개 카드, 뒤로가기 버튼 포함):
     - "AI 초안" (LuBot, "추천" 배지) → `/write/fill-in-blank` (IP 제한 시 비활성)
     - "AI 힌트" (LuSparkles) → `/write/easy`
     - "혼자서" (LuPenLine, "기본" 배지) → `/write/text`
   - 이미지 시작 선택 시 → `/write/image`

4. **추천 영감 섹션 (InspirationSection)**: 가로 배치 2개 영감 아이템

**이동 경로**: `/write/text`, `/write/image`, `/write/easy`, `/write/fill-in-blank`, `/write/edit/{id}`

#### `/write/text` - 텍스트 글쓰기

**접근 권한**: 로그인 필수

**입력 필드**: 주제 선택 드롭다운, 제목 입력, 리치 텍스트 에디터

**버튼**: **"저장된 초안"**, **"맞춤법 검사"**, **"AI 힌트"** (조건부), **"뒤로"**, **"저장"**

**AI 기능**:
- **실시간 텍스트 분석**: 점수, 감각어/감정어/의성어 탐지, 개선 제안
- **AI 힌트**: 4단계 진행형 힌트 (팀 설정으로 제한 가능)
- **맞춤법 검사**: 오류 단어 + 교정 제안

**자동 저장**: 작성 중 자동 저장 + 상태 표시

**특수 모드**:
- **수업 모드** (`lessonId`): 수업 프롬프트 표시, 자동 저장 비활성
- **팀 모드**: 팀 이름 + 주제 헤더
- **영감 모드** (`inspirationId`): 제목/주제 자동 채움

**다이얼로그**: 저장된 초안 목록, 주제 변경 경고, AI 힌트 드로어

**이동**: 저장 시 → `/imageUpload?writingId={id}`

---

#### `/write/image` - 이미지 글쓰기

**접근 권한**: 로그인 필수

**텍스트 글쓰기와 동일한 기능** (AI 분석, 힌트, 맞춤법, 자동 저장, 다이얼로그) + 아래 차이점:

**차이점**:
- **순차적 잠금 해제**: 주제 선택 → 제목 입력 → 이미지 업로드 + 에디터 활성화
- **이미지 업로드**: 드래그 앤 드롭, **"이미지 변경"** 으로 재업로드 가능
- 수업 모드/영감 모드 미지원

**이동**: 이미지 있으면 → `/interaction`, 없으면 → `/imageUpload`

#### `/write/easy` - 쉬운 글쓰기

**접근 권한**: 로그인 필수

**2가지 모드**: 텍스트 모드 (기본) / 이미지 모드

**입력**: 주제 선택, 제목 입력, 줄 단위 텍스트 입력 (Enter로 제출, 편집/삭제 가능), 이미지 모드 시 이미지 업로드

**버튼**: **"저장된 초안"**, **"뒤로"**, **"저장"**

**AI 기능**:
- **줄별 AI 제안**: 줄 제출 후 자동 생성 (줄당 최대 3개)
- **이미지 분석** (이미지 모드): 이미지에서 추천 키워드 추출

**자동 저장**: 작성 중 자동 저장 + 상태 표시

**이미지 모드 순차 잠금**: 주제 → 제목 → 이미지 + 글쓰기

**이동**: 이미지 있으면 → `/interaction`, 없으면 → `/imageUpload`

#### `/write/fill-in-blank` - 빈칸 채우기 글쓰기

**접근 권한**: 로그인 필수, AI 기능은 IP 화이트리스트 확인

**2가지 모드**: 이미지 우선 (기본) / 텍스트 우선

**Step 1 - 입력**:
- 주제 선택 → 제목 입력 → 콘텐츠 입력 (순차 잠금)
- 이미지 모드: 이미지 업로드 / 추천 이미지 선택 / 팀 글 이미지 선택
- 텍스트 모드: 텍스트 입력 (최소 20자)
- **"생성"** 버튼 → AI 초안 생성 (진행률 표시)

**Step 2 - 빈칸 채우기**:
- AI 초안의 빈칸을 순차적으로 채움 (원본/직접 입력/AI 제안 선택)
- 진행률 바 + 참여 보상 점수 표시
- **"다시 시작"** / **"저장"** 버튼

**이동**: 이미지 있으면 → `/interaction`, 없으면 → `/imageUpload`

#### `/write/edit/[id]` - 글 수정

**접근 권한**: 로그인 필수 (글 작성자)

**입력**: 제목 (편집 가능), 주제 (읽기 전용), 리치 텍스트 에디터, 이미지 변경 (선택)

**버튼**: **"뒤로"**, **"맞춤법 검사"**, **"AI 힌트"** (팀 AI 활성화 시), **"저장"**

**AI 기능**: `/write/text`와 동일 (실시간 분석, 맞춤법, AI 힌트)

**자동 저장**: 없음 (명시적 저장만)

**이동**: 이미지 있으면 → `/interaction`, 없으면 → `/imageUpload`

---

### 2.7 이미지 업로드 & 인터랙션

#### `/imageUpload` - 이미지 업로드

**접근 권한**: 로그인 필수

**파라미터**: `writingId` (필수)

**모드 선택 화면**: **"AI 이미지 생성"** / **"직접 업로드"** 버튼

**AI 모드 (4단계 플로우)**:
1. **추출 중**: 글 내용에서 장면 자동 추출
2. **장면 선택**: 추출된 장면 카드 목록 → 하나 선택 → **"생성"** 버튼
3. **생성 중**: 진행률 표시
4. **완료**: 생성 이미지 미리보기 + **"장면 변경"** / **"계속"** 버튼

**업로드 모드**:
- 파일 업로드 (드래그 앤 드롭) → 미리보기 + **"파일 변경"** / **"업로드"** 버튼

**수정 모드** (이미 이미지가 있는 글):
- 기존 이미지 표시 + **"이미지 변경"** / **"현재 유지"** 버튼

**AI 생성 비활성 조건**: 플랜 미지원, IP 제한, 일일 한도 초과, 팀 AI 비활성

**이동**: 완료 시 → `/interaction?writingId={id}`

---

#### `/interaction` - 인터랙티브 이미지 뷰어

**접근 권한**: 로그인 필수

**파라미터**: `writingId` (필수)

**주요 기능**:
- 생성된 이미지를 인터랙티브 캔버스로 표시
- 기존 왜곡 영역 및 효과 표시

**보기/편집 모드 토글**:

**보기 모드**: 클릭/터치로 왜곡 효과 활성화

**편집 모드** (소유자만):
- 왜곡 영역 추가/삭제/편집
- 물리/모션/이징/속도/강도 등 파라미터 조정 (프리셋 또는 커스텀)
- 스프라이트 효과 설정
- 전체 화면 토글
- **"저장"** 버튼

**분석 섹션**: 점수 (0~100), 영역 해금 배지, 개선 힌트

**댓글 섹션**: 댓글 목록 + 작성

---

### 2.8 커리큘럼 & 수업

#### `/curriculum` - 커리큘럼 목록

**접근 권한**: 로그인 필수 (미인증 시 홈으로 리다이렉트)

**기능**: 사용 가능한 커리큘럼 대시보드 표시

**이동**: 커리큘럼 클릭 → `/curriculum/{curriculumId}`

---

#### `/curriculum/[curriculumId]` - 커리큘럼 상세

**접근 권한**: 로그인 필수

**데이터**: 커리큘럼 정보 + 수업 목록 (병렬 로드)

**기능**: 커리큘럼 제목/설명 + 수업 목록 (순서대로) + 수업 뷰어

**상태별 화면**: 로딩 (스피너), 에러 (토스트 "커리큘럼 로드 실패")

**이동**: 수업 클릭 → `/lesson/{lessonId}`

---

#### `/lesson/[lessonId]` - 수업 상세

**접근 권한**: 로그인 필수

**파라미터**: `lessonId` (필수), `teamId`, `curriculumId`, `step` (선택)

**기능**:
- 수업 콘텐츠 표시 (마크다운, 비디오, 글쓰기 프롬프트 등)
- **"뒤로가기"** 버튼: teamId 있으면 → `/team/{teamId}`, 없으면 → 이전 페이지
- **"수업 완료"** 버튼: teamId + curriculumId + step 있을 때 → 수업 완료 처리 + 토스트 "레슨을 완료했어요!" + 팀 페이지로 이동

**상태별 화면**: 로딩 (스피너), 에러 (에러 메시지 + 뒤로가기), 권한 없음

---

#### `/my-curriculums` - 내 커리큘럼

**접근 권한**: 로그인 필수 (미인증 시 홈으로 리다이렉트)

**기능**: 사용자가 등록한 커리큘럼 대시보드 표시

---

### 2.9 마이페이지 & 글 관리

#### `/my` - 마이페이지

**접근 권한**: 로그인 필수 (미인증 시 홈으로 리다이렉트)

**주요 기능**:

1. **프로필**: 아바타 변경, 이름 편집, 나이/학년 편집, 플랜 배지
2. **통계** (4개 카드): 글 수, 팀 수, AI 크레딧, 주간 목표 진행률
3. **최근 글 미리보기**: 최대 3개 + **"전체 보기"** → `/writing`
4. **팀 미리보기**: 최대 3개 + **"전체 보기"** → `/team`
5. **커리큘럼 미리보기**: **"전체 보기"** → `/my-curriculums`
6. **환경 설정**: 언어, 테마 등
7. **계정 정보**: 현재 플랜 + 제한 사항 (AI 팀 수, 분석 사용량, 이미지 생성 한도) + AI 크레딧
   - FREE 플랜: **"업그레이드"** 버튼 → `/pricing`
   - **"계정 삭제"** → 확인 다이얼로그

#### `/writing` - 내 글 목록

**접근 권한**: 로그인 필수

**데이터**: 사용자의 모든 글 목록

**주요 기능**:
- 제목 + "총 {n}개의 글을 작성했어요" 통계
- **정렬 드롭다운**: "최신순" / "오래된순"
- 글 카드 그리드: 이미지 미리보기, 제목, 날짜, 삭제 버튼
- 글 카드 클릭 → `/writing/{writingId}`
- 글 삭제 (삭제 확인 후 목록에서 제거, 애니메이션)

**상태별 화면**:
- **로딩**: 스켈레톤
- **빈 상태**: "아직 작성한 글이 없어요" + **"글 쓰기 시작하기"** 버튼 → `/write`

---

#### `/writing/[writingId]` - 글 상세 보기

**접근 권한**: 전체 (공개 페이지, 로그인 불필요)

**데이터**: 글 상세 정보 (서버 사이드 렌더링)

**주요 기능**:
- **헤더** (스티키): 글 제목, 작성자 정보, 메타데이터
- **인터랙티브 이미지** (generatedImage 존재 시): 저장된 왜곡 영역 + 스프라이트 효과로 인터랙티브 뷰어 표시
- **원본 글**: HTML 포맷 텍스트 표시
- **댓글 섹션**: 댓글 목록 + 댓글 작성 + 답글

**상태별 화면**: 로딩, 에러 (글 없음 / 로드 실패 → 홈으로 이동)

---

### 2.10 요금제

#### `/pricing` - 요금제 안내

**접근 권한**: 전체 (공개 페이지)

**주요 기능**:

1. **결제 주기 토글**: 월간/연간 전환 (연간 할인 배지 표시)

2. **요금제 카드 4개**:
   - **Free**: 무료, 기본 기능, CTA → 로그인 다이얼로그
   - **Classroom** (하이라이트, "가장 인기" 배지): 유료, 교실 기능
   - **Academy**: 유료, 고급 기능
   - **School**: "문의" → 이메일 (`contact@bluenovalab.com`)
   - 각 카드: 플랜명, 설명, 가격, 기능 목록, CTA 버튼
   - 현재 플랜이면 버튼 비활성

3. **CTA 버튼 동작** (로그인 상태 + 유료 플랜):
   - 동일 플랜+주기 → 비활성
   - 무료→유료 → 구매 확인 다이얼로그
   - 업그레이드 → 업그레이드 다이얼로그 (즉시/예약, 예상 환불 크레딧)
   - 다운그레이드 → 다운그레이드 다이얼로그 (즉시/예약, 예상 크레딧+유효기간)
   - 주기 변경 → 주기 변경 다이얼로그

4. **기능 비교 테이블**: 9개 기능 × 4개 플랜 매트릭스 (팀 AI, 멤버, 글, AI 분석, AI 어시스턴트, 이미지 생성, 실시간 모니터링, 패턴 분석, 우선 지원)

5. **FAQ 섹션**: 4개 Q&A

**다이얼로그 4종**: 구매 확인, 업그레이드 옵션, 다운그레이드 옵션, 결제 주기 변경

---

## 3. 주요 유저 플로우

### 3.1 학생 글쓰기 플로우
```
랜딩 → 로그인 → /student/home → /write (모드 선택)
  ├── /write/text → /imageUpload → /interaction → 완료
  ├── /write/image → /interaction → 완료
  ├── /write/easy → 완료
  └── /write/fill-in-blank → 완료
```

### 3.2 교사 팀 관리 플로우
```
랜딩 → 로그인 → /teacher/home → /team/create → (초대 링크 생성)
                               → /team → /team/[teamId] → /team/[teamId]/manage
```

### 3.3 학생 팀 참가 플로우
```
초대 링크 클릭 → /invite/[inviteId] → 로그인 → 팀 참가 → /team/[teamId]
또는
/student/home → /team/all → 팀 선택 → /team/[teamId] → 참가
```

### 3.4 커리큘럼 학습 플로우
```
/curriculum → /curriculum/[curriculumId] → /lesson/[lessonId] → 수업 완료
                                                              → /write (연계 글쓰기)
```

### 3.5 교사 승인 플로우
```
교사 회원가입 → /teacher/pending-approval (대기)
관리자: /admin/teacher-approvals → 승인/거부
승인 후: /teacher/home
```

### 3.6 글 수정 플로우
```
/writing → /writing/[writingId] → /write/edit/[id] → 저장 → /writing/[writingId]
```

---

## 4. 공통 UI 요소 (모든 페이지)

- **인증 모달**: Google 로그인 다이얼로그 (별도 로그인 페이지 없음)
- **네비게이션**: 상단 헤더 (로고, 메뉴, 프로필)
- **로케일**: 한국어/영어/일본어 전환
- **토스트**: 성공/오류 알림
- **로딩**: 페이지별 스피너/스켈레톤

---

© 2024 BlueNovaLab. All rights reserved.