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

inclusion

inclusion
always

技术栈与构建

语言与运行时

• Python 3.10+，uv workspace（根 pyproject.toml 声明 4 个成员：etl/connectors/feiqiu、backend、mcp-server、shared）
• 管理后台：React + Vite + Ant Design（apps/admin-web/，独立 pnpm）

数据库

• PostgreSQL 远程实例，四库：etl_feiqiu / test_etl_feiqiu（ETL）、zqyy_app / test_zqyy_app（业务）
• ETL 六层 Schema：meta / ods / dwd / core / dws / app
• DSN：PG_DSN（ETL）、APP_DB_DSN（业务），根 .env 定义

常用命令

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                          # 属性测试

配置体系

• 分层叠加：根 .env < 应用 .env.local < 环境变量 < CLI 参数
• ETL 配置类：apps/etl/connectors/feiqiu/config/settings.py → AppConfig

脚本执行规范

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

核心依赖清单、DDL 基线、种子数据等详细信息见 tech-full.md（fileMatch：读到 pyproject.toml / 配置 / 迁移文件时自动加载，也可 #tech-full 手动加载）。