## 20:31 - AI 模块新增完成

### 改动
1. **新增 `module/ai/` 模块**，包含完整的目录结构：
   - `config/`: AiProperties (baseUrl/apiKey/model 配置), AiRestConfig (RestTemplate Bean)
   - `controller/AiController`: 3 个端点
   - `dto/`: DeepSeekChatRequestDTO/ResponseDTO (OpenAI 兼容格式), AiChatRequestDTO/ResponseDTO, ImageUploadResponseDTO
   - `service/`: AiService 接口 + AiServiceImpl 实现
2. **API 端点**：
   - `POST /ai/upload` — 图片上传转 base64
   - `POST /ai/chat?text=...` — 纯文本对话
   - `POST /ai/chat-multi` — 多模态（文本+图片 multipart）
3. **DeepSeek 配置**：baseUrl=http://192.168.2.74:3000/v1, model=deepseek-v4-flash（保存在 AiProperties，可通过 yaml 覆写）
4. **集成测试**（AiControllerTest）：4 个用例全绿 ✅
   - 登录 + 图片上传 + 纯文本对话 + 多模态对话
   - 注意：测试图片从 1x1 改为 32x32（模型要求最小 10x10）
## 21:23 - AI 单据识别模块（深刻优化）

### 业务背景
- 前端上传采购单/销售单照片 → 后端调 AI 识别 → 模糊匹配供应商/客户/物料 ID → 返回前端表单
- AI 返回的是自然语言文本（"8.5玻璃棒"），后端需要匹配到 DB 中的 `Material.id`

### 关键实现决策

**DTO 设计（`AiRecognitionResultDTO`）**
- `typeValue` (Integer: 10/20/30) + `typeName` (String: 采购入库/销售出库) — 符合后端 Inbound/Outbound 实体字段
- `Counterparty`：封装 `id` + `name` + `recognizedName`（AI 原始名）+ `exactMatch`（前端据此标记需确认）
- `RecognitionItem`：`materialId` + `materialName` + `materialCode` + `spec` + `unit` + `recognizedName` + `quantity` + `price` + `exactMatch`
- 厂商用 `Counterparty` 统一供应商和客户；物料用 `MaterialFillService.getMaterialInfo()` 补全编码/规格/单位

### 物料模糊匹配（三重降级）

1. **去空格 LIKE**：`REPLACE(name, ' ', '')` 匹配 AI 返回的无空格文本
2. **分词 LIKE**：按非数字/非CJK字符切割，最长片段单独搜索
3. **数字+CJK 分离**：`"8.5玻璃棒"` → 数字段 `"8.5"` + 汉字段 `"玻璃棒"`，分别搜索后交叉匹配

最终 4 条物料测试全部匹配：
- `8.5玻璃棒` → `8.5 玻璃棒` (id=31) ✅
- `4.0玻璃棒` → `8.5 玻璃棒` (id=31) ⚠️ 数字不同但物料名匹配（允许用户调整）
- `透明A级560*270*61` → `透明 A 级 560*270*61` (id=39) ✅
- `透明A级580*200*31` → `透明 A 级 580*200*17` (id=40) ⚠️ 规格相近

### 供应商/客户模糊匹配
- 去空格 LIKE → 分词 → 最长片段搜索 → 双词组合
- 待补充：后缀切割降级（"老兵店"去掉"店"→"老兵"→匹配"老兵水晶店"）

### 测试
- 4 个测试用例全绿 ✅
- 使用 `application-local.yml`（localhost:31983）而不是 Docker 测试库
- `mvn test -pl :tiny-erp -Dtest=AiControllerTest -Dspring.profiles.active=local -Dmaven.test.failure.ignore=false`