# 看板升级子项目 Brief

> 主项目 → 子项目的"交接宪法":红线、技术栈、出入口接口
> 起草日期:2026-06-12
> 状态:子项目立项时由主项目顾问(Opus)签发,子项目内部不修改

---

## 一、为什么做

**痛点**:制片人和编导团队拿到的"收视成绩单"只能看到结果(均值、走势、单期高低),
看不到结构性原因。每次复盘要靠人工拼诊断(21 期那次花了若干周),无法持续。

**升级目标**:把仪表盘从"看成绩"升级为"能分析"——
让"双引擎模型(题材热度 × 叙事结构)"这个一次性人工产出的分析框架,
变成一台**持续运转的诊断仪**。

---

## 二、做什么(功能边界,只列名)

| 模块 | 简述 |
|---|---|
| 三层信息架构 | 纯算 / 打标后 / AI 起草,分层呈现 |
| 双引擎象限图 | 招牌视觉,题材热度 × 叙事结构 |
| AI 打标流水线 | Prompt 1/2/3 + MiniMax M3 + ground-truth |
| 编导能力地图 | 反排名,正反馈 |
| 本期诊断小结 | AI 起草 + 制片人审改后发布 |
| 时间选择器 | 实时脉搏 vs 周期复盘,边界永远可调 |

**具体怎么做,子项目内部讨论,本 Brief 不预设方案。**

---

## 三、怎么用(目标流程)

- **每周**:制片人看"实时脉搏"——核心指标卡 + 近 9 期走势
- **每月**:制片人看"题材分析"——题材汇总,关注异动
- **每季**:制片人看"双引擎象限图 + 本期诊断小结"——周期复盘
- **新节目入库**:AI 打标草稿 → staging 表 → 制片人审 → 落库
- **编导维度**:制片人查能力地图,把强项做成全组可复用模板
- **离职编导**:历史保留,面向当下视图可筛掉

---

## 四、不做什么(红线)

子项目设计任何方案,**绝不**触碰以下:

- ❌ **不做深色大屏**(留给 2.0 数据大屏蓝本)
- ❌ **不做编导排名**(团队视角走能力地图)
- ❌ **AI 不自动盖章下结论**(永远是"AI 出草稿,人拍板")
- ❌ **不引入新图表库**(继续 ECharts / @ant-design/charts)
- ❌ **不引入主 project 没有的技术栈**
- ❌ **不动主 project 已有的 schema**(改字段必须走 §六交付协议)
- ❌ **不做"未审字段直接上看板"**(置信度三档必须可辨)
- ❌ **不写 / 不改 AI 打标 Prompt 由 Cline 完成**(Cline 是执行者不是作者)

---

## 五、技术栈约束(继承主 project)

子项目所有设计必须能落在以下栈上,不引入新依赖:

- **前端**:React 18 + Vite + AntD 5 + Zustand + ECharts / @ant-design/charts
- **后端**:FastAPI + SQLModel + PG 16 + pgvector
- **配色**:米色底 `#fbf9f1` + 深绿主色 `#6b8e6b`
- **三色色板**:红 `#c0584f` / 蓝 `#5b8db8` / 绿 `#7aa874`
- **基准线**:基础线 0.6448 / 摸高线 0.8989(2026)
- **AI 打标**:沙盒 `ai-labeling/`,生产模型 MiniMax M3,openai==1.55.0 锁版本
- **部署**:腾讯云 4 核 8G(性能上限,凡是吃不动的方案直接否决)

---

## 六、交付什么(出口接口)

子项目产出最终要回到主 project 实施,**交付物必须满足以下接口**:

### 6.1 Schema 变更类
- 子项目出:**字段定义文档**(命名 / 类型 / 枚举 / nullable / 约束 / 回滚方案)
- 主 project 实施:**Cline 切 Plan → Opus 审 → 制片人批准 Act → `pg_dump` 备份 → 跑迁移**
- 不接受:子项目自己改主 project schema 或 `backend/` 任何代码

### 6.2 前端实施类
- 子项目出:**设计 token JSON + HTML mock + 视觉规范文档**
- 主 project 实施:**Cline 按设计稿落 React 组件**
- 不接受:子项目自己写主 project 的 React 代码

### 6.3 AI 打标类
- 子项目在 `ai-labeling/` 沙盒自治,**沙盒内 Cline 可直接 Act**
- 子项目出:**Prompt 文件 + ground-truth.json + 模型选型结论**
- 主 project 实施:**episodes_staging 表 schema 落库 + 审稿 UI 落地**

### 6.4 回填类
- 子项目出:**回填脚本设计文档 + 23 期回填策略**
- 主 project 实施:**Cline 跑脚本 + 制片人审 staging**

### 6.5 通用约束
- 子项目**不主动 push** 文件到主 project,**所有交付物由制片人决定时机**
- 主 project 只接**稳定版**,子项目内部草稿不交付

---

## 七、入口接口(子项目要知道的主 project 现状)

- **Phase 0-3 已落地**:episodes / editors / 收视诊断基础数据,23 期 2026 年数据已入库
- **现有视觉语言**:米色 + 深绿,卡片圆角 12px,AntD 5 默认行高
- **现有 backlog**:主 project 这边的 backlog 已标注"看板升级条目已外迁"
- **现有沙盒**:`ai-labeling/` 工作区已搭建,Prompt 2 v0.2 已锁,MiniMax M3 已选定
- **现有 git**:Gitea 落库,关键 commit `38f3728`

---

## 八、未决项(归子项目自己拍板)

以下不在本 Brief 内预设,**由子项目和制片人讨论决定**:

- 横轴量化方法的具体公式
- AI 打标 Prompt 1 / Prompt 3 的具体写法
- 看板各屏幕的具体布局和交互
- 双引擎象限图的具体视觉细节
- 能力地图的具体可视化方案
- episodes 新字段的最终命名 / 类型 / 是否多对多关联表
- 置信度是单字段还是分字段
- 时间窗口取多大 / 小样本怎么兜底等具体口径

---

## 九、决策史指向(不重复内容)

子项目讨论前应该读的:
- `续接快照_看板分析升级_设计讨论.md`(v1,2026-06-09)
- `续接快照_看板分析升级_设计讨论_v3.md`(v3,2026-06-11 上午)
- `续接快照_看板分析升级_设计讨论_v4.md`(v4,2026-06-11 晚)
- `军事科技栏目收视诊断分析_v2.xlsx`(双引擎模型源数据)

---

## 十、本 Brief 自身的修订规则

- 本 Brief 不在子项目内修改
- 红线 / 技术栈如有变更,**主 project 这边发新版**,通过寄存条同步
- 子项目可在自己的 chat 里讨论"建议主 project 调整某条红线",但调整动作只能在主 project 发生
