# goods_stock_movements 商品库存变动流水

> 生成时间：2026-02-14

## 表信息

| 属性 | 值 |
|------|-----|
| Schema | ods |
| 表名 | goods_stock_movements |
| 主键 | sitegoodsstockid, content_hash |
| 数据来源 | export/test-json-doc/goods_stock_movements.json |
| 说明 | 商品库存变动流水 |

## 字段说明

| 序号 | 字段名 | 类型 | 可空 | 说明 |
|------|--------|------|------|------|
| 1 | sitegoodsstockid | BIGINT | NO | （待补充） |
| 2 | tenantid | BIGINT | YES | （待补充） |
| 3 | siteid | BIGINT | YES | （待补充） |
| 4 | sitegoodsid | BIGINT | YES | （待补充） |
| 5 | goodsname | TEXT | YES | （待补充） |
| 6 | goodscategoryid | BIGINT | YES | （待补充） |
| 7 | goodssecondcategoryid | BIGINT | YES | （待补充） |
| 8 | unit | TEXT | YES | 库存计量单位 |
| 9 | price | NUMERIC(18,4) | YES | 商品单价（单位金额） |
| 10 | stocktype | INTEGER | YES | （待补充） |
| 11 | changenum | NUMERIC(18,4) | YES | （待补充） |
| 12 | startnum | NUMERIC(18,4) | YES | （待补充） |
| 13 | endnum | NUMERIC(18,4) | YES | （待补充） |
| 14 | changenuma | NUMERIC(18,4) | YES | （待补充） |
| 15 | startnuma | NUMERIC(18,4) | YES | （待补充） |
| 16 | endnuma | NUMERIC(18,4) | YES | （待补充） |
| 17 | remark | TEXT | YES | 备注信息，用于手工记录本次变更的特殊原因说明（例如“盘点差异调整”“报损”） |
| 18 | operatorname | TEXT | YES | （待补充） |
| 19 | createtime | TIMESTAMP | YES | （待补充） |
| 20 | source_file | TEXT | YES | ETL 元数据：原始导出文件名，用于数据追溯 |
| 21 | source_endpoint | TEXT | YES | ETL 元数据：采集来源（接口/文件路径），用于数据追溯 |
| 22 | fetched_at | TIMESTAMPTZ | YES | ETL 元数据：采集/入库时间戳，用于口径对齐与增量处理 |
| 23 | payload | JSONB | NO | ETL 元数据：完整原始 JSON 记录快照，用于回溯与二次解析 |
| 24 | content_hash | TEXT | NO | ETL 元数据：对业务字段计算 SHA256，用于变更检测与去重 |

## 使用说明

```sql
-- 查询最新入库的记录
SELECT * FROM ods.goods_stock_movements
ORDER BY fetched_at DESC
LIMIT 10;
```

```sql
-- 按业务主键查询某条记录的所有版本
SELECT * FROM ods.goods_stock_movements
WHERE sitegoodsstockid = <value>
ORDER BY fetched_at DESC;
```

## ETL 元数据字段

| 字段名 | 类型 | 说明 |
|--------|------|------|
| content_hash | TEXT | 对业务字段计算 SHA256，用于变更检测与去重 |
| source_file | TEXT | 原始导出文件名，用于数据追溯 |
| source_endpoint | TEXT | 采集来源（接口/文件路径），用于数据追溯 |
| fetched_at | TIMESTAMPTZ | 采集/入库时间戳，用于口径对齐与增量处理 |
| payload | JSONB | 完整原始 JSON 记录快照，用于回溯与二次解析 |

## 可回溯性

| 项目 | 说明 |
|------|------|
| 可回溯 | ✅ 完全可回溯（保留 payload 原始 JSON） |
| 数据来源 | export/test-json-doc/goods_stock_movements.json |
