chore(frontend): 落地 ADS 治理体系并收录前端底座基线代码

2026-08-19 14:39:02 +08:00
parent 775e075495
commit 1f84456421
177 changed files with 18574 additions and 0 deletions
@@ -0,0 +1,28 @@
+# 治理体系落地（ADS Retrofit）
+
+- **日期**：2026-08-19
+- **关联**：ROADMAP M0
+- **会话上下文**：工作区两个参考模板（前端 abacus-static-framework、后端 abacus.springboot.example）此前无 git、无 docs/ 文档中心、无 .project.agents 治理。
+
+## 做了什么
+
+- 工作区根 `D:\workBuddySpace\member` 建单一 git 仓库 + `.gitignore`（node_modules/target/dist/.workbuddy 等）。
+- 创建 `docs/` 文档中心（单源化）：`README.md`（索引+映射表）、`architecture.md`（动静分离架构）、`coding-standards.md`（★前后端开发约束规范，约 4.5k 字）、`agent-guide.md`（AI 生成代码工作流与提示词协议）。
+- 本仓库落地 `.project.agents/`：CLAUDE.md / AGENTS.md / SELF_CONSTRAINTS.md / VIBECODING_GUIDE.md / settings.json / log/README.md + `docs/context/{PRD,ARCHITECTURE,ROADMAP,CONVENTIONS,UIUX}.md`，全部填充无残留 token。
+- 共享内容以指针引用 `../../../../docs/`（如 CONVENTIONS 引用 `coding-standards.md`），未复制正文。
+- 分析过程使用 CodeGraph MCP 索引后端（82 文件）与前端 subsystem（7 文件），符号级上下文工具受限，降级为关键文件定向读取（request.ts / vite.config / yml / pom / assembly / JcBillController 等）。
+
+## 提交
+
+- 见工作区根 git 提交（docs/ 文档中心、前端治理、后端治理三个原子提交）。
+
+## 状态变更
+
+- ARCHITECTURE：本仓库 ARCHITECTURE.md 已按实际结构（framework 只读 + subsystem 业务）编写；不变量 I1~I3。
+- PRD / UIUX：PRD、UIUX 均已填充；UIUX 面向业务子系统页面模式。
+- 测试：无代码改动，未触发。
+
+## 下一步
+
+- 按 ROADMAP M1 用第一个业务子系统（界面→代码）验证模板可复制性。
+- 待澄清项见 PRD §12（新业务复制起步方式 / 是否引入前端单测）。
@@ -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 / UIUX：是否触发回归？
+- 测试：跑了什么，结果
+
+## 下一步
+- 接下来要做的第一件事（具体到任务名）
+- 已知阻塞 / 待澄清项
+```
+
+## 何时写
+
+- 完成一个 ROADMAP milestone
+- 完成一个独立可验收的子任务
+- 完成非平凡的重构 / bug 修复
+- 会话即将结束（兜底）
+
+## 何时不写
+
+- 还没完成一个"可独立验收"的部分（别凑数）
+- 纯文档微调（commit 自身已够说明）
+- 实验性探索且最终 revert（commit 即可）