# tenant_goods_master 租户商品主表

> 生成时间：2026-02-14

## 表信息

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

## 字段说明

| 序号 | 字段名 | 类型 | 可空 | 说明 |
|------|--------|------|------|------|
| 1 | id | BIGINT | NO | 商品档案主键 ID，唯一标识一条商品 |
| 2 | tenant_id | BIGINT | YES | 租户/品牌 ID |
| 3 | goods_name | TEXT | YES | 商品名称（前台展示名称） |
| 4 | goods_bar_code | TEXT | YES | 商品条码（EAN 等），目前未维护 |
| 5 | goods_category_id | BIGINT | YES | 商品一级分类 ID |
| 6 | goods_second_category_id | BIGINT | YES | 商品二级分类 ID |
| 7 | categoryname | TEXT | YES | （待补充） |
| 8 | unit | TEXT | YES | 计量单位 |
| 9 | goods_number | TEXT | YES | 商品内部编码（自定义货号/系统货号） |
| 10 | out_goods_id | TEXT | YES | 外部系统商品 ID（对接第三方平台使用，如外卖、线上商城等） |
| 11 | goods_state | INTEGER | YES | 商品状态（上架/下架等） |
| 12 | sale_channel | INTEGER | YES | 销售渠道类型，如“门店堂食/线下零售/线上小程序”等的一种编码 |
| 13 | able_discount | INTEGER | YES | 是否允许参与折扣/打折 |
| 14 | able_site_transfer | INTEGER | YES | 布尔/开关字段，用于表示权限、可用性或状态开关 |
| 15 | is_delete | INTEGER | YES | 逻辑删除标志 |
| 16 | is_warehousing | INTEGER | YES | 是否启用库存管理 |
| 17 | isinsite | INTEGER | YES | （待补充） |
| 18 | cost_price | NUMERIC(18,4) | YES | 成本价格 |
| 19 | cost_price_type | INTEGER | YES | 金额字段，用于计费/结算/分摊等金额计算 |
| 20 | market_price | NUMERIC(18,4) | YES | 商品标价 / 售价（标准销售单价） |
| 21 | min_discount_price | NUMERIC(18,4) | YES | 该商品允许售卖的最低价格（底价） |
| 22 | common_sale_royalty | NUMERIC(18,4) | YES | 普通销售提成比例或提成金额的配置字段 |
| 23 | point_sale_royalty | NUMERIC(18,4) | YES | 积分销售提成/积分赠送规则相关配置 |
| 24 | pinyin_initial | TEXT | YES | 拼音首字母/助记码 |
| 25 | commoditycode | TEXT | YES | （待补充） |
| 26 | commodity_code | TEXT | YES | 商品编码（通常为对外商品编码或条码） |
| 27 | goods_cover | TEXT | YES | 商品封面图片 URL 地址 |
| 28 | supplier_id | BIGINT | YES | 供应商 ID，用于关联到供应商档案 |
| 29 | remark_name | TEXT | YES | 商品备注名/别名，通常用来配置简写或特殊显示名称 |
| 30 | create_time | TIMESTAMP | YES | 商品档案创建时间 |
| 31 | update_time | TIMESTAMP | YES | 商品档案最近一次修改时间 |
| 32 | payload | JSONB | NO | ETL 元数据：完整原始 JSON 记录快照，用于回溯与二次解析 |
| 33 | source_file | TEXT | YES | ETL 元数据：原始导出文件名，用于数据追溯 |
| 34 | source_endpoint | TEXT | YES | ETL 元数据：采集来源（接口/文件路径），用于数据追溯 |
| 35 | fetched_at | TIMESTAMPTZ | YES | ETL 元数据：采集/入库时间戳，用于口径对齐与增量处理 |
| 36 | content_hash | TEXT | NO | ETL 元数据：对业务字段计算 SHA256，用于变更检测与去重 |
| 37 | not_sale | INTEGER | YES | （待补充） |

## 使用说明

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

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