go-svc-mercury/internal/cmd/dw_shop_inventory.md

服装ERP店铺库存表创建提示词

核心需求

基于服装行业ERP系统，创建用于配货、补货、调拨决策支持的店铺库存数据表。

表基本信息

• 表名: dw_shop_inventory
• 模型名: DWShopInventory
• 表注释: 店铺库存快照表 - 用于配补调决策和库存分析
• 开发框架: Go + GORM

必需字段列表

1. 主键标识

• id - 主键ID (自增)
• inventory_sn - 库存流水号 (日期+店铺+商品，用于唯一标识)

2. 店铺与商品关联

• shop_id - 店铺ID (外键)
• shop_code - 店铺编码
• shop_name - 店铺名称
• product_id - 商品ID (外键)
• product_code - 商品编码
• product_name - 商品名称

3. 库存数量信息

• on_hand_qty - 现货数量 (店铺实际库存)
• in_transit_qty - 在途数量 (已发货未到店)
• committed_qty - 已承诺数量 (已销售未出库)
• available_qty - 可用库存 (on_hand_qty - committed_qty)
• reserved_qty - 预留数量 (用于调拨、补货预留)

4. 库存价值信息

• unit_cost - 单位成本 (最近采购成本)
• inventory_value - 库存金额 (on_hand_qty * unit_cost)
• last_receipt_date - 最近收货日期
• last_sales_date - 最近销售日期

5. 库存周转指标

• days_supply - 可销天数 (available_qty / 日均销量)
• stock_cover - 库存覆盖率 (现有库存能满足未来多少天的销售)
• inventory_turnover - 库存周转率
• sell_through_rate - 售罄率 (已售数量/总进货数量)

6. 补货相关指标

• safety_stock - 安全库存 (该店铺该商品的安全库存水平)
• reorder_point - 补货点 (触发补货的库存水平)
• reorder_qty - 建议补货量
• last_replenish_date - 最近补货日期

7. 时效信息

• season_code - 季节代码 (SS/FW)
• year - 年份
• inventory_age - 库龄 (天)
• is_new_arrival - 是否新品 (上市30天内)

8. 状态与时间

• inventory_status - 库存状态 (NORMAL正常/OVERSTOCK积压/SHORTAGE缺货/SLOW_MOVING滞销)
• data_date - 数据日期 (库存快照日期)
• snapshot_time - 快照时间 (具体时间点)
• created_at - 创建时间

索引要求

• 主键: id
• 唯一索引: inventory_sn
• 普通索引: shop_id, product_id, data_date, inventory_status
• 复合索引:
  • (shop_id, product_id, data_date) - 按店铺商品查询历史
  • (product_id, inventory_status, data_date) - 商品状态分析
  • (shop_id, season_code, inventory_status) - 店铺季节库存分析

特别说明

1. 此表为数据仓库快照表，每日或实时同步
2. 包含完整的配补调决策所需指标
3. 库存数量分维度存储：现货/在途/已承诺
4. 包含库存健康度指标：库龄、周转率、售罄率
5. 支持多维度库存分析：按店铺、商品、季节、状态等
6. 为自动补货、智能调拨提供数据基础

计算字段说明

1. available_qty = on_hand_qty - committed_qty
2. days_supply = available_qty / sales_velocity (需关联销售表)
3. inventory_age = DATEDIFF(data_date, last_receipt_date)
4. sell_through_rate = sold_qty / (initial_stock + replenished_qty)

输出路径

/Users/kenqdy/Documents/v-bdx-workspace/svc-mercury/internal/tables/dw_shop_inventory.go