项目文档索引

正式契约

正式契约保留在项目根目录，便于前后端开发、Codex执行会话和集成验收统一加载：

项目计划

历史提示词

以下材料用于需求追溯，不参与应用运行：

演示与汇报资料

assets/demo-20260728/：角色页面截图及项目计划文档
../deliverables/：本地生成的部署包和演示压缩包

维护规则

正式契约保持在根目录，修改业务语义时先升级契约版本。
阶段计划和进展报告放入 docs/planning/。
历史会话提示词统一放入 docs/prompts/。
截图和汇报素材放入 docs/assets/。
自动化测试保留在前后端各自的测试目录。
缓存、日志、构建产物、运行存储和部署包不提交Git。