Files
tps-dashboard/docs/cross_project/分钟收视回放/分钟收视回放_立项备忘_v1.md

120 lines
5.2 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 子项目立项备忘 — 分钟收视回放
> 文档类型:子项目立项备忘
> 子项目名称:分钟收视回放
> 立项日期:2026-06-11
> 子项目所在:秒级收视 project(Claude.ai 网页版的另一个 project
> 当前状态:**推进中**(设计已收敛,进入子板块内部实现阶段)
> 主 project 联系人:制片人刘通 + Claude Opus 4.7 顾问
---
## 一、文档用途
未来主 project 这边新开 chat 时(必然会发生 Claude 失忆),新 Claude 通过此文件快速恢复"分钟收视回放子项目"的上下文。**它不重复 v1 答复 md 里的细节,只留指针 + 关键决策摘要**。
---
## 二、立项缘由
制片人在另一个 project(秒级收视)里讨论分钟收视数据怎么进工作台、怎么呈现。那边 Claude 写了一份 PRD(需求规格 v1, 2026-06-10),向主 project 这边提了 6 个对接问题。
主 project 这边讨论两轮后采纳"以子项目模式独立推进",并把答复凝结成正式 md 带回子项目。**这次是项目里第一次完整使用"子项目模式"**——既是分钟收视回放本身的立项,也是这套跨 project 协作工作流的首次实操。
---
## 三、关键决策摘要(已采纳,不要重复讨论)
1. **视频不入工作台**:制片人多渠道自存(极空间/百度网盘/本地),工作台只接收截图
2. **本地切图工具**:子板块产出,py + exe + 使用说明,与工作台零耦合
3. **复用现有 episodes 表**:不新建"节目期次表",分钟数据表 `episode_minute_ratings` 外键挂到 `episodes.id`
4. **录入人字段用 `created_by INTEGER REFERENCES users(id)`**:不用 string,顺手落地 backlog B2 操作留痕
5. **后端不上 Celery/Redis**:异步任务在视频不入库后基本消失,必要时用 FastAPI BackgroundTasks
6. **图表库三选一**@ant-design/charts / ECharts / Recharts,不引第四个,最终由 Cline Plan 阶段定
7. **详情页 `/episodes/:id` 骨架由本子板块附带建起来**:早晚要做,借这次一起
8. **权限沿用 yearly_targets 口径**zhipianren + zebian 可写,biandao 只读
---
## 四、子板块要交付什么(五份产物)
子项目结束时,那边凝结以下交付包带回主 project:
1. 决策摘要 md
2. 接口约定 md(含 SQL DDL、API endpoint、UI 接入点、权限规则、存储路径规则)
3. 本地切图工具完整包(py 源码 + exe + 使用说明)
4. 未尽事项 backlog
5. 给主 project Claude 顾问的"接手提示词"
详见《分钟收视回放_主project答复_v1.md》第七节。
---
## 五、主 project 要做的事
**现在(推进期)**:不做事,不接收过程文档,等收交付包。
**收到交付包后**
1. 主 project 顾问 (Opus) 审一遍,看跟主项目红线有没有冲突
2. 无冲突 → 主 project workspace 里让 Cline 落代码
3. 有冲突 → 标出冲突点,回子项目修,循环
---
## 六、相关文档(指针)
**外部输入**(子项目发来的):
- 秒级 chat 的 PRD v1:《军事科技_分钟收视回放_子板块需求规格.md》(2026-06-10
- 已在主 project files 中(制片人 2026-06-11 上传)
**主 project 输出**(咱们这边给子项目的):
- 《分钟收视回放_主project答复_v1.md》(2026-06-11
- 建议归档位置:`docs/cross_project/分钟收视回放/分钟收视回放_主project答复_v1.md`
**配套文档**
- 《跨project协作提示单_v1.md》(2026-06-11,制片人随身保存)
- 不在主 project 仓库内,是制片人个人工作流手册
---
## 七、预计回归时间
未明确锁定。子项目那边的 Claude 表示"没有什么不清楚的了",已在内部推进。
**触发主 project 这边介入的信号**
- 子项目带交付包过来(正常路径)
- 子项目过程中遇到吃不准的事 → 单点咨询主 project 顾问(不要整份过程稿上传)
- 超过 4 周还没收敛 → 主动 ping 一下,看是不是要重新切分
---
## 八、给未来失忆接手 Claude 的提示
如果你是几周后接手主 project 的 Claude,看到这份备忘,请记住:
1. **分钟收视回放是一个独立推进的子项目**,主 project 不掺合其内部讨论
2. **复用 episodes 表,不要新建节目期次表**——这是已经定死的决策,不重新讨论
3. **改 schema 必须经 Opus 顾问审**,子项目交付包带 schema 修改建议时严守这条
4. **本地切图工具与工作台零耦合**,工作台 UI 里不要给它留接口
5. **视频不入工作台**——任何提议加视频上传接口的方案都已被否决
6. **审查交付包是必经环节**,发现子项目设计违反主项目红线(如角色枚举、收视颜色判定)时直接打回
---
## 九、版本演进
本文件未来如需更新(v2+):
- 子项目交付包接收后:更新"当前状态"为"已交付,整合中"
- Cline 实施完成后:更新"当前状态"为"已完成",加一节"实施回顾"
- 实施过程中如有重大决策变更:v2 顶部"主要变化"写明
---
*本立项备忘由主 project 顾问 (Claude Opus 4.7) 于 2026-06-11 制片人立项动作后随手生成。轻量、精简,未来失忆接手时由此恢复上下文。*