fix: 完成 doco src layout 重构,文件移至 src/doco/ 子目录
This commit is contained in:
simonkoson
@@ -0,0 +1,50 @@
|
||||
# 看板升级子项目 — 入口
|
||||
|
||||
> 这是 TPS 主 project 拆出来的子项目,聚焦"看板分析升级"。
|
||||
> 立项时间:2026-06-12
|
||||
> 顾问:Claude Opus 4.7 ｜ 制片人:刘通
|
||||
|
||||
---
|
||||
|
||||
## 开局必读(顺序)
|
||||
|
||||
1. `看板升级子项目_Brief.md` — 主项目签发的"交接宪法"(红线、技术栈、出入口接口)。**不在子项目内修改。**
|
||||
2. `续接快照_看板分析升级_设计讨论_v4.md` — 最新决策史(往前可回溯 v3 / v1)
|
||||
3. 上面两份读完,就有完整上下文了
|
||||
|
||||
---
|
||||
|
||||
## 已有资产
|
||||
|
||||
**决策史**:
|
||||
- 续接快照 v1 / v3 / v4 — 整个看板升级讨论的完整记录
|
||||
|
||||
**数据基础**:
|
||||
- `军事科技栏目收视诊断分析_v2.xlsx` — 双引擎模型源数据(主项目也留一份)
|
||||
- 11 份节目文稿 `.docx` — AI 打标基准集源稿(主项目也留一份)
|
||||
|
||||
**UI 参考**:
|
||||
- `dashiboard首页原版.jpg` — 首屏改造起点(主项目也留一份)
|
||||
- `dashiboard首页_拷贝.jpg` — 制片人批注稿
|
||||
- `色调字体倒角.webp` — 整体视觉资产(主项目也留一份)
|
||||
- `简洁风_清晰.jpg` — DataEase 风格参考
|
||||
|
||||
**协作纪律**:
|
||||
- `Claude协作原则.md` — 与主项目同源,沿用
|
||||
|
||||
**沙盒**:
|
||||
- `ai-labeling/` 工作区(物理上仍在 `E:\tps-dashboard\ai-labeling\`)
|
||||
- Prompt 2 v0.2 已锁,MiniMax M3 选定,ground-truth v0.2.1 锁定
|
||||
|
||||
---
|
||||
|
||||
## 子项目自由度
|
||||
|
||||
读完 Brief 你会注意到 §八"未决项"——那是子项目可自由发挥的部分。
|
||||
Brief 里没明确禁止、没在续接快照里拍板的事,都是讨论空间。
|
||||
|
||||
---
|
||||
|
||||
## 新 chat 开局第一句
|
||||
|
||||
> "续接 TPS 看板分析升级子项目。先读主 Brief 和续接快照 v4。本 project 是设计+PRD 产出,不动主 project 的 backend 代码。当前推进到 [具体任务]。"
|
||||
@@ -0,0 +1,143 @@
|
||||
# 看板升级子项目 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 发生
|
||||
@@ -0,0 +1,95 @@
|
||||
# 迁移清单 — 主 project 操作指南
|
||||
|
||||
> 用途:看板升级子项目立项时,主 project 这边的文件操作清单
|
||||
> 操作完即可丢弃
|
||||
> 制定时间:2026-06-12
|
||||
|
||||
---
|
||||
|
||||
## 资产分两类处理
|
||||
|
||||
### 🔵 子项目独有(主 project 这边删)
|
||||
|
||||
纯决策记录性质,主 project 不再需要:
|
||||
|
||||
1. `续接快照_看板分析升级_设计讨论.md`(v1)
|
||||
2. `续接快照_看板分析升级_设计讨论_v3.md`
|
||||
3. `续接快照_看板分析升级_设计讨论_v4.md`
|
||||
4. `dashiboard首页_拷贝.jpg`(批注稿)
|
||||
5. `简洁风_清晰.jpg`(参考图)
|
||||
|
||||
### 🟢 两边都留(各保留一份)
|
||||
|
||||
资产类性质,主 project 将来也可能用得到:
|
||||
|
||||
1. `军事科技栏目收视诊断分析_v2.xlsx` — 数据基础
|
||||
2. 11 份节目文稿 `.docx`(硅基大脑、潜艇仿生 等) — 节目原始资料
|
||||
3. `dashiboard首页原版.jpg` — 主 project 实施 React 时要看
|
||||
4. `色调字体倒角.webp` — 整体视觉资产
|
||||
|
||||
---
|
||||
|
||||
## 主 project 这边的其他动作
|
||||
|
||||
### 新增
|
||||
|
||||
- 上传 `寄存条_看板升级已外迁.md`
|
||||
|
||||
### 更新
|
||||
|
||||
- `backlog_md_TPS_工作台待办池_不丢视野_非排期_.md` 顶部加一段:
|
||||
|
||||
```markdown
|
||||
> ⚠️ 更新(2026-06-12):看板分析升级相关待办(原 F1-F8)已整体迁移到
|
||||
> **TPS 看板分析升级子项目**。主 project 这边不再维护这部分待办。
|
||||
> 子项目状态见 `寄存条_看板升级已外迁.md`。
|
||||
```
|
||||
|
||||
### 保留(不动)
|
||||
|
||||
主干文档(README、Claude协作原则、phase 日志、doco 系列、git_workflow、_clinerules、_gitignore、001_init.sql、dev_plan、project_plan、Phase 3 续接快照系列)全部保留。
|
||||
|
||||
---
|
||||
|
||||
## 操作步骤
|
||||
|
||||
**Step 1 ─ 建子项目**
|
||||
1. 新建 Claude project,名为 `TPS看板分析升级`
|
||||
2. 上传 4 份新文件:`INDEX.md` + `看板升级子项目_Brief.md` + 拷贝一份 `Claude协作原则.md`
|
||||
3. 上传 🔵 5 份子项目独有的文件
|
||||
4. 上传 🟢 14 份资产文件(主 project 也保留同名副本)
|
||||
|
||||
**Step 2 ─ 清主 project + 寄存**
|
||||
5. 删除 🔵 5 份文件
|
||||
6. 上传 `寄存条_看板升级已外迁.md`
|
||||
7. 更新 `backlog` 顶部标注
|
||||
|
||||
**Step 3 ─ 验证**
|
||||
8. 进主 project 新 chat:"读寄存条" → 看 Claude 是否懂"这部分外迁了,不在我这里讨论"
|
||||
9. 进子项目新 chat:按 INDEX 开局口径 → 看 Claude 是否能正确进入顾问角色
|
||||
|
||||
---
|
||||
|
||||
## 操作后的拓扑
|
||||
|
||||
```
|
||||
TPS 主 project TPS 看板升级子项目
|
||||
───────────────────── ─────────────────────
|
||||
├─ 主干文档(README/协作原则/phase 等) ├─ INDEX.md ★
|
||||
├─ doco/migration/git/init/dev/plan ├─ 看板升级子项目_Brief.md ★
|
||||
├─ Phase 3 续接快照系列 ├─ Claude协作原则.md(拷贝)
|
||||
├─ backlog(顶部加标注) ├─ 续接快照 v1/v3/v4
|
||||
├─ 寄存条_看板升级已外迁.md ★ ├─ xlsx + 11 份 docx(副本)
|
||||
├─ xlsx + 11 份 docx(副本) ├─ dashboard 首页原版(副本)
|
||||
├─ dashboard 首页原版(副本) ├─ 色调字体倒角(副本)
|
||||
└─ 色调字体倒角(副本) ├─ dashboard 首页_拷贝.jpg
|
||||
└─ 简洁风_清晰.jpg
|
||||
```
|
||||
|
||||
★ = 新增
|
||||
|
||||
---
|
||||
|
||||
## 拿不准的就先不动
|
||||
|
||||
任何一份文件去留拿不准的,**先保留**。文件保留比误删容易处理。
|
||||
Reference in New Issue
Block a user