======= 测试管理系统 H5 · 冷启动文件 =======

> 版本: 2.3 ｜ 更新: 2026-09-16 ｜ 用途: 测试管理系统（研发任务 H5 模块）的冷启动/重建/排障手册
> 入口: https://rd.huiflytech.com/test/ ｜ 数据库: ~/docs/test/test.db ｜ 服务: rd-h5.service (:13544)
>
> **v2.3 更新（2026-09-16 晚）**：
> ① ★ **电路测试分类拆分** —— 原「电路测试」31 项拆为 **功能性能(28) / 环境可靠性(高低温) / 机械应力(振动·跌落)**；两组各有独立「其他测试」：**电路组=三防漆性能测试**（内部名 `其他测试2`）、**结构组=扭力测试**
> ② 分类导航**二级选择通用化**（原硬编码仅"结构测试"生效）→ 点「电路测试」显示 4 个子模块；`CAT_LABEL` 让内部名 `其他测试2` 显示为「其他测试」
> ③ **历史会话迁移**：`category 电路测试 → 功能性能`（#6/#7）；`/api/test/sessions` 查询「功能性能」兼容旧「电路测试」
> ④ `CIRCUIT_CATS` + `isCircuitCat()` 统一「电路类」判定（基础信息字段/报告按钮/整机报告配对）
>
> **v2.2 更新（2026-09-15 ~ 09-16）**：
> ① **设备编码扫码记录** —— 所有测试项通用 + 测试员开放；jsQR 本地内嵌（`/test/jsqr.js`）；折叠列表（序号/编码/时间/删除）；`items.t_codes` 三链路保存
> ② **连续耐久循环测试**（施肥机）—— 按天记录；**温度矩阵：行=测试时间（可增删）× 列=电机/减速器/泵头**；当日**天气/气温/机油**；自动当日时长 + 总运行时长；报告三格式支持
> ③ **施肥机类型**（原"阀体类型"）4 种：软管泵集成 / 液体肥 / 固液两用 / 多通道；报告标题/字段/文件名按设备类型区分
> ④ **气密功能放宽**（不限阀体类型，项名含"气密"即可）+ 气密数据**默认折叠** + 阀体类型新增**直通阀**（14 种）
> ⑤ **设备文档列表加「← 返回设备类型」按钮**（backDev）
> ⑥ **报告按钮统一命名** Web报告/Word报告/PDF报告；Web 批量表表头**改黑字**
> ⑦ **报告生成时间可自定义**（`sessions.report_time`，编辑页可填，留空用当前时间）
> ⑧ **不合格数量/率 0 也显示**（原空白）
> ⑨ 修复 8 个 bug：测试员保存结构化数据丢失（swtime）｜耐久项记录数据不可用（分支漏判 + durOf 函数名冲突）｜耐久第2天保存失败（basePayload 抛错被空 catch 吞）｜任务负责人被判只读（全名 vs 简称）｜生成日报 500｜气密记录方式单选框缺失｜测试总数口径

====== 0. 教程与文档 ======
- 测试员快速使用教程（以 #15 为例，含 PDF）：~/docs/测试管理系统-测试员快速使用教程.md/.pdf；Wiki 页 测试管理系统h5:测试员快速使用教程

====== 1. 系统概述 ======

测试管理系统用于研发样机/阀门的**整机与电路测试全流程管理**：按设备类型（智慧阀门/施肥机/土壤墒情/气象站/蝶阀/LoRa网关）建立测试文档，预置模板测试项（电路 32 项/阀体 21 项），逐项记录测试数据与照片，输出报告。

**★ 铁律**：测试模块开发/修改绝不动任务（rd_h5）与库房（rd_store）功能；独立蓝图/独立库/独立页面。

====== 2. 部署架构 ======

- 统一服务 rd-h5.service（:13544，Flask 多蓝图：rd_h5 + rd_store + test_api）；Caddy 反代 rd.huiflytech.com→:13544；/test/ 路由在 test_api.py
- ⚠️ **服务 venv = /home/ubuntu/projects/ctwing-2/venv**（非 huifei venv！python-docx 等须装在此 venv）
- Word 导出：python-docx（横向排版含照片）；PDF 导出：docx→libreoffice（soffice --headless）
- 底部导航 5 tab（任务/库房/测试/评审会/我的）在 rd_h5.html 内嵌 tabbar

====== 3. 数据文件 ======

- `~/docs/test/test.db`（SQLite）
  - **sessions**：id/device_type/category/series/fw_ver/hw_ver/tester(负责人)/test_time/zc_no(物料编码)/supplier/batch_no/valve_type/sample_photo(样品照片;分隔)/remark(备注)/status/created
  - **items**：id/session_id/item_name/t_condition/t_method/t_tool/t_steps/t_result(通过/未通过)/t_data(测试数据)/t_followup(检查调整复测/设计变更)/t_ecr(变更详情)/t_photo/t_person/t_time/t_qty(测试数量)/t_struct(气密结构化 JSON)
- `~/docs/test/templates.json`：设备类型 6 + 分类 + 电路 32 项/阀体 21 项模板
- `~/docs/test/attachments/`：照片/附件
- `~/docs/test/report_seq.json`：报告流水号计数（日期+3位当日增序）

====== 3.1 数据结构速查（items.t_struct 各形态） ======

| 测试项类型 | 触发 | t_struct 结构 |
|---|---|---|
| 气密（全量） | 项名含"气密" | `{"mode":"full","step1":{"opens":[],"press":[],"time":"","cells":{}},"step2":{...},"meta":{parts:{}}}` |
| 气密（批量） | 记录方式=批量记录 | `{"mode":"batch","batch":{"per_batch":"160","total_batches":"4","step1":{cells:{}},"step2":{...}},"meta":{...}}`；cells 键 = `开度\|压力` → `{批次: {渗漏（台）/滴漏/重漏/流淌: 值}}` |
| 开关阀时间 | 项名含"开关阀" | `{"swtime":{"cfg":{"open_max","close_max"},"step1":{"rows":[{t,note}]},"step2":{"rows":[]}}}` |
| 扭力 | 项名含"扭力" | `{"torque":{"cfg":{...},"step1":{"rows":[]},"step2":{"rows":[]}}}` |
| 连续耐久循环 | 项名含"耐久" | `{"mode":"durability","tempInterval":"30","daily":[{"date","s","e","weather","airTemp","oil","times":["08:30"],"cells":{"电机\|08:30":"45.2"},"temps":[] }]}`（`temps` 为旧结构，`durMigrate` 自动迁移；`durFixOrphan` 并入空键）|

**sessions 关键列**：`device_type / category / valve_type(施肥机时为施肥机类型) / supplier / batch_no / zc_no / tester / test_time / status / remark / sample_photo / archived / report_time(报告生成时间，可空)`

**items 关键列**：`item_name / t_qty / t_struct / t_codes(扫码记录 JSON) / t_recs(时段) / t_photo / t_note / t_logs(操作记录) / status / t_result`

====== 4. 核心功能 ======

===== 4.1 设备类型与分类 =====
设备 6 类；智慧阀门含 电路测试/阀体测试 两分类（其余设备默认单类）

===== 4.2 测试项交互（历次定稿） =====
- 测试项以 **图标+名称列表**显示（图标按内容自动映射：功耗🔋温度🌡️扭力🔧气密💨防水💧…）；点击进入单项详情页（所有测试信息+保存+返回+单项报告）
- 每测试项字段：测试名称/测试数量/测试条件/测试方法/测试工具/测试步骤/测试数据/测试结果(☑通过☐未通过→处理方式：检查调整复测/设计变更(必填详情))/测试照片(拍照+图库双入口)/测试人员(文字输入)/测试时间
- 报告导出：空 测试人员/时间 → 横线 "______________"（打印手填）
- 新建会话先弹**测试项选择器**（勾选需要的测试项，默认全选；可全选/全不选）
- 基本信息：物料编码（🎲 随机 WL-日期-6位 / 手动）、备注栏、样品照片；阀体类型 **14 种**固定下拉（三通L/T型旋塞阀、三通L/T/D型球阀、**直通阀（2026-09-15 新增）**、双球阀、五通球阀、三通L陶瓷阀、五通单/双开陶瓷阀、双头/三头/四头阀）
- 会话列表：标题=供应商·阀体类型；下方显示 测试总数/测试系统/测试结果（后端 sessions API 聚合 agg_total/agg_system/agg_result）

===== 4.3 气密性测试结构化（**2026-09-15 放宽：任何阀体，测试项名含"气密"即可** —— 原限制为 阀体类型 ∈ 三通L型旋塞阀/三通L型球阀/三通L陶瓷阀） =====
- **触发条件**：测试项名含"气密"（`isQtyStruct()`，不再判断阀体类型）；标题"💧 气密性测试数据"
- **默认折叠**（2026-09-15）：气密数据区用 `<details>` 折叠（管理员"💧 气密性测试数据（点击展开）"、测试员"💧 气密性测试数据表（点击展开填写）"），点击展开后功能不变
- **记录方式二选一**：
  - **全量记录**：两步法（第1步堵B口看A口/第2步堵A口看B口），每步 开度 0-100%×6 多选 × 压力 0.5-4bar×4 多选 × 时间 10分-8小时×8 单选 → 数据表 行=开度×压力、列=台1..N（>10台分行每10台一区块）；每格下拉 正常(默认)/渗漏/滴漏/重漏/流淌
  - **批量记录**：每批数量+总批数 → 两步同样开度/压力/时间配置 → **每个开度/压力点一张表**：9 指标行（测试总数/合格数量/合格率/不合格数量/微渗/渗水/微漏/漏水/测试总时长）× 批数列（>5批分行每5批一区块），每格手动输入
- **公共信息 meta**：测试系统（智慧阀门批量测试系统/研发阀体模拟测试台下拉）、测试目的（预填：通过系统性的气密性测试，识别并评估阀杆位置、左右出水口位置及压力传感器位置是否存在漏水隐患）、检验部位 4 项 checkbox（阀门左侧出口/右侧出口/阀杆位置/压力传感器位置）
- **参考标准**（详情页可折叠 + 报告固定输出）：漏水等级定义 5 级表（无泄漏/渗漏渗水/滴漏/重漏/流淌 + 表现特征/说明）+ 合格判定规则 3 条（(1)无渗漏及以上→合格 (2)渗漏或滴漏→复测确认，复测仍同→不合格 (3)重漏或流淌→直接不合格）
- **t_struct JSON**：{mode: full|batch, meta:{system,purpose,parts{部位:true}}, step1/step2:{opens[],press[],time,cells{"开度|压力":{台号或批号:{指标:值}}}}, batch:{per_batch,total_batches,...}}
- 详情页数据表显示数据（统计口径，默认正常）；**Word/PDF 报告表格空白**（打印手填）——全量台表报告空白；批量报告显示录入值

===== 4.4 报告（2026-09-08 定稿） =====
- 4 级：单项报告 / 电路测试报告 / 阀体测试报告 / 整机测试报告（full=同机电路+阀体合并）
- 三格式：网页版（API 默认 text/html）+ **Word ?fmt=docx + PDF ?fmt=pdf**
- 内容全字段：基本信息（阀体类型/供应商/批号/物料编码/负责人/测试时间/备注/样品照片）+ 测试项全字段（含测试数量）+ 气密附加（系统/目的/部位/等级表/规则/数据表）
- 格式美化：蓝色主题信息卡 + 深蓝表头白字 + 斑马纹 + 圆角照片 + 页脚（时间+公司）
- **文件名/首行标题**：`智慧阀门阀体（阀体类型）测试报告（日期+3位当日流水号，如 20260908001）.docx/pdf`；docx 第一行内容=文件名
- 空字段横线（打印手填）；流水号存 report_seq.json

====== 4.5 手机号+验证码注册用户（测试员，2026-09-08） ======
- 注册登录：手机号+短信验证码（阿里云短信：AK/Secret/SIGN=慧飞数字科技秦皇岛/TEMPLATE=SMS_338340195 存 ~/.hermes/.env；SDK 装服务 venv ctwing-2；同一号码**每分钟限1条**；失败兜底钉钉群 webhook；验证码存 ~/docs/test/sms_codes.json 5 分钟有效）
- 用户表：~/docs/test/wx_users.json {手机号: {created}}；登录态 localStorage wx_user（受限身份）或 rd_user（钉钉，不受限）
- 权限：手机号注册用户=测试员 → **仅可保存 测试数据(t_data)/测试人员(t_person)/测试时间(t_time)**；前端详情页仅显示这 3 项；禁新建/删除（403）
- ⚠️ **数据保护警示（2026-09-08 事故）**：wx 保存若走全量替换会把 items 其他字段（t_struct/条件/方法）覆盖为空——曾致 #15 气密数据清空（已从 git 备份恢复）。修复方案待上线：后端 wx 分支改逐项合并 UPDATE（不删行不整表替换）+ t_struct 空值不覆盖；恢复命令 `git show <提交>:docs/test/test.db` 取备份库手动导数据
- 前端：页头身份条（未登录→手机号注册弹层；钉钉 rd_user 显示 👤 名；wx 显示 📱138**** 受限）；initAuth/wxReg/smsSend/wxLogin

====== 4.6 测试项与批量记录（2026-09-08~09 定稿） ======
- 测试项字段：状态（status：⏳未开始/🔄进行中/✅已完成 默认未开始）、条件=温度+湿度两输入（合成"温度X℃，湿度Y%"存 t_condition）、数量、方法/工具/步骤、结果勾选+处理方式、照片（**JSON [{u,d}] 描述+可分别删除**，兼容旧 ; 分隔）、人员、时间
- 测试项可删除（列表 🗑，全权限用户；保存信息后生效）；**测试数据文本框已去掉**（t_data 保留历史）
- 批量记录 v3/v4（2026-09-09）：输入 总台数+每批台数 → **自动分批 ceil**（不足一批按实际，850/160→6批末批50）；批次行号=阿拉伯数字；**列=批次|测试总数(自动=该批实际台数)|不合格数量(自动=四漏相加)|不合格率(自动)|微渗|渗水|微漏|漏水（7列，测试总时长列已删）**；合格数量列已删；**微渗/渗水/微漏/漏水默认显示0，不合格数量/不合格率按默认0自动算并显示**；前端 setBatchCell 后自动重算行；Web 报告显示自动值，Word/PDF 空白打印
- 批量数据模型：t_struct.batch{per_batch,total_qty,total_batches(自动),step1/2{opens,press,time,cells{ck:{批:{指标:值}}}}}
- 文档级状态=测试项 status 汇总：全未开始→未开始/任一进行中→进行中/全已完成→已完成（后端 sessions 列表 agg_status，不再用手工会话状态）
- 阀体测试文档隐藏整机报告按钮（整机从电路侧生成）；"保存会话"改名"保存信息"
- ⚠️ 报告导出 _report_fname/_next_seq 位于 _batch_html 与 _export_test_docx 之间——整函数替换该区间会误删定义 → Word 500；恢复命令参考 git 历史（多次踩坑）

