agent-skills-order-replenish/skills/stock-store-snapshot/SKILL.md

---

name: stock-store-snapshot description: 日店铺库存快照表 - 用于保存每天晚上所有店铺的商品库存 license: MIT compatibility: opencode metadata: category: database domain: retail-erp table_type: snapshot

business_type: inventory

日店铺库存快照表 (stock_store_snapshot)

表信息

• 表名: stock_store_snapshot
• 主键: id
• 时间字段: created_at, data_date
• 查询日期字段: data_date (快照日期字段)

关键字段

字段名	数据类型	查询用途
id	varchar(50)	主键ID
store_id	varchar(50)	店铺ID，关联master_store
product_id	varchar(50)	商品ID，关联master_product
style_code	varchar(30)	款式编码
color_code	varchar(20)	颜色代码
color_name	varchar(50)	颜色名称
size_code	varchar(10)	尺码代码
size_name	varchar(20)	尺码名称
stock_actual	decimal(12,4)	目前库存，实际库存数量
data_date	date	快照日期，默认查询日期字段
created_at	datetime	创建时间

关联关系

• 父表关联:
  • store_id → master_store.stor_id (店铺)
  • product_id → master_product.product_id (商品)

在查询拆解中的角色

• 查询部分：可查询库存数量、款式、颜色、尺码等维度信息
• where部分：可通过关联的店铺、商品字段进行筛选，时间条件使用data_date
• from部分：作为库存快照数据的主表，需关联档案表获取维度信息
• 汇总部分：可按店铺、商品、款式、颜色、尺码、时间等维度汇总库存数据
• 排序部分：通常按库存数量、店铺、商品或时间排序

关键查询规则

1. 快照性质: 此为日库存快照表，每天一条记录，记录每个店铺每个商品在data_date结束时的库存
2. 时间字段: 查询日期使用data_date字段，表示快照日期
3. 关联完整性: 必须正确关联店铺、商品档案表
4. 维度丰富: 包含款式、颜色、尺码等商品维度信息，可用于多维度分析
5. 无租户字段: 此表可能没有tenant_id字段，查询时注意

多步骤查询支持

• 可作为数据源表，创建中间表保存库存快照数据
• 支持创建中间表格式：{userid}{datetime}_step{n}_stock_snapshot
• 中间表关键字段：id, store_id, product_id, style_code, color_code, size_code, stock_actual, data_date
• 通常作为查询的中间步骤，先筛选档案数据再关联本表获取库存信息