erpnew/docs/WAREHOUSE_TYPE.md

仓库类型 (WarehouseTypeEnum)

本文档描述了 basic_info 模块中 WareHouse 模型的 type 字段及其枚举值。

功能说明

仓库类型字段 (type) 用于区分仓库的类别，目前支持两种类型：

• 整仓: 存储完整的、未分割的货物
• 散仓: 存储零散的、分割后的货物

枚举值

WarehouseTypeEnum

值 (Integer)	名称 (String)	描述
1	整仓	默认值，用于存储整卷/整件货物
2	散仓	用于存储散卷/拆分后的货物

模型定义

class WarehouseTypeEnum(models.IntegerChoices):
    """仓库类别枚举"""
    WHOLE = 1, '整仓'
    SCATTERED = 2, '散仓'


class WareHouse(ModelBase):
    # ...
    type = models.IntegerField(
        choices=WarehouseTypeEnum.choices,
        default=WarehouseTypeEnum.WHOLE,
        verbose_name='仓库类别',
    )
    # ...

API 使用

创建仓库

端点: POST /api/backend/warehouses/

请求体示例:

{
  "name": "主仓库",
  "type": 1,
  "location": "工厂一楼",
  "area": "广州",
  "mode": 1
}

参数说明:

• type: 仓库类型，可选值：1 (整仓) 或 2 (散仓)，默认为 1

列表查询

端点: GET /api/backend/warehouses/

响应示例:

{
  "results": [
    {
      "id": 1,
      "name": "主仓库",
      "type": 1,
      "location": "工厂一楼",
      "mode": 1,
      "area": "广州"
    },
    {
      "id": 2,
      "name": "散货仓",
      "type": 2,
      "location": "工厂二楼",
      "mode": 1,
      "area": "广州"
    }
  ]
}

更新仓库

端点: PATCH /api/backend/warehouses/{id}/

请求体示例:

{
  "type": 2
}

Admin 界面

在 Django Admin 界面中：

• 列表页: type 字段显示在列表中，并可用于筛选
• 编辑页: type 字段显示为下拉选择框
• 显示文本: 使用中文标签（整仓/散仓）

Admin 配置

• list_display 包含 type 字段
• list_filter 包含 type 字段，方便按类型筛选

注意事项

1. 默认值: 创建仓库时，如果未指定 type，默认为 1（整仓）
2. 验证: type 字段只接受 1 或 2 两个值
3. 兼容性: 现有仓库记录在迁移后将自动设置为默认值（整仓）
4. 扩展性: 如需添加新的仓库类型，可在 WarehouseTypeEnum 中添加新枚举值

数据库迁移

新字段通过以下迁移添加：

• 迁移文件: basic_info/migrations/0010_warehouse_type.py
• 字段: type (IntegerField)
• 默认值: 1 (整仓)

测试覆盖

测试文件包括：

• 模型测试: basic_info/tests.py - 测试字段默认值、枚举值等
• API 测试: api_man/tests.py - 测试 CRUD 操作和 API 返回值

运行测试：

# 测试模型
uv run python manage.py test basic_info.tests.WarehouseTypeTestCase

# 测试 API
uv run python manage.py test api_man.tests.WarehouseAPITestCase