docs: 小程序拍照巡检(#8)变更记录与开发交接记录

This commit is contained in:
weijuesen
2026-08-12 17:00:28 +08:00
parent 8274cc8c14
commit 971e1546f0
2 changed files with 30 additions and 0 deletions
+9
View File
@@ -119,6 +119,15 @@
- 验证:ai-service 服务器 pytest 6/6;巡检冒烟——创建 201mock 检测 healthy/0.95)→ 同 key 重试返回同记录 → 列表 1 条 → 图片 URL 200;非法 roomId 400 - 验证:ai-service 服务器 pytest 6/6;巡检冒烟——创建 201mock 检测 healthy/0.95)→ 同 key 重试返回同记录 → 列表 1 条 → 图片 URL 200;非法 roomId 400
- 回滚点:Go 旧二进制 `server-go-linux.old-20260812-9`ai-service 停 uvicorn 即可;记录见服务器 README - 回滚点:Go 旧二进制 `server-go-linux.old-20260812-9`ai-service 停 uvicorn 即可;记录见服务器 README
### 小程序拍照巡检(计划 #8
- `miniapp/src/api/inspections.ts`(新增):`uploadInspection`Taro.uploadFilemultipart 上传 + 自动生成 `Idempotency-Key`)、`listInspections`
- `miniapp/src/pages/inspection/`(新增):拍照/相册选图 → 预览 → 上传 AI 检测 → 结果卡片(类别 + 置信度 + 风险提示)→ 巡检历史记录(最近 10 条)
- `miniapp/src/types/index.ts`:新增 `InspectionRecord` / `AIDetection`
- 设置页新增「拍照巡检」入口;`app.config.ts` 注册页面
- 后端接口复用 #5/#6 已部署的 `POST/GET /api/v1/inspections`,无需服务端改动;`npm run build:weapp` 通过
- 说明:风险分级(绿/黄/橙/红)待 #9 评分引擎落地后接入;类名映射当前为 healthy/sick,7 类病种扩展后补充
## 2026-07-17 安全与界面优化整改 ## 2026-07-17 安全与界面优化整改
### 变更背景 ### 变更背景
+21
View File
@@ -199,6 +199,27 @@
--- ---
## 2026-08-12 模块:小程序拍照巡检(计划 #8)
### 做了什么
- 新增 `pages/inspection/`:拍照/相册选图(压缩)→ 预览 → 上传 `POST /api/v1/inspections`multipart,自动生成 `Idempotency-Key` 防重复)→ 结果卡片(AI 类别 + 置信度 + 风险提示文案)→ 巡检历史列表(最近 10 条)。
- 设置页「监控管理」新增「拍照巡检」入口;`app.config.ts` 注册页面。
### 思路与决策
- 复用 #5/#6 已部署的后端接口,本期纯小程序端,无服务端改动;
- 上传用 `Taro.uploadFile`(不是通用 request 封装),因为需要文件流 + 自定义头(Authorization / Idempotency-Key);
- 幂等键客户端生成(时间戳 + 随机串),弱网重试不会重复创建巡检记录;
- 结果展示先按二分类(healthy/sick)映射,风险分级(绿/黄/橙/红)等 #9 评分引擎落地后接入;7 类病种扩展后补充类名映射。
### 验证
- `npm run build:weapp` 编译通过;后端接口此前已冒烟(创建→幂等重试→列表→图片 200)。
- 相关提交:`8274cc8`
---
## 环境与踩坑备忘(新同事必读) ## 环境与踩坑备忘(新同事必读)
- **VPN**:开发服务器经 NetBird 访问;服务 Running 后需 `netbird up`,登录走 SSO(管理端 `115.191.19.95:6680`)。 - **VPN**:开发服务器经 NetBird 访问;服务 Running 后需 `netbird up`,登录走 SSO(管理端 `115.191.19.95:6680`)。