在前后端开发联调前 的提交20260223

apps/etl/connectors/feiqiu/docs/database/DWD/main/BD_manual_dim_staff.md

@@ -0,0 +1,44 @@
+# dim_staff 员工档案主表
+
+> 生成时间：2026-02-23
+
+## 表信息
+
+| 属性 | 值 |
+|------|-----|
+| Schema | dwd |
+| 表名 | dim_staff |
+| 主键 | staff_id, scd2_start_time |
+| 扩展表 | dim_staff_ex |
+| ODS 来源 | ods.staff_info_master |
+| 说明 | 员工档案维度主表（SCD2），包含核心业务字段 |
+
+## 字段说明
+
+| 序号 | 字段名 | 类型 | 可空 | 主键 | 说明 |
+|------|--------|------|------|------|------|
+| 1 | staff_id | BIGINT | NO | PK | 员工唯一标识（映射自 ODS id） |
+| 2 | staff_name | TEXT | YES | | 员工姓名 |
+| 3 | alias_name | TEXT | YES | | 别名 |
+| 4 | mobile | TEXT | YES | | 手机号 |
+| 5 | gender | INTEGER | YES | | 性别 |
+| 6 | job | TEXT | YES | | 职位（店长/主管/教练/收银员等） |
+| 7 | tenant_id | BIGINT | YES | | 租户 ID |
+| 8 | site_id | BIGINT | YES | | 门店 ID |
+| 9 | system_role_id | INTEGER | YES | | 系统角色 ID |
+| 10 | staff_identity | INTEGER | YES | | 员工身份类型 |
+| 11 | status | INTEGER | YES | | 账号状态 |
+| 12 | leave_status | INTEGER | YES | | 在职状态（0=在职，1=离职） |
+| 13 | entry_time | TIMESTAMPTZ | YES | | 入职时间 |
+| 14 | resign_time | TIMESTAMPTZ | YES | | 离职时间 |
+| 15 | is_delete | INTEGER | YES | | 删除标记 |
+| 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 | | 版本号 |
+
+## 与其他表的关系
+
+- 扩展表：`dwd.dim_staff_ex`（次要/低频变更字段）
+- ODS 来源：`ods.staff_info_master`
+- 与助教维度表（`dim_assistant`）是完全独立的实体

apps/etl/connectors/feiqiu/docs/database/DWD/main/BD_manual_dim_staff_ex.md

@@ -0,0 +1,51 @@
+# dim_staff_ex 员工档案扩展表
+
+> 生成时间：2026-02-23
+
+## 表信息
+
+| 属性 | 值 |
+|------|-----|
+| Schema | dwd |
+| 表名 | dim_staff_ex |
+| 主键 | staff_id, scd2_start_time |
+| 主表 | dim_staff |
+| ODS 来源 | ods.staff_info_master |
+| 说明 | 员工档案维度扩展表（SCD2），包含次要/低频变更字段 |
+
+## 字段说明
+
+| 序号 | 字段名 | 类型 | 可空 | 主键 | 说明 |
+|------|--------|------|------|------|------|
+| 1 | staff_id | BIGINT | NO | PK | 员工唯一标识（映射自 ODS id） |
+| 2 | avatar | TEXT | YES | | 头像 URL |
+| 3 | job_num | TEXT | YES | | 工号 |
+| 4 | account_status | INTEGER | YES | | 账号启用状态 |
+| 5 | rank_id | INTEGER | YES | | 职级 ID |
+| 6 | rank_name | TEXT | YES | | 职级名称 |
+| 7 | new_rank_id | INTEGER | YES | | 新职级 ID |
+| 8 | new_staff_identity | INTEGER | YES | | 新员工身份 |
+| 9 | is_reserve | INTEGER | YES | | 预约标记 |
+| 10 | shop_name | TEXT | YES | | 门店名称 |
+| 11 | site_label | TEXT | YES | | 门店标签 |
+| 12 | tenant_org_id | BIGINT | YES | | 租户组织 ID |
+| 13 | system_user_id | BIGINT | YES | | 系统用户 ID |
+| 14 | cashier_point_id | BIGINT | YES | | 收银点 ID |
+| 15 | cashier_point_name | TEXT | YES | | 收银点名称 |
+| 16 | group_id | BIGINT | YES | | 分组 ID |
+| 17 | group_name | TEXT | YES | | 分组名称 |
+| 18 | staff_profile_id | BIGINT | YES | | 员工档案 ID |
+| 19 | auth_code | TEXT | YES | | 授权码 |
+| 20 | auth_code_create | TIMESTAMPTZ | YES | | 授权码创建时间 |
+| 21 | ding_talk_synced | INTEGER | YES | | 钉钉同步状态 |
+| 22 | salary_grant_enabled | INTEGER | YES | | 工资发放启用 |
+| 23 | entry_type | INTEGER | YES | | 入职类型 |
+| 24 | entry_sign_status | INTEGER | YES | | 入职签约状态 |
+| 25 | resign_sign_status | INTEGER | YES | | 离职签约状态 |
+| 26 | criticism_status | INTEGER | YES | | 批评状态 |
+| 27 | create_time | TIMESTAMPTZ | YES | | 创建时间 |
+| 28 | user_roles | JSONB | YES | | 用户角色列表 |
+| 29 | scd2_start_time | TIMESTAMPTZ | NO | PK | SCD2 版本生效时间 |
+| 30 | scd2_end_time | TIMESTAMPTZ | YES | | SCD2 版本失效时间 |
+| 31 | scd2_is_current | INTEGER | YES | | 当前版本标记 |
+| 32 | scd2_version | INTEGER | YES | | 版本号 |

