在前后端开发联调前 的提交20260223
This commit is contained in:
@@ -4,29 +4,19 @@ inclusion: always
|
||||
|
||||
# 产品概述
|
||||
|
||||
NeoZQYY Monorepo — 面向台球门店业务的全栈数据平台,包含 ETL Connector、后端 API、管理后台、微信小程序。
|
||||
NeoZQYY Monorepo — 面向台球门店业务的全栈数据平台。
|
||||
|
||||
## 子系统
|
||||
- ETL Connector:从上游 SaaS API 抽取运营数据,经 ODS → DWD → DWS 三层处理
|
||||
- FastAPI 后端:业务 API 服务
|
||||
- 微信小程序:C 端用户界面
|
||||
- 管理后台(`apps/admin-web/`):任务管理、调度配置、数据查看、ETL 状态监控(已替代原 PySide6 桌面 GUI)
|
||||
- 共享包:枚举、金额精度、时间工具
|
||||
|
||||
> 各子系统路径见 `structure-lite.md`
|
||||
|
||||
## ETL 功能
|
||||
- 从上游 SaaS API 抽取运营数据(订单、支付、会员、助教、库存等)
|
||||
- 原始数据落地 ODS,保留源 payload 便于回溯
|
||||
- 清洗装载至 DWD,维度走 SCD2,事实按时间增量
|
||||
- 汇总至 DWS:助教业绩、财务日报、会员分析、工资计算、自定义指数算法(WBI/NCI/RS/OS/MS/ML)
|
||||
- 支持在线(API 抓取)和离线(JSON 回放)两种模式
|
||||
- ETL Connector(`apps/etl/connectors/feiqiu/`):上游 SaaS API → ODS → DWD → DWS 三层处理
|
||||
- FastAPI 后端(`apps/backend/`):业务 API 服务
|
||||
- 微信小程序(`apps/miniprogram/`):C 端用户界面
|
||||
- 管理后台(`apps/admin-web/`):任务管理、调度配置、数据查看、ETL 监控
|
||||
- MCP Server(`apps/mcp-server/`):AI 工具集成服务
|
||||
- 共享包(`packages/shared/`):枚举、金额精度、时间工具
|
||||
|
||||
## 业务上下文
|
||||
- 多门店隔离:通过 `site_id` + RLS 实现
|
||||
- 多门店隔离:`site_id` + RLS
|
||||
- 核心实体:会员、助教、台桌、订单、支付、退款、团购套餐、库存
|
||||
- 领域语言以中文为主;代码注释、文档、UI 文案均为中文
|
||||
- 货币:人民币(CNY),金额以 numeric(2) 存储
|
||||
- 领域语言中文;货币 CNY,金额 numeric(2)
|
||||
|
||||
## 主要入口
|
||||
详见 `tech.md` 常用命令节。
|
||||
> ETL 功能细节、指数算法等见 `product-full.md`(fileMatch:读到 ETL 任务/模型/业务规则文件时自动加载,也可 `#product-full` 手动加载)。
|
||||
|
||||
Reference in New Issue
Block a user