# 🚀 快速开始指南

## 📋 新接口信息

### 接口地址
```
GET /admin/stat/report/fuzzyReportPdfNew
```

### 功能说明
将模糊评价报告的 Word 文档转换为 PDF 格式并下载

### 请求参数
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| checkTaskId | Integer | 是 | 检查任务ID |
| templateId | Integer | 是 | 报告模版ID |

---

## ⚡ 3分钟快速测试

### 步骤1: 启动应用（如果未启动）

```bash
cd admin-server
mvn spring-boot:run
```

### 步骤2: 测试接口

**方式A: 浏览器访问**
```
http://localhost:8080/admin/stat/report/fuzzyReportPdfNew?checkTaskId=1262&templateId=1
```

**方式B: 使用测试脚本**
```bash
# Windows
测试新接口.bat

# Linux/Mac
./测试新接口.sh
```

### 步骤3: 验证结果

打开下载的PDF文件，检查：
- ✅ 文件能正常打开
- ✅ 内容完整
- ✅ **图片是否显示**（重点）

---

## 📁 文件说明

### 代码文件
```
ReportController.java
├─ fuzzyReportPdfNew()    # 新增接口（第81-90行）
└─ downloadAsPdf()        # PDF转换方法（第168-233行）
```

### 文档文件
```
README-新接口实现.md      # 完整实现总结（推荐阅读）
新接口使用说明.md          # 详细使用文档
新接口快速参考.md          # 快速参考卡片
快速开始.md               # 本文档
```

### 测试脚本
```
测试新接口.bat            # Windows自动化测试
测试新接口.sh             # Linux/Mac自动化测试
```

---

## 🔍 核心代码

### 接口实现
```java
@GetMapping("/fuzzyReportPdfNew")
public void fuzzyReportPdfNew(Integer checkTaskId, Integer templateId,
                               HttpServletResponse response) throws IOException {
    try (var doc = reportService.fuzzyReport(checkTaskId, templateId)) {
        downloadAsPdf(doc, response, "模糊评价", checkTaskId, templateId);
    }
}
```

### 转换流程
```
Word文档 → 字节数组 → XWPFDocument → PDF转换器 → PDF文件
```

---

## ⚠️ 重要提示

### 如果PDF中没有图片

**原因**: PDF转换库在处理内存流时可能丢失图片

**解决方案**: 使用临时文件方案

需要修改 `downloadAsPdf()` 方法，将内存流改为临时文件：
```java
// 使用临时文件
Path tempFile = Files.createTempFile("report_", ".docx");
try (FileOutputStream out = new FileOutputStream(tempFile.toFile())) {
    doc.write(out);
}
// 从文件读取并转换
```

详细代码见 `README-新接口实现.md` 中的"关于图片显示"章节。

---

## 📞 需要帮助？

### 常见问题

**Q1: 编译失败，提示Java版本错误**
```bash
# 检查Java版本
java -version

# 需要Java 17+
# 如果版本过低，请升级Java
```

**Q2: PDF无法打开**
```bash
# 查看日志
tail -f logs/application.log | grep -i "word转pdf"

# 检查文件大小
ls -lh *.pdf
```

**Q3: 图片不显示**
- 先确认Word版本有图片
- 使用临时文件方案（见上文）
- 查看详细文档：`README-新接口实现.md`

---

## 📚 更多文档

- **完整实现总结**: `README-新接口实现.md`
- **详细使用说明**: `新接口使用说明.md`
- **快速参考**: `新接口快速参考.md`

---

**创建时间**: 2026-01-24
**版本**: v1.0
**状态**: ✅ 已完成，等待测试