apps/etl/connectors/feiqiu/docs/database/DWD/main/BD_manual_dwd_assistant_trash_event.md

@@ -1,56 +0,0 @@
-# dwd_assistant_trash_event 助教服务作废主表
-
-> 生成时间：2026-01-28
-
-## 表信息
-
-| 属性 | 值 |
-|------|-----|
-| Schema | dwd |
-| 表名 | dwd_assistant_trash_event |
-| 主键 | assistant_trash_event_id |
-| 扩展表 | dwd_assistant_trash_event_ex |
-| 记录数 | 98 |
-| 说明 | 助教服务作废事实表，记录被取消/作废的助教服务记录 |
-
-## 字段说明
-
-| 序号 | 字段名 | 类型 | 可空 | 主键 | 说明 |
-|------|--------|------|------|------|------|
-| 1 | assistant_trash_event_id | BIGINT | NO | PK | 作废事件 ID |
-| 2 | site_id | BIGINT | YES | | 门店 ID |
-| 3 | table_id | BIGINT | YES | | 台桌 ID → dim_table |
-| 4 | table_area_id | BIGINT | YES | | 台区 ID |
-| 5 | assistant_no | VARCHAR(32) | YES | | 助教工号/昵称。**样本值**: "七七", "乔西", "球球"等 |
-| 6 | assistant_name | VARCHAR(64) | YES | | 助教名称，与 assistant_no 相同 |
-| 7 | charge_minutes_raw | INTEGER | YES | | 原计费时长（秒）。**样本值**: 0, 3600=1h, 10800=3h 等 |
-| 8 | abolish_amount | NUMERIC(18,2) | YES | | 作废金额（元）。**样本值**: 0.00, 190.00, 570.00 等 |
-| 9 | trash_reason | VARCHAR(255) | YES | | 作废原因（当前数据全为 NULL） |
-| 10 | create_time | TIMESTAMPTZ | YES | | 创建时间 |
-| 11 | tenant_id | BIGINT | YES | | 租户 ID |
-
-## 使用说明
-
-**版本与最新值**
-本表为事实表，无 SCD2 版本字段。
-
-- 可用时间字段：create_time
-
-```sql
--- 取最新一条（按时间字段倒序）
-SELECT *
-FROM dwd.dwd_assistant_trash_event
-ORDER BY create_time DESC NULLS LAST
-LIMIT 1;
-```
-**使用示例**
-```sql
--- 助教作废金额统计
-SELECT 
-  assistant_name,
-  COUNT(*) AS trash_count,
-  SUM(abolish_amount) AS total_abolished
-FROM dwd.dwd_assistant_trash_event
-GROUP BY assistant_name
-ORDER BY total_abolished DESC;
-```