2.6 KiB
2.6 KiB
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 文档代理