AutoMedinfo/START_GUIDE.md

2.9 KiB
Raw Blame History

快速启动指南

方式一使用Docker推荐 - 最简单)

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

2. 创建配置文件

在项目根目录创建 .env 文件(如果不存在):

copy .env.example .env

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

3. 启动所有服务

# Windows
start.bat

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

4. 访问系统


方式二:本地开发环境

前置要求

  • 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数据即使是空数组

检查前端

访问: http://localhost:3000

应该看到登录页面


常见问题

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

下一步

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

详细文档请参考: