---
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` 定义

## 常用命令
```bash
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` 手动加载）。