Neo-ZQYY/.kiro/steering/structure-lite.md

inclusion

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）
• packages/shared/ — 跨项目共享包
• db/ — DDL / 迁移 / 种子（etl_feiqiu/、zqyy_app/、fdw/）
• docs/ — 项目级文档 + audit/（统一审计落地点）
• tests/ — Monorepo 级属性测试
• scripts/ — 项目级运维脚本

高风险路径（变更需审计）

• apps/etl/connectors/feiqiu/ 下：api/、cli/、config/、database/、loaders/、models/、orchestration/、scd/、tasks/、utils/、quality/
• apps/backend/app/、apps/admin-web/src/、apps/miniprogram/miniapp/、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