src/
├── api/              # Axios HTTP 클라이언트 (1개)
│   └── client.ts     # 인스턴스, 인터셉터, 에러 핸들링
│
├── components/       # 컴포넌트 (100개+)
│   ├── ui/           # shadcn/ui 기반 (31개) - 도메인 무관
│   ├── common/       # 공통 (11개) - Footer, Modal, 캐릭터 상세
│   ├── editor/       # 에디터 모듈 (28개) - Tiptap, 사이드바, AI
│   │   ├── extensions/  # 커스텀 Tiptap 익스텐션 (16개)
│   │   ├── sidebar/     # 챕터 트리, 컨텍스트 메뉴
│   │   └── ai-chat/     # AI 채팅 UI
│   ├── CharacterGraph/  # 관계도 모듈 (20개) - D3, Canvas
│   │   └── CanvasGraph/ # Canvas 렌더러
│   ├── library/      # 서재 페이지 컴포넌트
│   ├── layouts/      # 레이아웃
│   └── ...
│
├── hooks/            # 커스텀 훅 (36개) ⭐
│   ├── useDocuments.ts       # 문서 CRUD (TanStack Query)
│   ├── useCharacters.ts      # 캐릭터 관리
│   ├── useForeshadowing.ts   # 복선 관리
│   ├── useProjectAnalysis.ts # AI 분석 트리거
│   ├── useJobSSE.ts          # SSE 작업 스트리밍
│   └── ...
│
├── services/         # API 서비스 레이어 (20개)
│   ├── documentService.ts
│   ├── characterService.ts
│   ├── aiService.ts
│   └── ...
│
├── stores/           # Zustand 스토어 (17개) ⭐
│   ├── useAuthStore.ts          # 인증 (persist)
│   ├── useEditorStore.ts        # 에디터 UI
│   ├── useEditorSettingStore.ts # 에디터 설정 (persist)
│   ├── useAnalysisBufferStore.ts # 증분 분석 버퍼 (IndexedDB)
│   ├─�� useWritingStatsStore.ts  # 집필 통계
│   └── ...
│
├── types/            # TypeScript 타입 정의 (21개)
│
├── pages/            # 라우트 단위 페이지 (14개)
│   ├── editor/       # 에디터 페이지
│   ├── library/      # 서재 페이지
│   ├── world/        # 세계관 페이지
│   └── ...
│
├── lib/              # 유틸리티 (12개)
│   └── utils.ts      # cn(), 공통 함수
│
├── design-system/    # 디자인 토큰
│
└── repositories/     # 로컬 데이터 저장소 (5개)
    ├── DocumentRepository.ts
    └── LocalDocumentRepository.ts  # 데모 모드용

┌──────────────────────────────────────────────────────────────────┐
│                         Data Flow                                │
├──────────────────────────────────────────────────────────────────┤
│                                                                  │
│   [User Input]                                                   │
│        │                                                         │
│        ▼                                                         │
│   [Component] ──────── useState (local) ◀──── 컴포넌트 상태      │
│        │                                                         │
│        ▼                                                         │
│   [Hook] ──────────── TanStack Query ◀────── API 데이터          │
│        │                     │                                   │
│        │                     └────── Optimistic Update           │
│        ▼                                                         │
│   [Service] ────────── Axios ────────────▶ [Backend API]         │
│        │                                                         │
│        │                                                         │
│   [Zustand Store] ◀─── Global UI State ◀──── 전역 UI 상태        │
│                                                                  │
│   [IndexedDB] ◀──────── Analysis Buffer ◀──── 증분 분석 버퍼     │
│                                                                  │
└──────────────────────────────────────────────────────────────────┘

src/__tests__/
└── qa/
    ├── api/        # API 연동 테스트
    └── scenarios/  # 시나리오 기반 기능 테스트

e2e/
├── fixtures/       # 테스트 데이터
└── tests/          # E2E 테스트 파일

feat: 새 기능 추가
fix: 버그 수정
docs: 문서 변경
style: 코드 포맷팅 (동작 변화 X)
refactor: 리팩토링 (동작 변화 X)
test: 테스트 추가
chore: 빌드, 설정, 의존성 변경

main ─────── Archive (직접 push 금지)
release ──── Production 배포 트리거
dev ──────── Staging 배포 트리거, 개발 통합
feature/* ── 기능 개발 → dev PR
fix/* ────── 버그 수정 → dev PR
hotfix/* ─── 긴급 수정 → release PR (자동 backport to dev)

1. GitHub Actions Trigger (release/dev push)
       │
       ▼
2. npm ci && npm run build
       │
       ▼
3. S3 Sync
   ├── /assets/* → max-age=31536000 (영구 캐시, 해시된 파일)
   └── /index.html → no-cache (항상 최신)
       │
       ▼
4. CloudFront Invalidation (/index.html only)
       │
       ▼
5. Health Check (5회 재시도)