====== 4.7 测试员权限（手机号注册，v7 定稿 2026-09-09） ======
- 可编辑：气密表格数据(t_struct cells)/测试状态(status)/测试人员/测试时间/**测试照片（v7 新增：上传+描述+删除）**
- 只读：基本信息/条件/方法/步骤/结果/配置/新建/删除/保存信息按钮
- 后端 tester-update：逐项合并 UPDATE items SET t_person,t_time,t_struct,status,t_photo WHERE session_id+item_name（不删行不整表不碰 sessions）
- 详情页：状态下拉+人员/时间+📷照片+（气密项 wxStructTable 表格，配置只读）；wx 保存=saveItem 直 POST 单行落库
- 姓名设置：GET /api/test/wx/info、POST /api/test/wx/name（存 wx_users.json {mobile:{name}}）；页头点击身份条→菜单（设置姓名/退出）
- 历史：v4 曾去掉 t_data 权限；v6 加回照片；**用户多次微调，改前 git 留痕**

====== 4.8 权限体系与归档（2026-09-09） ======
- 角色：admin（武燕青/accounts.json）｜user 普通（钉钉登录默认，不能删除测试文档，其他权限都有）｜tester（手机号注册，仅 表格数据/状态/人员/时间/照片）｜guest 游客（查看为主，不可删/归档）
- 判定：/api/test/me?user=；后端 `_role()`；写接口校验（DELETE/归档 admin only；归档文档非 admin POST 403）
- 测试员保存=tester-update 逐项合并 UPDATE（t_person/t_time/t_struct/status/t_photo，不删行不碰 sessions）；saveItem 直落库；"保存信息"对测试员无效
- 用户管理：点标题"🧪 测试管理系统"→ 菜单（第1级：👥用户管理[仅admin]/📖用户手册[全员，读测试员教程 md 实时渲染]）→ 第2级用户列表（/api/test/users admin 全量，其他仅本人）
- 归档：sessions.archived；文档按钮"📦 归档"（admin）；归档后非 admin 全只读（lockEdit+openItem 只读视图+后端 403）；列表"📦 已归档(N)"灰底折叠分组（localStorage archFold）
- 手机号测试员详情（openItem IS_WX）：状态下拉+人员/时间+📷照片+气密表格(wxStructTable,配置只读)；wx 身份条设置姓名/退出
- 事故教训：**权限验证误用真实#15 空保存清数据（从 git 7161fc7 恢复）**——以后对真实文档验证一律临时会话；git DB 快照=救命备份（改动后及时 commit）

====== 4.9 报告体系（2026-09-09 定稿） ======
- Web（_render_report）：主表数据列=文本摘要（测试目的首行）；气密明细块（📋标题+等级定义表+判定规则+批量/全量数据表）整宽显示在主表下方（after_blocks）
- Word/PDF：**v2 竖版全新设计**（_docx_v2/_export_test_docx_v2/_export_test_pdf_v2）：A4 竖版、标题装饰线、蓝色信息卡（两字段一行）、主表蓝表头白字+斑马纹 7 列（方法与工具/步骤合并列；气密项数据列="详见气密性测试明细"）；明细块：📋标题→检验部位（☑/☐ 复选框置顶）→漏水等级定义表→合格判定规则**表格化**（序号/判定情形/判定结果）→批量数据表（批次×7指标，自动列绿底）/全量台表（台号×结果竖版）；旧横向 _test_doc/_export_test_docx 保留可回退
- 文件名流水号 _report_fname/_next_seq（在 _batch_html 与 _export_test_docx 间，整函数替换会误删→Word 500 坑）
- docx v2 要点：helper _shade/_par_bottom_border/_cell_text 需各自内 import（Pt/send_file/subprocess 局部导入坑）

====== 4.10 测试项字段定稿（2026-09-09） ======
- t_purpose：**所有测试项名称下测试目的**（items 列，报告数据列首行显示）；气密 meta 区"测试目的/测试系统"已去掉（meta 保留 system/parts 历史数据不展示；检验部位 parts 在 docx ☑显示）
- 状态 status（未开始/进行中/已完成）+ 文档级汇总 agg_status；条件=温度/湿度合成；照片 JSON [{u,d}]；t_data 文本框已去掉（历史保留）

====== 4.11 批量记录每批独立台数与配置（2026-09-09 晚定稿） ======
- 交互：总批数（≤100）→ 自动展开"第1批~第N批"台数输入（默认 160、每批 ≤160 校验、超限红字拒绝）→ 总台数 = Σ各批自动显示（总批数后实时更新）；生成表格每行"测试总数(自动)"= 该批自己台数，不合格率按该批算
- 存储：batch.total_batches + batch.each_qty {1:x,...}（per_batch 160 兜底）+ total_qty=Σ；报告 Web/Word/PDF 与测试员表按 each_qty
- 步标题 = "第1步：堵住A口，调节A口开度，调节水压 / 第2步：堵住B口，调节B口开度，调节水压（共N批·总数X台）"
- 压力选项 PRESS 加 3bar（0.5/1/2/3/4）；**新选项不影响已存文档**（配置保存于 struct，需管理员重配或 DB 补）
- ★勾选实时同步（bSync）：开度/压力/时间 checkbox/radio 变更立即写内存——否则重生成/重开/保存还原旧配置（用户实测踩坑 2 次）
- 旧数据兼容：#15 多次修复（3bar 补/去0.5/只留100% opens=['100%']）；tester-update t_struct 合并写（配置保持库值仅合并 cells，防测试员旧页面覆盖配置——168958f）
- 批量改版历程：总台数/每批自动分批(ceil+末批实际)→手动"批数+每批台数"→"批数+逐批独立台数(each_qty)"（最终版）

====== 4.12 测试备注与验证码（2026-09-09 晚） ======
- t_note：每个测试项"测试结果"下一行输入框（现场情况/测试内容），**测试员可编辑**（tester-update 白名单加 t_note）；报告 Web 数据列+Word/PDF 结果列显示；归档只读视图显示
- 验证码：**只走阿里云短信直发手机**（去掉钉钉群 webhook 兜底）；失败明确报错"请1分钟后再试"（阿里云分钟级流控同号 1 条）；sms_codes.json 存 5 分钟码（可查询/告知用户）

====== 4.13 测试项字段与操作记录（2026-09-09 晚定稿） ======
- **测试时段多行**（items.t_recs JSON [{n,s,e}]）：测试人员/开始时间/结束时间一行一组，[＋增加一行] 可加多组、每行 ✕ 删；单行紧凑布局（姓名 60px + 时间 calc 均分）；旧 t_person/t_time_s/t_time_e 兼容为首行
- **测试备注** t_note（结果下一行；测试员可编辑）
- **操作记录**（items.t_logs JSON [{t,u,d}]，测试项详情最底部显示，**测试员不显示但照常采集**；上限 300 条）：
  - 记录内容具体化：修改 diff（如"修改：点 100%/1bar 第2批 渗漏 由 0 改为 2"）、新增/删除记录行（带组合）、记录行组合修改（1-E1 → 2-E3）、状态变更、备注更新、上传照片、保存
  - **保存去重**：fpOf 指纹比对，无改动重复点保存不新增记录；打开详情初始化指纹
  - 采集即时刷新（logAdd 后 refreshLogView；refreshLogView try 保护）
- **样品拍摄对测试员可用**：lockEdit 豁免 data-allow-wx；上传即落库 /api/test/sample/<sid>（归档非 admin 拒）
- 批量表指标改名：微渗/渗水/微漏/漏水 → **渗漏/滴漏/重漏/流淌**（全库数据键迁移）；等级表加 **等级编号 E0-E4** 列，"渗漏/渗水"→"渗漏"；检验部位 5 项（左侧出口/右侧出口/阀杆位置/压力灌胶/压力密封圈）
- 批量表**行列互换**：行=7 指标（测试总数/不合格数量/不合格率 自动绿底 + 渗漏/滴漏/重漏/流淌 手填），列=第1批..第N批
- 批量表**自定义行**（所有用户）：[➕增加行] 首格=位置▾(1-5)+等级▾(E1-E4) 组合（无连字符、格宽紧凑），✕ 删除；原表固定行列不增减；数据存 cells 键 "C:位置-等级"
- 批量输入：总批数（≤100）+ 逐批台数（默认 160、≤160）；总台数=Σ 自动显示；步标题"共N批·总数X台"
- 两步描述：第1步 堵住A口，调节A口开度，调节水压 ｜ 第2步 堵住B口，调节B口开度，调节水压
- 抽气/压力选项 PRESS 加 3bar；**bSync 勾选即时写内存**（防旧配置还原）；tester-update 的 t_struct 合并写入（保留库配置仅并 cells）
- 故障排查经验：字符串替换脚本 assert 中断会导致"部分未落盘"（本轮多处踩坑：partsChk/logAdd/df 描述）→ 改后必须 curl ?v=N 抽 <script> 用 node --check 验证；JS 属性内嵌单引号需 \' 转义

====== 4.14 分类两级与报告完善（2026-09-10） ======
- **分类两级导航**：顶层 [电路测试 ｜ 结构测试]；进系统默认**电路测试**；点"结构测试"→ 新画面**左右并排** [阀体测试 ｜ 其他测试]（子画面隐藏"＋新建测试"）；CAT 仍存子类名
- **"其他测试"分类**（templates.json categories 仅智慧阀门三分类）：可新建/填测试项/出报告；报告三按钮 genReport('other')；后端 mode=other（_render_report 与 **_docx_v2 的 rows 过滤都要加 other**，两处不同函数，易漏）
- **模板调整**：电路测试的"60N扭力测试"移入其他测试并改名"扭力测试"（方法/工具保留）
- **操作记录（t_logs）业务化**：
  - 描述格式："更新 100%开度/1bar 第2批 渗漏 数据（2）"/"更新测试状态为 X"/"更新测试备注"/"上传测试照片"/"新增记录行 1-E1"/"删除记录行 2-E3"/"记录行组合修改：1-E1 → 4-E3"/"保存：信息与数据已更新"
  - **保存去重**：fpOf 指纹比对，无改动重复保存不记；打开详情初始化指纹
  - **测试员不显示**（挂载处 if(!IS_WX)）；操作人显示**姓名**（wx_name_ls 优先；历史手机号已回填 wx_users 姓名）
  - logAdd 后即时 refreshLogView（try 保护）；记录上限 300
- **测试时段多行（t_recs）**：人员+开始+结束 一行一组，[＋增加一行]/✕；姓名后显示**该人员本次总时长**（同名多时段累计，改时间实时更新）；姓名框宽度 30px、时间框 calc 均分单行紧凑
- **样品拍摄对测试员可用**：lockEdit 豁免 `data-allow-wx`；上传即落库 `POST /api/test/sample/<sid>`（归档非 admin 拒）
- **报告**：
  - 自定义记录行渲染（Web `_batch_html` + docx v2）：行首文字映射 `PART_NAME{1:左侧出口,2:右侧出口,3:阀杆位置,4:压力灌胶,5:压力密封圈}` / `LEAK_NAME{E1:渗漏,E2:滴漏,E3:重漏,E4:流淌}` → "4-压力灌胶 ｜ E3-重漏"，各批显示已填数据（helper: `_custom_row_name`/`_custom_keys`）
  - 气密明细"测试项详情表"**已移除**，改为**只显示测试问题照片**（大图 5cm + 描述）
  - 检验部位符号：☑/☐（Word/PDF 乱码）→ **√ / □**；docx 内 emoji 标题已去掉
  - 照片**点击查看原图**：文档内 viewPhoto 全屏预览；Web 报告 window.open(this.src)
- **批量表自定义行前端**（手机适配）：首格 = 位置▾/等级▾ **竖排**（flex column，宽 46px，防窄屏遮挡）+ ✕；原表行列固定不增减；key `C:位置-等级`（重名自动序号 -2/-3，支持多行）
- **测试页禁缓存**：/test/ 响应头 no-store/no-cache（微信内置浏览器缓存顽固，改版看不到变化必查此项）

===== 今日修复的 Bug（重要） =====
1. `chgExtRow` **var 提升**：st/key 在声明前使用 → 改组合报错（Cannot read properties of undefined）→ 声明前置
2. 位置下拉 onchange 生成时 **curL 未拼接**（成字面量 `'-'+curL`）→ 只能改等级（现象：设 4-E3 存成 1-E3）→ 改为 `''+curL+''`
3. **docx v2 的 rows 过滤缺 other**（_docx_v2 与旧 _test_doc 是两个函数，易漏改）
4. **服务 502**：脚本误插 `import re` 破坏 `import os as _os`（缩进错误）→ 已修，顶部统一 `import json, os, re, sqlite3, datetime, time`
5. 自定义行保存失败链路：前端报错 → 数据写到旧 key；服务端 tester-update 合并（cells 整块覆盖）本身正确（已实测 Tester 提交 C:4-E3=2 落库保留）

====== 4.15 本轮修复（2026-09-15） ======

**① 气密"记录方式"单选框缺失（重要 bug）**
- 现象：测试项"气密性测试-常温"（如 #15/#42）打开后，气密数据区**没有"记录方式：全量记录/批量记录"单选** → 无法选择记录方式，无法进入表格
- 根因：`test.html` renderStruct() 第 1209 行 `'<div ...记录方式...'` **缺少 `h+=`**（字符串表达式被丢弃 = 死代码）
- 修复：补 `h+='...'`；扫描同类问题（440/444/1035 为正常多行续行）
- 验证：node --check 通过 + 页面 200 + 记录方式单选框已渲染；任务/库房页未受影响

**② 文档卡列表"测试总数"口径**
- 需求：列表卡片"测试总数" = 测试项**基本信息中的测试数量**（t_qty）
- 改前：批量模式下用 `per_batch × total_batches` 覆盖 → #42 显示 320（实际测试数量 160）
- 改后：优先取 t_qty（批量推算仅当 t_qty 为空时兜底）
- 验证：#42 → 160 ✅ ｜ #15 → 800 ✅（test_api.py line 414-433 聚合逻辑）

**③ 排查记录**
- 数据核查命令：`sqlite3 docs/test/test.db "SELECT s.id,i.item_name,i.t_qty,i.t_struct FROM items i JOIN sessions s ON s.id=i.session_id WHERE i.item_name LIKE '%气密%'"`
- 会话 #42（燕大科力-秦城，三通L型旋塞阀）为新建气密文档；#15 为历史文档

====== 4.16 设备编码扫码记录（2026-09-15 新增） ======

**功能**：所有测试项详情页新增"📷 设备编码扫码记录"折叠区（默认收起）
- **覆盖范围**：**所有测试项**通用（`injectCodes()` 在 `showV('item')` 统一注入到 i_struct 之后，找不到则回退 iForm/v-item——任何测试项都有）
- **权限**：**测试员开放**（扫码/手动录入/删除均可用；后端 `tester-update` 白名单含 t_codes，已实测落库）｜归档只读时隐藏按钮（仅查看）
- **扫码录入**：手机摄像头扫设备二维码 → jsQR 解码（本地内嵌库 `/test/jsqr.js`，256KB，**不用 CDN**）
- **列表显示**：序号 | 设备编码（等宽字体）| 录入时间 | ✕删除
- **备用入口**：✍ 手动输入（不支持摄像头时）
- 防连扫（1.6s 内同码忽略）+ 扫码震动反馈 + 录入写入操作记录

**数据层**：
- `items.t_codes`（JSON `[{"code":"HF-2026-0001","ts":"2026/9/15 13:00:00"}]`），migrate 已加列
- 保存链路三处：① 管理员保存 `collectItems()` 字段白名单 **已加 t_codes** ② 测试员 `saveItem` body 已加 ③ 后端 INSERT（管理员全量）+ `tester-update`（合并 UPDATE，**新值非空才写，防误清空**）
- 防覆盖：管理员保存前读旧 t_codes，新值空则保留旧值

**后端 API**：`GET /test/jsqr.js`（库文件）｜读写走既有 session POST

**验证**：临时会话端到端通过（创建→保存 2 条编码→读回一致→删除清理）｜JS node --check 通过｜三模块 200

====== 4.17 连续耐久循环测试（施肥机，2026-09-15 新增） ======

**入口**：设备类型「施肥机」→ 新建测试文档 → 勾选"连续耐久循环测试"（模板键 `施肥机:`，templates.json）

**数据录入（按天为单位）**：
- **温度测试间隔**（分钟，全局一项）
- 每天一条记录（`＋ 添加记录（按天）`）：**日期** / **开始时间** / **结束时间** → **自动算当日运行时长**（跨零点自动 +24h）；每天可加多个**温度测试点**（时间 + 温度℃），✕ 删除
- 底部自动汇总 **⏱ 总运行时长**（所有天累加）
- 行内增删：加天 / 删天 / 加温度点 / 删温度点

**数据结构**（items.t_struct，与气密结构区分）：
<code>
{"mode":"durability","tempInterval":"30",
 "daily":[{"date":"2026-09-15","s":"08:00","e":"20:00","temps":[{"t":"08:30","v":"25.3"}],"note":""}]}
</code>

**触发条件**：`isDurItem()` —— 测试项名含"耐久"（不限设备类型）
**渲染顺序**（renderStruct）：开关阀时间 → 扭力 → **耐久** → 气密；测试员视图（wxStructTable）同样可用（可填）
**权限**：管理员/普通用户/测试员均可填写；归档只读隐藏操作

**报告输出（三格式）**：
- Web：`_dur_html()` → 按天表格（天数/日期/开始/结束/当日时长/温度测试点）+ 总时长；**不输出漏水等级/判定规则**
- Word/PDF：`_docx_v2` 耐久分支 → 同结构表格 + "⏱ 总运行时长"
- 主表数据列：耐久项显示"详见连续耐久循环测试明细"
- ⚠️ **坑**：`_docx_v2` 里 `if not _is_qty:` 块带 `continue` 会提前跳过耐久项 → 必须改为 `if not _is_qty and not _is_dur0:`（本次已修）

**通用测试设备（施肥机等单类）报告**：
- 后端 `mode=other` 校验放开（category ∈ {"其他测试",""}）；`_render_report`/`_docx_v2`/`_test_doc` 三处 rows 过滤同步放开
- 前端报告按钮显示条件：`CAT==='其他测试' || CAT===''`（单类设备也有"其他报告"按钮）

====== 4.18 测试员保存结构化数据丢失修复（2026-09-15） ======

**现象**：测试员保存"开关阀时间测试"数据 → 重新打开测试项**看不到数据**（用户报）。

**根因**（后端 `tester-update` 的 t_struct 合并）：
<code>
if k in ("cells", "torque"): old[k] = v     # ❌ 白名单只有这两个键
elif isinstance(v, dict) ...: _merge(...)
# 其余键忽略 → swtime（开关阀时间）等结构被整块丢弃
</code>
开关阀时间数据键是 `swtime`（{cfg, step1:{rows}, step2:{rows}}）→ 不在白名单 → **保存即丢弃**。同样影响 `daily`（耐久测试）等一切非 cells/torque 的结构。

**修复**（配置键保留 + 其余合并）：
<code>
_KEEP_OLD = ("opens","press","time","per_batch","total_batches","each_qty","total_qty","meta","cfg")
def _merge(old, new):
    for k, v in new.items():
        if k in _KEEP_OLD: continue               # 配置保留库值（防旧页面覆盖配置）
        if isinstance(v, dict) and isinstance(old.get(k), dict): _merge(old[k], v)
        elif v not in (None,"",[],{}): old[k] = v # 非空才覆盖（防误清空）
        elif k not in old: old[k] = v
</code>
**验证**：临时会话 → 测试员提交开关阀时间（第1步2行/第2步1行）→ 读回一致 ✅；空提交不清空已有数据 ✅；配置上限保留 ✅

**⚠️ 数据影响**：修复前测试员保存的开关阀时间/耐久等结构化数据**已被丢弃，需重新填写一次**（已有 #44 第1步数据为管理员侧保存，未受影响）。

**前端链路确认**：`collectStruct()` 直接返回 `it.t_struct`（含 swtime）→ 前端提交正确；测试员视图 `isSwitchTimeItem()` 分支用 `swTimeForm(it)` 渲染（可填）✅

====== 4.19 耐久循环测试"记录数据不可用"修复（2026-09-15 晚） ======

**现象**：施肥机「连续耐久循环测试」里，数据记录功能打不开/点了没反应（用户报）。

**两个根因**：
1. **测试员视图分支漏判**：`openItem` 的 IS_WX 分支链条是 `if(isQtyStruct()) → else if(isSwitchTimeItem()) → else if(isTorqueItem()) → else(普通项)`，**耐久项不符合前三者** → 走普通分支，**不渲染 i_struct**，耐久表单永不出现（wxStructTable 里虽加了 isDurItem 分支，但根本没被调用）
   - 修复：`if(isQtyStruct()||isDurItem(it))`
2. **函数名冲突（隐蔽）**：自定义的 `durOf(it)`（耐久结构解析）与**已有函数 `durOf(r)`（本次测试时段时长计算）同名** → 后者定义在后**覆盖前者** → 拿到的是字符串 → `st.daily.push` 报 `TypeError: Cannot read properties of undefined`
   - 修复：改名 `durStruct()`（10 处引用同步）
   - ⚠️ 教训：**新增函数前先扫重复定义**（`grep -c "function 名字"`）

**验证（浏览器实测 + 接口）**：
- 测试员身份（IS_WX=true）打开耐久项 → 出现"＋ 添加记录（按天）"✅
- 添加 2 天 + 时间 + 温度点 → 当日 12h、总 21.5h 计算正确 ✅
- 测试员 saveItem → 接口落库：1 天记录 / 间隔 30 / 温度点 08:30 25.3 ✅
- 验证会话已清理（无残留）✅

====== 4.20 施肥机类型 + 报告按设备类型区分（2026-09-15 晚） ======

**需求**：施肥机设备的"阀体类型"改为"施肥机类型"，4 种：软管泵集成施肥机 / 液体肥施肥机 / 固液两用肥施肥机 / 多通道施肥机。

**实现**：
- 前端（`test.html` 基本信息分支）：`else if(DEVICE==='施肥机')` → label「施肥机类型」+ 上述 4 项（option value 仍存 `sessions.valve_type`，无需改库）
- 后端标签助手 `_type_label(sess)`：其他测试→"产品系列："｜**施肥机→"施肥机类型："**｜其余→"阀体类型："（替换 Web 报告 4 处 + docx 2 处）
- 报告信息卡字段分支加施肥机（类型+供应商+批号+物料编码+负责人+测试时间；原走"系列/固件/硬件"分支不合适）
- 报告标题：施肥机→**"施肥机测试报告"**（Web + docx/PDF 各一处）
- 报告文件名：**`施肥机（多通道施肥机）测试报告（流水号）.docx`**（_report_fname 加施肥机分支）

**验证**：Web/Word 含"施肥机类型：液体肥施肥机"且不含"阀体类型" ✅｜PDF 53KB ✅｜文件名 `施肥机（多通道施肥机）测试报告（20260915004）.docx` ✅｜临时会话已清理

====== 4.21 耐久测试增强：温度矩阵 + 天气/气温/机油（2026-09-15 晚） ======

**需求**：① 温度记录改为矩阵——**行=电机/减速器/泵头**，**列=测试时间**，格=温度 ② 每天增加**当日天气、气温**输入 ③ 每天增加**当日机油情况**记录。

**数据结构**（`items.t_struct`，兼容旧 `temps`）：
<code>
{"mode":"durability","tempInterval":"30",
 "daily":[{"date":"2026-09-15","s":"08:00","e":"20:00",
           "weather":"晴","airTemp":"26","oil":"正常",
           "times":["08:30","14:00"],
           "cells":{"电机|08:30":"45.2","减速器|14:00":"39.7","泵头|08:30":"36.5"}}]}
</code>
- 行固定 3 个部件（`durParts()`）；列可增删（`durAddTime/durDelTime/durSetTime`）
- 单元格键 = `部件|时间`（`durSetCell`，空值自动删键）
- **旧数据兼容**：`durMigrate(d)` 把旧 `temps[{t,v}]` 转为 times 列 + cells（值归"电机"行），原 temps 保留不删；后端渲染同样兼容

**界面**：每天一块 → 日期/起止/当日时长 + 🌤天气 + 🌡气温 + 🛢机油 + 温度矩阵表格（**行=测试时间（可增删，表头 ＋时间 / 行首 ✕）· 列=电机/减速器/泵头**，`overflow-x:auto` 手机可横向滚动）

> **2026-09-15 晚（v2 调整）**：温度矩阵**行列互换** —— 原「行=部件 × 列=时间」→ 现「**行=测试时间 × 列=部件**」（用户要求）。单元格数据键不变（仍为 `部件|时间`），仅前端渲染 + Web `_dur_html` + Word/PDF 两处 docx 矩阵转置。

**报告三格式**：Web `_dur_html()` / Word `_test_doc` / PDF `_docx_v2` 均输出「每天摘要行（含天气·气温·机油）+ 部件×时间矩阵表」+ 总运行时长

**验证**：Web/Word/PDF 均含天气·气温·机油·三部件行·温度值·时间列·总时长 ✅｜前端渲染（矩阵输入/时间列/取值/滚动）✅｜`#59` 用户旧数据可正常渲染（迁移内存态，保存后落库）✅

====== 4.22 耐久"第2天数据无法保存"修复（2026-09-15 晚） ======

**现象**：施肥机耐久测试，第1天数据能存、**第2天表格数据保存后重开就没了**（用户报）。

**两个根因**：
1. ★ **保存静默失败（主因）**：`basePayload()` 直接访问 `$('f_tester').value`、`$('f_time').value`、`$('f_zc').value` —— 这些是**编辑页（v-edit）**的表单元素，在**测试项详情视图（v-item）**里**不存在** → 抛 `TypeError` → 被 `saveItem` 的 `try{ saveSession(true) }catch(e){}` **空捕获吞掉** → 保存请求根本没发出，界面无任何提示
   - 修复：`basePayload()` 全部字段改 null 保护 + **回退内存 `CUR` 值**（防把已有基本信息覆盖为空）；`saveItem` 的 catch 改为提示错误
2. **时间键错位**：`durSetTime(i,j,v)` 改时间后**不重渲染** → 单元格 `onchange` 仍绑定旧时间（空串）→ 数据存成 `"电机|"` 空键 → 重开时 `times=['09:30']` 与键不匹配 → 显示空
   - 修复：`durSetTime` 改时间后 `durRe()` 重渲染 + **旧键数据迁移到新键**；另加 `durFixOrphan(d)` 把历史空键数据自动并入第一个时间列

**验证（浏览器真实路径 + 接口读回）**：
- 加载会话 → 加 2 天 → ＋时间 → 设时间 → 填温度/天气/气温/机油 → `basePayload()` 正常返回（device_type/valve_type/tester 均从内存回退）✅
- `saveItem()` 后读回：**2 天数据完整**，第2天 `times=['09:30']`、`cells={'电机|09:30':'47.7','减速器|09:30':'39.9'}`、天气=阴/气温=22/机油=需补充 ✅
- 会话基本信息未被覆盖（device_type/valve_type/supplier/tester 保留）✅

**⚠️ 教训**：
- 列表/详情视图与编辑视图共用的构造函数（如 `basePayload`）**禁止直接 `.value` 取值**，必须 null 保护 + 内存回退
- **空 `catch(e){}` 是事故温床**：保存链路失败却毫无提示，排查成本极高 → 至少 `toast` 出错误

====== 4.23 报告命名统一 + 生成时间可自定义 + 表头/不合格值（2026-09-16） ======

**① 报告按钮统一命名**（阀体测试，与电路/其他一致）：
`阀体报告→📄 Web报告`｜`阀体Word→📝 Word报告`｜`阀体PDF→📕 PDF报告`

**② Web 报告批量表表头改黑字**：`_batch_html` 中 `指标 ＼ 批次` 与 `第N批` 的 `<th>` 增加 `color:#000`（原被报告 CSS `th{color:#fff}` 渲染成白字，浅蓝底看不清）

**③ 报告生成时间可自定义**：
- `sessions` 新增列 `report_time TEXT`（migrate 自动加）
- Web `_render_report` / Word-PDF `_docx_v2` 页脚：`report_time` 非空即用它，否则用当前时间
- 保存接口：仅当传入非空时更新（防旧页面保存清空）
- 前端编辑页新增「报告时间」输入框（`f_report_time`，placeholder 示例 `2026-08-20 18:00`）+ `basePayload` 带上 `report_time`
- `#66` 已设为 `2026-08-20 18:00`

**④ 不合格数量/率 0 也显示**（Web `_batch_html` + Word/PDF `_docx_v2`）：原 `s4 if s4 else ""` 导致 0 显示为空白 → 改为 0 显示 `0`；不合格率 `0.0` 进一步整数化为 `0`

**验证（#66）**：Web/Word 生成时间=`2026-08-20 18:00` ✅｜不合格数量全 `0` ✅｜不合格率全 `0` ✅｜表头含 `color:#000` ✅｜PDF 984KB ✅

====== 4.24 电路测试分类拆分（2026-09-16） ======

**需求**：把原「电路测试」（31 项）拆分为 4 类。

**新分类（智慧阀门）**：`功能性能 ｜ 环境可靠性 ｜ 机械应力 ｜ 阀体测试 ｜ 其他测试`

| 分类 | 项数 | 内容 |
|---|---|---|
| **功能性能** | 28 | 原电路测试剩余全部项（待机功耗、双球标定、AEP 上报、蓝牙小程序、OTA、产线测试…）|
| **环境可靠性** | 1 | 高低温功能测试 |
| **机械应力** | 2 | 汽车模拟振动和随机振动 ｜ 跌落测试 |
| **其他测试**（电路组，内部名 `其他测试2`）| 1 | **三防漆性能测试**（method/tool 待补充）|
| 阀体测试 | 22 | 未变（结构组）|
| **其他测试**（结构组，内部名 `其他测试`）| 1 | **扭力测试** |

> ★ **两个组的「其他测试」内容不同**：分类名在数据层不能重复 → 电路组的内部名用 **`其他测试2`**，
> 前端 `CAT_LABEL={'其他测试2':'其他测试'}` + `catLabel(c)` 统一**显示为「其他测试」**（按钮/标题）。
> 分组：`GROUP_MAP={'电路测试':['功能性能','环境可靠性','机械应力','其他测试2'], '结构测试':['阀体测试','其他测试']}`
> `CIRCUIT_CATS` 含 `其他测试2`（沿用电路字段：系列/固件/硬件…）；结构组的 `其他测试` 保持原逻辑（产品系列）。

**实现**
- `templates.json`：`items` 拆为 `智慧阀门:功能性能/环境可靠性/机械应力`（+ 其他测试追加三防漆）；`categories.智慧阀门` 重排；`fields` 增加三个新分类（**复用电路测试字段**：系列/固件版本号/硬件版本号/测试人员/测试时间/测试样机准出编号）
- ★ **旧 key `智慧阀门:电路测试`（31 项）保留** → 历史会话（category='电路测试'）仍可正常打开
- 前端 `test.html`：
  - 新增 `CIRCUIT_CATS=['电路测试','功能性能','环境可靠性','机械应力']` + `isCircuitCat(c)`；所有 `CAT==='电路测试'` 判定（基础信息字段、报告按钮显示、整机报告配对）统一改用它
  - `GROUP_MAP` → `{'电路测试':['功能性能','环境可靠性','机械应力','其他测试'], '结构测试':['阀体测试']}`
    → **点「电路测试」显示 4 个子模块按钮**（功能性能/环境可靠性/机械应力/其他测试）；「结构测试」仅阀体测试（单子项时直接进入）
  - ★ **二级选择通用化**：原 `renderSubPane()` 硬编码"阀体测试/其他测试"两个按钮、`pickGroup()` 硬编码只对"结构测试"生效 → 改为一律按 `GROUP_MAP[组]` 动态渲染，并记住 `CUR_GROUP` 用于高亮（任意组只要有多个子分类都走二级选择）

**验证**：接口核对 功能性能 28 项（前 3 项正确）｜环境可靠性 [高低温功能测试] ｜机械应力 [振动、跌落] ｜其他测试 [扭力、三防漆] ｜阀体测试 22 项 ｜页面分类导航正常、`isCircuitCat` 5 处生效、无残留旧判定 ✅

> ⚠️ 「三防漆性能测试」的测试方法/工具字段留空（未提供）→ 需要时在 `templates.json` 补充，或在页面上管理员直接编辑。

**★ 历史数据迁移（用户截图发现"功能性能下暂无记录"后处理）**
- 现象：拆分后分类导航进入「智慧阀门 · 功能性能」显示"暂无测试记录"——因为历史会话 `sessions.category='电路测试'`，与新分类不匹配
- 处理：
  1. **数据迁移**：`UPDATE sessions SET category='功能性能' WHERE category='电路测试'` → #6、#7 归入功能性能 ✅（迁移前已备份 DB 到 `/tmp/test_db_bak_*.db`）
  2. **接口兼容**：`/api/test/sessions` 查询 `category=功能性能` 时改用 `AND category IN ('功能性能','电路测试')`（防遗留旧分类数据不可见）
- 验证：功能性能 → 2 个会话（#7/#6）✅｜环境可靠性 0（新分类暂无）｜机械应力 0｜其他测试 1（#32）｜阀体测试 4（#66/#44/#42/#15）✅

> 📌 历史会话内的测试项仍是旧模板的快照（31 项，含高低温/振动等），不影响查看与报告；新建会话才使用新分类的项。

====== 4.25 三防漆性能测试（步骤 + 数据记录 + 报告）（2026-09-16） ======

**来源**：用户提供的《测试项目、方法与判定标准》表格 + 现场手写记录（2026.8.24，金穗 4 块主板）。

**① 测试步骤与判定标准**（写入 `templates.json` → `智慧阀门:其他测试2` 的 `method`）
<code>
【试验流程】样品准备（清洗烘干→涂覆→固化）→ 外观检查 → 恒定湿热96h → 霉菌28d → 温度冲击5~10循环 → 各项检查与复测 → 数据汇总与判定 → 出具验证报告
1.外观检查：目视+10×放大镜+UV灯；判定：涂层连续均匀，无漏涂/针孔/气泡/流挂/起皮，禁涂区洁净
2.耐湿性：GB/T 2423.3，40℃、93%RH、96h；判定：无起泡/开裂/脱落，绝缘电阻≥10MΩ，功能正常
3.防霉性能：GB/T 2423.16，28℃、RH>90%、28天；判定：长霉等级≤1级，无性能下降
4.耐温度冲击：GB/T 2423.22，-40℃⇄+85℃、5~10循环；判定：无开裂、起皮、分层，功能正常
5.电性能确认：通电/通信/采集（配置、标定、蓝牙A关/B关、磁铁A关/B关）；判定：功能正常、无参数超差
</code>
`tool`：高低温试验箱/恒温恒湿箱/霉菌箱/UV灯/10×放大镜/绝缘电阻测试仪

**② 数据记录表**（前端 `test.html` 新增 coating 族，**按样品卡片**，手机友好）
- 判断函数 `isCoatingItem(it)`（项名含"三防漆"）；数据结构：
<code>
{"mode":"coating","samples":[{"no":"样品编号","appearance":"合格","ir":"≥10","mold":"0","thermal":"合格",
  "func":{"配置":true,"标定":true,"蓝牙A关/B关":true,"磁铁A关/B关":true},"verdict":"合格","note":""}]}
</code>
- 卡片字段：样品编号 ｜ 外观检查（合格/不合格）｜ 绝缘电阻(MΩ) ｜ 长霉等级（0~4）｜ 温度冲击｜ 电性能（4 项复选框）｜ 判定 ｜ 备注
- 操作：`coatAdd()` 添加样品 ｜ `coatDel(i)` 删除 ｜ `coatSet(i,k,v)` / `coatFunc(i,k,v)` 修改（即时写回 `t_struct`）
- 表单顶部自动显示该测试项的**步骤与判定标准**（从模板 `method` 读取）
- 接入：`renderStruct`（管理员）+ `wxStructTable`（测试员）+ openItem 的测试员分支条件

**③ 报告输出**（Web / Word / PDF）
- 后端新增 `_coat_html(st)`（Web 表格 + 判定依据说明）与 `_coat_docx_table(doc, st)`（Word/PDF 8 列表格）
- 明细块标题：「三防漆性能测试明细」；数据列文案：「详见三防漆性能测试明细」
- ★ **报告 mode 判定重构**：新增 `_is_other_cat(cat)`（非电路类/非阀体 → 通用报告 `mode=other`）与 `_is_circuit_cat(cat)`；原 4 处硬编码 `category in ("其他测试","")` 校验全部改用它 → 新分类（其他测试2 等）也能出报告

**验证**：用 4 块金穗主板（862323087529874/791/924/841）实测 → 落库 4 样品 ✅｜Web 报告含明细+编号+判定依据+☑电性能 ✅｜Word 36KB ✅｜PDF 51KB ✅｜测试数据已清理 ✅

====== 4.26 阀体测试新增「阀体耐压测试」（2026-09-16） ======

**需求**：阀体测试增加测试项 **阀体耐压测试** —— 可输入公称压力、测试依据用国标、需要数据记录。

**① 测试项**（`templates.json` → `智慧阀门:阀体测试`，22 → **23 项**）
<code>
【依据】GB/T 13927-2022《工业阀门 压力试验》—— 壳体强度试验（耐压试验）
【试验介质】常温清水（或按标准规定）；介质温度 5~50℃
【试验压力】壳体强度试验压力 = 1.5 × 公称压力 PN（常温）；记录实际试验压力（MPa）
【保压时间】按 GB/T 13927 规定（依公称尺寸 DN 分档）；记录实际保压时间（s）
【步骤】① 两端封堵、灌满介质排净空气 ② 缓慢加压至试验压力（不得超压）③ 按规定时间保压 ④ 观察壳体（阀体/连接处/密封面）⑤ 卸压擦拭记录
【判定】保压期间壳体无渗漏、无可见变形、无结构损伤 → 合格；出现渗漏/冒汗/变形 → 不合格
</code>
`tool`：阀门试压台/水压试验机/压力表（精度≥1.6级）/堵头工装/秒表

> ⚠️ 保压时间的**具体秒数分档**未写入（需按 GB/T 13927-2022 原文的 DN 分档确认）——页面上可按实际标准填入。

**② 数据记录**（前端 `test.html` 新增 press 族）
<code>
{"mode":"pressure","pn":"PN16","test_pressure":"2.4","media":"水","hold":"60",
 "samples":[{"no":"WX-PN16-001","pressure":"2.4","hold":"60","result":"无渗漏","verdict":"合格","note":""}]}
</code>
- **公称压力 PN 下拉**（PN6/PN10/PN16/PN25/PN40）→ ★ 选 PN 后**自动换算试验压力 = 1.5×PN**（PN16→2.4｜PN10→1.5｜PN25→3.75｜PN40→6 MPa），并同步到已存在的样品行；也可手动改
- 头部：试验介质（水/气）、保压（s）
- 样品卡片：编号 ｜ 试验压力(MPa) ｜ 保压(s) ｜ 壳体结果（无渗漏/渗漏/变形）｜ 判定 ｜ 备注
- 操作：`pressAdd/pressDel/pressSet/pressHead`（`pressRe` 统一重渲染）
- 表单顶部显示国标依据与判定基准
- 接入：`renderStruct`（管理员）+ `wxStructTable`（测试员）+ openItem 测试员分支条件

**③ 报告**：新增 `_press_html(st)`（Web）与 `_press_docx_table(doc, st)`（Word/PDF）；明细标题「阀体耐压测试明细」；数据列「详见阀体耐压测试明细」（`_is_press*` 判定插入既有链条）

**验证**：3 个样品（含 1 个渗漏不合格 + 备注"阀体与阀盖连接处渗漏"）实测 → 落库 ✅｜Web 报告含明细/GB-T 13927-2022/PN16/2.4 MPa/3 编号/渗漏备注 ✅｜Word 36KB ✅｜PDF 54KB ✅｜PN 换算单测（PN16→2.4、PN10→1.5、PN25→3.75）✅｜测试数据已清理 ✅

====== 4.27 气密性测试项：默认操作步骤 + 压力值调整（2026-09-16） ======

**需求**：气密性测试项的测试步骤加入默认内容（第一步堵住A调节A口；第二步堵住B口调节B口）；测试方法中压力改为 **1.0/2.0/3.0/4.0bar**。

**① 模板 `method` 更新**（3 个气密项）
<code>
【操作步骤】第一步：堵住A，调节A口；第二步：堵住B口，调节B口
【测试条件】不同开度（0/20/40/60/80/100%）、不同压力（1.0/2.0/3.0/4.0bar）气密性
【判定】无渗漏、无冒汗（常温项：保压期间各开度/压力下无渗漏、无冒汗；渗漏量按验收要求）
</code>
- 高温项前缀「【预处理】80℃放置8小时后取出」；低温项「【预处理】-30℃放置8小时后取出」
- ★ **压力值 0.5/1.0/2.0/4.0 → 1.0/2.0/3.0/4.0bar**（去掉 0.5，补 3.0）

**② 前端数据表同步**：`var PRESS=['0.5bar','1bar','2bar','3bar','4bar']` → **`['1.0bar','2.0bar','3.0bar','4.0bar']`**
（开度 `OPENS` 不变：0/20/40/60/80/100%）

> 历史数据不受影响：已存 `cells` 的键仍为旧压力值（如 `0.5bar|0%`），仅新建/新填数据使用新压力档。

**验证**：接口返回 3 个气密项 method 均含操作步骤与新压力 ✅｜页面 `PRESS=['1.0bar','2.0bar','3.0bar','4.0bar']`、无旧 0.5 ✅｜JS 语法通过 ✅

> ⚠️ **★ 连带 bug 与修复（2026-09-17）**：改压力档后，**历史文档（#66/#15）的数据表消失**，页面提示"第1步/第2步未勾选开度/压力"。
> - 根因：旧数据 `step.press=['1bar','2bar','3bar','4bar']` 与新选项 `['1.0bar','2.0bar',...]` **不匹配** → 渲染时复选框全部未勾选 → `buildTable` 判定"未勾选"提前 return → 表格不显示
> - 修复：新增 **`pressOpts(cur)`** —— 返回 `PRESS + 数据中出现的旧值`（按数值升序），`stepBlock`（全量）与 `batchBlock`（批量）均改用；同时 `st.press` 加空值保护
> - 验证：#66 表格数 **49**（含泄漏等级定义表 + 批次数据表）✅｜#15 表格数 **9** ✅｜"未勾选开度/压力"提示消失 ✅
> - ★ 教训：**修改可选项字典（下拉/复选框）时，必须兼容历史数据中已存在的旧值**，否则旧记录会因"勾选状态丢失"而无法渲染

====== 4.28 气密"检验部位"可手动增删（2026-09-16） ======

**需求**：气密性测试数据的检验部位 → 可手动增加部位、编号自动 +1、部位名称可输入。

**改前**：检验部位为**硬编码 6 项**（左侧出口/右侧出口/阀杆位置/压力灌胶/压力密封圈/转接件处），管理员可勾选，测试员视图**只读**。

**改后（`test.html` 新增 `partsEditor(meta, editable)`）**
- `meta.partList`（**有序名称数组**，决定编号与顺序）+ `meta.parts`（勾选状态映射，后端沿用）双结构
- 渲染：`1. ☑ 左侧出口 ✕` …… 编号 = 列表序号；`editable` 时每项带 **✕ 删除**、底部带 **输入框 + 「＋ 增加部位」**
- 增加：`addMetaPart()` — 名称取自输入框（回车也可提交），**编号自动 = 列表长度 + 1**，新部位默认勾选；重名拦截
- 删除：`delMetaPart(i)` — 二次确认后从 `partList` 移除并清理 `parts` 对应键
- 兼容旧数据：无 `partList` 时自动由 `DEFAULT_PARTS`（原 6 项）+ 旧 `parts` 里出现的额外键生成
- ★ **管理员视图与测试员视图都用它**（测试员原为只读配置 → 现可现场增删）
- 数据完整性：初始化时补齐 `parts`（每个 `partList` 项都有键），并经 `st.meta=meta; it.t_struct=JSON.stringify(st)` **写回**
- `structRe()`：增删后按视图（`IS_WX`）重渲染

**验证（浏览器实测，临时会话）**：默认 6 项渲染 + 6 个 ✕ ✅｜新增「阀体螺纹口」→ 成为第 **7** 项、编号自动 +1 ✅｜`parts` 键数 = 7（完整）✅｜勾选"左侧出口" → `parts["左侧出口"]=true` 且键数保持 7 ✅｜测试会话已清理 ✅

**★ 补充：已录入的部位名称也可编辑（`renameMetaPart(i, newName)`）**
- 部位名称渲染为**行内输入框**（不再只是文本），改动即生效
- 改名逻辑：`partList[i]=新名`，并把 `parts[旧名]` 的勾选状态 **迁移**到 `parts[新名]`、删除旧键
- 拦截：空名（提示后重渲染还原）｜重名（提示"该部位已存在"）
- 实测：「左侧出口」→「左侧出水口」→ 名称框/`partList` 同步更新、`parts` 勾选状态正确迁移（新键 true、旧键已删）、其余部位勾选状态保留 ✅

**★ 交互优化：修改部位后不折叠、不跳页（2026-09-16）**
- `structRe()` 重渲染前记录 `#i_struct details` 的 `open` 状态与 `window.scrollY`，渲染后**恢复**（原重渲染会把 `<details>` 打回折叠态并跳到页首）
- 「💧 气密性测试数据」`<details>` 增加 **`open`**（管理员与测试员视图都默认展开；summary 文案改为"点击折叠"）
- 实测：初始展开 ✅｜加部位后仍展开 + 滚动位置保持 ✅｜改名后仍展开 ✅｜删除后仍展开（部位数 4→3）✅

====== 4.29 气密全量记录：数量输入 + 默认留空 + 等级改名（2026-09-16） ======

**需求**：全量记录可输入测试数量（台）；表格数据默认空白；可选等级为 正常/微漏/渗漏/重漏/流淌。

**① 测试数量（台）输入**（全量记录区新增 `#fullQty`）
- 位置：记录方式单选框下方、`#st_full` 之上；提示"台（填后点生成数据表，表格按台数展开）"
- `setFullQty(v)`：写入 `t_struct.qty` **并同步** `items.t_qty`（基本信息"测试数量"，报告取此值）
- `buildTable` 数量优先级：`#fullQty` → `st.qty` → 基本信息 `i_qty` → 1；生成时回写 `st.qty`

**② 表格默认留空**
- 原 `var disp=v||'正常'` → **`var disp=LEAK_ALIAS[v]||v`**（空值即空白）
- 下拉首项为**空选项 `—`**（`<option value="">`），未选择的格不计入统计
- 提示文案改为"表格默认留空（—），按实测结果逐台逐点选择；未选择的点不计入统计"

**③ 等级选项改名：滴漏 → 微漏**
- 前端 `LEAKS=['正常','微漏','渗漏','重漏','流淌']`；新增 **`LEAK_ALIAS={'滴漏':'微漏'}`** 兼容历史值显示
- 后端同步 **14 处**（等级定义表 E2 名称、合格判定规则文案、`metrics` 统计列"微漏（台）"、`LEAK_NAME`、表头文案）
- 前端同步 **8 处**（`leakRef()` 等级定义表等）
- ★ 改名安全性核验：全库扫描确认**实际记录值中无"滴漏"**（67 处"滴漏"均为等级说明文案）→ 改名不影响历史数据

**验证（浏览器实测 + 接口）**：数量框存在且标注"台" ✅｜输入 3 台 → 生成 2 开度×3 台 = 6 个下拉 ✅｜默认值 `""`（空白）✅｜选项 `— / 正常 / 微漏 / 渗漏 / 重漏 / 流淌` ✅｜选"微漏" → `cells={"0%|1.0bar":{"1":"微漏"}}`、`st.qty=3`、`t_qty=3` ✅｜测试会话已清理 ✅

====== 4.30 报告「测试数据」列显示明细名称（2026-09-16） ======

**需求**（用户截图）：测试数据列应显示 **气密性测试明细**（该列原为空白）。

**改前**
- Web 报告：`data_html = t_data`，而气密项的 `t_data` 一律为空（数据都在 `t_struct`）→ **该列空白** ❌
- Word/PDF：显示"详见气密性测试明细"（带"详见"前缀）

**改后**（三处统一：数据列首行加**明细名称**，其后接原摘要/备注）
<code>
_dl = "气密性测试明细"
if mode == "pressure"   → "阀体耐压测试明细"
elif mode == "coating" or samples → "三防漆性能测试明细"
elif mode == "durability" or daily → "连续耐久循环测试明细"
elif 无 step1/step2/batch/meta → "测试明细"
</code>
- Web：`test_api.py` 明细块前置（`data_html` 首行 `<b>明细名</b>`）
- Word/PDF（`_docx_v2`）：`"详见X测试明细"` → **`"X测试明细"`**
- 旧 docx（`_test_doc`）：`_data_cell` 前置明细名（与 Web 一致）

**验证（会话 #70 实测）**：Web 报告数据列 = **`气密性测试明细`** + 检验部位摘要 ✅｜列映射正确（测试方法=常温下不同开度…｜测试工具=气密测试台｜测试数据=气密性测试明细）✅｜Word 1239KB ✅｜PDF 223KB ✅

> 📌 **截图中的"列错位"（方法列显示"气密测试台"）属旧版报告的渲染**——当前渲染已正确；历史报告需**重新生成**才会显示新样式与明细名称。

====== 4.31 阀体测试「扭矩测试」→「阀体启闭扭矩测试」（2026-09-16） ======

**需求**：把**阀体测试**下的扭矩测试项改名为「**阀体启闭扭矩测试**」，并按用户提供的完整规范实现记录与判定。
> ⚠️ 修正记录：首次误改在「其他测试 → 扭力测试」位置，经用户指出后**已还原**，正确位置为**阀体测试**。

**① 模板更新**（`智慧阀门:阀体测试`，23 项）
| 改前 | 改后 |
|---|---|
| 扭矩-常温 | **阀体启闭扭矩测试-常温** |
| 扭矩-高温80℃/8h后 | **阀体启闭扭矩测试-高温80℃/8h后** |
| 扭矩-低温-30℃/8h后 | **阀体启闭扭矩测试-低温-30℃/8h后** |

三个项均写入完整规范（各自温度条件不同）：
<code>
测试依据：GB/T 12224-2015《钢制阀门 一般要求》｜JB/T 8861-2018《阀门 扭矩测试方法》
环境条件：20℃±5℃（常温）｜介质 空气｜压力 0MPa（常压空载）｜动态扭矩测试仪 + 阀门固定工装
（高温/低温项另加【预处理】80℃8h / -30℃8h 后取出）
测试项目：① 开启最大扭矩 ② 关闭最大扭矩 ③ 启闭全程扭矩浮动差值
测试方法：① 样品安装（阀杆垂直/无偏心/校准零点）② 空载常压：全关→全开→全关 完整循环，记录开启/关闭峰值 ③ 重复性：连续 5 次循环
观测记录：开启/关闭最大扭矩｜五次循环偏差｜卡滞跳变｜扭矩差值合理性
合格判定：① 最大启闭扭矩 ≤ 设计额定负载扭矩 ② 五次波动均匀 ③ 全程无卡滞/卡死/摩擦异响
</code>
`tool`：动态扭矩测试仪、阀门固定工装（高温项含高温箱，低温项含低温箱）
**「其他测试 → 扭力测试」已还原**（method：3.6V电压、负载60Nm、正反转持续转动360度；tool：扭力测试台）

**② 记录表**（前端 `toc` 族；`isTorqueOCItem` = 项名含"启闭扭矩"→ 三个新项命中；"扭力测试"不命中，走旧渲染）
<code>
{"mode":"toc","cfg":{"rated":"200","temp":"20±5","media":"空气","pressure":"0","device":"动态扭矩测试仪"},
 "cycles":[{"n":1,"open":"185","close":"178","delta":"7","stick":"无","noise":"无","note":""}, ... 共5条]}
</code>
- 默认 5 条循环；列：循环 ｜ 开启最大扭矩(N·m) ｜ 关闭最大扭矩(N·m) ｜ 浮差 ｜ 卡滞(无/轻微/卡顿) ｜ 异响(无/轻微/明显) ｜ 备注 ｜ ✕
- 配置行：设计额定扭矩、介质、压力
- ★ **自动统计**：开启/关闭最大与均值、**五次偏差**（max−min）
- ★ **自动判定**：`max(开启,关闭) ≤ 额定` → ✅ 合格 / ❌ 不合格；存在卡滞或明显异响 → 附"需复测确认"
- 操作：`tocAdd/tocDel/tocSet/tocCfg/tocRe`

**③ 报告**：`_toc_html(st)`（Web）+ `_toc_docx_table(doc, st)`（Word/PDF）+ `_toc_stats()`；明细标题与数据列均为「阀体启闭扭矩测试明细」

**验证**：
- 模板：3 项改名 + 规范写入；其他测试扭力测试已还原 ✅
- 浏览器（临时会话含两测试项）：`阀体启闭扭矩测试-常温` → **新表单**（5 行循环 + 统计 + 判定）✅；`扭力测试` → **旧表单**且未误用新表单 ✅
- 报告（5 次循环 185/188/186/190/187 + 178/180/179/182/180，额定 200）：统计 开启最大190｜关闭最大182｜均值187.2/179.8｜**五次偏差12** ✅｜判定 ✅合格 ✅｜Word 36KB ✅｜PDF 50KB ✅｜测试数据已清理 ✅

====== 4.32 已生成测试文件支持「添加测试项」（2026-09-16） ======

**需求**：在**已生成的测试文件**（会话）里添加测试项 —— 可**自定义**，也可**从已有测试项中选**。

**改前**：`addItem()` 直接插入一个名为"自定义测试项"的空项（名称不可选、不可自定义）❌

**改后**（点「＋ 添加测试项」弹出选择面板）
<code>
＋ 添加测试项                                            ✕
① 从已有测试项中选择（智慧阀门 · 阀体测试，可多选）
   [搜索测试项…]
   ☐ 外观与结构检查 — 标准光源下目视检查…
   ☐ 气密性测试-常温 — 【操作步骤】第一步：堵住A…
   …（当前分类全部模板项，带方法首行摘要）
   [添加所选]
② 自定义测试项
   [输入自定义测试项名称]  [添加自定义项] [取消]
</code>
- **从模板添加**（`aiAddPicked`）：多选 → 追加到 `CUR_ITEMS`，**自动带入模板的 `method`/`tool`**；提示"记得保存"
- **自定义添加**（`aiAddCustom`）：输入名称（支持回车）→ 追加空项
- **搜索过滤**（`aiFilter`）：按名称实时筛选
- 关闭（`aiClose`）→ 移除面板；点面板外不误关（需点 ✕/取消/按钮）
- 归档只读会话：`btnAddItem` 已被隐藏（原有保护逻辑）；**测试员视图同样可用**（仅基本信息只读）

**验证（浏览器实测，临时会话）**：面板弹出 ✅｜模板复选框 **23** 个（阀体测试）并显示方法摘要 ✅｜勾选 2 项 → 测试项 1→3、`method` 正确带入 ✅｜自定义"自定义：盐雾复测" → 4 项、面板自动关闭 ✅｜搜索"气密"命中 4 项 ✅｜**保存后落库 4 项** ✅｜测试会话已清理 ✅

====== 4.33 阀体启闭扭矩测试增强：多阀杆 + 按台记录 + 模板字段（2026-09-16） ======

**需求**：① 默认"阀杆1扭矩"，可再选"阀杆2扭矩"（如双球阀需测 2 个阀杆）② 测试数量单位"台"，**每台分别记录** ③ 补齐测试目的/测试依据/测试条件/测试方法默认内容。

**① 模板字段补齐**（3 个启闭扭矩项）
| 字段 | 默认内容 |
|---|---|
| `purpose` | 测试阀门在常温常压、空载及带介质工况下的开启扭矩、关闭扭矩，验证阀体摩擦阻力、密封阻力是否符合设计值，确保电动执行器输出扭矩匹配、不卡滞、不过载、不堵转。 |
| `basis` | GB/T 12224-2015《钢制阀门 一般要求》；JB/T 8861-2018《阀门 扭矩测试方法》 |
| `condition` | 环境温度 20℃±5℃（常温）；测试介质 空气；测试压力 0MPa（常压空载）；设备 动态扭矩测试仪、阀门固定工装（高/低温项另加预处理） |
| `method` | 【测试依据】… + 1. 样品安装（阀杆垂直/无偏心/校准零点）+ 2. 扭矩测试（全关→全开→全关，记录开启/关闭峰值与波动）+ 3. 重复性测试（连续 5 次） |
| `tool` | 动态扭矩测试仪、阀门固定工装 |

★ **字段自动带入**：
- 新建会话勾选测试项 → 带入 `purpose/condition/method/tool/basis`
- 「＋ 添加测试项」从模板添加 → 同样带入 ✅

**② 多阀杆 + 按台记录**（数据结构升级，兼容旧 `{cycles}` 结构）
<code>
{"mode":"toc","cfg":{"rated":"200","qty":"2","shafts":["阀杆1","阀杆2"],
  "temp":"20±5","media":"空气","pressure":"0","device":"动态扭矩测试仪"},
 "units":[{"no":1,"shafts":{"阀杆1":[5条],"阀杆2":[5条]}}, {"no":2,"shafts":{"阀杆1":[5条],"阀杆2":[5条]}}]}
</code>
- 配置区：**设计额定扭矩** ｜ **测试数量（台）** ｜ **阀杆多选**（默认阀杆1；勾选阀杆2 适配双球阀）
- 每台一个 `<details>`（默认展开），台内按阀杆分块，各 5 次循环表：循环｜开启最大扭矩｜关闭最大扭矩｜浮差｜卡滞(无/轻微/卡顿)｜异响(无/轻微/明显)｜备注
- 勾选/取消阀杆、改台数 → **重建结构并持久化**（新阀杆自动补 5 行空表；取消勾选保留数据，重勾可恢复）
- ★ **统计/判定按「全部台 × 全部阀杆」汇总**，且填值后**实时刷新**（`tocRefreshStat`，无需重开）
- `tocRe()` 保留展开状态与滚动位置

**③ 报告**：`_toc_html` / `_toc_docx_table` 改为**按台 + 阀杆分组**输出（每台标题 + 每阀杆独立表格），统计含"X 台 · Y 阀杆 · Z 个数据"

**验证**：
- 浏览器：配置区（额定/台数/阀杆多选）✅｜第1台/第2台分块 ✅｜勾选阀杆2 → `cfg.shafts` 与每台结构持久化 ✅｜台数改 3 → 3 台 × 2 阀杆全部补齐 ✅
- **统计实时刷新**：填 205 → 开启最大 205 + ❌不合格；改回 185 → ✅合格 ✅
- 报告（2 台 × 2 阀杆 × 5 循环 = 40 个数据）：Web 含第1台/第2台/阀杆1/阀杆2/五次偏差/明细名/依据 ✅｜Word 36KB ✅｜PDF 58KB ✅｜测试数据已清理 ✅

====== 4.34 【开发纪律】改功能时不得修改已归档的测试文档（2026-09-17） ======

**规则（对助手/AI 的行为约束）**：改动测试系统任何功能时，**绝不能修改、加载保存、或把已归档的真实测试文档（#66、#15 等）当作试验对象**。
- ✅ 正确做法：一律**新建临时会话**做功能验证，验证完**立即删除**（`DELETE /api/test/session/<id>`）
- ❌ 禁止做法：直接对已归档文档调用保存接口、用它们跑测试脚本、改它们的字段
- ❌ 连带要求：功能改动**不能破坏归档文档的正常显示**（例如改可选项字典导致旧值不匹配 → 数据表消失，见下方教训）

**归档文档的既有权限（保持原状，未更改）**
| 角色 | 权限 |
|---|---|
| 管理员 | 可编辑（`isArchivedReadonly()` = `CUR.archived && ROLE!=='admin'`；后端 2 处校验均带 `_role != "admin"` 例外）|
| 普通用户/测试员/游客 | 只读（前端 `lockEdit()` 禁用输入+隐藏保存按钮；后端 403）|
| 归档/取消归档 | 仅管理员（`/api/test/archive/<sid>`）|

**历史教训（2026-09-17 实际踩坑）**
- ⚠️ 改气密压力档（`0.5bar/1bar/2bar/3bar/4bar` → `1.0bar/2.0bar/3.0bar/4.0bar`）后，**归档文档 #66/#15 的数据表消失**，页面提示"第1步/第2步未勾选开度/压力"
- 根因：旧数据勾选值与新选项不匹配 → 复选框全未勾选 → `buildTable` 提前 return
- 修复：新增 `pressOpts(cur)`（PRESS + 数据中旧值并存，按数值排序），`stepBlock`/`batchBlock` 均改用
- **教训**：改可选项字典必须兼容历史值；改功能后**必须回归验证归档文档 #66/#15 显示正常**（现已恢复：#66 = 49 个表格、#15 = 9 个表格 ✅）

====== 4.35 历史文档数据表/测试项显示修复（2026-09-17） ======

**用户反馈**：管理员、测试员都看不到 **#42** 号文档的测试数据表。

**① 根因**：`#42` 的数据里**配置项缺失**（`batch.step1.press=[]` 为空），但**数据键里有完整信息**：
<code>
batch.step1.opens=['0%','20%',...,'100%'] ✅   press=[] ❌（空）
batch.step1.cells 有 22 条，键格式 = "0%|1bar"、"0%|2bar"… ✅（压力值在键里）
</code>
→ 前端渲染时压力复选框全部未勾选 → `batchGen()` 判定"第1步未勾选开度/压力" → **不生成数据表** ❌

**② 修复：从数据键反推配置**（★ 只在内存补全，**不改动数据库**——符合"不改归档文档"纪律）
| 函数 | 作用 |
|---|---|
| `inferCfg(obj)` | 从 `cells` 键（`"开度\|压力"`）反推开度/压力列表并按数值排序 |
| `bOpensList(st,step)` / `bPressList(st,step)` | 批量区复选框选项 = 标准选项 + 数据中出现的旧值 |
| `bStepCfg(step)` | 配置为空时用 `inferCfg` 补全（渲染与生成共用）|
| `stepBlock()` | 全量模式同样接入 `inferCfg` |
| `bCk()` | 勾选判定改用反推后的值（选项与勾选值匹配，避免"值在但显示未勾"）|

**③ 顺带修复测试项列表显示**（`renderItems`）
- 「未填写」判定原来只看 `t_result` → 有结构化数据却显示"未填写"❌
  → 改为 `_hasData` 综合判断（`t_struct`/`t_data`/`t_note`/`t_codes`/`t_recs`/`t_logs`）；有数据无结果时显示「📝 已填数据」
- 图标同理：仅有测试结果时才用 ✅/❌，否则用测试项图标（原来有数据无结果会误显 ❌）

**验证（#42，管理员身份，仅本地渲染未保存）**：压力复选框正确勾选 **1bar/2bar/3bar/4bar** ✅｜开度 12/12 勾选 ✅｜`batchGen()` 生成 **24 个数据表**（6 开度 × 4 压力 × 第1步）✅｜无 JS 错误 ✅｜数据未被修改 ✅

====== 4.36 第2步数据表不显示修复（跨步沿用配置）（2026-09-17） ======

**用户反馈**：#42 文档「第2步：堵住B口，调节B口开度，调节水压」**这部分数据没有**。

**根因**：`batch.step2.cells` 本就**无数据**（第2步从未录入），且 `step2.press=[]` 为空 → 反推（`inferCfg`）拿不到压力值 → 第2步表格整块不渲染 ❌
（第1步有数据 → 反推成功 → 表格正常）

**修复：跨步沿用配置**——同一次测试的第1/2步开度与压力配置本应一致，故某步配置缺失时**沿用另一步**：
| 函数 | 用途 |
|---|---|
| `cfgWithFallback(st, step)` | 批量模式：`batch.stepN` 配置缺失 → 取 `step(3-N)` 的配置（含反推）|
| `cfgWithFallbackFull(st, step)` | 全量模式：顶层 `stepN` 同理 |
- 接入点（共 7 处）：`bOpensList` / `bPressList`（复选框选项）、`bCk`（勾选判定）、`batchGen`（生成时补全）、测试员视图批量分支、测试员视图全量分支、`stepBlock`（全量渲染）
- ★ 仍**只在渲染层补全，不写数据库**（符合"不改归档文档"纪律）

**验证（#42）**
- 测试员视图：数据表 **49** 个（第1步 24 + 第2步 24 + 等级表 1）✅｜第2步片段含「第1批126台/第2批34台」✅
- 管理员视图：压力复选框 1bar~4bar × 2 步全部勾选 ✅｜点「生成批次数据表」→ **48** 个表格 ✅
- 无 JS 错误 ✅｜数据未被修改 ✅

====== 4.37 气密勾选易用性：全选/清空 + 选项去重（2026-09-17） ======

**用户反馈**：手机端打开 #42，压力框全未勾选 → 提示"第1步/第2步未勾选开度/压力" → **无法生成表格**。

**① 新增「全选 / 清空」快捷键**（避免逐项勾选，手机端友好）
- 批量区：`bAll(step, field, on)` — 每步的"开度/压力"旁各有一组 `全选 ｜ 清空`
- 全量区：`fAll(n, field, on)` — 同理（经 DOM 勾选后触发 `cfgChg`）
- 勾选后点「生成批次数据表」即可出表

**② 选项列表去重**（关键修正）
- 原 `bPressList` 返回 `PRESS + 数据旧值`（8 个：`1.0bar…` 与 `1bar…` 并存）→ 全选会**重复生成**表格（96 个）❌
- 改为：**有实际配置/数据 → 只用数据里的值**；无数据 → 用标准选项 `PRESS`/`OPENS`
  - `bOpensList/bPressList`：`(f.opens?.length) ? f.opens : OPENS`
  - `stepBlock`：`_oList = (st.opens?.length) ? st.opens : OPENS`、`_pList = (st.press?.length) ? st.press : PRESS`

**验证（#42，管理员身份，仅本地渲染）**
- 压力选项 = 2 步 × 4 个（`1bar/2bar/3bar/4bar`），**全部自动勾选** ✅
- 开度 = 12 个（2 步 × 6）✅
- 点「生成批次数据表」→ **48 个表格**（6 开度 × 4 压力 × 2 步）✅，无重复 ✅
- 测试员视图 = **49 个表格**（48 + 泄漏等级定义表）✅
- 无 JS 错误 ✅｜数据未被修改 ✅

> 📌 **手机端注意**：改动后需**强刷**（微信缓存顽固）才能加载新代码；若页面仍是旧样式（压力只显示 1.0bar 且未勾选），说明仍是旧缓存。

====== 4.38 第2步压力表格不全修复（两步配置取并集）（2026-09-17） ======

**用户反馈**：#42 文档**第2步只有 1 公斤压力的表格**，应该 2、3、4 公斤的也都有。

**根因（数据实况）**
<code>
step1: opens=6个  press=['1bar','2bar','3bar','4bar']  cells=24 条（6开度×4压力）✅
step2: opens=6个  press=['1bar']                        cells=1 条（'20%|1bar'）❌ 不全
</code>
- 原 `cfgWithFallback` 逻辑是"**本步配置为空**才沿用另一步" → 第2步 `press=['1bar']` **非空** → 不触发沿用 → 只渲染 1 个压力表 ❌

**修复：两步配置改「取并集」**（`_mergeCfg(a,b)`）
<code>
var ops = a.opens ∪ b.opens;   // 开度并集
var prs = a.press ∪ b.press;   // 压力并集（均按数值升序）
</code>
- `cfgWithFallback(st, step)`（批量）与 `cfgWithFallbackFull(st, step)`（全量）均改为 `_mergeCfg(inferCfg(本步), inferCfg(另一步))`
- ★ 仍只在渲染层补全，**不写数据库** ✅

**验证（#42）**
- 管理员视图：`batchGen()` → **48** 个表格，第2步含 `1bar/2bar/3bar/4bar` 全部 4 个压力 ✅（修复前只有 1bar）
- 测试员视图：**49** 个表格，第2步同样 4 个压力 ✅
- 无 JS 错误 ✅

====== 4.39 测试员视图第2步表格仍不全（二次修复）（2026-09-17） ======

**用户反馈**：管理员已能看到全部（1/2/3/4bar），但**测试员仍只有第2步的 1公斤表格**。

**根因**：`wxStructTable()`（测试员视图）第2步渲染时仍用旧写法——
<code>
var opens=(s.opens&&s.opens.length)?s.opens:_inf.opens,
    press=(s.press&&s.press.length)?s.press:_inf.press;   // ❌ s.press=['1bar'] 非空 → 只用 1bar
</code>
→ 虽然 `cfgWithFallback` 已算出并集（4 个压力），但**因为本步非空而没用它** ❌
（管理员视图走的是复选框 DOM 收集路径，所以先前已修好）

**修复（3 处改为直接用并集结果）**
| 位置 | 改动 |
|---|---|
| 测试员·批量分支 | `var opens=_inf.opens, press=_inf.press;` |
| 测试员·全量分支 | `var opens=_inf2.opens, press=_inf2.press;` |
| 管理员 `batchGen()` | 收集后直接用 `cfgWithFallback(st,step)` 的并集结果 |

**验证（真实测试员路径：wx_user=高海荣 → openItem）**
- 表格总数 **49**（第1步24 + 第2步24 + 等级表1）✅
- 第2步压力值 = `1bar, 2bar, 3bar, 4bar` ✅（修复前只有 1bar）
- 无 JS 错误 ✅
- ★ 仅渲染层补全，数据库 `step2.press=['1bar']` 原样保留（未修改）✅

====== 4.40 其他测试新增「表压传感器气密性测试」（2026-09-25） ======

**需求**：智慧阀门 · 其他测试分类新增测试项「**表压传感器气密性测试**」（用户提供完整方案），数据记录分**批量记录/全量记录**（与阀门气密性测试完全相同）；★要求**不影响其他测试项与已有文档**。

**① 模板**（`templates.json` → `智慧阀门:其他测试2`，由 1 项变 **2 项**）
| 字段 | 内容 |
|---|---|
| name | 表压传感器气密性测试 |
| purpose | 对表压传感器进行加压气密性检查，筛选存在漏水、变形、泄漏等问题的产品，合格品进入后续交变测试 |
| condition | 试验压力：**0.4 MPa**；保压观察时间：**30 分钟**（10/20/30 分钟三个记录点）|
| method | 【设备与材料】压力管道(带分口)、气管、水泵、表压传感器、水碗、记号笔、计时器、记录表 ＋【6 步方法】①安装接线②加压至 0.4MPa③初检与基准刻线④定时观察(10/20/30min)⑤泄漏点定位(水碗气泡法)⑥结束与记录 ＋【数据记录】批量记录/全量记录 |
| tool | 压力管道（带分口）、配套气管、水泵、水碗、记号笔、计时器、测试记录表 |

**② 复用气密记录方式（零侵入）**
- 前端 `isQtyStruct()` 判定 = **项名含「气密」** → 本项名含"气密性" → **自动获得批量/全量记录功能** ✅（无需改判定逻辑）

**③ 压力档 0.4 MPa（仅本项生效）**
- 新增 `_curItemName()` + `_pressBase()`：当前项名含「表压传感器」→ 压力档返回 `['0.4MPa']`；否则返回原 `PRESS`
- 接入 3 处：`pressOpts()`、`bPressList()`（批量）、`stepBlock()`（全量）
- ★**未改 `PRESS` 常量** → 阀门气密等其余项不受影响

**④ 验证**
| 项 | 结果 |
|---|---|
| 新项压力档 | **0.4MPa**（无 1bar 等旧档）✅ |
| 新项记录方式 | 批量/全量可用 ✅ |
| **回归**：阀门气密性测试-常温（#66）压力档 | 仍 `1bar/2bar/3bar/4bar`，**无 0.4MPa 污染** ✅，表格 49 个 ✅ |
| 回归：真实文档 #15/#42/#44 可读 | ✅ |
| 回归：其他测试2 模板项 | 三防漆性能测试 + 表压传感器气密性测试（2 项）✅ |
| 验证会话 #82 | 已清理，无残留 ✅ |

====== 4.41 表压传感器气密性测试：位置调整到「结构测试组 · 其他测试」（2026-09-25） ======

**用户要求**：把「表压传感器气密性测试」放到 **智慧阀门 · 结构测试** 下的「其他测试」中（不是电路测试组那个"其他测试"）。

**两组「其他测试」的内部名区分（关键）**
| 顶层组 | 子模块显示名 | **内部名** | 现有测试项 |
|---|---|---|---|
| 电路测试 | 其他测试 | `其他测试2` | 三防漆性能测试 |
| **结构测试** | **其他测试** | **`其他测试`** | 扭力测试、**表压传感器气密性测试** ✅ |
- 前端 `catLabel()` 把两者都显示为「其他测试」；`GROUP_MAP = {"电路测试":["功能性能","环境可靠性","机械应力","其他测试2"],"结构测试":["阀体测试","其他测试"]}`

**迁移操作**（`templates.json`）
- 从 `智慧阀门:其他测试2` **移除** → 加入 `智慧阀门:其他测试`
- 迁移前：[电路组] 其他测试2 = 三防漆 + 表压传感器 ｜ [结构组] 其他测试 = 扭力测试
- 迁移后：[电路组] 其他测试2 = 三防漆 ｜ [结构组] 其他测试 = 扭力测试 + **表压传感器气密性测试**

**验证**
- 接口确认：结构测试组 其他测试 = `扭力测试 / 表压传感器气密性测试` ✅｜电路组 其他测试2 = `三防漆性能测试` ✅
- 浏览器实测：结构测试 → 其他测试 → 可选项含「表压传感器气密性测试」✅；打开该项 → 压力档 **0.4MPa** ✅
- **回归**：阀门气密性测试-常温（#66）压力档仍 `1bar/2bar/3bar/4bar`、表格 49 个 ✅；真实文档均正常 ✅；无 JS 错误 ✅

====== 4.42 【已撤销】表压传感器气密性测试（2026-09-25 添加后当日撤销） ======

**过程**：当日按用户方案新增「表压传感器气密性测试」→ 先放在电路测试组「其他测试」（内部名 `其他测试2`）→ 用户要求移到**结构测试组「其他测试」**（与扭力测试同组）→ 当日用户要求**去掉该项**。

**撤销结果**
| 位置 | 现状 |
|---|---|
| 结构测试组 `其他测试` | **扭力测试**（恢复原状）|
| 电路测试组 `其他测试2` | 三防漆性能测试（未变）|
- 该项**从未被任何会话使用**（`items` 表中无记录）→ 删除无数据影响 ✅

**保留的通用能力**（不影响任何现有测试项）
- `_curItemName()` / `_pressBase()`：按当前项名返回专属压力档（原为「表压传感器」项准备，现无项命中 → 恒返回 `PRESS`）
- `pressOpts()` / `bPressList()` / `stepBlock()` 已接入该函数 → 行为与原 `PRESS` 完全一致（回归验证：阀门气密 #66 压力档仍 1bar-4bar ✅）

**回归验证（删除后）**：#66 / #15 / #42 / #44 / #67 / #81 全部正常 ✅｜阀体测试 23 项 ✅｜两个「其他测试」内容正确 ✅

====== 4.43 结构测试·其他测试 新增「表压气密性测试-常温」（2026-09-25） ======

**需求**：在**结构测试**组的「其他测试」中新增测试项「**表压气密性测试-常温**」，**完全复制**阀体测试中的「气密性测试-常温」。

**执行**（`templates.json`）
<code>
new = copy.deepcopy(源项)          # 阀体测试 → 气密性测试-常温
new['name'] = '表压气密性测试-常温'
items['智慧阀门:其他测试'].append(new)
</code>
- **内容校验**：`deepcopy(new)` 改回原名后与源项 **完全相等** ✅（method/tool 逐字一致）
- 源项未改动：阀体测试仍 **23 项** ✅

**复制的内容**
- method：`【操作步骤】第一步：堵住A，调节A口；第二步：堵住B口，调节B口` ＋ `【测试条件】不同开度（0/20/40/60/80/100%）、不同压力（1.0/2.0/3.0/4.0bar）气密性` ＋ `【判定】保压期间各开度/压力下无渗漏、无冒汗；渗漏量按验收要求`
- tool：`气密测试台`

**记录方式**（自动继承，无需额外开发）
- 项名含「气密」→ `isQtyStruct()` 命中 → **自动获得**：记录方式（全量/批量）、检验部位、两步开度×压力配置、漏水等级定义、批次数据表、全选/清空

**验证（浏览器实测）**
| 项 | 结果 |
|---|---|
| 结构组 其他测试 | 扭力测试 ＋ **表压气密性测试-常温** ✅ |
| 记录方式 全量/批量 | ✅｜检验部位 ✅｜两步配置 ✅｜漏水等级 ✅｜测试数量 ✅ |
| 压力档 | `1.0bar / 2.0bar / 3.0bar / 4.0bar`（新项用标准档）|
| 对比 #66（历史文档）| `1bar / 2bar / 3bar / 4bar` —— **同一档位的旧写法**（历史数据反推），语义一致 ✅ |
| 回归 | 阀体测试 23 项 ✅｜其他测试2 = 三防漆 ✅｜真实文档正常 ✅｜无 JS 错误 ✅ |

> 💡 提示：若该测试项实际使用 **0.4 MPa**（像表压传感器那样），可在 `_pressBase()` 中把匹配条件从「表压传感器」扩展到「表压」，即可自动获得 0.4MPa 档位。

====== 4.44 阀体启闭扭矩测试：循环次数与测试数量可设置（2026-10-10） ======

**需求**：结构测试 → 阀体测试 → 「阀体启闭扭矩测试-常温」：
① **循环测试次数**改为可设置（**1~10 次**，原固定 5 次）
② **测试数量**可设置（**1~500 台**，原上限 50）

**① 循环次数可设（新增 `tocSetLoops`）**
- 新增 `tocBlank(n)` 取代原 `tocBlank5()`（保留 `tocBlank5()` 作兼容包装）
- `cfg.loops`（默认 `'5'`，范围 1~10）写入 `st.cfg`
- 表单新增输入框：`循环测试次数 [n] 次（1~10）`
- **改次数时的数据保护**：增加次数 → 补空行；减少次数 → 按序截断；**行号重排，已有数据按位置保留** ✅
- 边界：输入 `0` → 钳到 **1**（注意 `0` 是合法输入，不能用 `|| 5` 兜底，否则会变 5）；输入 `11` → 10；留空 → 5

**② 测试数量上限 50 → 500**
- 表单 `max="50"` → `max="500"`（提示文字改为「台（1~500）」）
- `tocSetQty()` 钳位 `Math.min(50,…)` → `Math.min(500,…)`
- **`tocStruct()` 内 units 生成上限** `if(qty>50)qty=50` → `if(qty>500)qty=500`（★此处易漏，漏改会导致"qty=500 但只建 50 台"）

**③ 旧数据兼容（关键）**
- 旧记录无 `cfg.loops` 字段 → **不写回数据**，改为**按现有表格行数最大值推断显示**
  - 会话 #70：实际 7 行 → 输入框显示 **7**（此前误显 5）✅
  - 会话 #42：实际 5 行 → 显示 5 ✅
- 用户不主动改次数时，原有行数与数据**完全不动** ✅

**④ 验证**
| 项 | 结果 |
|---|---|
| 循环次数输入框 | min=1 max=10 ✅ |
| 测试数量输入框 | min=1 max=500 ✅ |
| 改 3 次 → 表格行数 | 3 ✅ |
| 填 2 行后改 5 次 | 行数 5，原 2 行数据保留 ✅ |
| 改 1 次（截断） | 行数 1 ✅ |
| 数量 500 | qty=500，units=**500** ✅ |
| 边界 | 0→1｜11→10｜空→5 ✅；数量 0→1｜501→500 ✅ |
| **回归** | #42（50台×5行）、#70（12台×阀杆1/2×7行）数据完好 ✅；#6/#7/#15/#32/#44/#59/#66/#67/#81 正常 ✅ |
| 后端报告 | `_toc_stats` 按行数动态遍历，无需改动 ✅ |

====== 4.45 表压气密性测试-常温：填入默认测试工具/方法/步骤（2026-10-10） ======

**需求**：为该测试项填入三项默认内容（用户提供），★要求不影响其他测试项与测试文档。
① **测试工具**：压力管道（带分口）及配套气管；水泵；表压传感器（待测，按不同组合编号）；水碗（用于气泡法检漏）；记号笔（用于水位刻线、问题标注）；计时器；测试记录表
② **测试方法**：试验压力：0.4 MPa；保压观察时间：30 分钟。
③ **测试步骤**：6 步（安装接线 → 加压至 0.4MPa → 初检与基准刻线 → 定时观察 10/20/30 分钟 → 泄漏点定位（水碗气泡法）→ 结束与记录，形成《传感器测试清单》）

**实现**
| 位置 | 改动 |
|---|---|
| `templates.json`（智慧阀门:其他测试 → 表压气密性测试-常温）| 写入 `tool`/`method`；新增 `condition`、`steps` 字段 |
| `test.html` 新建会话勾选映射（约 576 行）| `t_steps:''` → **`t_steps:items[i].steps||''`** |
| `test.html`「＋添加测试项」面板映射（约 2808 行）| `t_steps:''` → **`t_steps:t.steps||''`** |

> ★ 踩坑：模板字段名与测试项字段名的映射链为
> `templates: name/condition/method/tool/purpose/basis/steps` → `items: t_name(由item_name)/t_condition/t_method/t_tool/t_purpose/t_basis/**t_steps**`
> 原代码两处映射把 `t_steps` **硬编码为空字符串**，导致模板里写 `steps` 也不会带入测试项 → 已修复（该字段对所有项通用，无 `steps` 的模板仍为空，无副作用）

**显示位置**（管理员 & 测试员均可看到）
- 测试项详情页「📋 测试项信息」区：测试方法 / 测试工具 / 测试步骤 三个字段（归档只读视图同样显示）
- 编辑器：`i_method` / `i_tool` / `i_steps`

**验证**
| 项 | 结果 |
|---|---|
| 接口返回 | tool/method/condition/steps 均已写入 ✅ |
| 新建会话勾选后字段 | t_tool/t_method/t_steps/t_condition **全部正确带入** ✅ |
| 详情页显示 | 截图确认「测试项信息」区显示 测试方法/测试工具/测试步骤 ✅ |
| **回归** | 阀体测试·气密性测试-常温 **未被改动**（tool=气密测试台、无 steps）✅；扭力测试 t_steps 为空 ✅ |
| 回归 | 阀体测试 23 项、其他测试 2 项、其他测试2 1 项，数量未变 ✅；无 JS 错误 ✅ |
| 数据 | 临时验证会话已清理，无残留 ✅ |

> 📌 提示：该测试项的压力档当前沿用阀门气密的 `1.0/2.0/3.0/4.0bar`；若实际按方案应打 **0.4 MPa**，可在 `_pressBase()` 中扩展匹配条件即可（需用户确认）。

====== 4.46 表压气密性测试-常温：去掉开度/压力行 + 只保留第1步（2026-10-10） ======

**用户需求（精确）**：① 去掉「开度（可多选）」「压力（可多选）」两行 → ② 去掉「第2步」。
★ 只改这一个测试项，其他测试项与已有文档不受影响。

**新增判定**：`isTPQItem()` = 当前测试项名含「表压气密性测试」
<code>
function isTPQItem(){ try{ var it=CUR_ITEMS[CUR_ITEM_IDX]; return !!(it&&/表压气密性测试/.test(it.item_name||'')); }catch(e){ return false; } }
</code>

**改动清单（共 7 处，均带 `isTPQItem()` 条件）**
| 位置 | 改动 |
|---|---|
| `stepBlock()`（全量记录·管理员）| 不渲染 开度/压力 两行；标题改为「第1步：加压至 0.4 MPa」|
| 全量渲染（2074 行附近）| `buildTable(2,…)` 仅非表压气密时调用 → **只保留第1步** |
| `batchBlock()`（批量记录·管理员）| 表压气密只渲染一行：「第1步：加压至 0.4 MPa ＋ 时间（单选）」|
| 测试员批量渲染（约 951 行）| `['step1','step2']` → `isTPQItem()?['step1']:…` |
| `batchGen()`（批次表生成）| 只处理第1步；无勾选行时**自动用默认值** `['100%']`/`['0.4MPa']` |
| `buildTable()`（全量表生成）| 无勾选行时自动用默认值 `100%`/`0.4MPa` |
| `_pressBase()` | 匹配条件 `/表压传感器/` → **`/表压/`**（表压类测试统一 **0.4 MPa** 档）|

**默认值设定**：开度固定 **100%**、压力固定 **0.4 MPa**（无开度概念 → 表格只出 1 张，行=批次/台）

**验证**
| 项 | 结果 |
|---|---|
| 表压气密性测试-常温 | 「开度（可多选）」✅去掉｜「压力（可多选）」✅去掉｜「第2步」✅去掉｜时间（单选）✅保留 |
| 生成表格 | 批量 1 张（100% / 0.4MPa），无"未勾选"提示 ✅ |
| **回归·阀门气密性测试-常温(#66)** | 开度行 ✅／压力行 ✅／第2步 ✅／表格 49 个 —— **完全未变** |
| 其他 | 检验部位、漏水等级、记录方式（全量/批量）保留 ✅；无 JS 错误 ✅ |
| 数据 | 验证时写入的临时配置已恢复（#91 该项 t_struct 归零）✅ |

====== 4.47 表压气密性测试-常温：检验部位改为 2 个（上漏 / 下漏）（2026-10-10） ======

**需求**：该项的检验部位只保留 **1 上漏、2 下漏** 两个（默认内容），其他测试项不变。

**前端**（`test.html`）
<code>
var DEFAULT_PARTS=['左侧出口','右侧出口','阀杆位置','压力灌胶','压力密封圈','转接件处'];
var TPQ_PARTS=['上漏','下漏'];                      // 2026-10-10：表压气密性测试专用
function _defaultParts(){ return isTPQItem()?TPQ_PARTS.slice():DEFAULT_PARTS.slice(); }
</code>
- `partsEditor()` 默认清单：`DEFAULT_PARTS.slice()` → **`_defaultParts()`**
- `addMetaPart()` 补齐默认：同上
- ★仅当当前项名含「表压气密性测试」时返回 2 个部位，其余项仍是原 6 个

**后端**（`test_api.py`，修复报告硬编码）
- `_custom_row_name(key)` → **`_custom_row_name(key, part_names=None)`**：优先用该项实际部位清单
<code>
  _pn = (part_names or []); _pname = _pn[int(pos)-1] if 0 <= int(pos)-1 < len(_pn) else None
  if not _pname: _pname = PART_NAME.get(pos, pos)
</code>
- Web 报告、Word 报告两处调用改为传 `(st.get("meta") or {}).get("partList")`
- 效果：该项自定义记录行会显示「1-上漏 ｜ E2-微漏」，不再错误显示「1-左侧出口」

**验证**
| 项 | 结果 |
|---|---|
| 表压气密性测试-常温 | 检验部位 = **上漏 / 下漏**（2 个）✅，无旧部位 ✅ |
| **回归** 阀门气密性测试-常温(#66) | 6 个部位（左侧出口…转接件处）**未变** ✅ |
| **回归** #42 阀门气密 | 6 个部位 **未变** ✅ |
| 其他 | 表格 49 个正常 ✅；无 JS 错误 ✅ |

====== 4.48 结构测试·其他测试 新增「表压气密性测试-交变」（2026-10-10） ======

**需求**：在结构测试组「其他测试」新增 **表压气密性测试-交变**，完全复制 **表压气密性测试-常温**；★不影响其他测试项与文档。

**执行**（`templates.json`）
<code>
new = copy.deepcopy(源项)          # 智慧阀门:其他测试 → 表压气密性测试-常温
new['name'] = '表压气密性测试-交变'
items['智慧阀门:其他测试'].append(new)
</code>
- 内容校验：`tool`(74字)/`method`(26字)/`condition`(47字)/`steps`(300字) 与源项**逐字一致、长度相同** ✅

**前端零改动自动继承**（关键）
- 判定 `isTPQItem()` 用的是 `/表压气密性测试/` 正则 → **「表压气密性测试-交变」同样命中** ✅
- 因此新项**自动获得**：检验部位 2 个（上漏/下漏）、隐藏「开度」「压力」多选行、只保留第 1 步（加压 0.4 MPa）、压力档 0.4 MPa、批量/全量记录方式、漏水等级定义

**当前「智慧阀门:其他测试」清单（3 项）**
1. 扭力测试
2. 表压气密性测试-常温
3. **表压气密性测试-交变** 🆕

**验证**
| 项 | 结果 |
|---|---|
| 模板字段与常温项对比 | tool/method/condition/steps **完全一致** ✅ |
| 新项详情页 | 测试方法/测试工具/测试步骤 正常显示 ✅ |
| 新项记录区 | 检验部位=上漏/下漏 ✅｜无开度行 ✅｜无压力行 ✅｜无第2步 ✅｜生成批次表 1 张含 0.4MPa ✅ |
| **回归** 表压气密性测试-常温 | 部位仍 上漏/下漏，行为不变 ✅ |
| **回归** 阀门气密性测试-常温(#66) | 6 个部位、49 个表格 **未变** ✅ |
| 其他 | 阀体测试 23 项不变 ✅；无 JS 错误 ✅ |

====== 4.49 表压气密性测试-交变：专属温循界面 + 三格式报告（2026-10-10） ======

**需求**：该项可设「低温温度 / 高温温度 / 交变间隔(小时) / 交变次数」；每达到预设交变次数后记录一次「测试总数量 / 漏水个数」，**漏水率自动计算**；**默认 2 行可手动增加**；**去掉**该测试项的全量/批量记录方式。

===== 前端（`test.html`） =====
**新增判定 `isTPQAlterItem()`** = 项名含「表压气密性测试-交变」；`isQtyStruct()` 排除该项。

**新增函数**
| 函数 | 作用 |
|---|---|
| `tpaStruct(it)` | 结构初始化：`{mode:'tpqalter', cfg:{low,high,interval,cycles}, rows:[…]}`，**默认 2 行** |
| `tpaForm(it)` | 渲染：温循配置行 + 记录表（序号｜交变次数｜测试总数量｜漏水个数｜漏水率(自动)｜备注｜✕） |
| `tpaCfg(k,v)` / `tpaSet(i,k,v)` | 配置 / 单元格写入 |
| `tpaAdd()` / `tpaDel(i)` | 增加/删除行（至少 1 行） |
| `tpaRate(r)` | **漏水率 = 漏水个数 ÷ 测试总数量 × 100%** |
| `tpaPaint()` | 刷新各行漏水率 + **累计合计**（总测试数/总漏水数/总漏水率） |

**接入点（5 处）**：`renderStruct()`（管理员）、`wxStructTable()`（测试员）、openItem 测试员气密分支、归档只读分支。

**默认值**：低温 `-30` ℃、高温 `80` ℃、交变间隔 `1` 小时、交变次数 `100` 次。

> 已验证：320 台/5 个 → **1.56%**；320 台/8 个 → **2.5%**；两行合计 640 台/13 个 → **2.03%**；无「记录方式(全量/批量)」、无「开度/压力」、无「检验部位/漏水等级」。

===== 后端报告（`test_api.py`） =====
- 新增 `_tpa_rate(qty,leaks)` / `_tpa_rows(st)` / `_tpa_html(st)` / `_tpa_docx_table(doc,st)`
- 三处接入：`_render_report`（Web）、**`_docx_v2`（Word / PDF 实际走此函数）**、明细名与标题（「交变（温循）测试明细」）
- ⚠️ **踩坑**：Word/PDF 导出走的是 **`_docx_v2`**，最初误改到旧函数 `_test_doc` → 报告无数据；另 `_tpa_docx_table` 为模块级函数，`Pt`/`WD_ALIGN_PARAGRAPH` 需**函数内局部 import**

**验证（临时会话，已清理）**
| 格式 | 结果 |
|---|---|
| Web | 含「交变（温循）测试明细」+ 条件 + 1.56% + 合计 640/13/2.03% ✅ |
| Word(docx) | 同上 ✅ |
| PDF | 同上 ✅（LibreOffice 由 docx 转换）|
| **回归** | 表压气密性测试-常温（上漏/下漏 + 气密记录方式）不变 ✅；阀门气密 #66 49 表格不变 ✅；其他文档正常 ✅ |

====== 4.50 交变项：去掉「累计/总漏水率」汇总（2026-10-10） ======

**用户反馈**：交变项底部的「累计：测试 N 台 ｜ 漏水 N 个 ｜ 总漏水率 X%」不对 → **去掉累计台数与总漏水率**。

**改动**
| 位置 | 改动 |
|---|---|
| 前端 `tpaPaint()` | 删除累计计算与 `#tpa_sum` 更新，**只保留每行自动漏水率** |
| 前端 `tpaForm()` | 移除 `<span id="tpa_sum">` 元素（只留「＋ 增加一行」按钮）|
| 后端 `_tpa_html()`（Web 报告）| 删除「合计」行 |
| 后端 `_tpa_docx_table()`（Word/PDF）| 表格行数 `1+len(rows)+1` → `1+len(rows)`，删除合计行 |

**保留内容**：温循条件（低温/高温/交变间隔/交变次数）、各轮记录行、**每行漏水率（自动计算）**

**验证（临时会话，已清理）**
| 项 | 结果 |
|---|---|
| 界面含「累计」/「总漏水率」/`tpa_sum` | ✅ 全部去掉 |
| 每行漏水率 | 1000台/5个 → **0.5%** ✅；1000台/8个 → **0.8%** ✅ |
| Web 报告含「合计」 | ✅ 已去掉；0.5%/0.8%/温循条件均保留 ✅ |
| docx/PDF 报告含「合计」 | **0 处** ✅；0.5%/0.8%/交变（温循）测试条件与明细均保留 ✅ |
| **回归** | 其他测试项与文档未受影响 ✅ |

====== 4.58 所有测试项新增「测试数据」区（手动输入 + 附件上传）（2026-10-10） ======

**需求**：所有测试项的**测试备注**下方增加**测试数据** —— 可手动输入测试数据、可上传测试文档附件。
★ **已归档文档与已生成文档一律不改动**。

===== 数据结构 =====
| 位置 | 改动 |
|---|---|
| `items` 表 | 新增字段 **`t_files`**（测试文档附件，格式 `url|文件名; url|文件名`）|
| `t_data` | 复用已有字段（手动输入的测试数据文本）|

===== 前端（`test.html`） =====
| 函数 | 作用 |
|---|---|
| `filesList(it)` / `filesStr(list)` | 附件列表 ↔ 存储串 互转 |
| `dataBlockHtml(it, editable)` | 渲染「测试数据」区：多行文本（可编辑/只读）+ 附件列表 + 📎上传入口 |
| `fileCards(it, editable)` | 附件卡片（图片显示缩略图，其它显示 📄 + 文件名 + 删除 ✕）|
| `uploadItemFile(input)` | 上传到 `/api/test/upload`（通用接口，任意文件类型）→ 写入 `t_files` |
| `delItemFile(i)` | 删除附件（带确认）|

**接入点（覆盖全部测试项）**
- 管理员主表单（测试备注之后）✅
- 测试员气密表单（2 处）✅
- 测试员扭力表单 ✅
- **专项项**：`renderStruct`/`wxStructTable` 的开关阀时间 / 扭力 / 三防漆 / 耐压 / 耐久 / 交变 分支，统一在表单后追加 `dataBlockHtml` ✅
- **归档只读视图**：显示「测试数据」「测试文档附件」（只读，无输入框、无上传入口）✅

**保存链路**：`collectItems()` 带 `t_data`/`t_files`；`pushItems()` 带 `t_files`；后端 INSERT 与测试员 PATCH 均含这两字段。

===== 后端报告（`test_api.py`） =====
- Web 报告：`data_html` 追加「📎 测试文档附件」可点击链接
- **`_docx_v2`**（Word/PDF 实际使用）：`_res` 追加「测试数据：」「测试文档附件：」
- ⚠️ 踩坑：先改到了 `_test_doc`（旧函数）→ Word/PDF 无变化；**报文导出实际走 `_docx_v2`**

===== 验证（真实执行） =====
| 项 | 结果 |
|---|---|
| 普通项/交变/扭矩/耐压/三防漆/耐久/开关阀时间 | 均出现「测试数据」区 + 附件上传入口 ✅ |
| 上传附件 | `/api/test/upload` → 200，附件可访问（200）✅ |
| 保存 → 重读 | `t_data`/`t_files` 正确保存与回显 ✅ |
| **归档文档（#15，测试员身份）** | 显示「仅查看」+ 只读测试数据；**无输入框、无上传入口** ✅ |
| 报告 | Web ✅ ／ docx（含测试数据 + 附件名）✅ ／ PDF ✅ |
| **数据零改动** | 原有 **14 个会话 / 87 条测试项保持原样** ✅；未重新生成任何已有报告 ✅ |
| 验证残留 | 全部临时会话已清理，残留守 0 ✅ |

====== 4.59 测试系统：复制测试文档生成副本（2026-10-10） ======

**需求**：对已生成的测试文档进行**复制**，生成副本；副本的**文档号重新生成且不重复**。

===== 文档号说明 =====
测试文档号 = `sessions.id`（数据库自增主键）→ 副本插入新行即为**全新且永不重复**的号。

===== 后端（`test_api.py`） =====
新增 **`POST /api/test/session/<int:sid>/copy`**
<code>
s = SELECT * FROM sessions WHERE id=sid           # 不存在 → 404
ins = 复制除 id/created/report_time/archived 外全部字段
      · status 重置为「未开始」
      · remark 追加「｜ 副本自 #<源文档号>」（便于追溯）
      · archived 保持 0（默认未归档，可继续编辑）
nid = last_insert_rowid()                          # ★ 新文档号
逐条复制 items 全部字段（含 t_struct/t_data/t_files/t_photo/t_logs...）
返回 {ok, id: nid, items: N, from: sid}
</code>

===== 前端（`test.html`） =====
- 文档卡片右上角新增 **📋 复制**图标（`copyIc`）：**管理员与测试员**可见；删除图标（🗑）左侧；`event.stopPropagation()` 防止误触打开文档
- 新增 `copySession(id)`：二次确认（说明会生成副本、副本可编辑）→ 调复制接口 → toast 提示「✅ 已生成副本 #N（M 个测试项）」→ 刷新列表
- ⚠️ 修复：原用不存在的 `USER.phone` → 改为 `UNAME || wxLocal() || curName()`（测试页实际的身份变量）

===== 验证（真实点击实测） =====
| 项 | 结果 |
|---|---|
| 点 📋（源 #88）| 生成副本 **#103**（新号 ≠ 源）✅ |
| 副本数据 | 测试项 **2 个全部复制**（气密性测试-常温、阀体启闭扭矩测试-常温），`t_struct` 字节数与原完全一致 ✅ |
| 副本属性 | `status=未开始`、`archived=0` → **可继续编辑** ✅ |
| 原文档 | **保持不变**，仍在列表中 ✅ |
| 独立性 | 改副本不影响原件（已实测）✅ |
| 副本出报告 | Web/Word/PDF 均可正常生成 ✅ |
| 图标 | 卡片右上角 🗑（管理员）+ 📋（管理员/测试员）✅；无 JS 错误 ✅ |
| 数据完整性 | 验证副本已清理，原有 **14 个会话 / 87 条测试项**不受影响 ✅ |

====== 4.60 事故复盘 + 修复：测试员保存 500 & #88 数据被覆盖（2026-10-10） ======

===== 事故一：测试员保存任何测试文档都 500（用户报「13933534044 保存 #88 无反应」） =====
**根因**：4.58 加「测试数据/附件」时，给测试员分支的 `UPDATE items` 语句**只改了参数列表（加了 t_data/t_files），没改 SQL 字段列表** →
<code>
SET t_person=?,t_time=?,t_time_s=?,t_time_e=?,t_logs=?,t_recs=?,t_struct=?,status=?,t_photo=?,t_note=? WHERE session_id=? AND item_name=?
-- 12 个占位符，却传了 14 个参数 → sqlite3.ProgrammingError → HTTP 500
</code>
前端拿不到 ok 也不提示 → 用户看到「点了保存没反应」。

**修复**：SQL 补上 `t_data=?,t_files=?`（12 字段 + 2 条件 = 14，与参数匹配）。实测测试员保存 → **200 ✅**

===== 事故二：#88 的「气密性测试-常温」数据被覆盖 =====
**根因（我的操作失误）**：排查事故一时，我**用真实文档 #88 直接调保存接口**做复测，而该接口是「**先删原 items 再按传入 items 重建**」→ 我传的简易 payload 把原数据覆盖为空。

**恢复**：从 `12:07` 全库备份精确恢复
- #88「气密性测试-常温」：`t_struct` 0 → **1110 字节**，并恢复 t_photo/t_person/status/t_note/t_time_s/t_time_e/t_logs/t_recs 共 9 个字段
- 顺带恢复 `#95`（智慧阀门/其他测试，含表压气密性测试-常温/交变 2 项）——该会话此前被人工删除（前端删除有二次确认）
- 最终全库与备份**零差异**：**14 个会话 / 87 条测试项**

===== ★★ 纪律（立即生效，写入冷启动文件） =====
1. **绝对禁止用真实测试文档做保存类测试**——必须**新建临时会话**（supplier 标记「验证-可删」），测完立即删除。
2. **改 SQL 必须同步核对占位符数 == 参数个数**（`?` 计数）。
3. **改动测试相关接口，必须同时验证「管理员」与「测试员」两条保存路径**（本次只验了管理员，导致测试员全线 500）。
4. 动数据库前**必须先备份**（本次能在 20 分钟内恢复，全靠 12:07 的备份）。
5. 删除类操作、数据写入类操作，**测试完成后必须回读校验并清理**。

====== 4.61 结构测试新增「表压测试」分类（2026-10-10） ======

**需求**：结构测试下新建一个「表压测试」，并把「其他测试」下的两个表压测试项移进来。

**执行**
| 位置 | 改动 |
|---|---|
| `templates.json` → `categories['智慧阀门']` | 新增 **`表压测试`**（位置：其他测试之后、阀体测试之前）|
| `templates.json` → `items['智慧阀门:表压测试']` | **新建**，移入 `表压气密性测试-常温`、`表压气密性测试-交变`（内容逐字未变）|
| `templates.json` → `items['智慧阀门:其他测试']` | 移出后**仅剩 `扭力测试`** |
| `test.html` → `GROUP_MAP['结构测试']` | `['阀体测试','其他测试']` → **`['阀体测试','其他测试','表压测试']`** |

**当前结构（智慧阀门 · 结构测试）**
<code>
结构测试
 ├── 阀体测试    （23 项）
 ├── 其他测试    （1 项：扭力测试）
 └── 表压测试    （2 项：表压气密性测试-常温、表压气密性测试-交变）🆕
</code>

**验证**
| 项 | 结果 |
|---|---|
| 导航 | 结构测试 → **阀体测试 / 其他测试 / 表压测试** ✅ |
| 新分类内容 | 2 项：表压气密性测试-常温、表压气密性测试-交变 ✅（内容长度与原一致：method 26 / tool 74 / steps 300 / condition 47 字）|
| 其他测试 | 仅剩 扭力测试 ✅ |
| 新建会话 | 选「表压测试」可选这 2 项 ✅ |
| **已有文档不受影响** | #95（category 仍为「其他测试」）打开后 2 项渲染正常：常温项显示 上漏/下漏 2 部位、交变项显示温循配置 ✅ |
| 判题逻辑 | `isTPQItem` / `isTPQAlterItem` 按**项名**判定（与分类无关）→ 行为不变 ✅ |
| 其他 | 无 JS 错误 ✅ |

====== 4.62 将 #91、#95 文档移入「表压测试」分类（2026-10-10） ======

**需求**：把 91、95 号测试文档挪到新建的「表压测试」分类。

**执行**（★改库前先备份 `/tmp/test_db_bak_move_*.db`）
<code>
UPDATE sessions SET category='表压测试' WHERE id IN (91,95);
</code>

| 文档 | 改前 | 改后 | 测试项 | 数据完整性 |
|---|---|---|---|---|
| #91 | 其他测试 | **表压测试** | 表压气密性测试-常温 / 交变 | t_struct 合计 2012 字节 ✅ |
| #95 | 其他测试 | **表压测试** | 表压气密性测试-常温 / 交变 | t_struct 合计 674 字节 ✅ |

**改后分类现状**
- **表压测试**：#105（武燕青新建）、#95（席江锋）、#91（席江锋）
- **其他测试**：#32、#81

**验证**：接口按 category=表压测试 查询返回 3 个文档（含 #91/#95）✅；页面列表可见 #91/#95 ✅；无 JS 错误 ✅

====== 4.63 自定义测试项自动加入模板（新建测试可选）（2026-10-10） ======

**需求**：在测试文档里「＋ 添加测试项 → 自定义测试项」手动添加的项，要**自动进入模板**，以后「新建测试」时在该分类下可选。

===== 后端（`test_api.py`） =====
新增 **`POST /api/test/templates/add`**
<code>
入参：{device, category, name, method?, tool?, steps?, condition?, purpose?}
权限：仅 admin / tester（普通用户、游客 → 403）
逻辑：写入 templates.json 的 items["<device>:<category>"]
      · 同名去重（已存在 → {ok:true, added:false}）
      · 分类不存在则补进 categories[device]
返回：{ok, added, key, count}
</code>

===== 前端（`test.html`） =====
`aiAddCustom()`（自定义测试项）在加入当前文档的同时，**同步 POST 到模板接口**：
- 成功且新增 → toast「✅ 已添加「XX」（已加入"表压测试"可选列表，新建测试时可选）」
- 已存在 → toast「已添加「XX」（该项此前已在可选列表中）」
- 失败/异常 → 降级为原提示（不影响文档内添加）

===== 验证 =====
| 项 | 结果 |
|---|---|
| 管理员添加自定义项 | ✅ `added:true`，模板项数 2 → 3 |
| 模板文件 | ✅ 含新项 |
| **模板接口**（前端新建测试读它）| ✅ 返回含新项 → **新建测试可选** ✅ |
| 重复添加 | ✅ 去重（`added:false, msg:"已存在"`）|
| 权限 | 普通用户 **403** ✅ ／ 游客 **403** ✅ ／ 测试员（**手机号登录**）**200** ✅ |
| 测试数据 | ✅ 已清理，模板恢复原状（表压测试 2 项）|
| 全库模板 | ✅ 各分类项数与改动前一致 |

⚠️ 注意：测试员身份由**手机号注册**决定，用**姓名**调用会被判为普通用户（403）——这是既有设计。

====== 4.67 产品系列下拉新增「普惠P1」「拓远T1」（2026-10-10） ======

**需求**：「其他测试」类目表单里的「产品系列」下拉，增加 普惠P1、拓远T1。

**原有机制**
- 字段：`#f_valvetype`（保存到 `sessions.valve_type`），仅 `CAT==='其他测试'` 时出现
- 选项来源：`SERIES_LIST` ← `/api/test/templates` 的 `series_list`，其值 = `SELECT DISTINCT series FROM sessions WHERE series != ''`（即"各行文档填过的系列值"）
- 改动前实际选项：金穗S1、润禾R1、普惠P3（分别来自 #67、#7、#6）

**改动**
| 位置 | 内容 |
|---|---|
| `templates.json` | 新增可配置基础清单 **`"series_list": ["普惠P1","拓远T1"]`** |
| `test_api.py` `/api/test/templates` | 返回前合并：`基础清单 + 各行文档 series 值`，去重（**基础清单在前**）|

**验证（真实页面渲染 + 接口）**
| 项 | 结果 |
|---|---|
| 接口 `series_list` | `['普惠P1','拓远T1','金穗S1','润禾R1','普惠P3']` ✅ |
| 「其他测试」表单产品系列下拉 | 普惠P1 / 拓远T1 / 金穗S1 / 润禾R1 / 普惠P3 ✅ |
| 已有文档 #110 | 原选中值「普惠P3」保持不变 ✅ |
| **回归 · 阀体测试** | 字段仍是「阀体类型」（14 个硬编码阀体类型），**未混入** 普惠P1/拓远T1 ✅ |
| **回归 · 功能性能** | 表单正常渲染（系列为文本输入）✅ |
| 无 JS 错误 | ✅ |

**维护方式**：以后要在此下拉增删选项，改 `templates.json` 的 `series_list` 即可（无需动代码）。

====== 4.68 每个测试项增加「清空测试记录数据」（2026-10-18） ======

**需求**：为每个测试项的测试文档，增加清空该测试项**测试记录数据**的功能。

===== 后端（`test_api.py`） =====
新增 **`POST /api/test/session/<int:sid>/item/clear`**（**仅管理员**）
<code>
入参：{item_name, scope:['data','photo','files','status']}   # scope 默认 ['data']
data   → 清空 t_struct(表格) / t_data(测试数据) / t_recs(测试时段) / t_logs(日志)
          / t_codes / t_result(测试结果) / t_followup(处理方式) / t_ecr(变更内容)
photo  → 清空 t_photo
files  → 清空 t_files
status → status 重置为「未开始」
保留：测试条件/方法/工具/步骤/目的、测试备注、测试人员与时间、测试数量
</code>
权限兜底：手机号能对应到管理员姓名（`_wx_users()[phone].name in _admins()`）也放行。

===== 前端（`test.html`） =====
- 测试项详情「测试项信息」标题右侧新增 **🧹 清空记录** 按钮（仅管理员可见/可用）
- 点击弹出**勾选式确认面板**：
<code>
  ☑ 测试数据（表格 / 记录 / 时段日志 / 测试结果）   ← 默认勾选
  ☐ 测试照片（N 张）
  ☐ 测试文档附件（N 个）
  ☐ 测试状态重置为「未开始」
  提示：保留 测试条件/方法/工具/步骤、测试备注、测试人员与时间
</code>
- 确认后调接口 → toast「🧹 已清空测试记录」→ 自动重载该文档并停留原测试项

===== 验证（临时文档实测，用完已删） =====
| 项 | 结果 |
|---|---|
| 只清 `data` | ✅ 表格/测试数据/结果/日志/编码全清；**照片、附件、备注、测试人员、状态、测试数量全部保留** |
| 其他测试项 | ✅ 完全不受影响 |
| 全清（data+photo+files+status）| ✅ 照片、附件清空；状态重置「未开始」；备注仍保留 |
| 测试员调用 | ✅ **403** 仅管理员可清空 |
| 前端 | ✅ 按钮存在；面板标题/4 个勾选项/照片张数正确；关闭正常；无 JS 错误 |
| 真实文档 #42 | 仅打开面板未确认 → **数据未被改动** |

====== 4.69 修复：电路测试类文档导出报告失败（页面显示原始 JSON）（2026-10-23） ======

**现象**（用户截图）：智慧阀门 → 电路测试 → 导出报告 → 手机上整屏显示
`{"error":"\u8be5\u4f1a\u8bdd..."}` 一串乱码，报告出不来（Word/PDF 同样）。

===== 根因（写死分类名） =====
`test_api.py` 报告接口的 mode 校验：
<code>
if mode == "circuit" and sess["category"] != "电路测试":   # ❌ 写死
    return jsonify({"error": "该会话不是电路测试"}), 400
</code>
但 2026-09-16 分类拆分后，**电路测试组的实际分类是 功能性能 / 环境可靠性 / 机械应力**（很少再叫"电路测试"），
所以这些文档导出 → 一律 400 → 前端 `window.open('/api/test/report/...')` 打开的就是这个 JSON → 手机满屏乱码。

`_render_report()` 里还有一处同样的写死判断 → 就算放过校验，报告里的测试项也会被**全部跳过（空报告）**。

===== 修复 =====
1. 两处判断统一改用已有 helper **`_is_circuit_cat()`**（含历史"电路测试"+ 拆分后三类）
2. 报告类接口的错误响应 → **友好 HTML 错误页**（⚠️ 大标题 + 具体原因 + 返回按钮），不再返回裸 JSON
3. 报告 HTML 响应加 `Cache-Control: no-store`（避免微信缓存旧的错误响应）
4. **归档文档对非管理员只读 → 导出时跳过保存**（原来必先保存 → 被 403"已归档不允许修改"拦下，导出不了）
5. 保存失败提示具体原因（原来只显示"保存失败"）

===== 实测 =====
| 场景 | 结果 |
|---|---|
| #7（功能性能·**已归档**）Web 报告 | ✅ 200，**2.5 MB / 4321 行**（修复前 400 且内容为空）|
| #7 Word / PDF | ✅ 200 docx / 200 pdf |
| #42（阀体测试）`mode=valve` | ✅ 200（回归正常）|
| #110（其他测试）`mode=other` | ✅ 200（回归正常）|
| 错误场景（阀体文档用 circuit 模式导出）| ✅ 显示**友好错误页**「⚠️ 无法生成报告 + 原因 + 返回」 |
| 测试员 + 归档文档导出 | ✅ **0 次保存请求**，直接出报告 |
| 管理员 + 未归档副本 | ✅ 先保存再导出 |
| 数据核对 | 17 会话 / 66 测试项，与备份逐会话比对无丢失（少掉的 31 条是早已删除的 #6 会话遗留孤儿项）|

⚠️ 提醒：手机上导 Word/PDF，微信内置浏览器**不支持下载**，需点右上角「⋯」→「在浏览器打开」；Web 报告在微信里可直接看。

====== 4.70 气密性测试新增「第3步：全关」（2026-10-23） ======

**需求**：气密性测试原来只有第1步（堵住A口）、第2步（堵住B口），**新增第3步 = 全关的情况**。

===== 三步定义（阀门气密） =====
| 步骤 | 状态 | 说明 |
|---|---|---|
| 第1步 | 堵住A口 | 堵住A口，调节A口开度，调节水压 |
| 第2步 | 堵住B口 | 堵住B口，调节B口开度，调节水压 |
| **第3步** | **全关** | **阀门全部关闭，观察各部位渗漏** |

⚠️ **表压气密性测试（表压测试分类）仍只有第1步**，不受影响。

===== 实现要点（`test.html`） =====
<code>
function stepKeyOf(n){ return n===1?'step1':(n===2?'step2':'step3'); }
function stepNums(){ return isTPQItem()?[1]:[1,2,3]; }   // 表压气密只有第1步
function stepTitle(n){ n=1→堵住A口… ; n=2→堵住B口… ; n=3→全关（阀门全部关闭，观察各部位渗漏）}
function _mergeAllSteps(container){ … }                  // 跨步配置并集支持 3 步
</code>
- 管理员 `renderStruct` 与 **测试员 `wxStructTable`** 两套渲染都支持三步
- 默认 `t_struct` 增加 `step3:{opens,press,time,cells}`
- **全量**与**批量**两种记录方式都支持第3步（各自可配 开度/压力/时间）
- 第3步默认沿用第1/2步的开度压力（`_mergeAllSteps`），不会出现空表

===== 报告（`test_api.py`） =====
<code>
def _step_list(st):   # 第1/2步始终输出（历史兼容）；第3步仅在已配置时输出
</code>
Web / Word / PDF **三种报告**都包含第3步；批量报告的三处表格也补齐第3步。

===== ★ 顺带修复的旧 bug =====
气密表格单元格的 `onchange` 行内**直接引用了函数局部变量** `o / p / j / bi2 / bi3`：
<code>
onchange="setCell(...);logAdd('更新 '+o+'开度/'+p+' 第'+(j+1)+'台 …')"
<!-- o/p/j 在事件触发时不存在 → Uncaught ReferenceError（步骤1/2 同样报错）-->
</code>
改为 **`logCell(this)`**：由函数从表格结构（首列"开度/压力" + 表头"第N台"）推导日志文案。
现在三步任意单元格改数据都**零报错**。

===== 验证 =====
| 项 | 结果 |
|---|---|
| 管理员视图（阀体气密）| ✅ 第1/2/3 步配置块与数据表齐全 |
| 测试员视图（`IS_WX`）| ✅ 三步齐全，第3步文案「全关」 |
| 第3步生成数据表 / 填值 / 保存 | ✅ cells 落库（如 `{"0%|1.0bar":{"1":"微漏"}}`）|
| 改任意步骤单元格 | ✅ 无 JS 错误（旧版三步都报 ReferenceError）|
| Web / Word / PDF 报告 | ✅ 均含「第3步：全关」（28KB / 18.5MB / 957KB）|
| 老文档（无 step3）报告 | ✅ 不出现第3步（`_step_list` 按需输出）|
| 表压气密性测试 | ✅ 仍只有第1步 |
| 数据安全 | 用「复制」副本验证，真实文档未改动；副本已删除 |

====== 4.71 气密性测试：开度改为「4 个手动选择槽位」（2026-10-26） ======

**需求**：开度选择提供 **4 个选项位置**，每个位置可手动选开度（**0%~100%，步进 10%**）。

===== 改前 / 改后 =====
| | 改前 | 改后 |
|---|---|---|
| 控件 | 6 个固定勾选框（0/20/40/60/80/100%，可多选）| **4 个下拉**，每个可选 0%~100% 步进10%（含"空"）|
| 组合 | 只能选那 6 个值 | 任意 4 个，如 0%/30%/60%/100% |

===== 实现（`test.html`） =====
<code>
var OPEN_STEPS = 0%,10%,…,100%;               // 步进 10%
function openSlotSelects(step,curOpens,cls,attr) // 生成 4 个下拉
function openValSort(list)                      // 去重 + 按数值排序
function openExtraHint(opens)                   // 超出4个的历史开度提示"已保留"
</code>
- **全量模式**：`select.o-slot`（`stepBlock`）
- **批量模式**：三步都用 `select.bo-slot`（`batchBlock`）
- `buildTable()` / `batchGen()` 改为从下拉取值

===== 历史兼容规则（重要） =====
<code>
· 打开老文档、四个槽位未被改动 → 保留原有【全部】开度（如原来 6 个，仍是 6 个表格）
· 一旦改动槽位 → 严格按这 4 个（或更少）生成
· 原有超出 4 个的开度会在界面上提示"原有额外开度（已保留）"
</code>
⚠️ 表压气密性测试（表压测试分类）**没有开度概念**，仍隐藏开度行、固定 100%/0.4MPa。

===== 验证 =====
| 项 | 结果 |
|---|---|
| 全量：下拉数量/选项 | ✅ 每步 4 个下拉；选项 `—,0%,10%,…,100%`（12 项）|
| 全量：老值回填 | ✅ 原 0%/100% 自动填入前两个槽位 |
| 全量：改选 0/30/60/100 | ✅ `step1.opens` 准确写入，数据表 34 行 |
| 批量：三步下拉 | ✅ 12 个（3 步 × 4）|
| 批量：未改动 | ✅ 历史 6 个开度全部保留 |
| 批量：改选 0%/50% | ✅ 严格按 2 个生成 |
| 表压气密（回归）| ✅ 无开度下拉、无第2/3步、仍 0.4MPa |
| JS 错误 | ✅ 无 |
| 数据安全 | 全部用「复制副本」验证，真实文档未动；副本已删 |

⚠️ 踩坑：`batchGen()` 里 `b[key]` 与 `st.batch[key]` 是**同一个对象引用**，
先 `b[key].opens=[]` 再取旧值 → 永远拿到空数组 → 必须**清空前先备份**。

====== 5. 测试项模板 ======
来源文档归档：~/docs/测试方案/20260903-普惠P3_4G测试项清单.docx、拓远T1执行器阀体测试方案.docx

====== 6. API 一览 ======
| 方法/路径 | 说明 |
|---|---|
| GET /api/test/templates | 模板（设备/分类/项） |
| POST /api/test/session | 新建会话 |
| GET/POST /api/test/session/<id> | 会话详情/保存（items 全量同步） |
| GET /api/test/sessions?device_type=&category= | 列表（含 agg_total/agg_system/agg_result） |
| DELETE /api/test/session/<id> | 删除会话 |
| POST /api/test/upload | 图片/附件上传 |
| GET /api/test/report/<sid>?mode=circuit\|valve&fmt=html\|docx\|pdf | 报告导出 |
| GET /api/test/report/full?circuit_id=&valve_id=&fmt= | 整机报告 |
| GET /api/test/report/item?sid=&item_name= | 单项报告 |
| GET /test/jsqr.js | 二维码解码库（jsQR，扫码功能用，本地内嵌）|
| GET /test/attachments/<fn> | 测试照片/附件（附件目录）|
| POST /api/test/session/<id> | 保存会话：`report_time` 非空才更新（防旧页面清空）；items 全量同步 |

====== 7. 关键规则 ======
1. 测试模块独立蓝图，**绝不动任务/库房功能**；改动后重启 + curl 验证三个模块
2. 测试数据即时清理严禁残留（/tmp 副本验证或独立库）；真实会话数据（张景茹等）不可删
3. 服务 venv = ctwing-2（python-docx 装那里）；页面 JS 改完 node --check；微信内置浏览器缓存顽固（版本号 ?v=）
4. 报告流水号当日增序（report_seq.json）；同一次导出 标题与文件名同号
5. 底部导航加 tab 需同步 4 个页面（rd_h5/rd_store/test/review）
6. SQLite 锁：journal 残留导致 locked → 重启服务；目录属主 ubuntu

====== 8. 运维命令 ======
<code>
sudo systemctl restart rd-h5.service
curl -s https://rd.huiflytech.com/test/ -o /dev/null -w "%{http_code}"
curl -s "https://rd.huiflytech.com/api/test/sessions?device_type=智慧阀门"
</code>

====== 9. 排障速查 ======
| 现象 | 原因 | 处理 |
|---|---|---|
| 报告乱码/JSON | API 返回 jsonify 而非 HTML | report 应 Response text/html |
| items 无 t_data 列报错 | migrate ALTER 被吞 | migrate 每列独立 try；停服务手动 ALTER |
| database is locked | journal 残留/并发 | 重启服务；chown 目录 |
| 新建保存无测试项 | 首次保存只建壳 | 保存=创建+立即写 items（两段式） |
| 气密项打不开 stepBlock is not defined | 大改误删函数 | git 历史恢复函数块 |
| 气密项打不开 batchCfg is not defined | renderStruct 调旧函数名 | 改 batchGen |
| 气密项打不开 b.opens.indexOf | 旧数据 batch 子结构缺字段 | bStepCfg 防御补齐并写回 |
| 表格无台数列 | cells 反推台数（空） | 台数列按 t_qty 生成 |
| 未选点显示正常 | 默认值当数据 | 未触碰不写 cells |
| 扫码无反应/按钮点了没反应 | jsQR 未加载或页面缓存旧版 | 检查 `/test/jsqr.js` 200；页面加 `?v=N` 强刷 |
| 摄像头打不开 | 非 HTTPS / 未授权 / 非手机端 | 用 HTTPS 域名访问 + 允许摄像头权限；降级用"✍ 手动输入" |
| 扫码记录保存后丢失 | 前端白名单漏字段 / 后端未合并 | 检查三处：collectItems、saveItem body、tester-update 白名单均含 t_codes |
| 气密记录方式单选框不显示 | renderStruct 字符串丢 `h+=`（已成死代码） | 检查该行是否有 `h+=` 前缀；改后 node --check |
| 气密区找不到/某测试项无扫码区 | 注入锚点缺失 | `injectCodes` 三级回退 i_struct→iForm→v-item；确认 showV('item') 被调用 |
| 测试员保存的开关阀时间/耐久数据丢失 | `tester-update` 合并白名单只含 cells/torque | 合并改为「配置键(_KEEP_OLD)保留库值 + 其余递归合并（非空才覆盖）」 |
| 耐久项"记录数据"不可用/无表单 | 测试员分支链漏判耐久项（走 else 普通分支，不渲染 i_struct） | `if(isQtyStruct()\|\|isDurItem(it))`；wxStructTable 内再有耐久分支 |
| 耐久函数报 `undefined.push` | 新增函数与已有同名（`durOf`＝时段时长计算）→ 被覆盖 | 自定义结构解析改名 **`durStruct`**；**新增函数前先扫重复定义** |
| 耐久第2天数据保存后消失 | ①`basePayload()` 在详情页访问缺失的 `f_*` 元素抛错被空 catch 吞 ②`durSetTime` 改时间不重渲染 → 数据存成 `部件\|` 空键 | ①basePayload 全字段 null 保护 + 回退 `CUR` ②改时间后 `durRe()` + 旧键迁移；`durFixOrphan` 并入历史空键 |
| 改报告生成时间 | 需要自定义时 | 编辑页「报告时间」填 `2026-08-20 18:00`（存 `sessions.report_time`）|

====== 10. 测试隔离 ======
- 页面/API 验证用浏览器 console（不写库只读）或临时会话（测后删）
- 副本验证：cp test.db /tmp 或 curl 创建 TEST 会话后清理
- 真实数据（用户在建会话 #13/14/15 等）绝不删除/覆盖；改结构先 migrate 不动数据