---
inclusion: always
---

# 项目结构（Lite）

> 详细目录树、架构模式、文件归属规则展开说明见 `structure.md`（读到 pyproject.toml 或 agent 定义时自动加载，也可 `#structure-full` 手动加载）。

## 顶层目录
- `apps/etl/connectors/feiqiu/` — 飞球 Connector
- `apps/backend/` — FastAPI 后端
- `apps/miniprogram/` — 微信小程序
- `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 级属性测试
- `scripts/` — 项目级运维脚本（`ops/`、`audit/`、`migrate/`、`server/`）

## 高风险路径（变更需审计）
- `apps/etl/connectors/feiqiu/` 下：`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/tests/scripts → 放根目录
- 审计产物统一写 `docs/audit/`，禁止写入子模块内部
- 一览表刷新：`python scripts/audit/gen_audit_dashboard.py`

## 编码/命名约定
- UTF-8、纯 SQL（非 ORM）、迁移脚本 `db/etl_feiqiu/migrations/`（日期前缀）
- 任务大写蛇形（`DWD_LOAD_FROM_ODS`）、日志经 `utils/logging_utils.py`