# 钢研院智能问答平台（gangyan）

面向冶金行业的 LLM 智能问答系统，提供智能对话、文档撰写、知识库管理、文献检索、翻译等功能。

## 项目结构

| 模块 | 路径 | 技术栈 | 端口 |
|------|------|--------|------|
| 前端 | `chat_web_front/` | Vue 3 + TypeScript + Element Plus + Vite | :3000 (上下文 `/metalinfo`) |
| Java 后端 | `chat_web_backend/` | Spring Boot 2.3.7 + MyBatis-Plus + JDK 11 | :8099 (上下文 `/chat_web_backend`) |
| Python RAG | `langchain-chat/` | Python 3.11 + FastAPI + LangChain + Milvus | :7861 |

## 基础设施

| 服务 | 端口 | 说明 |
|------|------|------|
| MySQL 8.4.4 | 33306 | 数据库 `chat_gpt_yj`，root/1234567890 |
| Redis | 6379 | 无密码，database 0 |
| Milvus 2.6.4 | 19530 | 向量数据库 |
| MinIO | 9002(console)/9003(API) | 对象存储（Milvus 依赖） |
| Embedding API | 10.102.24.75:3000 | bge-m3 向量模型 + LLM 网关 |

## 项目位置

- 服务器路径：`/opt/download/oss_files/gangyan-deploy/gangyan`
- Git 仓库：`http://123.57.146.97:3000/liuguancen/gangyan.git`
- 分支：`main`

## 详细文档索引

- [系统架构与运行配置](architecture.md) — 服务拓扑、各模块详细配置、包结构、API 分组
- [开发构建指南](development-guide.md) — 启动顺序、构建命令、环境要求、日志与健康检查
- [Agent 协同规则](agent-coordination.md) — 多 Agent 并行开发的分支、接口变更、提交规范