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
WangXuMing
a104aadf2b
chore: 提交敏感词库清理和测试文件