# 治理体系落地（ADS Retrofit）

- **日期**：2026-08-19
- **关联**：ROADMAP M0
- **会话上下文**：工作区两个参考模板（后端 abacus.springboot.example、前端 abacus-static-framework）此前无 git、无 docs/ 文档中心、无 .project.agents 治理。

## 做了什么

- 工作区根 `D:\workBuddySpace\member` 建单一 git 仓库 + `.gitignore`。
- 创建 `docs/` 文档中心（单源化）：`README.md`、`architecture.md`、`coding-standards.md`（★前后端开发约束规范）、`agent-guide.md`。
- 本仓库落地 `.project.agents/`：CLAUDE.md / AGENTS.md / SELF_CONSTRAINTS.md / VIBECODING_GUIDE.md / settings.json / log/README.md + `docs/context/{PRD,ARCHITECTURE,ROADMAP,CONVENTIONS}.md`（无 UIUX，include_uiux=false），全部填充无残留 token。
- 分层以示例模块实际结构为准（api/controller/dao/esb/pi/impl/repository/wsi/config/util/vo）；`util`、`vo` 冻结（可引不可增）。
- 共享内容以指针引用 `../../../../docs/`，未复制正文；`doc/升级日志.md` 追加 1.0.2(2026-08-19) 治理记录。
- 分析过程使用 CodeGraph MCP 索引本仓库（82 文件）；符号级上下文工具受限，降级为关键文件定向读取。

## 提交

- 见工作区根 git 提交（docs/ 文档中心、前端治理、后端治理三个原子提交）。

## 状态变更

- ARCHITECTURE：本仓库 ARCHITECTURE.md 已按实际分层编写；不变量 I1~I4（主键 DaoIdGenerator / SQL 参数化 / 依赖单向 / Controller 不拼响应体）。
- PRD：已填充（统一响应体/分层模型/多库/动静分离四核心）。
- 测试：无代码改动，未触发。

## 下一步

- 按 ROADMAP M1 用第一个业务模块（界面→代码）验证模板可复制性。
- 待澄清项见 PRD §12（包前缀 / 是否引入后端单测 / util、vo 冻结）。
- 已知负债：`springdoc-openapi-maven-plugin` apiDocsUrl 硬编码 8080（ARCHITECTURE §8）。
