WMS_MAIN/temp/docs/modelList.md

2.7 KiB

modelList

更新时间: 2026-03-22 扫描范围: app/model/*.js 模型文件数: 45

1. 目标

  • 用于快速查看模型层级结构。
  • 用于后续 model 命名规范、关联规范、迁移补全的基线输入。

2. 模型层级结构

app/model/
├─ 账号与权限
│  ├─ account.js
│  ├─ account_platform_active.js
│  ├─ account_store_employee.js
│  ├─ employee_role.js
│  ├─ permission.js
│  ├─ role.js
│  └─ role_permission.js
├─ 组织与仓库
│  ├─ store.js
│  ├─ store_join.js
│  ├─ store_warehouse.js
│  ├─ storage.js
│  ├─ receiving.js
│  ├─ receiving_detail.js
│  ├─ entry_order.js
│  └─ entry_items.js
├─ 库位与查询
│  ├─ location_type.js
│  ├─ location_zone.js
│  ├─ location_space.js
│  └─ fast_where.js
├─ 库存与商品
│  ├─ stock_store.js
│  ├─ stock_warehouse.js
│  ├─ stock_unit.js
│  ├─ stock_barcode.js
│  └─ prohibited_type.js
├─ 订单与履约
│  ├─ order_delivery.js
│  ├─ order_items.js
│  ├─ order_delivery_factory.js
│  └─ order_items_factory.js
├─ 打印能力
│  ├─ print_template.js
│  ├─ print_item.js
│  ├─ print_record.js
│  ├─ print_stations.js
│  ├─ print_station_express.js
│  └─ print_computer.js
├─ 开放平台与接口
│  ├─ api_app.js
│  ├─ qimen_app.js
│  ├─ qimen_log.js
│  ├─ platform.js
│  ├─ platform_setting.js
│  └─ interface_type.js
└─ 文件、日志与国际化
   ├─ file.js
   ├─ file_reference.js
   ├─ operation_log.js
   ├─ i18n_key.js
   └─ i18n_translation.js

3. 关键说明

3.1 动态分表模型

  • order_delivery_factory.js
    • 负责按 warehouse 维度动态创建/获取发货单模型。
  • order_items_factory.js
    • 负责按 warehouse 维度动态创建/获取订单商品模型。

说明:

  • 这两个文件不是普通静态 Sequelize 定义文件,而是动态模型工厂能力。

3.2 典型关联模型

  • fast_where.js
    • 自关联: parent/children。
  • location_zone.js
    • 自关联 + 与 Store、LocationSpace 的关联。
  • i18n_translation.js
    • 关联 i18n_key。
  • prohibited_type.js
    • 关联 Store、StockWarehouse。
  • stock_barcode.js
    • 关联 StockWarehouse。

3.3 命名现状观察

  • define 名称存在 snake_case 与 PascalCase 混用。
  • 部分模型文件命名与 define 名称不完全一致。
  • 后续需结合 model_naming_standard 做统一收敛。

4. 后续维护规则

  • 每次新增/删除/重命名 model 文件后,需同步更新本文件。
  • 每次新增/调整关联后,需同步更新本文件的关键说明章节。