Django模型设计：新增仓库与存量商品关联映射最优方案

一、新仓库与存量商品关联映射的高效落地方案 #

结合DRF+前端的技术栈，从后端逻辑到前端交互可以按以下方案设计，500条存量商品的配置操作1分钟内就能完成：

后端（DRF层）设计 #

• 新增仓库的接口内置自动初始化逻辑：新仓库创建成功后，后端直接在事务里批量给所有存量商品生成ItemWarehouse关联记录，默认值统一设为locked=True（默认锁定，符合风控逻辑——新仓库初始状态下不开放任意商品交易权限，避免误操作），不需要用户手动触发初始化操作。
• 单独开发批量更新权限的接口，不要复用单条记录更新接口：接口入参仅需接收warehouse_id（新建仓库ID）、allowed_item_ids（需要放开交易权限的商品ID列表），后端拿到参数后直接用Django ORM的bulk_update方法批量更新对应记录的locked字段为False，500条数据的更新耗时在毫秒级，远快于循环单条更新。接口全程加数据库事务包裹，避免部分更新成功、部分失败的数据不一致问题。
• 如果业务存在「新仓库默认全量开放所有商品交易，仅锁定特殊商品」的场景，给接口加个可选参数default_locked，支持初始化时直接把所有关联记录设为非锁定状态即可。

前端UI层设计 #

• 新仓库创建提交成功后，直接跳转到该仓库的商品权限配置页：页面一次性拉取所有存量商品列表（500条数据量极小，不需要分页，后续商品量破万再加滚动加载/分页），按商品编码、分类排序展示，每行前带复选框，默认全不选（对应默认锁定状态）。
• 页面顶部放快速操作栏：支持全选、反选、按商品编码搜索、按分类筛选，用户只需要勾选需要放开交易权限的商品，点「保存配置」按钮，就会把选中的商品ID列表传给后端批量接口。如果是默认全开放的场景，加个「一键全选/全不选」按钮即可，不需要逐个点开关调整。
• 保存成功后弹出明确提示，告知用户当前仓库下已放开权限的商品数量、保持锁定的商品数量，避免漏配。

二、现有模型设计的优化点 #

现有三表关联的思路是符合数据库三范式的，但是有几个细节可以调整，适配业务更顺滑，减少后续出bug的概率：

1. 修正外键定义问题
   现有ItemWarehouse模型里外键关联写的是不存在的ItemMaster，需要和你定义的Item模型对齐，同时两个外键必须加on_delete约束，生产环境建议用PROTECT规则，禁止直接删除已经关联了权限配置的仓库、商品，避免产生无主的脏数据。
2. 加唯一约束和查询索引
   在ItemWarehouse的Meta配置里加商品+仓库的联合唯一约束，避免同一个商品和同一个仓库生成重复的关联记录，导致查询权限状态时返回多条结果报错；同时加仓库+锁定状态的联合索引，后续查某个仓库下可交易的商品列表时可以直接走索引，数据量上来之后性能提升非常明显。
3. 把重复的关联初始化逻辑下沉到模型层，不要散落在业务代码里

• 给Item模型加post_save信号，判断是新建商品时，自动给当前所有已存在的仓库生成默认状态的ItemWarehouse关联记录，不需要每次在新建商品的业务接口里手动写循环创建关联，避免漏配。
• 给Warehouse模型加post_save信号，判断是新建仓库时，自动给所有存量商品生成默认状态的关联记录，后续再加新仓库不需要手动写脚本补数据。

优化后的ItemWarehouse模型参考代码如下：

class ItemWarehouse(models.Model):
    item = models.ForeignKey(Item, on_delete=models.PROTECT)
    warehouse = models.ForeignKey(Warehouse, on_delete=models.PROTECT)
    locked = models.BooleanField(default=True) # 可根据业务默认规则调整为False

    class Meta:
        unique_together = ('item', 'warehouse')
        indexes = [
            models.Index(fields=['warehouse', 'locked']),
        ]

小提示：如果你的业务里绝大多数仓库都是全品类开放，只有极个别商品需要单独锁定，把locked字段的默认值改成False就行，整体逻辑不需要调整，核心是让默认规则覆盖90%的场景，用户只需要配置特殊情况，操作效率最高。

内容的提问来源于stack exchange，提问作者Ranu Vijay