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

inclusion

inclusion
always

技术栈

• Python 3.10+，uv workspace（4 成员：etl/connectors/feiqiu、backend、mcp-server、shared）
• 管理后台：React + Vite + Ant Design（apps/admin-web/，独立 pnpm）
• PostgreSQL 四库：etl_feiqiu / test_etl_feiqiu（ETL，六层 Schema）、zqyy_app / test_zqyy_app（业务）
• DSN：PG_DSN（ETL）、APP_DB_DSN（业务），根 .env 定义
• 配置分层：根 .env < .env.local < 环境变量 < CLI 参数；ETL 配置类 → AppConfig

常用命令

uv sync                                                    # 安装依赖
cd apps/etl/connectors/feiqiu && python -m cli.main --dry-run --tasks DWD_LOAD_FROM_ODS
cd apps/backend && uvicorn app.main:app --reload
cd apps/etl/connectors/feiqiu && pytest tests/unit         # ETL 单元测试
cd C:\NeoZQYY && pytest tests/ -v                          # 属性测试

脚本规范

• 复杂操作优先写 Python 脚本，避免 PowerShell 复杂逻辑
• 一次性运维脚本 → scripts/ops/；模块专属 → 模块内 scripts/

依赖清单、DDL 基线等见 tech-full.md（fileMatch 自动加载）。