app/迭代/README.md

LineUp App 迭代文档

每个迭代使用一个独立目录，目录名固定为“迭代编号.简短名称”。目录内至少保留该迭代的主定义文档； 每进行一次设计、架构或实现评审，都必须新增一份独立评审记录，不覆盖之前的记录。

迭代/
├── plan.md                         # 当前阶段之后的总体路线和排期原则
├── 00.base/
│   └── 00.base.md
├── 01.kernel/
│   └── 01.kernel.md
└── 03.sdk_and_coreapp/
    ├── 03.sdk_and_coreapp.md       # 本迭代的权威目标、范围、契约、步骤和验收
    ├── 01.design_review.md         # 第 1 次评审记录
    ├── 02.design_review.md         # 第 2 次评审记录
    └── 03.design_review.md         # 第 3 次评审记录

约定如下：

1. 主定义文档命名为 <迭代目录名>.md，是当前实施依据；
2. 评审记录按发生顺序编号，命名为 <两位序号>.design_review.md；
3. 每份评审记录必须在元信息之后、评审正文之前维护“问题清单（Outline）”，格式参考 01.design_review.md：列出状态、编号、问题和当前结论/下一步；
4. 评审记录必须写明评审日期、编号、对象、方式和总体结论。新问题先在 Outline 中登记；问题确认后先 更新 Outline 状态，再回填主定义文档、验收项和评审正文；
5. 已确认的结论需要回填主定义文档和验收项；评审记录保留原始意见，用于追溯，不能替代主定义文档；
6. 迭代完成后的实现验收、发布复盘等文档也保留在对应目录内，并使用清晰的递增编号。

后续总计划

当前阶段之后的路线、迭代拆分、范围边界和完成标准见 plan.md。该文件记录已确认的整体方向； 每个具体迭代开始后，仍需在自己的目录中创建主定义文档和独立评审记录。

评审优先级与遗留问题

评审问题使用 P0～P5 标示处理优先级。优先级表达的是“最晚何时必须解决”，而不是问题描述的 修辞强弱。

级别	含义	当前迭代的处理规则
P0	根本性阻塞：安全边界、数据正确性或总体架构不能成立。	立即处理；在解决前不得进入相关实现。
P1	关键规则未定：不解决会让不同实现互相冲突或明显返工。	在开始相关模块实现前处理。
P2	交付或验收缺口：核心方向正确，但缺失会使恢复、安全验证或验收不完整。	必须在本迭代验收前处理。
P3	局部行为、一致性或质量问题：存在安全默认行为，但相关模块完成前仍需收敛。	必须在本迭代结束前处理。
P4	优化、可读性或维护性建议。	可以登记为遗留问题，不阻塞当前迭代。
P5	观察记录或未来机会，当前没有足够的产品需求或证据进入排期。	可以登记为遗留问题，不纳入当前迭代。

因此，P0～P3 必须在当前迭代处理完毕，P4～P5 可以作为遗留问题延期处理。

延期不是删除：评审中出现 P4/P5 时，必须在该评审文件的 Outline 或“遗留问题”段落中保留编号、问题、 延期原因和建议重新评估的阶段/条件。只有在对应迭代主定义文档或新的评审记录中明确重新纳入后，才将 其提升为当前迭代的 P0～P3 问题。