1010 lines
61 KiB
Python
1010 lines
61 KiB
Python
"""
|
||
生成字段补全复核文档：ODS + DWD 现有字段 + 待新增字段
|
||
输出到 FIELD_AUDIT_ROOT 目录
|
||
"""
|
||
import os
|
||
import sys
|
||
from pathlib import Path
|
||
|
||
# 加载 .env
|
||
sys.path.insert(0, str(Path(__file__).resolve().parent))
|
||
from _env_paths import get_output_path
|
||
|
||
output_dir = get_output_path("FIELD_AUDIT_ROOT")
|
||
output_file = os.path.join(output_dir, "field_review_for_user.md")
|
||
|
||
# ── 数据定义 ──────────────────────────────────────────────────────────
|
||
|
||
# 每张表: { ods_table, dwd_tables: [{name, columns: [(col, type, desc)]}], new_fields: [(col, type, target_table, desc, action)] }
|
||
TABLES = [
|
||
# ═══════════════════════════════════════════════════════════════════
|
||
# 1. assistant_accounts_master → dim_assistant + dim_assistant_ex
|
||
# ═══════════════════════════════════════════════════════════════════
|
||
{
|
||
"title": "1. assistant_accounts_master（助教账号档案）",
|
||
"ods_table": "ods.assistant_accounts_master",
|
||
"ods_columns": [
|
||
("id", "bigint", "PK，助教 ID"),
|
||
("tenant_id", "bigint", "租户 ID"),
|
||
("site_id", "bigint", "门店 ID"),
|
||
("assistant_no", "text", "助教编号"),
|
||
("nickname", "text", "昵称"),
|
||
("real_name", "text", "真实姓名"),
|
||
("mobile", "text", "手机号"),
|
||
("team_id", "bigint", "团队 ID"),
|
||
("team_name", "text", "团队名称"),
|
||
("user_id", "bigint", "用户 ID"),
|
||
("level", "text", "等级"),
|
||
("assistant_status", "integer", "助教状态"),
|
||
("work_status", "integer", "工作状态"),
|
||
("leave_status", "integer", "请假状态"),
|
||
("entry_time", "timestamp", "入职时间"),
|
||
("resign_time", "timestamp", "离职时间"),
|
||
("start_time", "timestamp", "排班开始"),
|
||
("end_time", "timestamp", "排班结束"),
|
||
("create_time", "timestamp", "创建时间"),
|
||
("update_time", "timestamp", "更新时间"),
|
||
("order_trade_no", "text", "订单交易号"),
|
||
("staff_id", "bigint", "员工 ID"),
|
||
("staff_profile_id", "bigint", "员工档案 ID"),
|
||
("system_role_id", "bigint", "系统角色 ID"),
|
||
("avatar", "text", "头像 URL"),
|
||
("birth_date", "timestamp", "出生日期"),
|
||
("gender", "integer", "性别"),
|
||
("height", "numeric(18,2)", "身高"),
|
||
("weight", "numeric(18,2)", "体重"),
|
||
("job_num", "text", "备用工号"),
|
||
("show_status", "integer", "展示状态"),
|
||
("show_sort", "integer", "展示排序"),
|
||
("sum_grade", "numeric(18,2)", "总评分"),
|
||
("assistant_grade", "numeric(18,2)", "助教评分"),
|
||
("get_grade_times", "integer", "被评次数"),
|
||
("introduce", "text", "个人介绍"),
|
||
("video_introduction_url", "text", "视频介绍 URL"),
|
||
("group_id", "bigint", "分组 ID"),
|
||
("group_name", "text", "分组名称"),
|
||
("shop_name", "text", "门店名称快照"),
|
||
("charge_way", "integer", "计费方式"),
|
||
("entry_type", "integer", "入职类型"),
|
||
("allow_cx", "integer", "允许促销"),
|
||
("is_guaranteed", "integer", "是否保底"),
|
||
("salary_grant_enabled", "integer", "工资发放启用"),
|
||
("light_status", "integer", "灯控状态"),
|
||
("online_status", "integer", "在线状态"),
|
||
("is_delete", "integer", "删除标记"),
|
||
("cx_unit_price", "numeric(18,2)", "促销时段单价"),
|
||
("pd_unit_price", "numeric(18,2)", "普通时段单价"),
|
||
("last_table_id", "bigint", "最后台桌 ID"),
|
||
("last_table_name", "text", "最后台桌名"),
|
||
("person_org_id", "bigint", "人事组织 ID"),
|
||
("serial_number", "bigint", "序列号"),
|
||
("is_team_leader", "integer", "是否组长"),
|
||
("criticism_status", "integer", "批评状态"),
|
||
("last_update_name", "text", "最后更新人"),
|
||
("ding_talk_synced", "integer", "钉钉同步"),
|
||
("site_light_cfg_id", "bigint", "灯控配置 ID"),
|
||
("light_equipment_id", "text", "灯控设备 ID"),
|
||
("entry_sign_status", "integer", "入职签约状态"),
|
||
("resign_sign_status", "integer", "离职签约状态"),
|
||
],
|
||
"dwd_tables": [
|
||
{
|
||
"name": "dwd.dim_assistant（主表）",
|
||
"columns": [
|
||
("assistant_id", "bigint", "PK"),
|
||
("user_id", "bigint", "用户 ID"),
|
||
("assistant_no", "text", "助教编号"),
|
||
("real_name", "text", "真实姓名"),
|
||
("nickname", "text", "昵称"),
|
||
("mobile", "text", "手机号"),
|
||
("tenant_id", "bigint", "租户 ID"),
|
||
("site_id", "bigint", "门店 ID"),
|
||
("team_id", "bigint", "团队 ID"),
|
||
("team_name", "text", "团队名称"),
|
||
("level", "integer", "等级"),
|
||
("entry_time", "timestamptz", "入职时间"),
|
||
("resign_time", "timestamptz", "离职时间"),
|
||
("leave_status", "integer", "请假状态"),
|
||
("assistant_status", "integer", "助教状态"),
|
||
("scd2_start_time", "timestamptz", "SCD2 开始"),
|
||
("scd2_end_time", "timestamptz", "SCD2 结束"),
|
||
("scd2_is_current", "integer", "SCD2 当前"),
|
||
("scd2_version", "integer", "SCD2 版本"),
|
||
],
|
||
},
|
||
{
|
||
"name": "dwd.dim_assistant_ex（扩展表）",
|
||
"columns": [
|
||
("assistant_id", "bigint", "PK"),
|
||
("gender", "integer", "性别"),
|
||
("birth_date", "timestamptz", "出生日期"),
|
||
("avatar", "text", "头像"),
|
||
("introduce", "text", "介绍"),
|
||
("video_introduction_url", "text", "视频介绍"),
|
||
("height", "numeric(5,2)", "身高"),
|
||
("weight", "numeric(5,2)", "体重"),
|
||
("shop_name", "text", "门店名"),
|
||
("group_id", "bigint", "分组 ID"),
|
||
("group_name", "text", "分组名"),
|
||
("person_org_id", "bigint", "人事组织 ID"),
|
||
("staff_id", "bigint", "员工 ID"),
|
||
("staff_profile_id", "bigint", "员工档案 ID"),
|
||
("assistant_grade", "double", "助教评分"),
|
||
("sum_grade", "double", "总评分"),
|
||
("get_grade_times", "integer", "被评次数"),
|
||
("charge_way", "integer", "计费方式"),
|
||
("allow_cx", "integer", "允许促销"),
|
||
("is_guaranteed", "integer", "是否保底"),
|
||
("salary_grant_enabled", "integer", "工资发放"),
|
||
("entry_type", "integer", "入职类型"),
|
||
("entry_sign_status", "integer", "入职签约"),
|
||
("resign_sign_status", "integer", "离职签约"),
|
||
("work_status", "integer", "工作状态"),
|
||
("show_status", "integer", "展示状态"),
|
||
("show_sort", "integer", "展示排序"),
|
||
("online_status", "integer", "在线状态"),
|
||
("is_delete", "integer", "删除标记"),
|
||
("criticism_status", "integer", "批评状态"),
|
||
("create_time", "timestamptz", "创建时间"),
|
||
("update_time", "timestamptz", "更新时间"),
|
||
("start_time", "timestamptz", "排班开始"),
|
||
("end_time", "timestamptz", "排班结束"),
|
||
("last_table_id", "bigint", "最后台桌 ID"),
|
||
("last_table_name", "text", "最后台桌名"),
|
||
("last_update_name", "text", "最后更新人"),
|
||
("order_trade_no", "bigint", "订单交易号"),
|
||
("ding_talk_synced", "integer", "钉钉同步"),
|
||
("site_light_cfg_id", "bigint", "灯控配置 ID"),
|
||
("light_equipment_id", "text", "灯控设备 ID"),
|
||
("light_status", "integer", "灯控状态"),
|
||
("is_team_leader", "integer", "是否组长"),
|
||
("serial_number", "bigint", "序列号"),
|
||
("scd2_*", "", "SCD2 四列"),
|
||
],
|
||
},
|
||
],
|
||
"new_fields": [
|
||
("system_role_id", "bigint", "dim_assistant_ex", "系统角色 ID，关联角色权限。采样值: 10", "新增 DWD 列 + FACT_MAPPINGS"),
|
||
("job_num", "text", "dim_assistant_ex", "备用工号。采样值: 全部 NULL（未启用）", "新增 DWD 列 + FACT_MAPPINGS"),
|
||
("cx_unit_price", "numeric(18,2)", "dim_assistant_ex", "促销时段单价。采样值: 0.00", "新增 DWD 列 + FACT_MAPPINGS"),
|
||
("pd_unit_price", "numeric(18,2)", "dim_assistant_ex", "普通时段单价。采样值: 0.00", "新增 DWD 列 + FACT_MAPPINGS"),
|
||
],
|
||
"skipped_fields": [],
|
||
},
|
||
|
||
# ═══════════════════════════════════════════════════════════════════
|
||
# 2. assistant_service_records → dwd_assistant_service_log + _ex
|
||
# ═══════════════════════════════════════════════════════════════════
|
||
{
|
||
"title": "2. assistant_service_records（助教服务流水）",
|
||
"ods_table": "ods.assistant_service_records",
|
||
"ods_columns": [
|
||
("id", "bigint", "PK，服务记录 ID"),
|
||
("tenant_id", "bigint", "租户 ID"),
|
||
("site_id", "bigint", "门店 ID"),
|
||
("siteprofile", "jsonb", "门店信息 JSON"),
|
||
("site_table_id", "bigint", "台桌 ID"),
|
||
("order_settle_id", "bigint", "结算单 ID"),
|
||
("order_trade_no", "text", "订单交易号"),
|
||
("order_pay_id", "bigint", "支付单 ID"),
|
||
("order_assistant_id", "bigint", "订单助教 ID"),
|
||
("order_assistant_type", "integer", "助教类型"),
|
||
("assistantname", "text", "助教名称"),
|
||
("assistantno", "text", "助教编号"),
|
||
("assistant_level", "text", "助教等级"),
|
||
("levelname", "text", "等级名称"),
|
||
("site_assistant_id", "bigint", "门店助教档案 ID"),
|
||
("skill_id", "bigint", "技能 ID"),
|
||
("skillname", "text", "技能名称"),
|
||
("system_member_id", "bigint", "系统会员 ID"),
|
||
("tablename", "text", "台桌名称"),
|
||
("tenant_member_id", "bigint", "租户会员 ID"),
|
||
("user_id", "bigint", "用户 ID"),
|
||
("assistant_team_id", "bigint", "助教团队 ID"),
|
||
("nickname", "text", "昵称"),
|
||
("ledger_name", "text", "台账名称"),
|
||
("ledger_group_name", "text", "台账组名"),
|
||
("ledger_amount", "numeric(18,2)", "台账金额"),
|
||
("ledger_count", "numeric(18,4)", "台账数量"),
|
||
("ledger_unit_price", "numeric(18,4)", "台账单价"),
|
||
("ledger_status", "integer", "台账状态"),
|
||
("ledger_start_time", "timestamp", "台账开始"),
|
||
("ledger_end_time", "timestamp", "台账结束"),
|
||
("manual_discount_amount", "numeric(18,2)", "手动折扣"),
|
||
("member_discount_amount", "numeric(18,2)", "会员折扣"),
|
||
("coupon_deduct_money", "numeric(18,2)", "券抵扣"),
|
||
("service_money", "numeric(18,2)", "服务费"),
|
||
("projected_income", "numeric(18,2)", "预计收入"),
|
||
("real_use_seconds", "integer", "实际使用秒数"),
|
||
("income_seconds", "integer", "计费秒数"),
|
||
("start_use_time", "timestamp", "开始使用时间"),
|
||
("last_use_time", "timestamp", "最后使用时间"),
|
||
("create_time", "timestamp", "创建时间"),
|
||
("is_single_order", "integer", "是否单点"),
|
||
("is_delete", "integer", "删除标记"),
|
||
("is_trash", "integer", "废除标记"),
|
||
("trash_reason", "text", "废除原因"),
|
||
("trash_applicant_id", "bigint", "废除申请人 ID"),
|
||
("trash_applicant_name", "text", "废除申请人"),
|
||
("operator_id", "bigint", "操作员 ID"),
|
||
("operator_name", "text", "操作员名称"),
|
||
("salesman_name", "text", "销售员名称"),
|
||
("salesman_org_id", "bigint", "销售组织 ID"),
|
||
("salesman_user_id", "bigint", "销售员用户 ID"),
|
||
("person_org_id", "bigint", "人事组织 ID"),
|
||
("add_clock", "integer", "加钟次数"),
|
||
("returns_clock", "integer", "退钟次数"),
|
||
("composite_grade", "numeric(10,2)", "综合评分"),
|
||
("composite_grade_time", "timestamp", "评分时间"),
|
||
("skill_grade", "numeric(10,2)", "技能评分"),
|
||
("service_grade", "numeric(10,2)", "服务评分"),
|
||
("sum_grade", "numeric(10,2)", "总评分"),
|
||
("grade_status", "integer", "评分状态"),
|
||
("get_grade_times", "integer", "被评次数"),
|
||
("is_not_responding", "integer", "未响应"),
|
||
("is_confirm", "integer", "已确认"),
|
||
("assistantteamname", "text", "助教团队名"),
|
||
("real_service_money", "numeric(18,2)", "实际服务费"),
|
||
],
|
||
"dwd_tables": [
|
||
{
|
||
"name": "dwd.dwd_assistant_service_log（主表）",
|
||
"columns": [
|
||
("assistant_service_id", "bigint", "PK"),
|
||
("order_trade_no", "bigint", "订单交易号"),
|
||
("order_settle_id", "bigint", "结算单 ID"),
|
||
("order_pay_id", "bigint", "支付单 ID"),
|
||
("order_assistant_id", "bigint", "订单助教 ID"),
|
||
("order_assistant_type", "integer", "助教类型"),
|
||
("tenant_id", "bigint", "租户 ID"),
|
||
("site_id", "bigint", "门店 ID"),
|
||
("site_table_id", "bigint", "台桌 ID"),
|
||
("tenant_member_id", "bigint", "租户会员 ID"),
|
||
("system_member_id", "bigint", "系统会员 ID"),
|
||
("assistant_no", "varchar(64)", "助教编号"),
|
||
("nickname", "varchar(64)", "昵称"),
|
||
("site_assistant_id", "bigint", "门店助教 ID（映射自 order_assistant_id）"),
|
||
("user_id", "bigint", "用户 ID"),
|
||
("assistant_team_id", "bigint", "团队 ID"),
|
||
("person_org_id", "bigint", "人事组织 ID"),
|
||
("assistant_level", "integer", "等级"),
|
||
("level_name", "varchar(64)", "等级名称"),
|
||
("skill_id", "bigint", "技能 ID"),
|
||
("skill_name", "varchar(64)", "技能名称"),
|
||
("ledger_unit_price", "numeric(10,2)", "台账单价"),
|
||
("ledger_amount", "numeric(10,2)", "台账金额"),
|
||
("projected_income", "numeric(10,2)", "预计收入"),
|
||
("coupon_deduct_money", "numeric(10,2)", "券抵扣"),
|
||
("income_seconds", "integer", "计费秒数"),
|
||
("real_use_seconds", "integer", "实际秒数"),
|
||
("add_clock", "integer", "加钟"),
|
||
("create_time", "timestamptz", "创建时间"),
|
||
("start_use_time", "timestamptz", "开始时间"),
|
||
("last_use_time", "timestamptz", "结束时间"),
|
||
("is_delete", "integer", "删除标记"),
|
||
("real_service_money", "numeric(18,2)", "实际服务费"),
|
||
],
|
||
},
|
||
{
|
||
"name": "dwd.dwd_assistant_service_log_ex（扩展表）",
|
||
"columns": [
|
||
("assistant_service_id", "bigint", "PK"),
|
||
("table_name", "varchar(64)", "台桌名"),
|
||
("assistant_name", "varchar(64)", "助教名"),
|
||
("ledger_name", "varchar(128)", "台账名"),
|
||
("ledger_group_name", "varchar(128)", "台账组名"),
|
||
("ledger_count", "integer", "台账数量"),
|
||
("member_discount_amount", "numeric(10,2)", "会员折扣"),
|
||
("manual_discount_amount", "numeric(10,2)", "手动折扣"),
|
||
("service_money", "numeric(10,2)", "服务费"),
|
||
("returns_clock", "integer", "退钟"),
|
||
("ledger_start_time", "timestamptz", "台账开始"),
|
||
("ledger_end_time", "timestamptz", "台账结束"),
|
||
("ledger_status", "integer", "台账状态"),
|
||
("is_confirm", "integer", "已确认"),
|
||
("is_single_order", "integer", "单点"),
|
||
("is_not_responding", "integer", "未响应"),
|
||
("is_trash", "integer", "废除"),
|
||
("trash_applicant_id", "bigint", "废除申请人 ID"),
|
||
("trash_applicant_name", "varchar(64)", "废除申请人"),
|
||
("trash_reason", "varchar(255)", "废除原因"),
|
||
("salesman_user_id", "bigint", "销售员 ID"),
|
||
("salesman_name", "varchar(64)", "销售员名"),
|
||
("salesman_org_id", "bigint", "销售组织 ID"),
|
||
("skill_grade", "integer", "技能评分"),
|
||
("service_grade", "integer", "服务评分"),
|
||
("composite_grade", "numeric(5,2)", "综合评分"),
|
||
("sum_grade", "numeric(10,2)", "总评分"),
|
||
("get_grade_times", "integer", "被评次数"),
|
||
("grade_status", "integer", "评分状态"),
|
||
("composite_grade_time", "timestamptz", "评分时间"),
|
||
("assistant_team_name", "text", "团队名"),
|
||
],
|
||
},
|
||
],
|
||
"new_fields": [
|
||
("operator_id", "bigint", "dwd_assistant_service_log_ex", "操作员 ID（如收银员）。采样值: 2790687322443013", "新增 DWD 列 + FACT_MAPPINGS"),
|
||
("operator_name", "text", "dwd_assistant_service_log_ex", "操作员名称。采样值: 收银员:郑丽珊", "新增 DWD 列 + FACT_MAPPINGS"),
|
||
],
|
||
"skipped_fields": [
|
||
("site_assistant_id", "已通过 FACT_MAPPINGS 映射（ODS order_assistant_id → DWD site_assistant_id），无需变更"),
|
||
],
|
||
},
|
||
# ═══════════════════════════════════════════════════════════════════
|
||
# 4. store_goods_sales_records → dwd_store_goods_sale + _ex
|
||
# ═══════════════════════════════════════════════════════════════════
|
||
{
|
||
"title": "4. store_goods_sales_records（门店商品销售流水）",
|
||
"ods_table": "ods.store_goods_sales_records",
|
||
"ods_columns": [
|
||
("id", "bigint", "PK"),
|
||
("tenant_id", "bigint", "租户 ID"),
|
||
("site_id", "bigint", "门店 ID"),
|
||
("siteid", "bigint", "门店 ID（冗余）"),
|
||
("sitename", "text", "门店名"),
|
||
("site_goods_id", "bigint", "门店商品 ID"),
|
||
("tenant_goods_id", "bigint", "租户商品 ID"),
|
||
("order_settle_id", "bigint", "结算单 ID"),
|
||
("order_trade_no", "text", "订单交易号"),
|
||
("order_goods_id", "bigint", "订单商品 ID"),
|
||
("ordergoodsid", "bigint", "订单商品 ID（冗余）"),
|
||
("order_pay_id", "bigint", "支付单 ID"),
|
||
("order_coupon_id", "bigint", "订单券 ID"),
|
||
("ledger_name", "text", "台账名"),
|
||
("ledger_group_name", "text", "台账组名"),
|
||
("ledger_amount", "numeric(18,2)", "台账金额"),
|
||
("ledger_count", "numeric(18,4)", "台账数量"),
|
||
("ledger_unit_price", "numeric(18,4)", "台账单价"),
|
||
("ledger_status", "integer", "台账状态"),
|
||
("discount_money", "numeric(18,2)", "折扣金额"),
|
||
("discount_price", "numeric(18,2)", "折后单价"),
|
||
("coupon_deduct_money", "numeric(18,2)", "券抵扣"),
|
||
("member_discount_amount", "numeric(18,2)", "会员折扣"),
|
||
("option_coupon_deduct_money", "numeric(18,2)", "选项券抵扣"),
|
||
("option_member_discount_money", "numeric(18,2)", "选项会员折扣"),
|
||
("point_discount_money", "numeric(18,2)", "积分抵扣"),
|
||
("point_discount_money_cost", "numeric(18,2)", "积分抵扣成本"),
|
||
("real_goods_money", "numeric(18,2)", "实际商品金额"),
|
||
("cost_money", "numeric(18,2)", "成本金额"),
|
||
("push_money", "numeric(18,2)", "推送费"),
|
||
("sales_type", "integer", "销售类型"),
|
||
("is_single_order", "integer", "单点"),
|
||
("is_delete", "integer", "删除标记"),
|
||
("goods_remark", "text", "商品备注"),
|
||
("option_price", "numeric(18,2)", "选项价格"),
|
||
("option_value_name", "text", "选项值名"),
|
||
("member_coupon_id", "bigint", "会员券 ID"),
|
||
("package_coupon_id", "bigint", "套餐券 ID"),
|
||
("sales_man_org_id", "bigint", "销售组织 ID"),
|
||
("salesman_name", "text", "销售员名"),
|
||
("salesman_role_id", "bigint", "销售角色 ID"),
|
||
("salesman_user_id", "bigint", "销售员 ID"),
|
||
("operator_id", "bigint", "操作员 ID"),
|
||
("operator_name", "text", "操作员名"),
|
||
("opensalesman", "text", "开单销售"),
|
||
("returns_number", "integer", "退货数量"),
|
||
("site_table_id", "bigint", "台桌 ID"),
|
||
("tenant_goods_business_id", "bigint", "商品业务 ID"),
|
||
("tenant_goods_category_id", "bigint", "商品分类 ID"),
|
||
("create_time", "timestamp", "创建时间"),
|
||
("coupon_share_money", "numeric(18,2)", "券分摊金额"),
|
||
],
|
||
"dwd_tables": [
|
||
{"name": "dwd.dwd_store_goods_sale（主表）", "columns": [
|
||
("store_goods_sale_id", "bigint", "PK"),
|
||
("order_trade_no / order_settle_id / order_pay_id / order_goods_id", "", "订单关联 ID"),
|
||
("site_id / tenant_id / site_goods_id / tenant_goods_id", "", "门店/商品 ID"),
|
||
("tenant_goods_category_id / tenant_goods_business_id / site_table_id", "", "分类/台桌"),
|
||
("ledger_name / ledger_group_name / ledger_unit_price / ledger_count / ledger_amount", "", "台账信息"),
|
||
("discount_price", "numeric(18,2)", "⚠️ 实际映射自 ODS discount_money（折扣金额），非折后单价"),
|
||
("real_goods_money / cost_money / coupon_share_money", "", "金额字段"),
|
||
("ledger_status / is_delete / create_time", "", "状态/时间"),
|
||
]},
|
||
{"name": "dwd.dwd_store_goods_sale_ex（扩展表）", "columns": [
|
||
("store_goods_sale_id", "bigint", "PK"),
|
||
("legacy_order_goods_id / site_name / legacy_site_id", "", "快照"),
|
||
("goods_remark / option_value_name / operator_name", "", "备注/操作员"),
|
||
("open_salesman_flag / salesman_user_id / salesman_name / salesman_role_id / salesman_org_id", "", "销售员"),
|
||
("discount_money / returns_number / coupon_deduct_money / member_discount_amount", "", "折扣"),
|
||
("point_discount_money / point_discount_money_cost", "", "积分"),
|
||
("package_coupon_id / order_coupon_id / member_coupon_id", "", "券 ID"),
|
||
("option_price / option_member_discount_money / option_coupon_deduct_money", "", "选项"),
|
||
("push_money / is_single_order / sales_type / operator_id", "", "其他"),
|
||
]},
|
||
],
|
||
"new_fields": [],
|
||
"skipped_fields": [
|
||
("discount_price", "DWD discount_price 列名已被占用（映射自 ODS discount_money）。ODS discount_price（折后单价）未映射。如需可后续新增 unit_discount_price"),
|
||
],
|
||
},
|
||
|
||
# ═══════════════════════════════════════════════════════════════════
|
||
# 5. member_balance_changes → dwd_member_balance_change + _ex
|
||
# ═══════════════════════════════════════════════════════════════════
|
||
{
|
||
"title": "5. member_balance_changes（会员余额变动）",
|
||
"ods_table": "ods.member_balance_changes",
|
||
"ods_columns": [
|
||
("id", "bigint", "PK"),
|
||
("tenant_id", "bigint", "租户 ID"),
|
||
("site_id", "bigint", "门店 ID"),
|
||
("register_site_id", "bigint", "注册门店 ID"),
|
||
("registersitename", "text", "注册门店名"),
|
||
("paysitename", "text", "支付门店名"),
|
||
("tenant_member_id", "bigint", "租户会员 ID"),
|
||
("tenant_member_card_id", "bigint", "会员卡 ID"),
|
||
("system_member_id", "bigint", "系统会员 ID"),
|
||
("membername", "text", "会员名"),
|
||
("membermobile", "text", "会员手机"),
|
||
("card_type_id", "bigint", "卡类型 ID"),
|
||
("membercardtypename", "text", "卡类型名"),
|
||
("account_data", "numeric(18,2)", "变动金额"),
|
||
("before", "numeric(18,2)", "变动前余额"),
|
||
("after", "numeric(18,2)", "变动后余额"),
|
||
("refund_amount", "numeric(18,2)", "退款金额"),
|
||
("from_type", "integer", "来源类型"),
|
||
("payment_method", "integer", "支付方式"),
|
||
("relate_id", "bigint", "关联 ID（充值/订单）"),
|
||
("remark", "text", "备注"),
|
||
("operator_id", "bigint", "操作员 ID"),
|
||
("operator_name", "text", "操作员名"),
|
||
("is_delete", "integer", "删除标记"),
|
||
("create_time", "timestamp", "创建时间"),
|
||
("principal_after", "numeric(18,2)", "本金变动后"),
|
||
("principal_before", "numeric(18,2)", "本金变动前"),
|
||
("principal_data", "text", "本金变动数据"),
|
||
],
|
||
"dwd_tables": [
|
||
{"name": "dwd.dwd_member_balance_change（主表）", "columns": [
|
||
("balance_change_id", "bigint", "PK"),
|
||
("tenant_id", "bigint", "租户 ID"),
|
||
("site_id", "bigint", "门店 ID"),
|
||
("register_site_id", "bigint", "注册门店 ID"),
|
||
("tenant_member_id", "bigint", "租户会员 ID"),
|
||
("system_member_id", "bigint", "系统会员 ID"),
|
||
("tenant_member_card_id", "bigint", "会员卡 ID"),
|
||
("card_type_id", "bigint", "卡类型 ID"),
|
||
("card_type_name", "varchar", "卡类型名"),
|
||
("member_name", "varchar", "会员名"),
|
||
("member_mobile", "varchar", "会员手机"),
|
||
("balance_before", "numeric(18,2)", "变动前余额"),
|
||
("change_amount", "numeric(18,2)", "变动金额"),
|
||
("balance_after", "numeric(18,2)", "变动后余额"),
|
||
("from_type", "integer", "来源类型"),
|
||
("payment_method", "integer", "支付方式"),
|
||
("change_time", "timestamptz", "变动时间"),
|
||
("is_delete", "integer", "删除标记"),
|
||
("remark", "varchar", "备注"),
|
||
("principal_before", "numeric(18,2)", "本金变动前"),
|
||
("principal_after", "numeric(18,2)", "本金变动后"),
|
||
("principal_change_amount", "numeric(18,2)", "本金变动额"),
|
||
]},
|
||
{"name": "dwd.dwd_member_balance_change_ex（扩展表）", "columns": [
|
||
("balance_change_id", "bigint", "PK"),
|
||
("pay_site_name", "varchar", "支付门店名"),
|
||
("register_site_name", "varchar", "注册门店名"),
|
||
("refund_amount", "numeric(18,2)", "退款金额"),
|
||
("operator_id", "bigint", "操作员 ID"),
|
||
("operator_name", "varchar", "操作员名"),
|
||
("principal_data", "text", "本金变动数据"),
|
||
]},
|
||
],
|
||
"new_fields": [
|
||
("relate_id", "bigint", "dwd_member_balance_change_ex", "关联 ID（充值记录/订单 ID）。采样值: 2993181992014533, 0, 2888539288521221", "新增 DWD 列 + FACT_MAPPINGS"),
|
||
],
|
||
"skipped_fields": [],
|
||
},
|
||
|
||
# ═══════════════════════════════════════════════════════════════════
|
||
# 6. tenant_goods_master → dim_tenant_goods + _ex
|
||
# ═══════════════════════════════════════════════════════════════════
|
||
{
|
||
"title": "6. tenant_goods_master（租户商品档案）",
|
||
"ods_table": "ods.tenant_goods_master",
|
||
"ods_columns": [
|
||
("id", "bigint", "PK"),
|
||
("tenant_id", "bigint", "租户 ID"),
|
||
("goods_name", "text", "商品名"),
|
||
("goods_bar_code", "text", "条码"),
|
||
("goods_category_id", "bigint", "一级分类 ID"),
|
||
("goods_second_category_id", "bigint", "二级分类 ID"),
|
||
("categoryname", "text", "分类名"),
|
||
("unit", "text", "单位"),
|
||
("goods_number", "text", "商品编号"),
|
||
("out_goods_id", "text", "外部商品 ID"),
|
||
("goods_state", "integer", "商品状态"),
|
||
("sale_channel", "integer", "销售渠道"),
|
||
("able_discount", "integer", "可折扣"),
|
||
("able_site_transfer", "integer", "可门店调拨"),
|
||
("is_delete", "integer", "删除标记"),
|
||
("is_warehousing", "integer", "是否入库"),
|
||
("isinsite", "integer", "是否在门店"),
|
||
("cost_price", "numeric(18,4)", "成本价"),
|
||
("cost_price_type", "integer", "成本价类型"),
|
||
("market_price", "numeric(18,4)", "市场价"),
|
||
("min_discount_price", "numeric(18,4)", "最低折扣价"),
|
||
("common_sale_royalty", "numeric(18,4)", "普通销售提成"),
|
||
("point_sale_royalty", "numeric(18,4)", "积分销售提成"),
|
||
("pinyin_initial", "text", "拼音首字母"),
|
||
("commoditycode", "text", "商品编码集合（花括号包裹）"),
|
||
("commodity_code", "text", "商品编码（单个）"),
|
||
("goods_cover", "text", "商品封面"),
|
||
("supplier_id", "bigint", "供应商 ID"),
|
||
("remark_name", "text", "备注名"),
|
||
("create_time", "timestamp", "创建时间"),
|
||
("update_time", "timestamp", "更新时间"),
|
||
("not_sale", "integer", "禁售标记"),
|
||
],
|
||
"dwd_tables": [
|
||
{"name": "dwd.dim_tenant_goods（主表）", "columns": [
|
||
("tenant_goods_id", "bigint", "PK"),
|
||
("tenant_id", "bigint", "租户 ID"),
|
||
("supplier_id", "bigint", "供应商 ID"),
|
||
("category_name", "varchar", "分类名"),
|
||
("goods_category_id", "bigint", "一级分类 ID"),
|
||
("goods_second_category_id", "bigint", "二级分类 ID"),
|
||
("goods_name", "varchar", "商品名"),
|
||
("goods_number", "varchar", "商品编号"),
|
||
("unit", "varchar", "单位"),
|
||
("market_price", "numeric(18,2)", "市场价"),
|
||
("goods_state", "integer", "商品状态"),
|
||
("create_time", "timestamptz", "创建时间"),
|
||
("update_time", "timestamptz", "更新时间"),
|
||
("is_delete", "integer", "删除标记"),
|
||
("not_sale", "integer", "禁售标记"),
|
||
("scd2_*", "", "SCD2 四列"),
|
||
]},
|
||
{"name": "dwd.dim_tenant_goods_ex（扩展表）", "columns": [
|
||
("tenant_goods_id", "bigint", "PK"),
|
||
("remark_name", "varchar", "备注名"),
|
||
("pinyin_initial", "varchar", "拼音首字母"),
|
||
("goods_cover", "varchar", "商品封面"),
|
||
("goods_bar_code", "varchar", "条码"),
|
||
("commodity_code", "varchar", "商品编码（自动映射）"),
|
||
("commodity_code_list", "TEXT[]", "商品编码数组（FACT_MAPPINGS 映射自 ODS commoditycode，CAST TEXT[]）"),
|
||
("min_discount_price", "numeric(18,2)", "最低折扣价"),
|
||
("cost_price", "numeric(18,2)", "成本价"),
|
||
("cost_price_type", "integer", "成本价类型"),
|
||
("able_discount", "integer", "可折扣"),
|
||
("sale_channel", "integer", "销售渠道"),
|
||
("is_warehousing", "integer", "是否入库"),
|
||
("is_in_site", "boolean", "是否在门店"),
|
||
("able_site_transfer", "integer", "可门店调拨"),
|
||
("common_sale_royalty", "integer", "普通销售提成"),
|
||
("point_sale_royalty", "integer", "积分销售提成"),
|
||
("out_goods_id", "bigint", "外部商品 ID"),
|
||
("scd2_*", "", "SCD2 四列"),
|
||
]},
|
||
],
|
||
"new_fields": [],
|
||
"skipped_fields": [
|
||
("commoditycode", "已映射。commodity_code_list 现从 commoditycode CAST TEXT[] 获取（2026-02-21 迁移）。commodity_code 仍自动映射为单值冗余"),
|
||
],
|
||
},
|
||
|
||
# ═══════════════════════════════════════════════════════════════════
|
||
# 7. site_tables_master → dim_table + dim_table_ex
|
||
# ═══════════════════════════════════════════════════════════════════
|
||
{
|
||
"title": "7. site_tables_master（台桌档案）",
|
||
"ods_table": "ods.site_tables_master",
|
||
"ods_columns": [
|
||
("id", "bigint", "PK，台桌 ID"),
|
||
("site_id", "bigint", "门店 ID"),
|
||
("sitename", "text", "门店名"),
|
||
("appletQrCodeUrl", "text", "小程序二维码 URL"),
|
||
("areaname", "text", "台区名"),
|
||
("audit_status", "integer", "审核状态"),
|
||
("charge_free", "integer", "是否免费"),
|
||
("create_time", "timestamp", "创建时间"),
|
||
("delay_lights_time", "integer", "延迟关灯时间（秒）"),
|
||
("is_online_reservation", "integer", "是否在线预约"),
|
||
("is_rest_area", "integer", "是否休息区"),
|
||
("light_status", "integer", "灯控状态"),
|
||
("only_allow_groupon", "integer", "仅允许团购"),
|
||
("order_delay_time", "integer", "订单延迟时间（秒）"),
|
||
("self_table", "integer", "是否自助台桌"),
|
||
("show_status", "integer", "展示状态"),
|
||
("site_table_area_id", "bigint", "台区 ID"),
|
||
("tablestatusname", "text", "台桌状态名"),
|
||
("table_cloth_use_cycle", "integer", "台布使用周期"),
|
||
("table_cloth_use_time", "timestamp", "台布使用时间"),
|
||
("table_name", "text", "台桌名"),
|
||
("table_price", "numeric(18,2)", "台桌价格"),
|
||
("table_status", "integer", "台桌状态"),
|
||
("temporary_light_second", "integer", "临时灯光秒数"),
|
||
("virtual_table", "integer", "是否虚拟台桌"),
|
||
("order_id", "bigint", "当前订单 ID"),
|
||
],
|
||
"dwd_tables": [
|
||
{"name": "dwd.dim_table（主表）", "columns": [
|
||
("table_id", "bigint", "PK"),
|
||
("site_id", "bigint", "门店 ID"),
|
||
("table_name", "text", "台桌名"),
|
||
("site_table_area_id", "bigint", "台区 ID"),
|
||
("site_table_area_name", "text", "台区名"),
|
||
("tenant_table_area_id", "bigint", "租户台区 ID"),
|
||
("table_price", "numeric(18,2)", "台桌价格"),
|
||
("order_id", "bigint", "当前订单 ID"),
|
||
("scd2_*", "", "SCD2 四列"),
|
||
]},
|
||
{"name": "dwd.dim_table_ex（扩展表）", "columns": [
|
||
("table_id", "bigint", "PK"),
|
||
("show_status", "integer", "展示状态"),
|
||
("is_online_reservation", "integer", "是否在线预约"),
|
||
("table_cloth_use_time", "integer", "台布使用时间"),
|
||
("table_cloth_use_cycle", "integer", "台布使用周期"),
|
||
("table_status", "integer", "台桌状态"),
|
||
("scd2_*", "", "SCD2 四列"),
|
||
]},
|
||
],
|
||
"new_fields": [
|
||
("sitename", "text", "dim_table_ex", "门店名称快照。采样值: 朗朗桌球", "新增 DWD 列 + FACT_MAPPINGS"),
|
||
("appletqrcodeurl", "text", "dim_table_ex", "小程序二维码 URL。采样值: 全部 NULL", "新增 DWD 列 + FACT_MAPPINGS"),
|
||
("audit_status", "integer", "dim_table_ex", "审核状态。采样值: 2", "新增 DWD 列 + FACT_MAPPINGS"),
|
||
("charge_free", "integer", "dim_table_ex", "是否免费（0=否）。采样值: 0", "新增 DWD 列 + FACT_MAPPINGS"),
|
||
("create_time", "timestamptz", "dim_table_ex", "台桌创建时间。采样值: 2025-07-16 11:30:20", "新增 DWD 列 + FACT_MAPPINGS"),
|
||
("delay_lights_time", "integer", "dim_table_ex", "延迟关灯时间（秒）。采样值: 0", "新增 DWD 列 + FACT_MAPPINGS"),
|
||
("is_rest_area", "integer", "dim_table_ex", "是否休息区（0=否）。采样值: 0", "新增 DWD 列 + FACT_MAPPINGS"),
|
||
("light_status", "integer", "dim_table_ex", "灯控状态。采样值: 1, 2", "新增 DWD 列 + FACT_MAPPINGS"),
|
||
("only_allow_groupon", "integer", "dim_table_ex", "仅允许团购。采样值: 2", "新增 DWD 列 + FACT_MAPPINGS"),
|
||
("order_delay_time", "integer", "dim_table_ex", "订单延迟时间（秒）。采样值: 0", "新增 DWD 列 + FACT_MAPPINGS"),
|
||
("self_table", "integer", "dim_table_ex", "是否自助台桌。采样值: 1", "新增 DWD 列 + FACT_MAPPINGS"),
|
||
("tablestatusname", "text", "dim_table_ex", "台桌状态名。采样值: 空闲中, 使用中, 暂停中", "新增 DWD 列 + FACT_MAPPINGS"),
|
||
("temporary_light_second", "integer", "dim_table_ex", "临时灯光秒数。采样值: 0", "新增 DWD 列 + FACT_MAPPINGS"),
|
||
("virtual_table", "integer", "dim_table_ex", "是否虚拟台桌（0=否）。采样值: 0", "新增 DWD 列 + FACT_MAPPINGS"),
|
||
],
|
||
"skipped_fields": [],
|
||
},
|
||
|
||
# ═══════════════════════════════════════════════════════════════════
|
||
# 8. recharge_settlements → dwd_recharge_order + _ex（B 类）
|
||
# ═══════════════════════════════════════════════════════════════════
|
||
{
|
||
"title": "8. recharge_settlements（充值结算单）— B 类",
|
||
"ods_table": "ods.recharge_settlements",
|
||
"ods_columns": [
|
||
("id", "bigint", "PK"),
|
||
("tenantid", "bigint", "租户 ID"),
|
||
("siteid", "bigint", "门店 ID"),
|
||
("sitename", "text", "门店名"),
|
||
("memberid", "bigint", "会员 ID"),
|
||
("membername", "text", "会员名"),
|
||
("memberphone", "text", "会员手机"),
|
||
("tenantmembercardid", "bigint", "会员卡 ID"),
|
||
("membercardtypename", "text", "卡类型名"),
|
||
("tableid", "bigint", "台桌 ID"),
|
||
("settletype", "integer", "结算类型"),
|
||
("settlename", "text", "结算名称"),
|
||
("settlestatus", "integer", "结算状态"),
|
||
("settlerelateid", "bigint", "结算关联 ID"),
|
||
("isfirst", "integer", "是否首次"),
|
||
("payamount", "numeric(18,2)", "支付金额"),
|
||
("refundamount", "numeric(18,2)", "退款金额"),
|
||
("pointamount", "numeric(18,2)", "积分金额"),
|
||
("cashamount", "numeric(18,2)", "现金金额"),
|
||
("paymentmethod", "integer", "支付方式"),
|
||
("createtime", "timestamptz", "创建时间"),
|
||
("paytime", "timestamptz", "支付时间"),
|
||
("onlineamount", "numeric(18,2)", "在线金额"),
|
||
("balanceamount", "numeric(18,2)", "余额金额"),
|
||
("cardamount", "numeric(18,2)", "卡金额"),
|
||
("couponamount", "numeric(18,2)", "券金额"),
|
||
("rechargecardamount", "numeric(18,2)", "充值卡金额"),
|
||
("giftcardamount", "numeric(18,2)", "礼品卡金额"),
|
||
("prepaymoney", "numeric(18,2)", "预付金额"),
|
||
("consumemoney", "numeric(18,2)", "消费金额"),
|
||
("goodsmoney", "numeric(18,2)", "商品金额"),
|
||
("realgoodsmoney", "numeric(18,2)", "实际商品金额"),
|
||
("tablechargemoney", "numeric(18,2)", "台费"),
|
||
("servicemoney", "numeric(18,2)", "服务费"),
|
||
("activitydiscount", "numeric(18,2)", "活动折扣"),
|
||
("allcoupondiscount", "numeric(18,2)", "全部券折扣"),
|
||
("goodspromotionmoney", "numeric(18,2)", "商品促销金额"),
|
||
("assistantpromotionmoney", "numeric(18,2)", "助教促销金额"),
|
||
("assistantpdmoney", "numeric(18,2)", "助教普通时段费"),
|
||
("assistantcxmoney", "numeric(18,2)", "助教促销时段费"),
|
||
("assistantmanualdiscount", "numeric(18,2)", "助教手动折扣"),
|
||
("couponsaleamount", "numeric(18,2)", "券销售金额"),
|
||
("memberdiscountamount", "numeric(18,2)", "会员折扣金额"),
|
||
("pointdiscountprice", "numeric(18,2)", "积分折扣价"),
|
||
("pointdiscountcost", "numeric(18,2)", "积分折扣成本"),
|
||
("adjustamount", "numeric(18,2)", "调整金额"),
|
||
("roundingamount", "numeric(18,2)", "抹零金额"),
|
||
("operatorid", "bigint", "操作员 ID"),
|
||
("operatorname", "text", "操作员名"),
|
||
("salesmanname", "text", "销售员名"),
|
||
("salesmanuserid", "bigint", "销售员 ID"),
|
||
("orderremark", "text", "订单备注"),
|
||
("revokeorderid", "bigint", "撤销订单 ID"),
|
||
("revokeordername", "text", "撤销订单名"),
|
||
("revoketime", "timestamptz", "撤销时间"),
|
||
("canberevoked", "boolean", "可撤销"),
|
||
("isusecoupon", "boolean", "使用券"),
|
||
("isusediscount", "boolean", "使用折扣"),
|
||
("isactivity", "boolean", "是否活动"),
|
||
("isbindmember", "boolean", "绑定会员"),
|
||
("serialnumber", "bigint", "序列号"),
|
||
("plcouponsaleamount", "numeric(18,2)", "平台券销售金额"),
|
||
("mervousalesamount", "numeric(18,2)", "美团券销售金额"),
|
||
("electricitymoney", "numeric(18,2)", "电费"),
|
||
("realelectricitymoney", "numeric(18,2)", "实际电费"),
|
||
("electricityadjustmoney", "numeric(18,2)", "电费调整金额"),
|
||
],
|
||
"dwd_tables": [
|
||
{"name": "dwd.dwd_recharge_order（主表）", "columns": [
|
||
("recharge_order_id", "bigint", "PK"),
|
||
("tenant_id / site_id / member_id", "", "租户/门店/会员 ID"),
|
||
("member_name_snapshot / member_phone_snapshot", "", "会员快照"),
|
||
("tenant_member_card_id / member_card_type_name", "", "会员卡"),
|
||
("settle_relate_id / settle_type / settle_name / is_first", "", "结算信息"),
|
||
("pay_amount / refund_amount / point_amount / cash_amount", "", "金额"),
|
||
("payment_method / create_time / pay_time", "", "支付/时间"),
|
||
("pl_coupon_sale_amount", "numeric(18,2)", "⚠️ DWD 列已存在，但 FACT_MAPPINGS 未配置"),
|
||
("mervou_sales_amount", "numeric(18,2)", "⚠️ DWD 列已存在，但 FACT_MAPPINGS 未配置"),
|
||
("electricity_money", "numeric(18,2)", "⚠️ DWD 列已存在，但 FACT_MAPPINGS 未配置"),
|
||
("real_electricity_money", "numeric(18,2)", "⚠️ DWD 列已存在，但 FACT_MAPPINGS 未配置"),
|
||
("electricity_adjust_money", "numeric(18,2)", "⚠️ DWD 列已存在，但 FACT_MAPPINGS 未配置"),
|
||
]},
|
||
{"name": "dwd.dwd_recharge_order_ex（扩展表）", "columns": [
|
||
("recharge_order_id", "bigint", "PK"),
|
||
("site_name_snapshot / settle_status / is_bind_member / is_activity", "", "快照/状态"),
|
||
("is_use_coupon / is_use_discount / can_be_revoked", "", "布尔标记"),
|
||
("online_amount / balance_amount / card_amount / coupon_amount", "", "支付渠道金额"),
|
||
("recharge_card_amount / gift_card_amount / prepay_money", "", "卡/预付"),
|
||
("consume_money / goods_money / real_goods_money / table_charge_money / service_money", "", "消费明细"),
|
||
("activity_discount / all_coupon_discount / goods_promotion_money / assistant_promotion_money", "", "折扣"),
|
||
("assistant_pd_money / assistant_cx_money / assistant_manual_discount", "", "助教费用"),
|
||
("coupon_sale_amount / member_discount_amount", "", "券/会员折扣"),
|
||
("point_discount_price / point_discount_cost / adjust_amount / rounding_amount", "", "积分/调整"),
|
||
("operator_id / operator_name_snapshot / salesman_user_id / salesman_name / order_remark", "", "操作员/销售"),
|
||
("table_id / serial_number / revoke_order_id / revoke_order_name / revoke_time", "", "台桌/撤销"),
|
||
]},
|
||
],
|
||
"new_fields": [
|
||
("plcouponsaleamount → pl_coupon_sale_amount", "numeric(18,2)", "dwd_recharge_order", "平台券销售金额。DWD 列已存在，仅缺 FACT_MAPPINGS 映射条目", "仅补 FACT_MAPPINGS"),
|
||
("mervousalesamount → mervou_sales_amount", "numeric(18,2)", "dwd_recharge_order", "美团券销售金额。DWD 列已存在，仅缺 FACT_MAPPINGS 映射条目", "仅补 FACT_MAPPINGS"),
|
||
("electricitymoney → electricity_money", "numeric(18,2)", "dwd_recharge_order", "电费。DWD 列已存在，仅缺 FACT_MAPPINGS 映射条目", "仅补 FACT_MAPPINGS"),
|
||
("realelectricitymoney → real_electricity_money", "numeric(18,2)", "dwd_recharge_order", "实际电费。DWD 列已存在，仅缺 FACT_MAPPINGS 映射条目", "仅补 FACT_MAPPINGS"),
|
||
("electricityadjustmoney → electricity_adjust_money", "numeric(18,2)", "dwd_recharge_order", "电费调整金额。DWD 列已存在，仅缺 FACT_MAPPINGS 映射条目", "仅补 FACT_MAPPINGS"),
|
||
],
|
||
"skipped_fields": [],
|
||
},
|
||
|
||
# ═══════════════════════════════════════════════════════════════════
|
||
# 9. store_goods_master → dim_store_goods + _ex（B 类）
|
||
# ═══════════════════════════════════════════════════════════════════
|
||
{
|
||
"title": "9. store_goods_master（门店商品档案）— B 类",
|
||
"ods_table": "ods.store_goods_master",
|
||
"ods_columns": [
|
||
("id", "bigint", "PK"),
|
||
("tenant_id", "bigint", "租户 ID"),
|
||
("site_id", "bigint", "门店 ID"),
|
||
("sitename", "text", "门店名"),
|
||
("tenant_goods_id", "bigint", "租户商品 ID"),
|
||
("goods_name", "text", "商品名"),
|
||
("goods_bar_code", "text", "条码"),
|
||
("goods_category_id", "bigint", "一级分类 ID"),
|
||
("goods_second_category_id", "bigint", "二级分类 ID"),
|
||
("onecategoryname", "text", "一级分类名"),
|
||
("twocategoryname", "text", "二级分类名"),
|
||
("unit", "text", "单位"),
|
||
("sale_price", "numeric(18,4)", "售价"),
|
||
("cost_price", "numeric(18,4)", "成本价"),
|
||
("cost_price_type", "integer", "成本价类型"),
|
||
("min_discount_price", "numeric(18,4)", "最低折扣价"),
|
||
("safe_stock", "numeric(18,4)", "安全库存"),
|
||
("stock", "numeric(18,4)", "当前库存"),
|
||
("stock_a", "numeric(18,4)", "副库存"),
|
||
("sale_num", "numeric(18,4)", "销售数量"),
|
||
("total_purchase_cost", "numeric(18,4)", "采购总成本"),
|
||
("total_sales", "numeric(18,4)", "总销售额"),
|
||
("average_monthly_sales", "numeric(18,4)", "月均销售"),
|
||
("batch_stock_quantity", "numeric(18,2)", "批次库存数量"),
|
||
("days_available", "integer", "可用天数"),
|
||
("provisional_total_cost", "numeric(18,2)", "暂估总成本"),
|
||
("enable_status", "integer", "启用状态"),
|
||
("audit_status", "integer", "审核状态"),
|
||
("goods_state", "integer", "商品状态"),
|
||
("is_delete", "integer", "删除标记"),
|
||
("is_warehousing", "integer", "是否入库"),
|
||
("able_discount", "integer", "可折扣"),
|
||
("able_site_transfer", "integer", "可门店调拨"),
|
||
("forbid_sell_status", "integer", "禁售状态"),
|
||
("freeze", "integer", "冻结"),
|
||
("send_state", "integer", "配送状态"),
|
||
("custom_label_type", "integer", "自定义标签"),
|
||
("option_required", "integer", "选项必填"),
|
||
("sale_channel", "integer", "销售渠道"),
|
||
("sort", "integer", "排序"),
|
||
("remark", "text", "备注"),
|
||
("pinyin_initial", "text", "拼音首字母"),
|
||
("goods_cover", "text", "商品封面"),
|
||
("create_time", "timestamp", "创建时间"),
|
||
("update_time", "timestamp", "更新时间"),
|
||
("commodity_code", "text", "商品编码"),
|
||
("not_sale", "integer", "禁售标记"),
|
||
],
|
||
"dwd_tables": [
|
||
{"name": "dwd.dim_store_goods（主表）", "columns": [
|
||
("site_goods_id", "bigint", "PK"),
|
||
("tenant_id / site_id / tenant_goods_id", "", "租户/门店/商品 ID"),
|
||
("goods_name / goods_category_id / goods_second_category_id", "", "商品/分类"),
|
||
("category_level1_name / category_level2_name", "", "分类名"),
|
||
("batch_stock_qty / sale_qty / total_sales_qty", "", "库存/销售"),
|
||
("sale_price / avg_monthly_sales", "", "价格/月均"),
|
||
("goods_state / enable_status / send_state / is_delete / commodity_code / not_sale", "", "状态"),
|
||
("created_at / updated_at / scd2_*", "", "时间/SCD2"),
|
||
]},
|
||
{"name": "dwd.dim_store_goods_ex（扩展表）", "columns": [
|
||
("site_goods_id", "bigint", "PK"),
|
||
("site_name / unit / goods_barcode / goods_cover_url / pinyin_initial", "", "快照/基础"),
|
||
("stock_qty / stock_secondary_qty / safety_stock_qty", "", "库存"),
|
||
("cost_price / cost_price_type / provisional_total_cost / total_purchase_cost", "", "成本"),
|
||
("min_discount_price / is_discountable / days_on_shelf", "", "折扣/天数"),
|
||
("audit_status / sale_channel / is_warehousing / freeze_status", "", "状态"),
|
||
("forbid_sell_status / able_site_transfer / custom_label_type / option_required", "", "标记"),
|
||
("remark / sort_order / time_slot_sale / scd2_*", "", "备注/排序/分时段/SCD2"),
|
||
]},
|
||
],
|
||
"new_fields": [
|
||
("batch_stock_quantity", "numeric(18,2)", "dim_store_goods_ex", "批次库存数量（与 stock 不同）。采样值: 35.00, 270.00, 8.00", "新增 DWD 列 + FACT_MAPPINGS"),
|
||
],
|
||
"skipped_fields": [
|
||
("time_slot_sale", "已映射。ODS + DWD 均已新增 time_slot_sale INTEGER（2026-02-21 迁移）"),
|
||
("provisional_total_cost", "DWD 列名已被占用（映射自 ODS total_purchase_cost）。ODS provisional_total_cost（暂估总成本）未映射"),
|
||
],
|
||
},
|
||
|
||
# ═══════════════════════════════════════════════════════════════════
|
||
# 10. goods_stock_summary（C 类 — 需新建 DWD 表）
|
||
# ═══════════════════════════════════════════════════════════════════
|
||
{
|
||
"title": "10. goods_stock_summary（库存汇总）— C 类，需新建 DWD 表",
|
||
"ods_table": "ods.goods_stock_summary",
|
||
"ods_columns": [
|
||
("sitegoodsid", "bigint", "门店商品 ID"),
|
||
("goodsname", "text", "商品名"),
|
||
("goodsunit", "text", "单位"),
|
||
("goodscategoryid", "bigint", "一级分类 ID"),
|
||
("goodscategorysecondid", "bigint", "二级分类 ID"),
|
||
("categoryname", "text", "分类名"),
|
||
("rangestartstock", "numeric(18,4)", "期初库存"),
|
||
("rangeendstock", "numeric(18,4)", "期末库存"),
|
||
("rangein", "numeric(18,4)", "入库数量"),
|
||
("rangeout", "numeric(18,4)", "出库数量"),
|
||
("rangesale", "numeric(18,4)", "销售数量"),
|
||
("rangesalemoney", "numeric(18,2)", "销售金额"),
|
||
("rangeinventory", "numeric(18,4)", "盘点数量"),
|
||
("currentstock", "numeric(18,4)", "当前库存"),
|
||
],
|
||
"dwd_tables": [
|
||
{"name": "（无 DWD 表 — 需新建 dwd_goods_stock_summary）", "columns": []},
|
||
],
|
||
"new_fields": [
|
||
("全部 14 个 ODS 列", "", "dwd_goods_stock_summary（新建）", "需新建 DWD 表，全部 ODS 业务列映射（驼峰 → 蛇形）", "新建 DWD 表 + TABLE_MAP + FACT_MAPPINGS + loader/task"),
|
||
],
|
||
"skipped_fields": [],
|
||
},
|
||
|
||
# ═══════════════════════════════════════════════════════════════════
|
||
# 11. goods_stock_movements（C 类 — 需新建 DWD 表）
|
||
# ═══════════════════════════════════════════════════════════════════
|
||
{
|
||
"title": "11. goods_stock_movements（库存变动明细）— C 类，需新建 DWD 表",
|
||
"ods_table": "ods.goods_stock_movements",
|
||
"ods_columns": [
|
||
("sitegoodsstockid", "bigint", "门店商品库存 ID"),
|
||
("tenantid", "bigint", "租户 ID"),
|
||
("siteid", "bigint", "门店 ID"),
|
||
("sitegoodsid", "bigint", "门店商品 ID"),
|
||
("goodsname", "text", "商品名"),
|
||
("goodscategoryid", "bigint", "一级分类 ID"),
|
||
("goodssecondcategoryid", "bigint", "二级分类 ID"),
|
||
("unit", "text", "单位"),
|
||
("price", "numeric(18,4)", "单价"),
|
||
("stocktype", "integer", "库存变动类型"),
|
||
("changenum", "numeric(18,4)", "变动数量"),
|
||
("startnum", "numeric(18,4)", "变动前数量"),
|
||
("endnum", "numeric(18,4)", "变动后数量"),
|
||
("changenuma", "numeric(18,4)", "副变动数量"),
|
||
("startnuma", "numeric(18,4)", "副变动前数量"),
|
||
("endnuma", "numeric(18,4)", "副变动后数量"),
|
||
("remark", "text", "备注"),
|
||
("operatorname", "text", "操作员名"),
|
||
("createtime", "timestamp", "创建时间"),
|
||
],
|
||
"dwd_tables": [
|
||
{"name": "（无 DWD 表 — 需新建 dwd_goods_stock_movement）", "columns": []},
|
||
],
|
||
"new_fields": [
|
||
("全部 19 个 ODS 列", "", "dwd_goods_stock_movement（新建）", "需新建 DWD 表，全部 ODS 业务列映射（驼峰 → 蛇形）", "新建 DWD 表 + TABLE_MAP + FACT_MAPPINGS + loader/task"),
|
||
],
|
||
"skipped_fields": [],
|
||
},
|
||
]
|
||
|
||
|
||
# ── Markdown 生成 ─────────────────────────────────────────────────────
|
||
|
||
def gen_md():
|
||
lines = []
|
||
lines.append("# 字段补全复核文档（ODS + DWD 全量对照）\n")
|
||
lines.append(f"> 生成时间：{__import__('datetime').datetime.now().strftime('%Y-%m-%d %H:%M')}")
|
||
lines.append("> 用途：供人工复核字段排查结论，确认后再执行代码变更\n")
|
||
lines.append("---\n")
|
||
|
||
# 全局汇总
|
||
total_new = sum(len(t["new_fields"]) for t in TABLES)
|
||
total_skip = sum(len(t["skipped_fields"]) for t in TABLES)
|
||
lines.append("## 全局汇总\n")
|
||
lines.append(f"| 指标 | 数量 |")
|
||
lines.append(f"|------|------|")
|
||
lines.append(f"| 涉及 ODS 表 | {len(TABLES)} |")
|
||
lines.append(f"| 待新增/补映射字段 | {total_new} |")
|
||
lines.append(f"| 跳过字段 | {total_skip} |")
|
||
lines.append("")
|
||
|
||
for t in TABLES:
|
||
lines.append(f"\n---\n")
|
||
lines.append(f"## {t['title']}\n")
|
||
|
||
# ODS 现有字段
|
||
lines.append(f"### ODS 现有字段（{t['ods_table']}）\n")
|
||
lines.append("| 列名 | 类型 | 说明 |")
|
||
lines.append("|------|------|------|")
|
||
for col, dtype, desc in t["ods_columns"]:
|
||
lines.append(f"| `{col}` | {dtype} | {desc} |")
|
||
lines.append(f"\n共 {len(t['ods_columns'])} 列（不含 ODS 元数据列 payload/content_hash/source_file/source_endpoint/fetched_at）\n")
|
||
|
||
# DWD 现有字段
|
||
lines.append(f"### DWD 现有字段\n")
|
||
for dwd in t["dwd_tables"]:
|
||
lines.append(f"#### {dwd['name']}\n")
|
||
if dwd["columns"]:
|
||
lines.append("| 列名 | 类型 | 说明 |")
|
||
lines.append("|------|------|------|")
|
||
for col, dtype, desc in dwd["columns"]:
|
||
lines.append(f"| `{col}` | {dtype} | {desc} |")
|
||
lines.append(f"\n共 {len(dwd['columns'])} 列\n")
|
||
else:
|
||
lines.append("（无 — 需新建）\n")
|
||
|
||
# 待新增字段
|
||
lines.append(f"### ✅ 待新增 / 补映射字段\n")
|
||
if t["new_fields"]:
|
||
lines.append("| ODS 列 → DWD 列 | 类型 | 目标表 | 说明 | 操作 |")
|
||
lines.append("|-----------------|------|--------|------|------|")
|
||
for col, dtype, target, desc, action in t["new_fields"]:
|
||
lines.append(f"| `{col}` | {dtype} | {target} | {desc} | {action} |")
|
||
lines.append("")
|
||
else:
|
||
lines.append("无\n")
|
||
|
||
# 跳过字段
|
||
lines.append(f"### ⏭️ 跳过字段（含原因）\n")
|
||
if t["skipped_fields"]:
|
||
lines.append("| ODS 列 | 跳过原因 |")
|
||
lines.append("|--------|---------|")
|
||
for item in t["skipped_fields"]:
|
||
if len(item) == 2:
|
||
col, reason = item
|
||
else:
|
||
col, reason = item[0], item[1]
|
||
lines.append(f"| `{col}` | {reason} |")
|
||
lines.append("")
|
||
else:
|
||
lines.append("无\n")
|
||
|
||
# 写入文件
|
||
content = "\n".join(lines)
|
||
with open(output_file, "w", encoding="utf-8") as f:
|
||
f.write(content)
|
||
print(f"✅ 复核文档已生成: {output_file}")
|
||
print(f" 共 {len(TABLES)} 张表，{total_new} 个待新增字段，{total_skip} 个跳过字段")
|
||
|
||
|
||
if __name__ == "__main__":
|
||
gen_md()
|