34 lines
1.5 KiB
Markdown
34 lines
1.5 KiB
Markdown
---
|
||
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` 手动加载）。
|