From 9acb9d380d2306edc68feb7bed713510c3f03fad Mon Sep 17 00:00:00 2001
From: simonkoson <28867558@qq.com>
Date: Wed, 27 May 2026 19:51:41 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E6=96=B0=E5=A2=9E=20claude=20=E5=8D=8F?=
 =?UTF-8?q?=E4=BD=9C=E5=8E=9F=E5=88=99=E6=96=87=E4=BB=B6,backlog=20?=
 =?UTF-8?q?=E5=BE=85=E5=8A=9E=E6=B1=A0=E5=85=A5=E5=BA=93?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 claude协作原则.md                             | 13 +++
 ...og_md_TPS_工作台待办池_不丢视野_非排期_.md | 88 +++++++++++++++++++
 2 files changed, 101 insertions(+)
 create mode 100644 claude协作原则.md
 create mode 100644 docs/backlog_md_TPS_工作台待办池_不丢视野_非排期_.md

diff --git a/claude协作原则.md b/claude协作原则.md
new file mode 100644
index 0000000..0eb6cf1
--- /dev/null
+++ b/claude协作原则.md
@@ -0,0 +1,13 @@
+**本文件是制片人刘通与 Claude(Opus 4.7 高级技术顾问)的协作原则,与项目宪法(.clinerules / project_plan.md / dev_plan.md / docs/git_workflow.md)并列。新对话接手时,请连同宪法一并阅读本文件。**
+
+---
+
+**Claude 与我交流、沟通、协作时需要注意的原则**
+
+1. 全程使用简体中文。
+
+2. 我不懂代码编程,给我的解释说明和理由要尽量简明扼要。不要堆叠大量技术语言,说人话。
+
+3. 请参阅宪法文件中你(Claude)的定位:写具体 Plan 是 Cline 的事,不要架空 Cline 的 Plan 模式。除非特别必要(Cline 反复修改都过不去的坎)可以上手,以及制片人明确指定你可以操刀的具体工作。
+
+4. 给 Cline 的指令要用代码块封装起来,方便复制。
diff --git a/docs/backlog_md_TPS_工作台待办池_不丢视野_非排期_.md b/docs/backlog_md_TPS_工作台待办池_不丢视野_非排期_.md
new file mode 100644
index 0000000..ffef357
--- /dev/null
+++ b/docs/backlog_md_TPS_工作台待办池_不丢视野_非排期_.md
@@ -0,0 +1,88 @@
+# backlog.md — TPS 工作台待办池（不丢视野，非排期）
+
+> 维护人：刘通 + 顾问 Opus
+> 用途：记录"暂不做但不能漏"的事项。区别于 phase 计划，这里是池子，
+>    每个 Phase 收尾时回看一遍，决定捞哪条进下个 Phase。
+
+---
+
+## A. 定位澄清（认知，非待办）
+
+- 本系统对外称"中台/工作台"，实质是**单栏目业务系统**（一条业务线、8 用户）。
+- 不套真中台那套（多租户/服务网格/配置中心/跨线统一权限）——对 8 人是纯负担。
+- 真正定位：把散在 Excel/Word/微信/个人电脑/师徒口传的工作流，收拢成
+  有沉淀、有权限、可检索的系统。核心价值 = 经验从"靠人"变"靠系统"。
+- 现有克制选择（不用 TS / 不用 Alembic / pgvector 不用独立向量库 /
+  Session 不用 JWT）方向正确，保持。
+
+---
+
+## B. 工作台核心能力缺口（按优先级）
+
+### B1. 选题状态流转【优先级：高】
+- 现状：episodes 存收视+元数据，但"提报→立项→排期→拍摄→制作→播出→复盘"
+  这条状态线是散的。
+- 建议：给 topics/episodes 加状态机字段，制片人一眼看到每个选题卡在哪环。
+- 与模块 F 甘特图区别：甘特是排期视角，这是业务状态视角，两回事。
+- 触发时机：Phase 4b（TPS 闭环时一并补最自然）。
+
+### B2. 操作留痕 / 审计【优先级：高，成本极低，建议早埋】
+- 现状：谁改收视、谁删选题、谁换题图，全靠信任，无记录。
+- 建议：核心业务表（episodes/topics/yearly_targets）加
+  created_by / updated_by / updated_at 字段即可，不必做复杂日志系统。
+- 触发时机：越早埋越好，建议 Phase 3 起手时顺带加（改表成本最低）。
+
+### B3. 数据导出 / 备份【优先级：中】
+- 现状：Phase 2 做了 Excel 导入，导出是它的镜像，迟早要。
+- 收视、选题是栏目资产，将来要能导出 Excel、能定期备份。
+- 触发时机：Phase 5 上线前后。
+
+### B4. 通知 / 待办提醒【优先级：低】
+- "选题被审了""该交稿了"这类。小团队可能微信/Mattermost 群就解决了。
+
+- 若 B 见下方与 Mattermost 打通，可借 IM 发通知，不必自建。
+
+- 触发时机：看实际使用反馈再定，可能不做。
+
+  ### B5.关联【优先级：低】
+
+  题图"自动算近5期最高份额提示"本期做的是静态文案占位,  自动计算挪二期(原计划)。
+
+---
+
+## C. 跨系统整合（与现有其他系统合服务器、打通）
+
+### C1. 蓝皓配音 TTS 2.0 合服务器【待商议】
+- 背景：TTS 2.0 现为独立网站/服务器，单租服务器费钱。
+- 设想：与 TPS 中台挪到同一台服务器，省一份租金。
+- 待办：制片人把 TTS 2.0 源代码给 Opus → 一起评估
+  ①技术栈是否冲突（端口/依赖/数据库）②Nginx 反代能否共存
+  ③资源够不够（4核8G 轻量服务器跑两套+PG+pgvector 要算内存账）。
+- 注：dev_plan 部署章已写"Nginx 反代整合 TPS / 蓝皓 TTS / MMIM"，本条是落实。
+- 触发时机：Phase 5 部署规划时。
+
+### C2. Mattermost(内部 IM) 打通【待商议】
+- 背景：团队内部 IM 用 Mattermost，部署在与 TTS 2.0 同一服务器。
+- 设想：TPS 的通知/待办（见 B4）可推到 Mattermost，不必自建通知系统。
+- 待办：评估 Mattermost incoming webhook 接入成本（通常很低）。
+- 触发时机：B4 真要做时一并考虑。
+
+---
+
+## D. 已知技术隐患（从 phase log 汇集，不漏）
+
+- backend/ 补 venv（全局依赖搬进去）。
+- 隐患 A：ImportError 与 Python 内置同名（低优）。
+- 隐患 B：ExcelService 返回 Pydantic 化（低优）。
+- Phase 5 部署安全：SECRET_KEY 换真随机、same_site=strict + https_only=True、
+  上 SSL、关 /docs。
+- Phase 5 上线前数据清理：清测试数据（期次 8888/8889、年度目标 2027/2028
+  占位等），录真数据。
+- logo 路径用 /src/assets/...(Vite开发模式),生产打包会失效,Phase5部署改。 - reset_password.py 能改任意用户密码,Phase5部署前不能暴露在生产环境。 - 柱图设计为取最近12期,当前真实数据仅7期故显7根;Phase5录真数据后自动补齐,届时确认满12根正常。 - 完成率用 new Date().getFullYear() 取当前年:每年初需录入当年 yearly_targets,  否则跨年后两项完成率显"—"。(运营提醒,非bug)
+
+---
+
+## E. 明确不做（防止被"中台"概念诱导加功能）
+
+- 多租户、服务网格、配置中心、跨业务线统一权限平台 —— 8 人单栏目纯负担。
+- 任何让 AI 替编导拍板的功能 —— 违背"AI 给方向不给答案"。
\ No newline at end of file