# modelList 更新时间: 2026-03-22 扫描范围: app/model/*.js 模型文件数: 45 ## 1. 目标 - 用于快速查看模型层级结构。 - 用于后续 model 命名规范、关联规范、迁移补全的基线输入。 ## 2. 模型层级结构 ```text 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 文件后,需同步更新本文件。 - 每次新增/调整关联后,需同步更新本文件的关键说明章节。