LQAgentPlatform/README.md

LQAgentPlatform

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

环境安装

# 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 .

启动服务

# 开发模式（单进程）
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 部署

# 首次或依赖变更时：构建 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

运行测试

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