Forráskód Böngészése

docs(kb): 新增 93-架构决策 骨架 作为重构收尾 ADR 沉淀点

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
tianyu.chu 2 hete
szülő
commit
04b4ea9c4d
3 módosított fájl, 15 hozzáadás és 0 törlés
  1. 1 0
      README.md
  2. 1 0
      kb/92-重构进度.md
  3. 13 0
      kb/93-架构决策.md

+ 1 - 0
README.md

@@ -98,6 +98,7 @@ PG/ES ──DataX(raw)──> RAW ──> ODS ──> DWD ──> DWS ──> TD
 |----|----|
 | [90-重构路线](kb/90-重构路线.md) | **重构决策**:P0-P3 聚簇、已完成结论、待启动方案 |
 | [92-重构进度](kb/92-重构进度.md) | **重构执行**:阶段 checklist + changelog |
+| [93-架构决策](kb/93-架构决策.md) | **ADR 沉淀**:重构收尾时 90/91/92 压缩留档(当前仍在重构,骨架) |
 
 ## 阅读建议
 

+ 1 - 0
kb/92-重构进度.md

@@ -190,3 +190,4 @@
 | 2026-04-22 | **kb/00 §1 目录树补齐子目录并去冗余注释;章节号去跳号**:(a) §1 补子目录 `bin/common/`、`conf/templates/{datax/{datasource,sync},spark/{ddl,sql}}/`、`conf/bak/{datax/{config,datasource},flume/config}/`、`dw_base/datax/{datasources,plugins/{reader,writer}}/`、`dw_base/io/{db,file,hdfs}/`、`dw_base/udf/{common,business}/`、`tests/unit/udf/`;conf 下"行为/开关类少改 vs 资源/调优类常改"等冗余注释去掉;bin/ 脚本逐行列出;(b) 用户调整大标题顺序后号码与位置不匹配,重排为连续 §1/§2/§3 执行链详解/§4 配置管理体系/§5 DataX 入口/§6 Spark 入口/§7 部署架构 | — |
 | 2026-04-23 | **kb/00 章节顺序再调**:执行链详解后移到入口说明之后(理由:先有入口才有调用链),最终顺序 §1 目录结构 / §2 模块关系图 / §3 配置管理体系(§3.1 配置分类)/ §4 DataX 入口 / §5 Spark 入口(§5.1 常用参数 / §5.2 Spark 参数优先级)/ §6 执行链详解 / §7 部署架构。kb/90 + kb/30 外部引用仅指向 §1 目录树,不受影响 | — |
 | 2026-04-23 | **kb/00 §2 模块关系图并入 §5 执行链路 + 新增 §6 基础模块骨架**:`模块关系图`(静态依赖拓扑)与 `执行链详解`(动态调用)在本项目线性链式结构下几乎 1:1,合并为 §5 **执行链路**(业界更通用表述);新增 §6 **基础模块** 骨架,后续介绍 `dw_base/` 除 `spark/` / `datax/` / `udf/` 外的其他模块。子节编号随父节上移:§3.1 配置分类 → §2.1;§5.1 常用参数 → §4.1;§5.2 Spark 参数优先级 → §4.2。最终 §1 目录结构 / §2 配置管理体系 / §3 DataX 入口 / §4 Spark 入口 / §5 执行链路 / §6 基础模块 / §7 部署架构 | — |
+| 2026-04-23 | **新增 kb/93-架构决策.md 骨架(永久文档)**:作为重构收尾后 `90-重构路线.md` / `91-重构备忘.md` / `92-重构进度.md` 三份过程文档压缩留档的 ADR 沉淀点;当前仅留"说明 + 决策清单(待补充)"骨架;README §9x 过渡资料表加行 | — |

+ 13 - 0
kb/93-架构决策.md

@@ -0,0 +1,13 @@
+# 架构决策
+
+> 重构完成后沉淀的关键架构决策(ADR),给自己看的备忘。
+
+## 说明
+
+- 本文档是**重构完成态**的沉淀:`90-重构路线.md` / `91-重构备忘.md` / `92-重构进度.md` 三份过程文档会在重构收尾时删除,关键决策、权衡、反悔条件压到这里留档。
+- 当前仍在重构中,本文档先留骨架,内容待重构收尾时填入。
+- 记录粒度:**选了什么方案 / 为什么选 / 否决了哪些替代 / 什么条件下会反悔**。操作性细节留在代码与 commit history 里,不在此复述。
+
+## 1. 决策清单
+
+待补充