docs(GOV-001): 建立工程治理与追溯规范

2026-08-12 18:18:55 +08:00
parent 7cc2ba06a6
commit efdfb331bb
46 changed files with 1030 additions and 0 deletions
@@ -0,0 +1,22 @@
+# ADR-0001：采用单仓库、双项目、独立部署
+
+- 状态：已接受
+- 日期：2026-08-12
+
+## 背景
+
+市场概览功能会同时影响前端、API、规则、消息契约和部署配置，需要完整版本关联；API、Scheduler和Worker又必须能够独立运行。
+
+## 方案
+
+1. 前后端完全分仓：隔离强，但跨仓版本关联和整体回退复杂。
+2. 单仓库双项目：统一历史与图谱，同时独立构建部署。
+3. 单体应用：初期简单，但定时任务和请求链耦合。
+
+## 决定
+
+采用方案二。前端和后端拥有独立依赖、测试、构建及镜像，但共享 Git 历史、契约、文档和 GitNexus 图谱。
+
+## 代价
+
+需要维护根目录工作区和跨项目验证脚本；仓库增长后需控制索引与 CI 范围。
@@ -0,0 +1,16 @@
+# ADR-0002：采用 GitNexus 开发前后双门禁
+
+- 状态：已接受
+- 日期：2026-08-12
+
+## 背景
+
+仅保存代码 diff 无法解释变更影响的调用者、功能分区和执行流程，也无法回答当时为什么修改。
+
+## 决定
+
+每个功能开发前刷新 GitNexus、读取上下文并完成影响计划；开发后执行实际变更检测、重新索引并保存前后比较。`.gitnexus/` 为可重新生成缓存，不提交；可读报告进入功能档案。
+
+## 代价
+
+每次开发增加少量文档和索引时间，但换取影响可见、架构可读和历史决策可追溯。