# 问答系统

**Repository Path**: guo-sufang/qa-system

## Basic Information

- **Project Name**: 问答系统
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-10
- **Last Updated**: 2026-02-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Enterprise QA System (RAG)

## 项目简介
这是一个基于 RAG (Retrieval-Augmented Generation) 的企业知识问答系统。
- **前端**: Vue 3 + Element Plus
- **后端**: FastAPI + Python 3.10
- **数据库**: MySQL (用户数据), Milvus (向量数据)
- **LLM**: 通义千问 (Qwen)

## 快速开始

### 前置要求
- Docker & Docker Compose
- Python 3.10+ (本地开发)
- Node.js 18+ (本地开发)

### 运行方式 (Docker)

> **注意**: 默认配置假设您在 Windows 上运行 Docker，且本地已安装并运行了 Milvus 服务 (端口 19530) 和 Redis 服务 (端口 6379, 密码 1234)。Docker 容器将通过 `host.docker.internal` 连接宿主机的这些服务。

1. **构建并启动服务**
   ```bash
   docker-compose up --build -d
   ```

2. **访问服务**
   - 前端页面: http://localhost:80
   - 后端文档: http://localhost:8000/docs

### 常见问题与排查

1. **Milvus/Redis 连接失败**
   - 确保本地服务已在 `F:\milvus_redis` 下启动。
   - 如果 Docker 无法解析 `host.docker.internal`，请检查 Docker Desktop 设置或防火墙规则。
   - 可以在 backend 容器内运行 `python check_deps.py` 进行诊断。

2. **端口冲突**
   - 本项目 MySQL 默认映射到宿主机 **3308** 端口，以避免与本地 MySQL (通常在 3306) 冲突。
   - 前端占用 **80** 端口，如遇冲突请在 `docker-compose.yml` 中修改。

### 本地开发

#### 后端
1. 进入 backend 目录
   ```bash
   cd backend
   ```
2. 创建虚拟环境并安装依赖
   ```bash
   python -m venv venv
   source venv/bin/activate  # Windows: venv\Scripts\activate
   pip install -r requirements.txt
   ```
3. 启动服务
   ```bash
   uvicorn app.main:app --reload
   ```

#### 前端
1. 进入 frontend 目录
   ```bash
   cd frontend
   ```
2. 安装依赖
   ```bash
   npm install
   ```
3. 启动开发服务器
   ```bash
   npm run dev
   ```

## 注意事项
- 默认使用阿里云 DashScope API，请在 `.env` 或 `backend/app/core/config.py` 中配置您的 API Key。
- 数据库密码默认为 `123456`，生产环境请修改。