微信小程序页面迁移校验之前 P5任务处理之前

.kiro/steering/project-overview.md

@@ -0,0 +1,36 @@
+---
+inclusion: always
+---
+# 项目概览
+
+NeoZQYY Monorepo — 面向台球门店业务的全栈数据平台。多门店隔离（`site_id` + RLS），领域语言中文，货币 CNY，金额 numeric(2)。
+
+## 子系统与目录
+| 目录 | 说明 |
+|------|------|
+| `apps/etl/connectors/feiqiu/` | 飞球 Connector：上游 SaaS API → ODS → DWD → DWS |
+| `apps/backend/` | FastAPI 后端 |
+| `apps/miniprogram/` | 微信小程序（C 端） |
+| `apps/admin-web/` | 管理后台（React + Vite + Ant Design） |
+| `apps/mcp-server/` | MCP Server（AI 工具集成） |
+| `packages/shared/` | 跨项目共享包（枚举、金额精度、时间工具） |
+| `db/` | DDL / 迁移 / 种子（`etl_feiqiu/`、`zqyy_app/`、`fdw/`） |
+| `docs/` | 项目级文档 + `audit/`（统一审计落地点） |
+| `tests/` | Monorepo 级属性测试（hypothesis） |
+| `scripts/` | 项目级运维脚本（`ops/`、`audit/`、`migrate/`、`server/`） |
+
+## 高风险路径（变更需审计）
+- ETL：`api/`、`cli/`、`config/`、`database/`、`loaders/`、`models/`、`orchestration/`、`scd/`、`tasks/`、`utils/`、`quality/`
+- `apps/backend/app/`、`apps/admin-web/src/`、`apps/miniprogram/miniprogram/`
+- `packages/shared/`、`db/`、根目录散文件（`.env*`、`pyproject.toml`）
+
+## 文件归属规则
+- 模块专属 docs/tests/scripts → 模块内部
+- 项目级/跨模块 → 根目录对应文件夹
+- 审计产物统一写 `docs/audit/`，禁止写入子模块
+- 编码：UTF-8、纯 SQL、迁移脚本日期前缀、任务大写蛇形
+
+## 治理
+任何逻辑改动必须可追溯、可验证、可回滚。审计检测与提醒由 hooks 自动执行（`agent-on-stop` + `prompt-on-submit`），用户按需手动触发 `/audit`。
+
+> 详细目录树见 `structure.md`（fileMatch 自动加载）；ETL 功能细节见 `product-full.md`（fileMatch 自动加载）。