交付计划：从骨架到 MVP

执行编排视角。范围里程碑见 02_milestones.md，MVP 范围见 01_mvp_plan.md，技术选型见 ../03_architecture/05_tech_stack_decision.md。

当前状态

✅ Phase 0 完成 — 文档定稿、技术选型（ADR）、前后端骨架、git 初始化。

总体流程

Phase 1  PRD + 领域建模
            │
            ▼
Phase 2  ┌─ 前端设计 (claude design) ─┐   ← 并行
         └─ 后端设计 (Claude) ────────┘
            │
            ▼
Phase 3  接口规范 (REST + AG-UI 契约)     ← 前后端解耦 gate
            │
            ▼
Phase 4  ┌─ 后端实现 (Claude) ─┐          ← 并行
         └─ 前端实现 ──────────┘
            │
            ▼
Phase 5  联调 + MVP Demo + 部署

关键原则：接口规范（Phase 3）是前后端并行的 gate。 一旦 REST + AG-UI 契约定稿，前端可用 mock 独立开发、后端独立实现，互不阻塞——AG-UI 的干净边界让这成为可能。

Phase 详情

Phase 1 · PRD + 领域建模

负责： Claude ｜ 输入： docs/02_product + docs/04_roadmap
产出：
- 完整 PRD，分模块（见下「模块分解」），每模块含用户故事 / 功能点 / 验收标准 / 优先级（P0·P1）
- 数据模型定稿 → 可执行 migration 设计（基于 03_data_model.md）
Gate： 你评审 PRD 通过

Phase 2 · 前端设计 ∥ 后端设计（并行）

轨道 A — 前端设计（负责：claude design）

输入：PRD + interactive_ui_protocol
产出：交互稿、设计规范（design tokens / 组件视觉）、参考 UI
范围：Interview 受访者端、Study Builder、Results Dashboard

轨道 B — 后端设计（负责：Claude）

LangGraph harness 详设（graph 节点 / state / interrupt() 点 / extraction 触发）
服务分层、DB migration、Model Gateway（LiteLLM）、Extraction pipeline、KB/RAG
产出：后端设计文档 + migration
Gate： 两轨产出就绪

Phase 3 · 接口规范（负责：Claude，对齐设计稿）

REST API（OpenAPI）：admin + public，基于 02_api_contracts 细化
AG-UI 事件契约：interview runtime 事件 schema（message / render_interaction / interaction result / extraction / conclude）
共享类型：pydantic（后端）+ zod（前端）
Gate： 契约冻结 → 解锁 Phase 4 并行

Phase 4 · 后端实现 ∥ 前端实现（并行）

后端（Claude）： 数据层 → API → LangGraph harness → interaction tool → extraction → KB/RAG → model gateway → AG-UI endpoint（可先 mock 稳定契约，让前端并行）
前端（基于设计稿 + 接口规范）： assistant-ui interview runtime、interaction 组件库、study builder、results dashboard；对接 REST + AG-UI
Gate： 各自冒烟可用

Phase 5 · 联调 + MVP Demo + 部署（负责：Claude 主导）

端到端：创建 study → 发布 → 受访者访谈（含交互组件）→ extraction + evidence → results → export
Demo Study：用 AgentSurvey 调研 AgentSurvey（见 01_mvp_plan）
部署：前端 Vercel + 后端容器 + Postgres（Neon/Supabase）+ Redis
验收：对齐 mvp_plan 的 Functional / Technical / UX Acceptance

模块分解（PRD 将按此组织）

模块	优先级	摘要
Auth / Workspace	P0	登录、workspace、成员
Project / Study 管理	P0	project / study CRUD、版本、public link
Study Builder	P0	brief / objectives / guide / agent / tools / output schema / KB / preview（stepper）
Interview Runtime	P0	assistant-ui chat + AG-UI + harness 驱动
Interaction 组件库	P0	single / multiple choice、Likert、ranking（MVP 先 4 种）
Extraction / Evidence	P0	结构化抽取 + confidence + evidence + review
Results / Review	P0	sessions、transcript、字段表、evidence panel、export
Knowledge Base	P1	文本 KB、chunk、pgvector retrieval
Model / Tool 配置	P1	provider 配置、tool registry、policy

部署架构

[ 用户浏览器 ]
   │
   ├──▶ [ 内容站 Astro @ Vercel ]   landing / 101 文档(公开) · PRD 可视化(内部) · 静态,读 docs/
   │
   └──▶ [ 前端 Next.js @ Vercel ]
              │ REST + AG-UI (HTTP / SSE)
              ▼
        [ 后端 FastAPI + LangGraph @ 容器平台 ]   (Railway / Render / Fly.io；规模化 → Cloud Run / ECS)
              ├── PostgreSQL + pgvector  (Neon / Supabase)   ← 业务 + checkpointer + 向量
              ├── Redis                  (session / stream / queue)
              ├── Arq worker             (extraction / synthesis / KB ingestion)
              └── 对象存储 (S3 兼容)      (上传 / 导出)

内容站轨道（website，与产品主线并行）

Astro + Starlight 内容站，与产品 app 低耦合，可独立推进：

内容	何时	访问
PRD 可视化	现在（PRD 边写边可视化）	内部（密码保护 / 本地）
101 文档中心	随产品功能成型	公开
Landing page	随品牌 / 上线	公开

数据源 = docs/（SSOT）；骨架与适配点见 ../../website/README.md。

分工速查

Phase	Claude	claude design	你
1 PRD	主笔	—	评审
2 设计	后端设计	前端设计稿	评审设计
3 接口	主笔	对齐	确认契约
4 实现	后端 + 前端落地	设计支持	验收
5 联调部署	主导	走查	验收 + 上线决策