{
  "schema": "ods",
  "table": "goods_stock_summary",
  "columns": [
    {
      "name": "sitegoodsid",
      "data_type": "bigint",
      "is_nullable": false,
      "column_default": null,
      "comment": "【说明】门店商品 ID，本库存汇总表的主键，对应某个具体商品在本店的唯一标识。     【示例】2791953867886725（用于门店商品 ID，本库存汇总表的主键，对应某个具体商品在本店的唯一标识）。          【JSON字段】goods_stock_summary.json - $ - siteGoodsId。",
      "ordinal_position": 1
    },
    {
      "name": "goodsname",
      "data_type": "text",
      "is_nullable": true,
      "column_default": null,
      "comment": "【说明】商品名称，冗余于门店商品档案的 goods_name。     【示例】东方树叶（用于商品名称，冗余于门店商品档案的 goods_name）。          【JSON字段】goods_stock_summary.json - $ - goodsName。",
      "ordinal_position": 2
    },
    {
      "name": "goodsunit",
      "data_type": "text",
      "is_nullable": true,
      "column_default": null,
      "comment": "【说明】商品的计量单位（售卖单位）。     【示例】瓶（用于商品的计量单位（售卖单位））。          【JSON字段】goods_stock_summary.json - $ - goodsUnit。",
      "ordinal_position": 3
    },
    {
      "name": "goodscategoryid",
      "data_type": "bigint",
      "is_nullable": true,
      "column_default": null,
      "comment": "【说明】一级商品分类 ID。     【示例】2790683528350539（用于一级商品分类 ID）。          【JSON字段】goods_stock_summary.json - $ - goodsCategoryId。",
      "ordinal_position": 4
    },
    {
      "name": "goodscategorysecondid",
      "data_type": "bigint",
      "is_nullable": true,
      "column_default": null,
      "comment": "【说明】二级（次级）商品分类 ID，是 goodsCategoryId 的下级分类。     【示例】2790683528350540（用于二级（次级）商品分类 ID，是 goodsCategoryId 的下级分类）。          【JSON字段】goods_stock_summary.json - $ - goodsCategorySecondId。",
      "ordinal_position": 5
    },
    {
      "name": "categoryname",
      "data_type": "text",
      "is_nullable": true,
      "column_default": null,
      "comment": "【说明】一级分类名称，属于冗余字段，用于直接展示。     【示例】酒水（一级分类名称，属于冗余字段，用于直接展示）。          【JSON字段】goods_stock_summary.json - $ - categoryName。",
      "ordinal_position": 6
    },
    {
      "name": "rangestartstock",
      "data_type": "numeric",
      "is_nullable": true,
      "column_default": null,
      "comment": "【说明】查询区间 起始时刻 的库存数量（期初库存）。     【示例】165（用于查询区间 起始时刻 的库存数量（期初库存））。          【JSON字段】goods_stock_summary.json - $ - rangeStartStock。",
      "ordinal_position": 7
    },
    {
      "name": "rangeendstock",
      "data_type": "numeric",
      "is_nullable": true,
      "column_default": null,
      "comment": "【说明】查询区间 结束时刻 的库存数量（期末库存）。     【示例】118（用于查询区间 结束时刻 的库存数量（期末库存））。          【JSON字段】goods_stock_summary.json - $ - rangeEndStock。",
      "ordinal_position": 8
    },
    {
      "name": "rangein",
      "data_type": "numeric",
      "is_nullable": true,
      "column_default": null,
      "comment": "【说明】查询区间内的 入库数量汇总（正值），包括采购入库、调拨入库等。     【示例】450（用于查询区间内的 入库数量汇总（正值），包括采购入库、调拨入库等）。          【JSON字段】goods_stock_summary.json - $ - rangeIn。",
      "ordinal_position": 9
    },
    {
      "name": "rangeout",
      "data_type": "numeric",
      "is_nullable": true,
      "column_default": null,
      "comment": "【说明】查询区间内的 出库数量汇总，以 负数 表示从库存扣减（出库/销售）。     【示例】-497（用于查询区间内的 出库数量汇总，以 负数 表示从库存扣减（出库/销售））。          【JSON字段】goods_stock_summary.json - $ - rangeOut。",
      "ordinal_position": 10
    },
    {
      "name": "rangesale",
      "data_type": "numeric",
      "is_nullable": true,
      "column_default": null,
      "comment": "【说明】查询区间内，该商品的 销售数量汇总（售出多少“包/瓶/份”等）。     【示例】488（用于查询区间内，该商品的 销售数量汇总（售出多少“包/瓶/份”等））。          【JSON字段】goods_stock_summary.json - $ - rangeSale。",
      "ordinal_position": 11
    },
    {
      "name": "rangesalemoney",
      "data_type": "numeric",
      "is_nullable": true,
      "column_default": null,
      "comment": "【说明】查询区间内，该商品销售的 金额小计（按商品维度汇总）。     【示例】3904.0（用于查询区间内，该商品销售的 金额小计（按商品维度汇总））。          【JSON字段】goods_stock_summary.json - $ - rangeSaleMoney。",
      "ordinal_position": 12
    },
    {
      "name": "rangeinventory",
      "data_type": "numeric",
      "is_nullable": true,
      "column_default": null,
      "comment": "【说明】查询区间内的 盘点调整净变动量（盘盈–盘亏）。     【示例】0（用于查询区间内的 盘点调整净变动量（盘盈–盘亏））。          【JSON字段】goods_stock_summary.json - $ - rangeInventory。",
      "ordinal_position": 13
    },
    {
      "name": "currentstock",
      "data_type": "numeric",
      "is_nullable": true,
      "column_default": null,
      "comment": "【说明】导出时刻的实时库存数量。     【示例】118（用于导出时刻的实时库存数量）。          【JSON字段】goods_stock_summary.json - $ - currentStock。",
      "ordinal_position": 14
    },
    {
      "name": "content_hash",
      "data_type": "text",
      "is_nullable": false,
      "column_default": null,
      "comment": null,
      "ordinal_position": 15
    },
    {
      "name": "source_file",
      "data_type": "text",
      "is_nullable": true,
      "column_default": null,
      "comment": "【说明】ETL 元数据：原始导出文件名，用于数据追溯。     【示例】goods_stock_summary.json（ETL 元数据：原始导出文件名，用于数据追溯）。          【JSON字段】goods_stock_summary.json - ETL元数据 - 无。",
      "ordinal_position": 16
    },
    {
      "name": "source_endpoint",
      "data_type": "text",
      "is_nullable": true,
      "column_default": null,
      "comment": "【说明】ETL 元数据：采集来源（接口/文件路径），用于数据追溯。     【示例】export/test-json-doc/goods_stock_summary.json（ETL 元数据：采集来源（接口/文件路径），用于数据追溯）。          【JSON字段】goods_stock_summary.json - ETL元数据 - 无。",
      "ordinal_position": 17
    },
    {
      "name": "fetched_at",
      "data_type": "timestamp with time zone",
      "is_nullable": true,
      "column_default": "now()",
      "comment": "【说明】ETL 元数据：采集/入库时间戳，用于口径对齐与增量处理。     【示例】2025-11-10T00:00:00+08:00（ETL 元数据：采集/入库时间戳，用于口径对齐与增量处理）。          【JSON字段】goods_stock_summary.json - ETL元数据 - 无。",
      "ordinal_position": 18
    },
    {
      "name": "payload",
      "data_type": "jsonb",
      "is_nullable": false,
      "column_default": null,
      "comment": "【说明】完整原始 JSON 记录快照，用于回溯与二次解析。     【示例】{...}（完整原始 JSON 记录快照，用于回溯与二次解析）。          【JSON字段】goods_stock_summary.json - $ - $。",
      "ordinal_position": 19
    }
  ]
}