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

docs/bd_manual/DWD/main/BD_manual_dim_member.md

@@ -0,0 +1,63 @@
+# dim_member 会员档案主表
+
+> 生成时间：2026-01-28
+
+## 表信息
+
+| 属性 | 值 |
+|------|-----|
+| Schema | billiards_dwd |
+| 表名 | dim_member |
+| 主键 | member_id, scd2_start_time |
+| 扩展表 | dim_member_ex |
+| 记录数 | 556 |
+| 说明 | 租户会员档案主表，记录会员基本信息和卡种等级 |
+
+## 字段说明
+
+| 序号 | 字段名 | 类型 | 可空 | 主键 | 说明 |
+|------|--------|------|------|------|------|
+| 1 | member_id | BIGINT | NO | PK | 租户内会员 ID（tenant_member_id） |
+| 2 | system_member_id | BIGINT | YES | | 系统级会员 ID |
+| 3 | tenant_id | BIGINT | YES | | 租户 ID（当前值: 2790683160709957） |
+| 4 | register_site_id | BIGINT | YES | | 注册门店 ID → dim_site（当前值: 2790685415443269） |
+| 5 | mobile | TEXT | YES | | 手机号码 |
+| 6 | nickname | TEXT | YES | | 昵称。**样本值**: "陈先生", "张先生", "李先生",等 |
+| 7 | member_card_grade_code | BIGINT | YES | | 卡等级代码 |
+| 8 | member_card_grade_name | TEXT | YES | | 卡等级名称。**枚举值**: "储值卡", "台费卡", "年卡", "活动抵用券", "月卡" |
+| 9 | create_time | TIMESTAMPTZ | YES | | 创建时间 |
+| 10 | update_time | TIMESTAMPTZ | YES | | 更新时间 |
+| 11 | pay_money_sum | NUMERIC(18,2) | YES | | 累计支付金额 |
+| 12 | recharge_money_sum | NUMERIC(18,2) | YES | | 累计充值金额 |
+| 13 | scd2_start_time | TIMESTAMPTZ | NO | PK | SCD2 版本生效时间 |
+| 14 | scd2_end_time | TIMESTAMPTZ | YES | | SCD2 版本失效时间 |
+| 15 | scd2_is_current | INTEGER | YES | | 当前版本标记 |
+| 16 | scd2_version | INTEGER | YES | | 版本号 |
+
+## 使用说明
+
+**版本与最新值**
+本表为 SCD2 维度表，版本字段：scd2_start_time / scd2_end_time / scd2_is_current / scd2_version。
+
+- 最新版本：scd2_is_current = 1
+- 按业务主键取最新：按 scd2_start_time 倒序
+
+```sql
+-- 取某业务主键的最新版本
+SELECT *
+FROM billiards_dwd.dim_member
+WHERE member_id = <value>
+ORDER BY scd2_start_time DESC
+LIMIT 1;
+```
+**使用示例**
+```sql
+-- 查询当前有效会员
+SELECT * FROM billiards_dwd.dim_member
+WHERE scd2_is_current = 1;
+-- 按卡类型统计会员数
+SELECT member_card_grade_name, COUNT(*)
+FROM billiards_dwd.dim_member
+WHERE scd2_is_current = 1
+GROUP BY member_card_grade_name;
+```