chore(backend): 落地 ADS 治理体系、升级日志并收录后端模板基线代码

2026-08-19 14:39:18 +08:00
parent 1f84456421
commit 54c21876e4
113 changed files with 19953 additions and 0 deletions
@@ -0,0 +1,30 @@
+# 治理体系落地（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）。
@@ -0,0 +1,54 @@
+# 实施日志（execution log）
+
+本目录沉淀"做了什么 + 哪些提交 + 下一步"，供下一个会话接手用。
+规则与时机见 `../VIBECODING_GUIDE.md §5`；硬约束见 `../SELF_CONSTRAINTS.md §B6`。
+
+---
+
+## 文件命名
+
+`YYYY-MM-DD-<slug>.md`
+
+- `<slug>` = 简短动词 + 范围，kebab-case
+- 同日多份按写作顺序加 `-1`、`-2` 后缀
+
+## 模板
+
+```markdown
+# <一句话标题：完成了什么>
+
+- **日期**：YYYY-MM-DD
+- **关联**：ROADMAP M<N> / 子任务名 / 关联文档
+- **会话上下文**：（可选）本会话从哪开始接手的
+
+## 做了什么
+- bullet 1
+- bullet 2
+
+## 提交
+- `<short hash>` <commit subject>
+
+（若本段未提交：明确写"未提交，工作树状态：…"并说明原因）
+
+## 状态变更
+- ARCHITECTURE：是否动过？动了哪一节？
+- PRD：是否触发回归？
+- 测试：跑了什么，结果
+
+## 下一步
+- 接下来要做的第一件事（具体到任务名）
+- 已知阻塞 / 待澄清项
+```
+
+## 何时写
+
+- 完成一个 ROADMAP milestone
+- 完成一个独立可验收的子任务
+- 完成非平凡的重构 / bug 修复
+- 会话即将结束（兜底）
+
+## 何时不写
+
+- 还没完成一个"可独立验收"的部分（别凑数）
+- 纯文档微调（commit 自身已够说明）
+- 实验性探索且最终 revert（commit 即可）