master-slave.md
3.55 KB
主从单据模式
xly 中几乎所有业务单据,例如报价单、销售订单、工单、付款凭证,都是以一行表头 + N 行明细存储。xly 对此的术语是 master / slave。master 保存单据身份和汇总;每个 slave 行是一条明细、一段阶段、一项材料、一个产品或一笔费用。
这个模式无处不在:
| 单据 | Master | Slave 表族 |
|---|---|---|
| 报价单 | quoQuotationMaster |
quoQuotationSlave、quoQuotationMaterials、quoQuotationProcess、quoQuotationFreight、quoQuotationParam、quoQuotationControl、quoQuotationControlCombine、quoQuotationPacking,以及编辑中使用的并行 *_tmp 表族。 |
| 工单 | mftWorkOrderMaster |
mftWorkOrderSlave、mftWorkOrderMaterials、mftWorkOrderProcess、mftWorkOrderPacking、mftWorkOrderControl、mftWorkOrderControlCombine、mftWorkOrderParam、mftWorkOrderChangeApply,以及若干 *_tmp 表族。 |
| 销售订单 | salSalesOrderMaster |
salSalesOrderSlave、salSalesOrderMaterials、salSalesOrderProcess、salSalesOrderControl、salSalesOrderControlCombine、salSalesOrderAddress、salSalesOrderParam 等。 |
| 成本分析 |
accOrderCostAnalysis(无 Master 后缀) |
accOrderCostAnalysisOperation |
| 框架自身表单 | gdsconfigformmaster |
gdsconfigformslave、gdsconfigformcustomslave、gdsconfigformuserslave
|
这个约定足够普遍,因此 Wiki 使用 master 和 slave 作为专门术语。它们分别表示表头和明细;命名来自旧代码库,值得保留,因为它逐字出现在 14k+ 表名和列名中。
模式内约定
- 从表行的连接列通常叫
sMasterId或sParentId(这是语义 FK,不强制)。有时会使用更具体的名称,例如报价从表中的sQuoId、工单从表中的sWoId;以从表列为准。 - Master 及其所有 slave 共享相同的多租户作用域列(
sBrandsId、sSubsidiaryId)。 - “Control” 变体从表(例如
mftWorkOrderControl、quoQuotationControl)保存复合或聚合状态:汇总、状态标志、计算列。它们仍然是 master 的从表。 - 子明细表通过额外后缀命名,例如
...SlaveChildren或...ControlCombine,并连接到某个从表行。
为什么这个模式对 Wiki 重要
- 切片 1 风格导航中的几乎每个表单,都是某个单据表族的 master。当选中 master 行时,slave 会作为嵌套表格或第二表单加载。
- 框架自身的表单元数据(
gdsconfigformmaster/gdsconfigformslave)本身就是该模式实例:框架用要求 PM 遵循的同一约定来描述自己。 - 定制覆盖(
gdsconfigformcustomslave、gdsconfigformuserslave)是同级 slave 表,不是更深层模式。见切片 4。
“Slave” 命名说明
这个词在英文中有额外含义,而中文“主表 / 从表”没有。Wiki 保留 “slave”,原因是:
- 改名会破坏代码库、schema 和自动目录中的全部交叉引用(14k+ 标识符)。
- 把每次出现都映射成 “detail” 或 “child” 会损害可搜索性,并使 Wiki 文本偏离开发者实际 grep 到的内容。
未来 xly 版本可能改名为 “detail” / “header”;在此之前,Wiki 使用代码库中的原词,并在此处一次性说明。