2.9 KiB
2.9 KiB
快速启动指南
方式一:使用Docker(推荐 - 最简单)
1. 确保Docker Desktop已安装并运行
2. 创建配置文件
在项目根目录创建 .env 文件(如果不存在):
copy .env.example .env
编辑 .env 文件,配置必要的信息(数据库密码、API密钥等)
3. 启动所有服务
# 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数据库
# 启动MySQL服务
# Windows: 在服务中启动MySQL
# Linux: sudo systemctl start mysql
步骤2: 创建数据库
-- 连接MySQL
mysql -u root -p
-- 执行数据库脚本
source database/schema.sql
source database/sample_data.sql
步骤3: 启动后端服务
打开第一个命令行窗口:
# 进入后端目录
cd backend
# 启动Spring Boot(会自动编译)
mvn spring-boot:run
或者如果已经编译过:
cd backend
java -jar target/medical-info-system-1.0.0.jar
后端服务将在 http://localhost:8080 启动
步骤4: 启动前端服务
打开第二个命令行窗口:
# 进入前端目录
cd frontend
# 安装依赖(首次运行)
npm install
# 启动开发服务器
npm run dev
前端服务将在 http://localhost:3000 启动
验证服务状态
检查后端
访问: http://localhost:8080/api/inquiries
应该返回JSON数据(即使是空数组)
检查前端
应该看到登录页面
常见问题
1. 端口被占用
# 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,添加国内镜像:
<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
下一步
- 使用默认账号登录系统
- 创建第一个查询请求
- 配置知识库
- 配置Dify API和大模型API
详细文档请参考:
- PROJECT_STRUCTURE.md - 项目结构
- DEPLOYMENT.md - 完整部署指南