137 lines
3.9 KiB
Python
137 lines
3.9 KiB
Python
|
"""T+ 字段映射元数据。
|
|||
|
|
|
|||
|
|
这里记录候选字段和确认状态，不把字典中的候选直接当成业务契约。
|
|||
|
|
高风险口径在客户确认前保持 ``PENDING``，同步器只允许写入原始 staging。
|
|||
|
|
"""
|
|||
|
|
|
|||
|
|
from dataclasses import dataclass
|
|||
|
|
from enum import StrEnum
|
|||
|
|
|
|||
|
|
|
|||
|
|
class MappingStatus(StrEnum):
|
|||
|
|
"""字段映射的证据状态。"""
|
|||
|
|
|
|||
|
|
CONFIRMED = "CONFIRMED"
|
|||
|
|
CANDIDATE = "CANDIDATE"
|
|||
|
|
MISSING = "MISSING"
|
|||
|
|
PENDING = "PENDING"
|
|||
|
|
|
|||
|
|
|
|||
|
|
@dataclass(frozen=True, slots=True)
|
|||
|
|
class TPlusMapping:
|
|||
|
|
"""一个实体的源表、候选字段和目标表说明。"""
|
|||
|
|
|
|||
|
|
entity_type: str
|
|||
|
|
source_table: str
|
|||
|
|
source_fields: tuple[str, ...]
|
|||
|
|
target_table: str
|
|||
|
|
status: MappingStatus
|
|||
|
|
unresolved: tuple[str, ...] = ()
|
|||
|
|
version: str = "0.2"
|
|||
|
|
schema_evidence: str = "ceshi20261026.bak，2026-10-27 恢复副本结构核验"
|
|||
|
|
|
|||
|
|
|
|||
|
|
TPLUS_MAPPINGS: tuple[TPlusMapping, ...] = (
|
|||
|
|
TPlusMapping(
|
|||
|
|
"personnel",
|
|||
|
|
"AA_Person",
|
|||
|
|
("id", "code", "name", "disabled", "mobilePhoneNo", "officePhoneNo", "iddepartment"),
|
|||
|
|
"personnel",
|
|||
|
|
MappingStatus.CANDIDATE,
|
|||
|
|
("工号是否等于 code", "经理隶属关系", "入职日期", "试用期"),
|
|||
|
|
),
|
|||
|
|
TPlusMapping(
|
|||
|
|
"products",
|
|||
|
|
"AA_Inventory",
|
|||
|
|
("id", "code", "name", "specification", "idunit", "idinventoryclass"),
|
|||
|
|
"products",
|
|||
|
|
MappingStatus.CANDIDATE,
|
|||
|
|
("库存数量语义", "参考价来源", "系统产品分类"),
|
|||
|
|
),
|
|||
|
|
TPlusMapping(
|
|||
|
|
"customers",
|
|||
|
|
"AA_Partner",
|
|||
|
|
("id", "code", "name", "Contact", "representative", "disabled", "updated"),
|
|||
|
|
"customers",
|
|||
|
|
MappingStatus.CANDIDATE,
|
|||
|
|
("客户唯一键", "改名/合并规则", "系统客户分类"),
|
|||
|
|
),
|
|||
|
|
TPlusMapping(
|
|||
|
|
"businesses",
|
|||
|
|
"SA_SaleOrder",
|
|||
|
|
("id", "code", "voucherdate", "idcustomer", "idclerk", "idbusinesstype", "updated"),
|
|||
|
|
"businesses",
|
|||
|
|
MappingStatus.PENDING,
|
|||
|
|
("成本口径", "业务负责人覆盖规则", "含税口径"),
|
|||
|
|
),
|
|||
|
|
TPlusMapping(
|
|||
|
|
"shipments",
|
|||
|
|
"SA_SaleDelivery",
|
|||
|
|
(
|
|||
|
|
"id",
|
|||
|
|
"code",
|
|||
|
|
"voucherdate",
|
|||
|
|
"SendDate",
|
|||
|
|
"deliveryDate",
|
|||
|
|
"auditeddate",
|
|||
|
|
"SourceVoucherCode",
|
|||
|
|
"updated",
|
|||
|
|
),
|
|||
|
|
"shipments",
|
|||
|
|
MappingStatus.PENDING,
|
|||
|
|
("发货日期", "订单关联路径", "退货/红冲规则", "运费来源"),
|
|||
|
|
),
|
|||
|
|
TPlusMapping(
|
|||
|
|
"receipts",
|
|||
|
|
"ARAP_ReceivePayment",
|
|||
|
|
(
|
|||
|
|
"id",
|
|||
|
|
"code",
|
|||
|
|
"voucherDate",
|
|||
|
|
"auditedDate",
|
|||
|
|
"createdTime",
|
|||
|
|
"SaleOrderCode",
|
|||
|
|
"SaleOrderID",
|
|||
|
|
"ts",
|
|||
|
|
),
|
|||
|
|
"receipts",
|
|||
|
|
MappingStatus.PENDING,
|
|||
|
|
("到账日期", "收款方式", "核销状态", "回款与发货关联"),
|
|||
|
|
),
|
|||
|
|
)
|
|||
|
|
|
|||
|
|
DETAIL_MAPPINGS: tuple[TPlusMapping, ...] = (
|
|||
|
|
TPlusMapping(
|
|||
|
|
"business_items",
|
|||
|
|
"SA_SaleOrder_b",
|
|||
|
|
("id", "idSaleOrderDTO", "LatestCost"),
|
|||
|
|
"business_items",
|
|||
|
|
MappingStatus.PENDING,
|
|||
|
|
("成本口径", "含税口径"),
|
|||
|
|
),
|
|||
|
|
TPlusMapping(
|
|||
|
|
"shipment_items",
|
|||
|
|
"SA_SaleDelivery_b",
|
|||
|
|
("ID", "idSaleDeliveryDTO", "saleOrderId"),
|
|||
|
|
"shipment_items",
|
|||
|
|
MappingStatus.PENDING,
|
|||
|
|
("发货归属", "红冲和退货"),
|
|||
|
|
),
|
|||
|
|
TPlusMapping(
|
|||
|
|
"receipt_items",
|
|||
|
|
"ARAP_ReceivePayment_b",
|
|||
|
|
("id", "idArapReceivePaymentDTO", "saleorderid"),
|
|||
|
|
"receipts",
|
|||
|
|
MappingStatus.PENDING,
|
|||
|
|
("回款拆分", "核销语义", "增量水位"),
|
|||
|
|
),
|
|||
|
|
)
|
|||
|
|
|
|||
|
|
|
|||
|
|
def get_mapping(entity_type: str) -> TPlusMapping:
|
|||
|
|
"""按实体类型取得映射；未知实体直接拒绝。"""
|
|||
|
|
for mapping in (*TPLUS_MAPPINGS, *DETAIL_MAPPINGS):
|
|||
|
|
if mapping.entity_type == entity_type:
|
|||
|
|
return mapping
|
|||
|
|
raise KeyError(f"未知 T+ 实体类型：{entity_type}")
|