# db/etl_feiqiu/ — ETL 数据库资产

## 六层 Schema

| Schema | 用途 | DDL 基线 |
|--------|------|---------|
| meta | ETL 调度元数据（任务注册、游标、运行记录） | `docs/database/ddl/etl_feiqiu__meta.sql` |
| ods | 原始数据层（API payload 落地） | `docs/database/ddl/etl_feiqiu__ods.sql` |
| dwd | 明细数据层（维度 SCD2 + 事实增量） | `docs/database/ddl/etl_feiqiu__dwd.sql` |
| core | 跨门店标准化维度/事实 | `docs/database/ddl/etl_feiqiu__core.sql` |
| dws | 汇总数据层（业绩、财务、会员、工资、指数） | `docs/database/ddl/etl_feiqiu__dws.sql` |
| app | RLS 视图层（仅视图，无表） | `docs/database/ddl/etl_feiqiu__app.sql` |

## 种子数据

| 文件 | 用途 |
|------|------|
| `seeds/seed_ods_tasks.sql` | 注册 ODS 抓取任务到 `meta.etl_task` |
| `seeds/seed_scheduler_tasks.sql` | 初始化调度任务配置 |
| `seeds/seed_dws_config.sql` | DWS 配置（绩效档位、等级定价、技能映射等） |
| `seeds/seed_index_parameters.sql` | 指数算法参数（WBI/NCI/RS/OS/MS/ML） |

## Schema 约定

- 表名小写蛇形，带 schema 前缀（如 `dwd.dim_member`）
- 维度表含 SCD2 列：`scd2_start_time`、`scd2_end_time`、`scd2_is_current`、`scd2_version`
- ODS 表含元数据列：`content_hash`、`payload`、`fetched_at`、`source_file`
- 金额字段 `NUMERIC(12,2)`，ID 字段 `BIGINT`
- 不使用 ORM，SQL 通过 `psycopg2` 直接执行