# LQAgentPlatform

施工方案智能审查与编写系统（FastAPI + LangGraph + Celery）

## 环境安装

```bash
# 1. 安装生产依赖
pip install -r requirements/base.txt -i https://mirrors.aliyun.com/pypi/simple/

# 2. 安装开发依赖（可选，含 pytest/ruff/mypy）
pip install -r requirements/dev.txt -i https://mirrors.aliyun.com/pypi/simple/

# 3. 注册项目路径（替代 sys.path.insert，秒级完成）
pip install -e .
```

## 启动服务

```bash
# 开发模式（单进程）
uvicorn server.app:app --port=8001 --host=0.0.0.0

# 开发模式（含 Celery Worker）
python server/app.py --host 0.0.0.0 --port 8001

# 生产模式（多进程）
gunicorn -c gunicorn_config.py server.app:app
```

## Docker 部署

```bash
# 首次或依赖变更时：构建 base 镜像（耗时较长）
docker build -f Dockerfile.base -t lq-agent-base:latest .

# 日常构建：秒级（仅复制源码）
docker build -t lq_agent_platform_server_dev:v1.0 .

# 启动
docker-compose -f docker/docker-compose.yml up -d
```

## 运行测试

```bash
pytest utils_test/<TestDir>/
```

## 项目结构

```
server/          — 应用入口（app/factory/routes/celery_manager/runner）
views/           — API 路由层
core/            — 业务逻辑（审查引擎、编写引擎、工作流编排）
foundation/      — 基础设施（AI 模型、数据库、Redis、Celery、链路追踪）
config/          — 配置文件 & Prompt 模板
requirements/    — 依赖清单（base.txt 生产 / dev.txt 开发）
data_pipeline/   — Milvus 向量库灌入工具
utils_test/      — 按模块组织的测试套件
```

## API 路由前缀

| 前缀 | 功能 |
|------|------|
| `/sgsc` | 施工方案审查 |
| `/sgbx` | 施工方案编写 |
| `/health` | 健康检查 |
| `/celery/status` | Celery 状态 |

## 架构约束

- `views/` 禁止直接导入 `foundation/database/`
- `core/component/` 禁止直接导入 `foundation/database/`
- 配置读取通过 `config_handler.get(section, key)`
- 提交前运行 `python scripts/check_imports.py`