# 快速启动指南

## 方式一：使用Docker（推荐 - 最简单）

### 1. 确保Docker Desktop已安装并运行

### 2. 创建配置文件
在项目根目录创建 `.env` 文件（如果不存在）：
```bash
copy .env.example .env
```

编辑 `.env` 文件，配置必要的信息（数据库密码、API密钥等）

### 3. 启动所有服务
```bash
# Windows
start.bat

# 或者手动执行
docker-compose up -d
```

### 4. 访问系统
- 前端: http://localhost
- 后端API: http://localhost:8080/api
- 默认账号: admin / admin123

---

## 方式二：本地开发环境

### 前置要求
- ✅ JDK 17+
- ✅ Maven 3.8+
- ✅ Node.js 18+
- ✅ MySQL 8.0+

### 步骤1: 启动MySQL数据库

```bash
# 启动MySQL服务
# Windows: 在服务中启动MySQL
# Linux: sudo systemctl start mysql
```

### 步骤2: 创建数据库

```sql
-- 连接MySQL
mysql -u root -p

-- 执行数据库脚本
source database/schema.sql
source database/sample_data.sql
```

### 步骤3: 启动后端服务

**打开第一个命令行窗口：**

```bash
# 进入后端目录
cd backend

# 启动Spring Boot（会自动编译）
mvn spring-boot:run
```

或者如果已经编译过：
```bash
cd backend
java -jar target/medical-info-system-1.0.0.jar
```

后端服务将在 **http://localhost:8080** 启动

### 步骤4: 启动前端服务

**打开第二个命令行窗口：**

```bash
# 进入前端目录
cd frontend

# 安装依赖（首次运行）
npm install

# 启动开发服务器
npm run dev
```

前端服务将在 **http://localhost:3000** 启动

---

## 验证服务状态

### 检查后端
访问: http://localhost:8080/api/inquiries

应该返回JSON数据（即使是空数组）

### 检查前端
访问: http://localhost:3000

应该看到登录页面

---

## 常见问题

### 1. 端口被占用
```bash
# Windows查看端口占用
netstat -ano | findstr :8080
netstat -ano | findstr :3000

# 结束进程
taskkill /PID <进程ID> /F
```

### 2. 后端启动失败
- 检查MySQL是否已启动
- 检查`application.yml`中的数据库配置
- 确认数据库已创建

### 3. 前端启动失败
- 删除`node_modules`文件夹，重新`npm install`
- 检查Node.js版本是否为18+

### 4. Maven依赖下载慢
编辑 `backend/pom.xml`，添加国内镜像：
```xml
<repositories>
    <repository>
        <id>aliyun</id>
        <url>https://maven.aliyun.com/repository/public</url>
    </repository>
</repositories>
```

---

## 开发工具建议

### 后端开发
- **IntelliJ IDEA** (推荐)
- **Eclipse** with Spring Tools

### 前端开发
- **VS Code** (推荐)
  - 安装插件: Vue Language Features (Volar)
  - 安装插件: ESLint

---

## 下一步

1. 使用默认账号登录系统
2. 创建第一个查询请求
3. 配置知识库
4. 配置Dify API和大模型API

详细文档请参考：
- [PROJECT_STRUCTURE.md](./PROJECT_STRUCTURE.md) - 项目结构
- [DEPLOYMENT.md](./DEPLOYMENT.md) - 完整部署指南