106 lines
2.7 KiB
Markdown
106 lines
2.7 KiB
Markdown
# 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 文件后,需同步更新本文件。
|
|
- 每次新增/调整关联后,需同步更新本文件的关键说明章节。
|