# 总账项目手册

最后核对：2026-08-23。核对依据是当前 `main` 最新代码（`5f21527`）、数据库迁移、接口、测试和近期提交记录。

这是接手本项目的第一站。阅读顺序如下：

1. [项目需求](项目需求.md)：先知道系统要解决什么问题，以及哪些规则绝不能碰。
2. [最新进度](最新进度.md)：再确认哪些能力已经真实完成，哪些仍未完成。
3. [任务清单](任务清单.md)：最后挑选下一项工作，避免重复做已经完成的事。
4. 需要技术细节时，再查看 `decisions/` 中的技术决定和 `issues/` 中保留的历史任务规格。

## 维护规矩

- 每新增、开始、完成、取消一项任务，负责的智能体都要在同一次提交里更新 `最新进度.md` 和 `任务清单.md`。
- 新功能改变产品规则时，同时更新 `项目需求.md`；技术方案有变化时，补充 `decisions/` 的决定记录。
- 写进手册的“已完成”必须能在代码、测试或已合并提交中找到依据；只有计划、页面演示或口头讨论的内容，一律写为“未完成”。
- 不删除历史文档。旧内容与当前代码不一致时，在旧文件开头加“已过时，仅留档备查”提示，并在本目录写新版说明。

## 旧交接说明

`HANDOFF.md` 是 2026-08-06 的历史交接稿，已经不反映当前实现，保留仅作对照。当前事实以本手册三份正文为准。
