初始提交：飞球 ETL 系统全量代码

docs/bd_manual/DWD/main/BD_manual_dwd_refund.md

@@ -0,0 +1,56 @@
+# dwd_refund 退款流水主表
+
+> 生成时间：2026-01-28
+
+## 表信息
+
+| 属性 | 值 |
+|------|-----|
+| Schema | billiards_dwd |
+| 表名 | dwd_refund |
+| 主键 | refund_id |
+| 扩展表 | dwd_refund_ex |
+| 记录数 | 45 |
+| 说明 | 退款流水事实表，记录退款的金额、关联业务等信息 |
+
+## 字段说明
+
+| 序号 | 字段名 | 类型 | 可空 | 主键 | 说明 |
+|------|--------|------|------|------|------|
+| 1 | refund_id | BIGINT | NO | PK | 退款流水 ID |
+| 2 | tenant_id | BIGINT | YES | | 租户 ID |
+| 3 | site_id | BIGINT | YES | | 门店 ID |
+| 4 | relate_type | INTEGER | YES | | 关联业务类型。**枚举值**: 1(7)=预付退款 , 2(31)=结账退款, 5(7)=充值退款 |
+| 5 | relate_id | BIGINT | YES | | 关联业务 ID |
+| 6 | pay_amount | NUMERIC(18,2) | YES | | 退款金额（元，负数） |
+| 7 | channel_fee | NUMERIC(18,2) | YES | | 渠道手续费 |
+| 8 | pay_time | TIMESTAMPTZ | YES | | 退款时间 |
+| 9 | create_time | TIMESTAMPTZ | YES | | 创建时间 |
+| 10 | payment_method | INTEGER | YES | | 支付方式，暂无用途。 |
+| 11 | member_id | BIGINT | YES | | 会员 ID（当前数据全为 0） |
+| 12 | member_card_id | BIGINT | YES | | 会员卡 ID（当前数据全为 0） |
+
+## 使用说明
+
+**版本与最新值**
+本表为事实表，无 SCD2 版本字段。
+
+- 可用时间字段：pay_time, create_time
+
+```sql
+-- 取最新一条（按时间字段倒序）
+SELECT *
+FROM billiards_dwd.dwd_refund
+ORDER BY pay_time DESC NULLS LAST
+LIMIT 1;
+```
+**使用示例**
+```sql
+-- 退款统计
+SELECT 
+  relate_type,
+  COUNT(*) AS refund_count,
+  SUM(ABS(pay_amount)) AS total_refund
+FROM billiards_dwd.dwd_refund
+GROUP BY relate_type;
+```