传统设备维保行业存在四个核心痛点：① 客户报修走电话/微信，工程师响应慢、过程不透明；② 工单记录靠 Excel + 微信群，月底统计/绩效考核靠人工；③ 工程师现场到岗缺乏 GPS 围栏 + 拍照水印证据，客户扯皮多；④ 巡检计划靠人盯，超期/漏检频发。本项目以"客户扫码报修 → 客服审核派单 → 工程师移动端接单打卡 → Word 工单归档 → AI 自动日报"为主线，覆盖工单、巡检、报修、知识库、AI 日报、SLA 预警全链路。
面向制造企业、物业公司、设备服务商、维保公司、连锁门店的设备运维场景。客户通过手机扫码即可报修，客服在后台审核派单，工程师移动端接单后按 GPS 围栏打卡，作业过程拍照叠水印留证，完工后 Word 工单流式下载归档。AI 每日自动聚合工程师工作数据生成日报/周报，SLA 即将超时的工单提前 2 小时通知，超期标记防重复打扰。
**功能模块：** ① Word 工单导出（Apache POI 模板引擎，含复选框 ☐/☑ 处理 + 签字 base64）；② AI 日报 + 语音转文字（OpenAI Whisper + GPT，**带降级到模板**）；③ SLA 超时预警（Quartz 每 10 分钟扫，提前 2h 通知 + sla_warning_sent 防重）；④ 巡检计划自动展开（每日/周一/每月 1 号/cron 四种频率）；⑤ GPS 电子围栏 + 拍照水印（uni-app Canvas 自研，**零依赖**）；⑥ 客户门户 Vue3 重构（指标卡 + ECharts 资产健康度 + 30 天趋势）；⑦ 报修 → 工单状态机（6 状态：报修/审核/派单/打卡/提交/确认/评价）；⑧ 知识库 + 合同（Tesseract OCR + EasyExcel）。
**主要功能描述：** 三种角色（客户/客服/工程师）+ 三种端（PC 后台/客户门户/移动端 APP）全打通。技术亮点不在 CRUD，而在工程化细节：模板引擎自己写、OCR 自己接、AI 网关带降级、SLA 用 200 条分批循环防 OOM、围栏打卡零依赖自研。这套东西在制造/物业/连锁行业的真实生产环境里跑过，事务、超时、降级、批处理这些细节都踩过坑。
**我负责的具体任务：** 全栈独立完成。包含：Spring Boot 后端 + Vue2 后台 PC + Vue3 客户门户 + uni-app 移动端工程师 APP + 13 张业务表设计 + Word 工单模板引擎自研（WorkOrderTemplateRenderer / FieldMapper / PhotoCollector 三职责拆分）+ AI 日报网关（带降级到模板）+ SLA 定时任务（Quartz + 分批循环）+ 巡检计划自动展开（4 种频率）+ GPS 围栏 + 拍照水印自研组件（uni-app Canvas）+ 知识库 OCR（Tesseract）+ 客户门户 Vue3 重构（718 行单文件 + ECharts）。
**技术栈 / 架构 / 亮点难点：**
- **Word 模板引擎**：Apache POI 自研，含 run 段处理（复选框 ☐/☑）+ 签字 base64 + 流式下载
- **AI 网关**：OpenAI Whisper + GPT 聚合，**挂了自动降级到模板**（绝不让用户面对白屏）
- **SLA 预警**：Quartz 定时 + 200 条分批循环防 OOM + `sla_warning_sent='Y'` 防重
- **巡检展开**：Java 17 switch 表达式 + `existsTodayTaskByPlanAndAsset` 防重
- **围栏 + 水印**：uni-app Canvas 手写签名 / GPS 围栏打卡 / 拍照叠时间地点水印，零依赖
- **状态机**：6 状态完整闭环 + `@Transactional` + 6 张表 join
- **难点**：模板引擎跑段处理 + AI 降级到模板的容错路径 + 单文件 718 行的客户门户重构
评论