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

docs/bd_manual/DWD/main/BD_manual_dwd_payment.md

@@ -0,0 +1,58 @@
+# dwd_payment 支付流水表
+
+> 生成时间：2026-01-28
+
+## 表信息
+
+| 属性 | 值 |
+|------|-----|
+| Schema | billiards_dwd |
+| 表名 | dwd_payment |
+| 主键 | payment_id |
+| 扩展表 | 无 |
+| 记录数 | 22949 |
+| 说明 | 支付流水事实表，记录每笔支付的方式、金额、时间等信息 |
+
+## 字段说明
+
+| 序号 | 字段名 | 类型 | 可空 | 主键 | 说明 |
+|------|--------|------|------|------|------|
+| 1 | payment_id | BIGINT | NO | PK | 支付流水 ID |
+| 2 | site_id | BIGINT | YES | | 门店 ID |
+| 3 | relate_type | INTEGER | YES | | 关联业务类型。**枚举值**: 1=预付, 2=结账, 5=充值, 6=线上商城 |
+| 4 | relate_id | BIGINT | YES | | 关联业务 ID |
+| 5 | pay_amount | NUMERIC(18,2) | YES | | 支付金额（元） |
+| 6 | pay_status | INTEGER | YES | | 支付状态。**枚举值**: 2=已支付 |
+| 7 | payment_method | INTEGER | YES | | 支付方式。**枚举值**: 2=现金支付 , 4=离线支付 |
+| 8 | online_pay_channel | INTEGER | YES | | 在线支付渠道（当前数据全为 0） |
+| 9 | create_time | TIMESTAMPTZ | YES | | 创建时间 |
+| 10 | pay_time | TIMESTAMPTZ | YES | | 支付时间 |
+| 11 | pay_date | DATE | YES | | 支付日期 |
+| 12 | tenant_id | BIGINT | YES | | 租户 ID |
+
+## 使用说明
+
+**版本与最新值**
+本表为事实表，无 SCD2 版本字段。
+
+- 可用时间字段：create_time, pay_time, pay_date
+
+```sql
+-- 取最新一条（按时间字段倒序）
+SELECT *
+FROM billiards_dwd.dwd_payment
+ORDER BY pay_time DESC NULLS LAST
+LIMIT 1;
+```
+**使用示例**
+```sql
+-- 每日支付金额统计
+SELECT 
+  pay_date,
+  COUNT(*) AS pay_count,
+  SUM(pay_amount) AS total_amount
+FROM billiards_dwd.dwd_payment
+WHERE pay_status = 2
+GROUP BY pay_date
+ORDER BY pay_date DESC;
+```