---
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字段，查询时注意

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