simonkoson
71 lines
4.7 KiB
Markdown
71 lines
4.7 KiB
Markdown
# 项目协作主控文件 (episode-intake/CLAUDE.md)
|
||
|
||
<!--
|
||
期次一条龙录入子项目主控文件。
|
||
通用协作原则、主项目技术栈、角色定位、Git 红线等
|
||
已在上一级 tps-dashboard/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）
|
||
|
||
1. **文稿口径 = doco 融合A稿**。doco 以播出后唱词字幕 OCR 为最标准依据；CCA 是播出前生产工具，审片/播出后还会改，不算最终文稿。**doco 由此转入常态运行**：每期播出后跑一遍 doco 产融合A稿，作为文稿环节的固定上游。
|
||
2. **doco 22 期旧稿导入知识库时回联期次**（期次号/播出日期在文件名上，可解析匹配），挂 PRD 第二刀。
|
||
3. **责编可触发「开始 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 资产所在地，继续在那边迭代）。
|