表结构与业务表字典

本文按业务域整理 DGJ2.0 的核心业务表。表名以 application/config/tables.php 为准，常量名是代码里最常见的检索入口，排查时优先用常量名 rg，再确认真实物理表。

业务目标

  • 让新人知道每个业务域的主表、明细表、流水表和扩展表分别是什么。
  • 让排查同学能从单号、sid、orderId、billNo、srcOrderId、srcOrderNo 顺着表关系查下去。
  • 让开发改表字段前知道影响采购、销售、库存、财务、报表、活动和外部同步。

采购域

| 常量 | 物理表 | 用途 | 关键字段口径 | | --- | --- | --- | --- | | SCM_PO_ORDER | t_scm_po_order | 采购主单 | sid、采购单号、billStatus、orderType、srcOrderType、支付类型、金额 | | SCM_PO_ORDER_EXT | t_scm_po_order_ext | 采购扩展 | 外部来源、扩展标记、兼容字段 | | SCM_PO_ORDER_INFO | t_scm_po_order_info | 采购明细 | 商品、skuId、invId、采购数量、价格、关闭数量 | | SCM_PO_ORDER_INFO_QTY | t_scm_po_order_info_qty | 明细数量状态 | 原始数量、已发、已收、关闭、退货等数量拆分 | | SCM_PO_ORDER_PAYINFO | t_scm_po_order_payinfo | 采购支付明细 | 支付单号、支付状态、支付流水、在线支付关联 | | SCM_PO_OUT_INFO | t_scm_po_out_info | 采购出库明细 | 调拨/仓库侧发货、配送数量 | | SCM_PO_CLOSE_INFO | t_scm_po_close_info | 采购关闭明细 | 整单/部分关闭、关闭数量、关闭原因 | | SCM_PU_INVOICE | t_scm_pu_invoice | 采购入库主单 | 入库单号、采购来源、仓库、入库状态 | | SCM_PU_INVOICE_INFO | t_scm_pu_invoice_info | 采购入库明细 | 入库数量、成本、货位 | | SCM_PO_RETURN_CLOSE | t_scm_po_return_close | 采购退货关闭 | 退货关闭记录 |

采购查询一般从 t_scm_po_order 开始，按主键/单号查明细，再按 srcOrderId、srcOrderNo、srcOrderType 反查活动、预订单、秒杀或外部系统来源。

销售域

| 常量 | 物理表 | 用途 | 关键字段口径 | | --- | --- | --- | --- | | SCM_SA_ORDER | t_scm_sa_order | 销售主单 | sid、客户、来源类型、销售状态、收款状态、金额 | | SCM_SA_ORDER_INFO | t_scm_sa_order_info | 销售明细 | 商品、销售数量、已出库数量、价格、折扣 | | SCM_SA_ORDER_INFO_EXT | t_scm_sa_order_info_ext | 销售明细扩展 | 活动、报价、外部来源扩展 | | SCM_SA_INVOICE | t_scm_sa_invoice | 销售出库主单 | 出库单号、出库状态、配送/签收/对账状态 | | SCM_SA_INVOICE_INFO | t_scm_sa_invoice_info | 出库明细 | 出库数量、货位、成本、退货数量 | | SCM_SA_INVOICE_INFO_EXT | t_scm_sa_invoice_info_ext | 出库明细扩展 | 外部系统、三方配送扩展 | | SCM_SA_RETURN_LOG | t_scm_abnormal_return_log | 异常退货记录 | 退货原因、退货数量、处理状态 | | SCM_THIRD_PARTY_DELIVERY_ORDER | t_scm_third_party_delivery_order | 三方配送单 | 配送平台、运单、状态 | | SCM_SA_INVOICE_DELIVERY_RELATION | t_sa_invoice_delivery_relation | 出库和配送关系 | 出库单到三方配送单映射 |

销售排查要区分“销售单状态”和“出库单状态”：销售单看是否待出库/部分出库/完成/关闭，出库单看是否已出库/派送中/送达/对账/核销/撤销。

库存域

