历史设计使用说明
docs/system_a/、docs/system_b/、根目录旧架构文档和早期进度记录保留了项目演进过程,但不能直接代表当前实现。
1. 默认不上传全量历史文档
原因:
- 旧文档假定用户端是 uni-app,当前实际为 Vue 3 H5。
- 旧文档假定管理端采用 GeekerAdmin,当前实际是自研单页后台。
- 旧数据库、Provider、队列和视频能力与当前代码差异明显。
- 同一能力可能在系统 A/B 中重复定义,容易让 Work 得出相互冲突的结论。
2. 可按需查阅的历史资料
| 历史资料 | 适合回答 | 使用条件 |
|---|---|---|
docs/system_a/ |
小说、漫剧和早期平台业务设想 | 必须与当前状态文档对照 |
docs/system_b/ |
真人动态视频的早期需求与合并思路 | 不得推断已全部实现 |
CURRENT_ARCHITECTURE.md |
某阶段架构演进 | 先核对日期和源码 |
NOVEL_IP_SYSTEM_DESIGN.md |
小说/IP 资产设计来源 | 只采纳未过时的规则 |
CODEX_PROGRESS.md |
开发过程和阶段记录 | 不作为验收结果 |
AI_VIDEO_TEST_LESSONS.md |
视频生产经验 | 已复制版本化快照到同步包 |
3. 上传历史文档的格式
如 Work 需要某份旧文档,应在文件顶部增加外部说明或上传备注:
状态:历史参考
不代表当前实现
当前基线:WORK_SYNC_2026-07-15_V1
需要对照:PROJECT_STATUS_V1.md
讨论目的:<为什么需要这份旧文档>
不要直接修改原历史文件来伪装成当前设计;有价值的结论应提炼到新的 FEATURE、ADR 或当前领域文档。
4. 何时归档当前文档
当前领域文档升级版本后,旧版移入此区的对应子目录,并在新文档和 CHANGELOG 中说明替代关系。状态快照不移除,持续保留 V1、V2、V3。