Neo-ZQYY/.kiro/steering/product.md

inclusion

inclusion
always

产品概述

NeoZQYY Monorepo — 面向台球门店业务的全栈数据平台，包含 ETL Connector、后端 API、管理后台、微信小程序。

子系统

• 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 回放）两种模式

业务上下文

• 多门店隔离：通过 site_id + RLS 实现
• 核心实体：会员、助教、台桌、订单、支付、退款、团购套餐、库存
• 领域语言以中文为主；代码注释、文档、UI 文案均为中文
• 货币：人民币（CNY），金额以 numeric(2) 存储

主要入口

详见 tech.md 常用命令节。