35 lines
1.6 KiB
Markdown
35 lines
1.6 KiB
Markdown
---
|
||
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`
|