From 971e1546f0383e26e1b6f32326c7bc925934a650 Mon Sep 17 00:00:00 2001 From: weijuesen Date: Wed, 12 Aug 2026 17:00:28 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=B0=8F=E7=A8=8B=E5=BA=8F=E6=8B=8D?= =?UTF-8?q?=E7=85=A7=E5=B7=A1=E6=A3=80=EF=BC=88#8=EF=BC=89=E5=8F=98?= =?UTF-8?q?=E6=9B=B4=E8=AE=B0=E5=BD=95=E4=B8=8E=E5=BC=80=E5=8F=91=E4=BA=A4?= =?UTF-8?q?=E6=8E=A5=E8=AE=B0=E5=BD=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 变更记录.md | 9 +++++++++ 开发交接记录.md | 21 +++++++++++++++++++++ 2 files changed, 30 insertions(+) diff --git a/变更记录.md b/变更记录.md index 22acd6c..151a10a 100644 --- a/变更记录.md +++ b/变更记录.md @@ -119,6 +119,15 @@ - 验证：ai-service 服务器 pytest 6/6；巡检冒烟——创建 201（mock 检测 healthy/0.95）→ 同 key 重试返回同记录 → 列表 1 条 → 图片 URL 200；非法 roomId 400 - 回滚点：Go 旧二进制 `server-go-linux.old-20260812-9`；ai-service 停 uvicorn 即可；记录见服务器 README +### 小程序拍照巡检（计划 #8） + +- `miniapp/src/api/inspections.ts`（新增）：`uploadInspection`（Taro.uploadFile，multipart 上传 + 自动生成 `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 安全与界面优化整改 ### 变更背景 diff --git a/开发交接记录.md b/开发交接记录.md index 50c234d..13b323b 100644 --- a/开发交接记录.md +++ b/开发交接记录.md @@ -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`）。