技能｜一数一源架构原则

适用场景

设计数据模型、台账体系、AI 索引、展示层时，作为最高架构约束。

操作步骤

1. 单根权威源：制度权威源 = Word（WORD_LIB）；业务数据 = SQLite；展示为只读镜像。
2. 台账 SPECS 驱动 N 体系：新增体系只改一段定义，不写建表 / CRUD 代码（零重复）。
3. 表名白名单 table_of(key) 杜绝外部输入拼 SQL（防注入第一道闸）。
4. 制度↔台账同号映射：制度 XX-NN↔台账键 xx_fNN*、XX-RNN↔xx_rNN*、XX-00 无台账。
5. 自动表单（母本驱动）与手工表单一数一源；手工优先不被自动覆盖。

注意边界

SPECS 是唯一字段来源：改字段只改定义，不在视图另写列名。
展示层只读，写回唯一出口 = write_inst（整篇替换单制度 docx + 域汇编章节）。

反例避雷

多处维护同一数据；视图 / SQL 手拼列名；台账加字段只改 CREATE 不写 ALTER 补列。

关联笔记

• [[技能｜三级架构与十域编码规则]]
• [[技能｜台账体系SPECS驱动扩展法]]

实战战绩

2026-10-03 从 HFMS 开发实战沉淀，纳入《程序技能库》七阶段分类（00 总纲 / 03 设计）。

版本记录