23 lines
1.2 KiB
Markdown
23 lines
1.2 KiB
Markdown
# 产品概述
|
||
|
||
飞球 ETL 系统 (etl-billiards) — 面向台球门店业务的数据仓库 ETL 管线。
|
||
|
||
## 功能
|
||
- 从上游 SaaS API 抽取运营数据（订单、支付、会员、助教、库存等）
|
||
- 原始数据落地 **ODS**（操作数据存储层），保留源 payload 便于回溯
|
||
- 清洗装载至 **DWD**（明细数据层），维度走 SCD2，事实按时间增量
|
||
- 汇总至 **DWS**（数据服务层）：助教业绩、财务日报、会员分析、工资计算、自定义指数算法（WBI/NCI/RS/OS/MS/ML）
|
||
- 提供 **PySide6 桌面 GUI**，支持任务管理、调度配置
|
||
- 支持在线（API 抓取）和离线（JSON 回放）两种模式
|
||
|
||
## 业务上下文
|
||
- 单租户：一家台球门店（由 `STORE_ID` 标识）
|
||
- 核心实体：会员（客户）、助教（教练）、台桌、订单、支付、退款、团购套餐、库存
|
||
- 领域语言以中文为主；代码注释、文档、UI 文案均为中文
|
||
- 货币：人民币（CNY），金额以 numeric(2) 存储
|
||
|
||
## 主要入口
|
||
- CLI：`python -m cli.main`（主入口）
|
||
- GUI：`python -m gui.main`
|
||
- 批处理脚本：`run_etl.bat`、`run_gui.bat`（根目录）、`scripts/run_ods.bat`
|