# stock_goods_category_tree 库存商品分类树

> 生成时间：2026-02-14

## 表信息

| 属性 | 值 |
|------|-----|
| Schema | ods |
| 表名 | stock_goods_category_tree |
| 主键 | id, content_hash |
| 数据来源 | export/test-json-doc/stock_goods_category_tree.json |
| 说明 | 商品分类树 |

## 字段说明

| 序号 | 字段名 | 类型 | 可空 | 说明 |
|------|--------|------|------|------|
| 1 | id | BIGINT | NO | 分类节点主键 ID（在商品分类维度中的唯一标识） |
| 2 | tenant_id | BIGINT | YES | 租户 ID（品牌/商户 ID） |
| 3 | category_name | TEXT | YES | 分类名称（实际业务分类名称） |
| 4 | alias_name | TEXT | YES | 名称字段，用于展示与辅助识别 |
| 5 | pid | BIGINT | YES | 父级分类 ID |
| 6 | business_name | TEXT | YES | 业务大类名称 |
| 7 | tenant_goods_business_id | BIGINT | YES | 业务大类 ID |
| 8 | open_salesman | INTEGER | YES | 是否启用“营业员”或“导购提成”相关的功能开关 |
| 9 | categoryboxes | JSONB | YES | （待补充） |
| 10 | sort | INTEGER | YES | 分类的排序序号，用于前端展示顺序的控制 |
| 11 | is_warehousing | INTEGER | YES | 本文件可视为“所有参与库存管理的商品分类清单”，因此均为 1 |
| 12 | source_file | TEXT | YES | ETL 元数据：原始导出文件名，用于数据追溯 |
| 13 | source_endpoint | TEXT | YES | ETL 元数据：采集来源（接口/文件路径），用于数据追溯 |
| 14 | fetched_at | TIMESTAMPTZ | YES | ETL 元数据：采集/入库时间戳，用于口径对齐与增量处理 |
| 15 | payload | JSONB | NO | ETL 元数据：完整原始 JSON 记录快照，用于回溯与二次解析 |
| 16 | content_hash | TEXT | NO | ETL 元数据：对业务字段计算 SHA256，用于变更检测与去重 |

## 使用说明

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

```sql
-- 按业务主键查询某条记录的所有版本
SELECT * FROM ods.stock_goods_category_tree
WHERE id = <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/stock_goods_category_tree.json |