| 常量 | 物理表 | 用途 | 关键字段口径 | | --- | --- | --- | --- | | SCM_INVENTORY | t_scm_inventory | 当月库存流水主表 | sid、单据号、transType、业务日期 | | SCM_INVENTORY_INFO | t_scm_inventory_info | 库存流水明细 | skuId、invId、仓库、货位、数量、成本 | | TH_SCM_INVENTORY | th_scm_inventory | 往月库存流水 | 历史月份归档数据 | | SCM_INVENTORY_REAL_TIME | t_scm_inventory_real_time | 实时库存 | sid、skuId/invId、仓库、货位、实时数量 | | SCM_INVENTORY_WARNING | t_scm_inventory_warning | 库存预警 | 预警上限/下限 | | BS_STORAGE | t_bs_storage | 仓库 | 服务站仓、微仓、特殊仓属性 | | BS_STORAGE_LOCATION | t_bs_storage_location | 仓库定位 | 仓库地址和配送信息 | | BS_AREA | t_bs_storage_area | 货位 | 货位编码、状态 | | SCM_INVENTORY_CHECK | t_scm_inventory_check | 盘点主表 | 盘点状态、盘点人、盘点时间 | | SCM_INVENTORY_CHECK_INFO | t_scm_inventory_check_info | 盘点明细分表 | 表名按 sid 个位分表 |

库存数量要看方向：采购入库、销售退货入库、盘盈增加库存；销售出库、采购退货、盘亏减少库存。库存流水是过程事实，实时库存是当前结果。

活动域

| 常量 | 物理表 | 用途 | 关键字段口径 | | --- | --- | --- | --- | | SALE_ACTIVITY | t_sale_activity | 普通销售活动 | 活动时间、类型、状态 | | GIFT_ACTIVITY | t_gift_activity | 赠品活动主表 | 活动状态、适用范围 | | GIFT_ACTIVITY_GOODS | t_gift_activity_goods | 赠品活动商品 | 商品、赠品、活动数量 | | GIFT_ACTIVITY_ORDER_REL | t_gift_activity_order_rel | 赠品活动订单关系 | 活动和采购单关系 | | FLASH_ACTIVITY | t_flash_activity | 秒杀活动主表 | 活动时间、审批、启用、库存口径 | | FLASH_ACTIVITY_GOODS | t_flash_activity_goods | 秒杀活动商品 | 活动价、限购、总量、锁定量、使用量 | | FLASH_ACTIVITY_STATION_SCOPE | t_flash_activity_station_scope | 服务站黑白名单 | 黑名单/白名单、sid | | FLASH_CART | t_flash_cart | 秒杀购物车 | 活动商品、数量、有效/失效 | | FLASH_ORDER | t_flash_order | 秒杀订单主表 | 秒杀订单状态、支付、采购单关系 | | FLASH_ORDER_DETAIL | t_flash_order_detail | 秒杀订单明细 | 商品、数量、价格、活动商品关系 |

秒杀链路的核心数量是 activity total qty、locked_qty、used_qty。支付超时、取消、采购关闭都要确认锁定量是否释放或已使用量是否回滚。

渠道域

| 常量 | 物理表 | 用途 | 关键字段口径 | | --- | --- | --- | --- | | CHANNEL_ORDER | t_channel_order | 大客户渠道订单主表 | 平台单号、审核状态、发货状态 | | CHANNEL_ORDER_INFO | t_channel_order_info | 渠道订单明细 | 商品、数量、发货数量 | | CHANNEL_AFTERSALE | t_channel_aftersale | 渠道售后主表 | 退货/退款状态 | | CHANNEL_AFTERSALE_INFO | t_channel_aftersale_info | 渠道售后明细 | 退货商品、数量 | | CHANNEL_ORDER_SIGN_DETAIL | t_channel_order_sign_detail | 渠道签收明细 | 签收数量、签收状态 |

渠道单号前缀来自 ChannelOrderEnums.php：CHS 是平台订单，CHR 是平台退单。渠道状态是字符串，不要按采购/销售数字状态解释。

财务域

| 常量 | 物理表 | 用途 | 关键字段口径 | | --- | --- | --- | --- | | SCM_ACCOUNT | t_scm_account | 当月账户流水主表 | 客户/供应商、账户、金额方向 | | SCM_ACCOUNT_INFO | t_scm_account_info | 账户流水明细 | 业务单据、交易类型、金额 | | TH_SCM_ACCOUNT | th_scm_account | 往月账户流水 | 历史归档 | | SCM_PAYMENT | t_scm_payment | 收付款主表 | 收款/付款、状态、对象、金额 | | SCM_PAYMENT_INFO | t_scm_payment_info | 收付款明细 | 关联业务单据、核销金额 | | SCM_PAYMENT_LOG | t_scm_payment_log | 收付款日志 | 操作轨迹 | | SCM_REPAYMENT_ORDER | t_scm_repayment_order | 授信还款单 | 白条/授信还款状态 |

支付中心在线回调通常先落 t_scm_payment、t_scm_payment_info，再通过 t_scm_po_order_payinfo 或业务单据字段串回采购单、退款单、还款单。

基础资料域

| 常量 | 物理表 | 用途 | | --- | --- | --- | | BS_GOODS / BS_GOODS_EXT | t_bs_goods / t_bs_goods_ext | 商品基础和扩展 | | BS_GOODS_STO | t_bs_goods_sto | 商品仓库配置 | | BS_GOODS_PURPRICE | t_bs_goods_purprice | 结算价 | | BS_CONTACT / BS_CONTACT_INFO | t_bs_contact / t_bs_contact_info | 客户/供应商 | | BS_ACCOUNT | t_bs_account | 结算账户 | | BS_STORE | t_bs_store | 门店 | | BS_CATEGORY / BS_BRAND | t_bs_category / t_bs_brand | 分类和品牌 |

基础资料变更会影响采购可买、销售可卖、库存展示、价格、报表维度和缓存索引，不能只回归一个页面。

权限和系统域

| 常量 | 物理表 | 用途 | | --- | --- | --- | | ACL_SYS_RESOURCE | t_acl_sys_resource | 系统资源 | | ACL_SYS_RESOURCE_RULE | t_acl_sys_resource_rule | 资源权限规则 | | SYS_ADMIN | t_sys_admin | 后台用户 | | SYS_MENU | t_sys_menu | 系统功能权限 | | SYS_MENU_DATA | t_sys_menu_data | 数据权限 | | SYS_MENU_CONFIG | t_sys_menu_config | 菜单控制 | | SYS_OPS_MENU_RULE / SYS_OPS_MENU_RULE_NEW | t_sys_ops_menu_rule / t_sys_ops_menu_rule_new | OPS 控制菜单规则 | | SYS_OPS_WHITELIST | t_sys_ops_whitelist | 服务站白名单 |

常用排查命令

rg -n "define\\('SCM_PO_ORDER'|define\\('SCM_SA_ORDER'|define\\('FLASH_ACTIVITY'" application/config/tables.php
rg -n "SCM_PO_ORDER|SCM_PO_ORDER_INFO|SCM_PO_ORDER_PAYINFO" application/models application/service application/Services
rg -n "SCM_INVENTORY_REAL_TIME|changeInventoryQty|save\\(" application/Services/Storage application/service
rg -n "FLASH_ORDER|locked_qty|used_qty|ORDERTYPE_FLASH_ORDER" application

改动风险和回归清单

  • 改采购表字段：回归普通采购、采购退货、在线支付、订单中心审核、采购入库、秒杀转采购。
  • 改销售表字段：回归销售开单、出库、配送、退货、对账、APP/SAAS 同步。
  • 改库存表字段：回归采购入库、销售出库、退货入库、盘点、调拨、实时库存查询。
  • 改活动表字段：回归 OPS 活动、服务站列表、加购、下单、支付、补偿任务。
  • 改财务表字段：回归在线支付回调、线下挂账、退款、白条还款、账户流水和报表。