master-slave.md 3.55 KB

主从单据模式

xly 中几乎所有业务单据,例如报价单、销售订单、工单、付款凭证,都是以一行表头 + N 行明细存储。xly 对此的术语是 master / slave。master 保存单据身份和汇总;每个 slave 行是一条明细、一段阶段、一项材料、一个产品或一笔费用。

这个模式无处不在:

单据 Master Slave 表族
报价单 quoQuotationMaster quoQuotationSlavequoQuotationMaterialsquoQuotationProcessquoQuotationFreightquoQuotationParamquoQuotationControlquoQuotationControlCombinequoQuotationPacking,以及编辑中使用的并行 *_tmp 表族。
工单 mftWorkOrderMaster mftWorkOrderSlavemftWorkOrderMaterialsmftWorkOrderProcessmftWorkOrderPackingmftWorkOrderControlmftWorkOrderControlCombinemftWorkOrderParammftWorkOrderChangeApply,以及若干 *_tmp 表族。
销售订单 salSalesOrderMaster salSalesOrderSlavesalSalesOrderMaterialssalSalesOrderProcesssalSalesOrderControlsalSalesOrderControlCombinesalSalesOrderAddresssalSalesOrderParam 等。
成本分析 accOrderCostAnalysis(无 Master 后缀) accOrderCostAnalysisOperation
框架自身表单 gdsconfigformmaster gdsconfigformslavegdsconfigformcustomslavegdsconfigformuserslave

这个约定足够普遍,因此 Wiki 使用 masterslave 作为专门术语。它们分别表示表头和明细;命名来自旧代码库,值得保留,因为它逐字出现在 14k+ 表名和列名中。

模式内约定

  • 从表行的连接列通常叫 sMasterIdsParentId(这是语义 FK,不强制)。有时会使用更具体的名称,例如报价从表中的 sQuoId、工单从表中的 sWoId;以从表列为准。
  • Master 及其所有 slave 共享相同的多租户作用域列(sBrandsIdsSubsidiaryId)。
  • “Control” 变体从表(例如 mftWorkOrderControlquoQuotationControl)保存复合或聚合状态:汇总、状态标志、计算列。它们仍然是 master 的从表。
  • 子明细表通过额外后缀命名,例如 ...SlaveChildren...ControlCombine,并连接到某个从表行。

为什么这个模式对 Wiki 重要

“Slave” 命名说明

这个词在英文中有额外含义,而中文“主表 / 从表”没有。Wiki 保留 “slave”,原因是:

  1. 改名会破坏代码库、schema 和自动目录中的全部交叉引用(14k+ 标识符)。
  2. 把每次出现都映射成 “detail” 或 “child” 会损害可搜索性,并使 Wiki 文本偏离开发者实际 grep 到的内容。

未来 xly 版本可能改名为 “detail” / “header”;在此之前,Wiki 使用代码库中的原词,并在此处一次性说明。