diff --git a/AGENTS.md b/AGENTS.md index 1ce82b2..5322bb2 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -76,6 +76,20 @@ - 结论必须区分已实现、已验证、未验证和后续事项，并给出命令或其他可检查证据。 - 未经明确要求，不执行提交、推送、合并、变基、删分支或其他扩大 Git 状态影响的操作。 +## 文档新鲜度 + +- 每次任务完成前必须执行一次文档新鲜度检查，根据实际变更核对权威文档索引、规则、 + 设计、任务状态、运行手册、README、接口、数据库和测试资料；不得只检查代码与测试。 +- 当前任务改变需求范围、接口契约、架构或数据边界、运行方式、验收门禁、已完成状态或 + 待办结论时，相关且属于当前授权范围的文档必须在同一任务中同步更新后才能宣称完成。 +- 进度和待办文档必须直接更新已失效的阶段、状态与结论；不得只在旧结论后追加说明， + 造成同一文件同时存在互相冲突的“当前状态”。历史事实需要保留时必须明确标记日期和 + 历史属性。 +- 如果应更新的文档位于任务未授权的仓库、存在用户未提交修改，或需要先建立新的权威 + 契约版本，停止对该文档的写入，报告精确缺口并取得确认；不得以越权修改或静默跳过 + 维持表面上的文档一致。 +- 任务结论必须说明本次检查过哪些相关文档、实际更新了什么，以及哪些文档因何未更新。 + ## 本地中间件环境 本项目本地联调所需的 MySQL、Redis、Nacos 等中间件由独立仓库 diff --git a/docs/tasks/2026-07-26-code-review-followups.md b/docs/tasks/2026-07-26-code-review-followups.md index 734bf6f..19205de 100644 --- a/docs/tasks/2026-07-26-code-review-followups.md +++ b/docs/tasks/2026-07-26-code-review-followups.md @@ -9,6 +9,15 @@ 本文最初登记其余问题；已完成项按后续实现日期补充状态，未标记完成的条目仍是待办。 +## 2026-08-09 文档治理结论 + +- `TODO-BIZ-001`、`TODO-BIZ-002`、`TODO-P1-001` 和 `TODO-P1-002` 均已完成，保留 + 下文作为历史问题与验收依据，不再视为当前待办。 +- `TODO-P1-003` 仍是未完成的独立技术债；当前 M3 后端收口任务明确不处理 Flyway + 兼容治理，不得把现有 MySQL 8.4 迁移成功误写成该兼容问题已经消失。 +- `TODO-DOC-001` 已由 2026-08-04 定稿的 PRD V0.15.9、架构 V0.3.22、接口 V0.2.5、 + 数据库模型 V0.3.8 及定稿索引完成同步。 + ## 2026-07-29 本轮完成事实 - Wish M1.2 已完成创建、分页与详情、更新、购买转 Item、放弃、重新考虑、删除及 @@ -145,6 +154,11 @@ Snowflake ID 转成 JavaScript number。 ### TODO-P1-003：Flyway 与 MySQL 8.4 兼容基线漂移 +**状态（2026-08-09）** + +未完成，保留为独立 P1 技术债。当前 M3 后端收口任务按用户要求明确排除 Flyway +兼容治理；迁移测试继续执行并如实保留兼容警告，不在本任务中升级或覆盖版本。 + **现状** 当前依赖解析为 Flyway 11.7.2。MySQL 8.4 Testcontainers 迁移日志提示该版本只验证到 @@ -165,7 +179,13 @@ MySQL 8.1，MySQL 8.4 支持未经测试。 ### TODO-DOC-001：同步账号密码登录权威基线 -**现状** +**状态（2026-08-09）** + +已完成。现行 PRD V0.15.9 已冻结密码登录适用端和统一 Bearer 登录态；架构 V0.3.22、 +接口 V0.2.5、数据库模型 V0.3.8 与定稿索引已经同步账号密码登录、凭据边界、错误语义 +及 Auth V2 迁移事实。下述“现状”仅保留为 2026-07-26 的历史记录。 + +**历史现状（2026-07-26）** 账号密码登录是用户明确要求的功能，代码、V2 凭据表和本地账号初始化已经实现，但 上级 PRD、接口终稿和数据库定稿索引仍只登记微信登录及 V1 Auth 迁移。 diff --git a/rules/00-project-context.md b/rules/00-project-context.md index 19c2aa7..b8f4aaf 100644 --- a/rules/00-project-context.md +++ b/rules/00-project-context.md @@ -2,9 +2,14 @@ ## 当前阶段 -WorthIt Server 是《值不值》小程序的后端工程。当前按 Phase 0 和 M1 范围逐步搭建，先建立可靠的工程与契约基线，再实现最小业务闭环。 - -- 不因目录、接口或扩展点已在终稿中出现，就提前实现 M2、M3。 +WorthIt Server 是《值不值》小程序的后端工程。Phase 0、M1/M2 后端闭环、M3 Tracking +完整恢复和 M3 基础数据导出已经完成；当前处于其余 M3 公开试用准备能力的契约核对与 +增量实施阶段。 + +- 账号注销、导入和备份恢复尚未实现；不得仅凭目录、标题或产品概述自行补全接口、 + 状态、表结构、迁移与验收语义。 +- 公开试用采用的受支持 Spring Boot、Spring Cloud 和 Spring Cloud Alibaba 版本线尚未 + 决策；版本迁移必须独立授权并重新执行 Phase 0。 - 不为“以后可能使用”创建空模块、抽象层、Client 或基础设施。 - 任务未授权业务代码时，不从架构文档自行推导并追加实现范围。 @@ -21,7 +26,7 @@ WorthIt Server 是《值不值》小程序的后端工程。当前按 Phase 0 | 接口契约 | HTTP 路径、请求响应字段、错误码、请求头和内部 Client | | 数据库 | 表、字段、索引、约束和 Flyway 迁移顺序 | | 技术测试 | Phase 0、P0/P1 技术门禁和合码条件 | -| 产品验收 | M1 验收用例、金标数据和需求追溯 | +| 产品验收 | M1/M2、M3 完整恢复与基础数据导出验收、金标数据和需求追溯 | 不得把某一领域文档用于覆盖另一领域的权威结论。修改一个基线时，必须检查其他基线中的版本引用、契约和追溯关系。 @@ -62,5 +67,5 @@ WorthIt Server 是《值不值》小程序的后端工程。当前按 Phase 0 - 上级文档索引或当前终稿不可读取； - 终稿之间存在无法按权威领域消解的冲突； - 需求需要新增终稿未定义的字段、状态、错误码、接口、表或模块； -- 任务从 Phase 0/M1 扩大到 M2/M3 或公开试用版本迁移； +- 任务需要实施现行终稿尚未冻结契约的 M3 能力，或扩大到公开试用版本迁移； - 需要修改任务范围外的上级文档、前端仓库或环境配置。