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

## 快速开始

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

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

1. **启动后端**（终端1）
```bash
cd /Users/destiny/dev/emoon/demos/lab_report_interpret
mvn spring-boot:run
```
后端启动在：http://localhost:8080

2. **启动前端**（终端2）
```bash
cd /Users/destiny/dev/emoon/demos/lab_report_interpret/frontend
npm run dev
```
前端启动在：http://localhost:3000

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

✅ **优点**：
- 前端代码修改后自动热更新
- 无需手动构建
- 开发效率高

---

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

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

1. **构建前端**
```bash
cd /Users/destiny/dev/emoon/demos/lab_report_interpret/frontend
npm run build
```

2. **启动后端**
```bash
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