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

docs/bd_manual/DWD/main/BD_manual_dim_assistant.md

@@ -0,0 +1,47 @@
+# dim_assistant 助教档案主表
+
+> 生成时间：2026-01-28
+
+## 表信息
+
+| 属性 | 值 |
+|------|-----|
+| Schema | billiards_dwd |
+| 表名 | dim_assistant |
+| 主键 | assistant_id, scd2_start_time |
+| 扩展表 | dim_assistant_ex |
+| 记录数 | 69 |
+| 说明 | 助教人员档案的核心信息，包括工号、姓名、联系方式、团队归属、等级等 |
+
+## 字段说明
+
+| 序号 | 字段名 | 类型 | 可空 | 主键 | 说明 |
+|------|--------|------|------|------|------|
+| 1 | assistant_id | BIGINT | NO | PK | 助教唯一标识 ID |
+| 2 | user_id | BIGINT | YES | | 关联用户 ID（当前数据全为 0，**[作用待确认]**） |
+| 3 | assistant_no | TEXT | YES | | 助教工号，如 "11"、"27" |
+| 4 | real_name | TEXT | YES | | 真实姓名，如 "梁婷婷"、"周佳怡" |
+| 5 | nickname | TEXT | YES | | 昵称/花名，如 "柚子"、"周周"、"Amy" |
+| 6 | mobile | TEXT | YES | | 手机号码 |
+| 7 | tenant_id | BIGINT | YES | | 租户 ID（当前值: 2790683160709957） |
+| 8 | site_id | BIGINT | YES | | 门店 ID → dim_site（当前值: 2790685415443269） |
+| 9 | team_id | BIGINT | YES | | 团队 ID |
+| 10 | team_name | TEXT | YES | | 团队名称。**枚举值**: "1组"(对应 team_id = 2792011585884037), "2组"(对应 team_id = 2959085810992645) |
+| 11 | level | INTEGER | YES | | 助教等级。**枚举值**: 8 = 助教管理, 10 = 初级, 20 = 中级, 30 = 高级, 40 =专家 |
+| 12 | entry_time | TIMESTAMPTZ | YES | | 入职时间 |
+| 13 | resign_time | TIMESTAMPTZ | YES | | 离职时间（远未来日期如 2225-xx-xx 表示在职） |
+| 14 | leave_status | INTEGER | YES | | 在职状态。**枚举值**: 0 = 在职, 1 = 已离职 |
+| 15 | assistant_status | INTEGER | YES | | 观察者状态。**枚举值**: 1 = 为非观察者, 2 = 为观察者。 |
+| 16 | scd2_start_time | TIMESTAMPTZ | NO | PK | SCD2 版本生效时间 |
+| 17 | scd2_end_time | TIMESTAMPTZ | YES | | SCD2 版本失效时间 |
+| 18 | scd2_is_current | INTEGER | YES | | 当前版本标记 |
+| 19 | scd2_version | INTEGER | YES | | 版本号 |
+
+## 使用说明
+
+使用 scd2_is_current = 1 获取当前版本。
+```sql
+-- 查询当前在职助教
+SELECT * FROM billiards_dwd.dim_assistant
+WHERE scd2_is_current = 1 AND leave_status = 0;
+```