172 lines
2.9 KiB
Markdown
172 lines
2.9 KiB
Markdown
# 快速启动指南
|
||
|
||
## 方式一：使用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) - 完整部署指南
|
||
|
||
|
||
|
||
|