lab_report_interpret/开发说明.md

检验报告解读系统 - 开发说明

快速开始

方式一：开发模式（推荐用于开发调试）

特点：前端热更新，修改代码后自动刷新，无需重启

1. 启动后端（终端1）

   cd /Users/destiny/dev/emoon/demos/lab_report_interpret
   mvn spring-boot:run
   

   后端启动在：http://localhost:8080

2. 启动前端（终端2）

   cd /Users/destiny/dev/emoon/demos/lab_report_interpret/frontend
   npm run dev
   

   前端启动在：http://localhost:3000

3. 访问应用 打开浏览器访问：http://localhost:3000

✅ 优点：

• 前端代码修改后自动热更新
• 无需手动构建
• 开发效率高

---

方式二：生产模式（推荐用于演示部署）

特点：前后端整合在一起，只需启动一个服务

1. 构建前端

   cd /Users/destiny/dev/emoon/demos/lab_report_interpret/frontend
   npm run build
   

2. 启动后端

   cd /Users/destiny/dev/emoon/demos/lab_report_interpret
   mvn spring-boot:run
   

3. 访问应用 打开浏览器访问：http://localhost:8080

✅ 优点：

• 只需启动一个服务
• 前后端整合在一起
• 适合演示和生产环境

❌ 缺点：

• 修改前端代码后需要重新构建
• 开发效率较低

---

项目结构

lab-report-interpret/
├── src/main/java/          # 后端Java代码
├── src/main/resources/     # 后端资源文件
├── frontend/               # 前端Vue项目
│   ├── src/               # 前端源代码
│   ├── dist/              # 前端构建产物（自动生成）
│   └── package.json       # 前端依赖配置
└── target/classes/static/ # Spring Boot静态资源目录（从frontend/dist复制）

常见问题

Q: 修改前端代码后看不到变化？

A:

• 开发模式：访问 http://localhost:3000，会自动热更新
• 生产模式：需要运行 npm run build 重新构建，然后刷新浏览器

Q: 前端代理配置在哪里？

A: 在 frontend/vite.config.js 中，API请求会自动代理到 http://localhost:8080

Q: 如何切换开发/生产模式？

A:

• 开发模式：运行 npm run dev，访问 3000 端口
• 生产模式：运行 npm run build，访问 8080 端口

技术栈

• 后端: Spring Boot 3.2 + Java 17
• 前端: Vue 3 + Vite 5
• AI: LangChain4J + 阿里云百炼
• 工具: Hutool + Lombok