# Express 模型与数据表整理 ## 一览 | 模型文件 | Sequelize key | 数据表 | 当前状态 | | --- | --- | --- | --- | | app/model/express.js | Express | wms_express | 已补齐 | | app/model/express_setting.js | ExpressSetting | wms_express_setting | 已补齐 | | app/model/order_express.js | OrderExpress | wms_order_express | 已补齐 | | app/model/order_express_print_data.js | OrderExpressPrintData | wms_order_express_print_data | 已补齐 | | app/model/express_print_record.js | ExpressPrintRecord | wms_express_print_record | 已补齐 | ## 关键说明 - 本次仅整理模型与真实数据表对齐,不改动业务逻辑与接口行为。 - 通过 `script/db-query.ps1` 实查,数据库中包含 5 张 express 相关表,上述模型已全部覆盖。 - 既有字段型快递信息(如 `wms_entry_order.express_code`、`wms_order_delivery.express_code`)仍保留为业务字段,不属于独立主数据表。 ## 建议的后续收敛 - 将 `index.getExpressList` 的配置源(`app.config.expressList`)逐步收敛到 `wms_express`,避免配置与数据表双源。 - 若后续存在统一查询需求,可新增 `systems/express.js`,统一对 `Express / ExpressSetting / OrderExpress` 的读写入口。 ## 包材关联字段说明 - **新增字段**:`wms_order_express.package_material_id`(可空,BIGINT unsigned)、`wms_order_express.package_material_name_snapshot`(可空,VARCHAR(128))。用于记录订单快递所使用的包材引用与名称快照,`package_material_id` 指向 `wms_package_material.id`。 - **新增表**:`wms_package_material`(包材主数据表)和 `wms_package_supplier`(包材供应商表),均已在 migration 与 model 中定义;关键索引:`idx_wms_package_material_warehouse_id`、`uk_wms_package_material_warehouse_material_code`、`idx_wms_package_supplier_warehouse_id`、`uk_wms_package_supplier_warehouse_supplier_code`。 - **索引**:为 `wms_order_express.package_material_id` 新增索引 `idx_wms_order_express_package_material_id`,以支持基于包材的过滤与联表查询。 - **兼容性**:新增列为可空,不会破坏现有接口契约。若系统存在将 `wms_order_express` 全量返回给外部的接口(未在 methods/system.json 中声明新增字段),请在需要暴露字段的接口中补充文档说明并在变更记录中标注。当前已检查的 system 方法文档未需修改,因此本次不改 methods/system.json(无接口契约变化)。 - **回滚要点**:迁移的 down 会删除新增列、索引与新增表;回滚前请务必备份或迁移相关业务数据。 文档维护者:WMS 文档代理