simonkoson
4.7 KiB
4.7 KiB
项目协作主控文件 (episode-intake/CLAUDE.md)
🔖 状态栏（每次结束 session 前必须更新这三行）
- 最后更新：Claude Fable（顾问）｜ 2026-07-07
- 当前状态一句话：已立项，PRD v1.0 完成（含制片人三项拍板），未开发。 等制片人排期后按 PRD §8 四刀实施。
- 下一个动手的人从这里开始：读本文件 +
PRD_期次一条龙录入_v1.md全文。开发时严格按 PRD §8 分四刀，第一刀 Cline 指令已备好（见下方「⏩ 交接备注」）。
1. 子项目概览
- 项目名：期次一条龙录入（episode-intake）— 收视分析看板的"持续运行入口"
- 目标：把每期节目的五件事（收视录入 → 文稿入库 → AI 打标+摘要卡 → 制片人审核 → 进看板）收进责编录入页面，做成每期一张任务清单，让看板从"一次性导入的静态报告"变成"每周自动生长的持续诊断"。
- 落点页面：责编录入（
frontend/src/pages/EditorDesk/EditorDesk.jsx） - 完整方案：见同目录
PRD_期次一条龙录入_v1.md（页面设计/API 设计/schema 变更/验收标准/分刀计划齐全）。
与主干的关系（特殊说明）
本子项目实施时全部落在主干（EditorDesk 前端 + backend API/服务 + 005 迁移），不是独立部署的应用。外迁的是方案讨论和 PRD 迭代；动代码时走主干纪律：Cline Plan + Opus 审 + 制片人批准 Act，005 迁移前必须 pg_dump 备份。
2. 关键决策（制片人已拍板，2026-07-07）
- 文稿口径 = doco 融合A稿。doco 以播出后唱词字幕 OCR 为最标准依据；CCA 是播出前生产工具，审片/播出后还会改，不算最终文稿。doco 由此转入常态运行：每期播出后跑一遍 doco 产融合A稿，作为文稿环节的固定上游。
- doco 22 期旧稿导入知识库时回联期次（期次号/播出日期在文件名上，可解析匹配），挂 PRD 第二刀。
- 责编可触发「开始 AI 处理」（系统日常维护以责编为主）。
设计要点（PRD 核心结论，防跨 session 丢失）
- 任务清单模式，不是强制向导：五环节各自独立完成，期次表格加 4 个状态点（收视/文稿/AI处理/已审核），全绿 = 进看板全部模块。
- 状态不单独存列，全部从现有字段推导（audience_share / transcript_item_id / program_format+content_digest / ai_label_confidence）。
- 审核权仅制片人：AI 打标落库为 draft；看板象限图等标签类模块只用 reviewed 期次——设计哲学红线（编导绝不见 AI 草稿值）的代码落地。
- 只加一列 schema：005 迁移
episodes.transcript_item_id（软引用知识库条目，ON DELETE SET NULL，禁级联删）。存量 25 期ai_label_confidence回填 'reviewed'（源自制片人审定的 GT v0.6.0）。 - 全面复用：Prompt 1-4 留在
ai-labeling/prompts/后端只读；打标调用逻辑移植自ai-labeling/scripts/；文稿入库复用 Phase 3 知识库链路；后台任务用 BackgroundTasks+内存表（不引 celery）。
3. 待办（按 PRD §8 四刀）
- 第一刀（纯前端）：流水线状态列 + 抽屉骨架 + 区块一（复用现有表单）
- 第二刀（后端）：005 迁移（先 pg_dump）+ 文稿上传入库关联 + doco 22 期批量导入回联
- 第三刀：AI 处理服务 + 后台任务 + 进度轮询
- 第四刀：审核表单 + 权限 + 看板 reviewed 过滤
- 每刀独立验收（PRD §7 七条验收标准，制片人真实点页面逐条验）
4. 已完成（只追加，最新在上）
- [2026-07-07 ｜ Claude Fable] 立项：PRD v1.0 完成（含制片人三项拍板写入 §9）、子项目文件夹建立、主项目寄存条与 CLAUDE.md 登记。
5. ⏩ 交接备注
- 开发未启动，等制片人排期。启动时从 PRD §8 第一刀开始。
- 第一刀 Cline 指令已在 2026-07-07 主项目对话中封装好（Plan 模式：状态列+抽屉骨架+区块一+Response schema 补字段，不动 Model/不迁移）。若找不到原文，按 PRD §8 第一刀范围重新封装即可。
- 依赖提醒：第三刀需
backend/.env加MIMO_API_KEY；后端确认 python-docx 依赖。 - 关联子项目：doco（融合A稿上游，常态运行）、ai-labeling（Prompt 1-4 资产所在地，继续在那边迭代）。