Files

文档索引

当前文档只保留对求职演示和短期迭代有用的内容,避免旧方案、临时交接和原型素材混在主线里。

Product

  • product/job-search-relaunch-prd.md 求职版产品重启 PRD。用于说明产品定位、用户价值、MVP 范围和面试表达主线。

  • product/unified-generation-workflow-prd.md 统一生成工作流 PRD。用于说明故事、绘本、封面、语音如何收敛成一条清晰体验。

  • product/voice-co-creation-mode-incremental-prd.md 语音共创模式增量 PRD。用于定义孩子通过语音生成并修正故事走向的后续产品路线当前仅作为并行发现文档不插队主开发线。

Planning

  • planning/week-1-execution-backlog.md Week 1 执行 backlog。用于说明求职版重启的第一阶段范围、进展和交付状态。

  • planning/week-2-execution-backlog.md Week 2 执行 backlog。用于继续推进演示闭环、前端状态体验和面试材料。

  • planning/week-2-to-4-execution-backlog.md Week 2 到 Week 4 总执行 backlog。用于跟踪 Phase 2 音频缓存、时间线联动、Provider 运营摘要和 Demo 包装。

  • planning/demo-checklist.md 求职演示检查清单。用于演示前确认 Docker 环境、核心链路、话术和风险预案。

  • planning/demo-package.md 求职版 Demo 包装页。用于面试前快速准备演示路径、讲解锚点和失败预案。

  • planning/demo-validation-log.md 本地 Docker 演示验证记录。用于说明最近一次构建、smoke 和手动检查结果。

  • planning/interview-pitch.md 3 分钟项目讲解稿。用于面试中说明产品定位、生成工作流、Provider 分层和取舍。

  • planning/week-1-sprint-review.md Week 1 复盘总结。用于沉淀已完成成果、剩余缺口和下一阶段建议。

  • planning/week-4-sprint-review.md Week 4 复盘总结。用于说明求职版 Demo 包装、当前状态和生产化 backlog。

Technical

  • technical/architecture.md 求职版架构说明。用于解释产品闭环、后端分层、状态模型和可观测性。

  • technical/memory-system-dev.md 记忆系统技术说明。用于后续继续做孩子档案、故事宇宙和个性化生成。

  • technical/api-compatibility.md 旧生成 API 兼容层策略。用于说明历史接口如何迁移到统一 generation 入口。

  • technical/generation-job-state.md Generation Job 状态落库决策。用于说明 job/event 如何追踪 workflow、资产补全、provider 调用和查询入口。

  • technical/provider-routing.md Provider Routing 技术说明。用于解释 Capability / Provider / Adapter / Routing Policy 的职责边界。

  • technical/voice-co-creation-phase-a-tech-spec.md 语音共创 Phase A 技术方案。用于把增量 PRD 收敛成最小可实现的会话模型、API 草图、状态机与实现顺序。

  • technical/voice-co-creation-phase-a-migration-api-draft.md 语音共创 Phase A 迁移与 API 草案。用于把 voice_sessions 数据迁移、Pydantic schema、路由签名和实现落点细化到可直接开工的程度。

维护规则

  • 新 PRD 放到 docs/product/
  • 新执行计划放到 docs/planning/
  • 新技术说明放到 docs/technical/
  • 一次性记录、过期交接、旧原型、未验证部署实验不再放进主仓库
  • 如果某份文档不能帮助“演示产品、解释决策、指导下一步编码”,优先删除而不是继续堆叠