!145 docs(xispeak): 归档前端页面 QA 审查报告（用户视角）

* docs(xispeak): 归档前端页面 QA 审查报告（用户视角）
* docs(fixcontact): 归档前端页面 QA 审查报告（用户视角）
* docs(inspectTask): 归档前端页面 QA 审查报告（工程师+用户视角）
* docs(bqtakepulse): 归档前端页面 QA 审查报告（工程师+用户视角）
* docs(bgpartymatter): 归档前端页面 QA 审查报告（工程师+用户视角）

qa-report/bgpartymatter/QA_REPORT.md

@@ -0,0 +1,86 @@
+# 前端页面工程师视角审查报告 — 党委会/所务会事项（bgpartymatter）
+
+## 审查信息
+
+- 页面/路由：`/bg/bgpartymatter/BgPartymatterList`（党委会台账，菜单「党委会决策事项」）；所务会复用 `BgOfficematterList`（`meetingType=office`，菜单「所务会决策事项」）
+- 审查日期：2026-08-11
+- 审查视角：前端资深工程师（浏览器实测 + 代码审查结合，覆盖 API 契约、权限、状态一致性、表单校验、性能/异常等工程师专项维度）
+- 相关文件：
+  - `src/views/bg/bgpartymatter/BgPartymatterList.vue`
+  - `src/views/bg/bgpartymatter/components/BgPartymatterForm.vue`
+  - `src/views/bg/bgpartymatter/components/BgPartymatterModal.vue`
+  - `src/views/bg/bgpartymatter/BgPartymatter.data.ts`、`BgPartymatter.api.ts`
+  - 后端：`backend/supervison-java/.../bgpartymatter/controller/BgPartymatterController.java`、`jeecg-boot-base-core/.../base/controller/JeecgController.java`
+- 测试账号：`admin`（仅 1 个账号，多角色/多部门/多密级对比场景未覆盖，见「未覆盖项」）
+- 证据目录：`qa-tmp/bgpartymatter/scripts/*.json`（eng_04~eng_09、02_modal、12_adddel_final、05_flow 等）
+- 配套文档：`qa-report/bgpartymatter/QA_REPORT_UX.md`（用户视角报告，可并列对比）
+- 说明：全程无头浏览器实测（Playwright，dev 端口 3100，登录走 mock、业务接口走真实后端 8080），登录账号 admin/123456。
+
+## 总体结论
+
+- **P0 × 1 ｜ P1 × 2 ｜ P2 × 7**
+- 一句话总结：党委会/所务会台账的搜索、详情、流程、新增、删除都能走通且状态一致，但**导出功能 100% 不可用（后端稳定 500，前端静默无任何反馈）**——这是唯一的交付阻塞项，已定位到 AutoPoi 对不可变集合执行 `Iterator.remove()` 的根因；顶部统计标签不随筛选/增删改刷新、详情弹窗字段"看似可编辑实被透明遮罩拦截"是两大 P1 体验/一致性问题。
+
+## P0 - 必须修复
+
+| # | 维度 | 问题描述 | 证据 | 位置 |
+|---|------|---------|------|------|
+| 1 | 后端调用/功能 | **导出（导出 Excel）完全不可用**：点击工具栏「导出」→ 无下载、无 toast、无任何反馈；后端 `exportXls` 稳定返回 500。党委会、所务会两页同一 exportConfig 与同一后端接口，均复现。**根因（已定位）**：后端 `JeecgController.exportXls` 将 `service.list(queryWrapper)` 的查询结果直接作为数据集合传给 AutoPoi 导出；AutoPoi `ExcelExportServer.createSheet()` 第 198-202 行对数据集合迭代器执行 `its.next(); its.remove();` 分块清理，当数据集合为**不可变集合**时 `Iterator.remove()` 抛 `UnsupportedOperationException`；第 213 行 catch 用 `e.getCause()` 包裹（该异常无 cause → null），把真实原因吞掉，统一抛成 `ExcelExportException: Excel导出错误`，响应 trace 无 "Caused by"（与实测一致）。**实测链路**：0 行导出=200，任意 ≥1 行导出=500 且与字段内容无关（最小行、全字段行均失败）；用与 `BgPartymatter` 全部 `@Excel` 字段一致的副本类独立复现（`C:\Users\sz04\AppData\Local\Temp\ap_repro`）：可变 `ArrayList` → 成功(8704 字节)，不可变集合 → 完全相同的 500。修复方向：① 前端 `exportConfig` 切换到后端已有的 EasyExcel 导出端点 `exportXlsByEasyExcel`（`BgPartymatterController.java:490-495`，同模块 `exportXlsHeaders` 模板下载已实测可用，见 P0 修复建议）；② 或后端导出前把数据集合复制为可变 `List`；③ 同时前端应把导出失败透出错误提示而非静默。 | 实测：`exportXls` 响应 HTTP 500 body `ExcelExportException: Excel导出错误`（`qa-tmp/bgpartymatter/scripts/eng_04_trace.json`、eng_09 再复现 500 且 `export_toasts=[]`）；所务会页同样 500（`eng_05_empty_office.json`）；独立复现成功/失败对比（`ap_repro/MainRepro2.java` vs `MainReplica.java`）；AutoPoi 源码 `ExcelExportServer.java:198-213` | `BgPartymatterList.vue:303-307`（exportConfig）、后端 `BgPartymatterController.java:281-287`、`JeecgController.java:62-88`（`:74` `service.list`、`:86` DATA_LIST）、AutoPoi `ExcelExportServer.java:198-213` |
+
+## P1 - 强烈建议
+
+| # | 维度 | 问题描述 | 证据 | 位置 |
+|---|------|---------|------|------|
+| 1 | 状态一致性 | **顶部统计标签（未开始/督办中/已完成）不随筛选、搜索、增删改刷新**：搜索无结果/有结果、新增一条、删除一条后，列表数据都在变（总条数 3→4→3 正确变化），但三个统计标签始终不变（全程 `未开始 3 / 督办中 0 / 已完成 0`），与列表对不上，用户无法判断哪个是当前数据。**根因**：`fetchStatusStats` 仅在 `onMounted` 调用一次；`searchQuery`、`searchReset`、`handleSuccess`、新增/删除成功回调均未再触发统计刷新。 | 实测：`eng_09_engineer_final.json` —— 统计初始/新增后重查后/删除后重查后均为 `['未开始 3',...]`，而列表总条数 3→4→3（`events.after_api_add_reload.has_new_row=true`、`after_delete.residue=0`）；`eng_07_listdump.json` —— 搜索前/搜索无结果后统计不变 | `BgPartymatterList.vue:100-104`（标签渲染）、`:446-465`（fetchStatusStats）、`:463`（仅 onMounted 调用）、`:440-444`（searchQuery）、`:509-513`（handleSuccess）、`:789-796`（searchReset） |
+| 2 | 用户体验/交互 | **详情弹窗字段"看似可编辑、实际点不动"**：详情模式下表单上方有一层透明遮罩 `.jeecg-form-detail-effect`（实测 1100×580 透明 div，`pointer-events:auto`）拦截全部点击，但控件本身未灰化（下拉控件 opacity=1、cursor=pointer、肉眼无只读提示）；点「密级」下拉实测不弹出；「确认」按钮被 `jee-hidden` 隐藏。用户反复点击无反应，误以为系统坏了/自己没点中。**根因**：`handleDetail` 设 `disableSubmit=true` → JFormContainer `:disabled` 渲染遮罩 + Modal 隐藏确认按钮，但只读态缺视觉表达（控件未置灰、无"只读"标识）。 | 实测：`eng_09_engineer_final.json` —— `detail_overlay_count=1`、`detail_overlay_style={pointerEvents:'auto', bg:'rgba(0,0,0,0)', 1100×580}`、`detail_select_dd_open=false`（点密级下拉不弹）、`detail_confirm_visible=false`、`detail_enabled_inputs=6`；`02_modal.json` —— 详情模式 11 只读 / 6 可编辑输入并存；关闭后页面可交互、无残留遮罩 | `BgPartymatterList.vue:486-490`（handleDetail）、`BgPartymatterModal.vue:2-6`（`jee-hidden`）、`BgPartymatterForm.vue:3`（JFormContainer `:disabled`）、`:256`（disabled=formDisabled） |
+
+## P2 - 建议
+
+| # | 维度 | 问题描述 | 证据 | 位置 |
+|---|------|---------|------|------|
+| 1 | 反馈 | **新增成功无 toast**：新增提交成功、列表出现新行，但没有任何"保存成功"提示；删除却有"删除成功!"，反馈不一致。**根因**：`submitForm` 用 `createMessage.success(res.message)`，后端返回的 `res.message` 为空串，`success()` 收到空串不渲染。 | 实测：`eng_09_engineer_final.json` 的 API add `{"success":true,"message":"添加成功！"}`（后端有 message 但前端未取到/为空）；`12_adddel_final.json` —— add 无 toast、delete 有「删除成功!」 | `BgPartymatterForm.vue:403-411` |
+| 2 | 表单校验文案 | **校验文案与字段名不一致**：主办部门字段漏选时，提示「请选择责任部门」，但字段 label 是「主办部门」，用户对不上号。 | 实测：`02_modal.json` form_item_errors（含「请选择责任部门」） | `BgPartymatterForm.vue:232-241`（validator message 写死"责任部门"） |
+| 3 | 表单校验体验 | **序号字段只读却报「请输入序号」**：序号输入框是只读的（自动生成），但必填校验文案是「请输入序号」，用户无法手动消除该错误（实际需回去填"议题序号"触发自动生成）。 | 实测：`02_modal.json`、`07_formmap.json` | `BgPartymatterForm.vue:23-26`（只读）+ `:228`（校验"请输入序号"） |
+| 4 | 布局/性能 | **表格过宽需横向拖动**：21 列总宽约 2808px，可视区约 1200px，中部字段（事项目录编码/抄告单编号/密级等）需反复横拖才能看到，看漏字段风险高。 | 实测：`.ant-table-body` scrollWidth=2808、clientWidth=1200（`eng_02_listdata.json` / 测量输出） | `BgPartymatter.data.ts:7-153`（21 列） |
+| 5 | 可发现性 | **「完成状态」筛选默认藏在「展开」折叠里**：初始工具栏不显示，需点「展开」才出现，首次用户找不到状态筛选。 | 实测：toggle 文案"展开→收起"（`04_expand_filter.png`） | `BgPartymatterList.vue:39-52`（toggleSearchStatus 默认 false） |
+| 6 | 空态引导 | **搜索无结果空态只有「暂无数据」**，无"换个条件/清除筛选"引导，也无一键清空入口。 | 实测：`eng_09` race_final 空表（`03b_search_empty.png`） | `BgPartymatterList.vue`（BasicTable 默认空态） |
+| 7 | 控制台异常 | **列表页交互期间控制台出现 `Invalid prop: type check failed for prop "onChange". Expected Function, got Array`（`<ASelect onChange= [, ]>`），以及点击「导出」时 500 触发 `Unhandled error during execution of component event handler`**。前者疑似筛选/搜索组件把多个 handler 合并成数组传给 ASelect（组件 prop 契约不严谨）；后者证明导出失败在前端是未处理异常、被静默吞掉。 | 实测：`eng_09_engineer_final.json` console（19 条：5 个 app-shell `Failed to resolve component` + 7 条 ASelect onChange + 1 条 500 resource + 1 条 unhandled export handler） | 控制台证据（`eng_09_engineer_final.json`）；export 相关 `BgPartymatterList.vue:303-307` |
+
+## 通过项（做得好的地方）
+
+- **列表刷新正常**：新增后手动点「查询」，列表立即出现新行（总条数 3→4）；删除后「查询」，行消失（4→3）。列表数据链路（list API + 查询/重置）一致、无残留。
+- **竞态安全**：快速连续输入 3 个不同关键词（`QA_TEST_ENG_RACE_01 → 督办 → QA_ZZZ_NO_MATCH_RACE`，无间隔），最终表格与最后一个关键词一致（0 行）、无旧响应串台/残留渲染，未出现 out-of-order 覆盖。搜索即输即查无竞态问题。
+- **详情弹窗回显完整**：详情标题「详情」，19 项字段回显；关闭后页面完全可交互，无残留遮罩/状态污染。
+- **模板下载可用**：「下载模板」成功下载 `党委会-导入模板.xls`（EasyExcel `exportXlsHeaders` 路径，与走 AutoPoi 的「导出」形成对照——问题只在 AutoPoi 导出，不在模板）。
+- **删除链路完整**：行内更多 → 删除 → 二次确认 → 「删除成功!」toast → 列表刷新。新增/删除后列表均刷新。
+- **数据分流正确**：党委会（party）/所务会（office）数据严格隔离，不串台。
+- **流程弹窗可用**：「再次督办」发起流程弹窗标题/部门预填正确；「查询督办流程」流程列表可打开（引用 `QA_REPORT_UX.md` 任务 6 实测证据）。
+- **校验覆盖**：必填校验能定位到字段；序号自动生成（会议时间+议题序号联动）有效。
+- **导出 0 行场景正常**：无数据时导出返回 200（进一步佐证根因只在"有数据的迭代"路径）。
+
+## 未覆盖项 / 待实测（不列入 P0/P1/P2 判定）
+
+| # | 项目 | 原因 / 现有线索 |
+|---|------|----------------|
+| 1 | 多角色/多部门/多密级权限对比（按钮级 `v-auth` 隐藏、数据权限过滤） | 仅 admin 一个账号，无法对比；`exportXls` 接口有 `@RequiresPermissions`，前端按钮有 `v-auth`，但未用第二账号实测不同角色下的可见性/越权 |
+| 2 | 「模板校验」「模板导入」真实文件流程（选 Excel → 校验通过/报错提示） | headless 无法模拟系统文件选择框；对隐藏 input 塞 .txt 无任何 toast，结果不明确（`BgPartymatterList.vue:746-784`） |
+| 3 | 后端 `service.list()` 返回**不可变集合**的具体包装层（是哪个拦截器/配置把 MP 的 `selectList` 结果变成不可变） | 前端侧证据已足够（0 行 200 / ≥1 行 500 / 独立复现），但精确到后端哪个类包装需后端日志/断点确认；已确认 `BgPartymatterServiceImpl` 为纯 MP `ServiceImpl` 无 `list()` 覆盖、`JeecgController.exportXls` 无包裹、运行时 AutoPoi 为 1.4.11（trace 行号与源码逐行吻合） |
+| 4 | 「完成状态」筛选选中后的实际过滤行为（BPM 状态 dict 映射） | 未单独实测（筛选在「展开」里，见 P2-5）；代码走 `JDictSelectTag @change="searchQuery"`，推断正常 |
+
+## 测试过程记录
+
+- **环境**：前端 dev `http://127.0.0.1:3100`（运行中，未动）；后端 `:8080/jeecg-boot`（真实）；登录 `admin/123456`（mock 登录 + 真实业务接口）。脚本见 `qa-tmp/bgpartymatter/scripts/`。
+- **核心操作与产物**：
+  1. `eng_04_trace.py` / `eng_05_empty_office.py`：直接导出抓 500 全量 body（party/office）、0 行导出对比 → `eng_04_trace.json`、`eng_05_empty_office.json`（0 行 200 / ≥1 行 500）。
+  2. `eng_07_listdump.py`：搜索无结果前后统计标签对比 → `eng_07_listdump.json`（统计不变）。
+  3. `eng_08_token2.py`：从请求头提取 X-Access-Token（localStorage 无 token，token 在内存/请求头注入）。
+  4. `eng_09_engineer_final.py`：综合验证（登录 → 列表 → API 新增 → 查询刷新 → 快速搜索竞态 → 详情遮罩 → 导出 → 模板 → API 删除）→ `eng_09_engineer_final.json`。
+  5. 复用既有产物：`02_modal.json`（新增必填校验+详情字段态）、`12_adddel_final.json`（新增/删除 toast）、`05_flow.json`（流程弹窗+导出 500）、`07_formmap.json`（表单字段映射）。
+- **关键网络请求**：
+  - `GET /jeecgboot/bgpartymatter/bgPartymatter/list?...` → 200（列表，正常）
+  - `POST /jeecgboot/bgpartymatter/bgPartymatter/add` → 200 `{"success":true}`（新增）
+  - `DELETE /jeecgboot/bgpartymatter/bgPartymatter/delete?id=...` → 200 `{"success":true}`（删除）
+  - `GET /jeecgboot/bgpartymatter/bgPartymatter/exportXls?...` → **500**（导出，P0）
+  - `GET /jeecgboot/bgpartymatter/bgPartymatter/exportXlsHeaders?...` → 200 下载 `党委会-导入模板.xls`（模板）
+- **console 摘要**：5 条 app-shell `Failed to resolve component`（AppSearch/Notify/SettingDrawer 等，首页框架级，非本页引入）；7 条 `ASelect onChange` 类型警告（P2-7）；1 条 500 resource + 1 条 export 未处理异常（P0 佐证）。
+- **测试数据卫生**：本次会话创建 `QA_TEST_ENG_RACE_01` ×4（含多次中断运行残留）与既有的 `QA_ENG_BISECT_*` ×5、`清空后测试`、`assacas`（office），已全部经删除 API 清理并复核：party/office 列表按 `QA_`/`QA_TEST`/`QA_ENG` 过滤均 **0 残留**。测试数据一律置于 `qa-tmp/bgpartymatter/`（gitignore），不入库。

qa-report/bgpartymatter/QA_REPORT_UX.md

@@ -0,0 +1,98 @@
+# 前端页面用户视角审查报告 — 党委会/所务会事项（bgpartymatter）
+
+## 审查信息
+
+- 页面/路由：`/bg/bgpartymatter/BgPartymatterList`（党委会台账，菜单名「党委会决策事项」）；所务会复用 `BgOfficematterList`（`meetingType=office`，菜单名「所务会决策事项」）
+- 审查日期：2026-08-11
+- 审查视角：业务用户（主视角，兼顾首次使用新手）
+- 相关文件：`src/views/bg/bgpartymatter/BgPartymatterList.vue`、`components/BgPartymatterForm.vue`、`BgPartymatter.data.ts`、`BgPartymatter.api.ts`
+- 证据目录：`qa-tmp/bgpartymatter/screenshots/`（截图 01–22）、`qa-tmp/bgpartymatter/scripts/*.json`（网络/表单/交互证据）
+- 测试账号：`admin`（仅 1 个账号，多角色/多部门对比场景未覆盖）
+- 说明：审查全程无头浏览器实测（Playwright，dev 端口 3100，登录走 mock，其余接口走真实后端 8080）。视觉复核已用 claude-vision-skill 实读截图（如 `08_detail_modal_closeup.png`）+ DOM 实测互补。
+
+## 总体结论
+
+- **P0 × 1 ｜ P1 × 2 ｜ P2 × 6**
+- 一句话总结：搜索、查看详情、展开办理情况、发起/查询流程、新增、删除这些核心流程都能走通，但工具栏的「导出」按钮完全不可用且点击后毫无反应（后端 500 静默失败），是用户日常办事最大的拦路虎；顶部统计标签不随筛选/搜索/增删改刷新、详情弹窗字段「看似可编辑实则点不动」，会让用户误读数据、反复操作。
+
+## P0 - 用户办不成事 / 会出错
+
+| # | 用户场景 | 用户会遇到什么 | 后果 | 证据 | 位置 |
+|---|---------|--------------|------|------|------|
+| 1 | 我要把党委会台账导成 Excel 交上去 | 点击工具栏「导出」按钮，没有任何反应——不弹窗、不下载、不报错，页面静悄悄 | 台账无法导出，用户以为在下载/以为卡了，反复点也没用；后端每次返回 500（POI `ExcelExportException`），但前端吞掉异常不提示 | 实测：点击导出后 `downloads` 列表为空、无任何 toast；后端响应 `exportXls?meetingType=party` 返回 HTTP 500，body 为 `org.jeecgframework.poi.exception.excel.ExcelExportException: Excel导出错误`（见 `qa-tmp/bgpartymatter/scripts/06_crud.json` export_resp、`05_flow.json` api 日志；截图 `13_export.png`） | `BgPartymatterList.vue` 的 `useListPage` exportConfig（line 303-307）+ 后端 `bgPartymatter/exportXls` |
+
+## P1 - 明显受阻 / 容易困惑
+
+| # | 用户场景 | 用户会遇到什么 | 后果 | 证据 | 位置 |
+|---|---------|--------------|------|------|------|
+| 1 | 我想看看「督办中」还有几件事，于是用事项名称/完成状态筛选 | 筛选后下面列表变了（比如 0 条），但顶部三个统计标签（未开始 0 / 督办中 1（已逾期 1）/ 已完成 0）**始终不变**，还是全台账的全局数字 | 列表与统计对不上，用户不知道哪个才对，可能误以为还有未完成事项没人管、或以为自己筛选没生效；增删改后统计也不刷新 | 实测：搜索无关关键词后列表 0 条，统计仍显示「督办中 1（已逾期 1）」；搜索命中后仍不变（`qa-tmp/bgpartymatter/scripts` 运行输出 / `02_list_overview.png` 初始态）；`fetchStatusStats` 仅在 `onMounted` 调用一次，`searchQuery/searchReset/handleSuccess` 均未刷新统计（`BgPartymatterList.vue:446-465`） | `BgPartymatterList.vue:100-104`（统计标签）、`:463`（onMounted 仅一次） |
+| 2 | 我在详情弹窗里想顺手改一下某字段再确认 | 详情弹窗里字段看起来都能点（光标是手型、颜色正常），但点下去**毫无反应**——实际被一层看不见的透明遮罩拦住，保存按钮也被隐藏 | 用户以为系统坏了/自己没点中，反复尝试浪费时间；看不清到底能不能编辑（视觉上无明确只读提示） | 实测：详情模式 `.jeecg-form-detail-effect` 遮罩层存在并拦截 pointer 事件；表单项 cursor=not-allowed、pointer-events=none，但下拉控件 opacity=1、cursor=pointer 显示为可点；主按钮带 `jee-hidden` 类隐藏（`qa-tmp/bgpartymatter/scripts/04_detail2.json`；截图 `08_detail_modal_closeup.png`）；已用 vision 实读 `08_detail_modal_closeup.png` 确认截图视觉上下拉控件未灰化、呈可点外观，与点击无反应形成反差 | `BgPartymatterList.vue:486-490`（handleDetail 设 disableSubmit）+ `JFormContainer` 详情遮罩 |
+
+## P2 - 体验细节
+
+| # | 用户场景 | 用户会遇到什么 | 后果 | 证据 | 位置 |
+|---|---------|--------------|------|------|------|
+| 1 | 我填完新增表单点「确认」 | 弹窗关掉、列表里出现了新记录，但**没有任何"保存成功"提示** | 用户不确定存没存上，容易重复提交或去别处找；删除却有"删除成功!"提示，前后反馈不一致 | 实测：新增 QA_UX_BGPM_003 后列表出现该行，但 `ADD TOASTS=[]`；删除时出现「删除成功!」toast（`12_adddel_final.json`） | `BgPartymatterForm.vue:403-411`（`createMessage.success(res.message)`，res.message 为空则不显示） |
+| 2 | 我填主办部门时漏选了，直接提交 | 校验提示显示「**请选择责任部门**」，可这个字段明明叫「主办部门」 | 用户对不上号，以为提示说的是另一个字段 | 实测：空表单提交后，主办部门字段下报错文案为「请选择责任部门」（`02_modal.json` form_item_errors；截图 `10_add_validation_dupe.png`） | `BgPartymatterForm.vue:232-241`（校验 rule message 写死"责任部门"，字段 label 为"主办部门"） |
+| 3 | 我只填了会议时间、没填议题序号就提交 | 「序号」字段提示「请输入序号」，可这个输入框是**只读的**（自动生成），我根本没法手动输入 | 用户不知道怎么消除这个错（实际上要回去填"议题序号"才会自动带出），提示指向了错误的操作对象 | 实测：序号输入框 readonly，placeholder 为"填写会议时间和议题序号后自动生成"，但校验文案是「请输入序号」（`02_modal.json`、`07_formmap.json`） | `BgPartymatterForm.vue:23-26`（只读输入）+ `:228`（校验"请输入序号"） |
+| 4 | 我想看某条记录后面的完成状态、密级等字段 | 表格有 21 列，宽度约 2808px，可视区只有约 1200px，中部字段（序目录编码、抄告单编号、密级等）要一直横拖才能看到 | 反复左右拖动才能看完一条记录，看漏字段的风险高 | 实测：`.ant-table-body` scrollWidth=2808、clientWidth=1200，存在横向滚动（`scripts` 测量输出；截图 `02_list_overview.png`） | `BgPartymatter.data.ts:7-153`（21 列） |
+| 5 | 我想按"完成状态"筛一下在办的 | 「完成状态」筛选条件默认藏在「**展开**」折叠里，不点开看不到 | 首次用户以为只能按年份/领导/名称/决议筛，找不到状态筛选 | 实测：页面初始工具栏无"完成状态"，点「展开」后才出现（`04_expand_filter.png`，toggle 文案由"展开"变"收起"）；`toggleSearchStatus` 默认 false（`BgPartymatterList.vue:39`） | `BgPartymatterList.vue:39-52` |
+| 6 | 我搜了个没结果的关键词 | 表格显示「暂无数据」四个字，没有"换个条件试试/清除筛选"的引导 | 用户不知道是没数据还是搜错了，也没有一键清空入口（只能自己点重置） | 实测：搜索无结果后表格空态为纯「暂无数据」（`03b_search_empty.png`） | `BgPartymatterList.vue` 空态（BasicTable 默认） |
+
+## 用户会觉得顺的地方
+
+- 搜索即输即查（输入事项名称/会议决议时自动查询），「查询/重置」按钮位置和文案清楚，实测有效。
+- 事项名称可点击进详情，详情弹窗字段回显完整（年份/会议时间/议题序号/密级/事项名称/会议决议/主办协办部门/完成状态/督办次数/要求完成日期/是否急件/需所办领导审批等 19 项）。
+- 行首「展开」能看每条记录的责任部门办理情况子表，子表自带 未开始/进行中(含逾期)/已完成 统计，层级清晰。
+- 新增表单「序号」会根据会议时间+议题序号自动生成（如 `20260811-9`），少填一项（实测自动带出）。
+- 发起流程弹窗标题明确（如「发起流程（清空后测试 第二次督办）」），被督办部门已按主办/协办部门预填，发起类型/截止时间/是否急件/审批意见齐全。
+- 「查询督办流程」弹窗能列出该事项的流程列表（含流程图/审批历史/修改/删除入口）。
+- 删除有二次确认（「是否确认删除」），删除成功有 toast「删除成功!」。
+- 行状态着色（未开始黄 / 督办中红 / 已完成绿）+ 顶部统计标签帮助扫读（注：配色为浅粉彩 #fff1f0 系，单行时区分度中等；统计标签不随筛选刷新见 P1-1）。
+- 党委会/所务会数据严格分流（实测所务会页显示独立的"assacas"记录，不串台）。
+- 校验错误信息具体（请选择年份/请输入事项名称/请输入会议决议），能定位到字段。
+
+## 12 维度核对结果汇总
+
+| # | 维度 | 通过 | 问题（简写+证据位置） |
+|---|------|------|----------------------|
+| 1 | 目标达成 | 部分 | 导出任务完全无法完成（P0-1）；其余核心任务走通 |
+| 2 | 可发现性 | 部分 | 完成状态筛选藏在"展开"折叠（P2-5）；导出/下载模板/模板校验/模板导入等按钮集中在工具栏，一眼可见 |
+| 3 | 可学习性 | 部分 | 序号只读但报"请输入序号"（P2-3）；校验文案"主办部门/责任部门"不一致（P2-2） |
+| 4 | 效率 | 通过 | 搜索即输即查、序号自动生成、部门预填；无需多余确认 |
+| 5 | 认知负荷 | 部分 | 表格 21 列过宽需横拖（P2-4）；统计与筛选不一致增加理解负担（P1-1） |
+| 6 | 文案清晰度 | 部分 | 校验文案字段名不一致（P2-2）；导出失败无任何文案（P0-1）；多数提示文案业务化、可读 |
+| 7 | 反馈及时性 | 部分 | 导出静默失败无反馈（P0-1）；新增无成功 toast（P2-1）；删除有 toast；列表增删后自动刷新 |
+| 8 | 误操作防护 | 通过 | 删除有二次确认；详情模式保存按钮隐藏（不可误提交）；提交前必填校验明确 |
+| 9 | 空态/加载/错误态 | 部分 | 空态仅"暂无数据"无引导（P2-6）；后端 500 被吞成静默（P0-1）；加载中正常 |
+| 10 | 无障碍细节 | 部分 | 详情字段"看似可点实则被遮罩拦截"，光标/颜色与行为不一致（P1-2，已 vision 复核 `08_detail_modal_closeup.png` 确认下拉控件未灰化、cursor=pointer、肉眼无只读提示）；Tab 键盘流未专项验证 |
+| 11 | 视觉一致性 | 通过 | 按钮、标签、状态色与平台其他台账页一致（参照 xispeak/inspectTask 风格）；无错位溢出（此前 BGPARTYMATTER_CHECKLIST 已核） |
+| 12 | 边界场景 | 部分 | 搜索空结果有"暂无数据"；超长文本/连点/刷新丢数据等未逐项实测（见待实测） |
+
+## 用户任务走查记录
+
+- 任务 1：登录进入台账
+  - 打开 `/user/login` 输入 admin/123456 回车 → 进入流程门户；直接访问 `/bg/bgpartymatter/BgPartymatte
+- 任务 2：搜索一条记录rList` 打开党委会台账。截图 `01_login_home.png`、`02_list_overview.png`。顺畅。
+  - 事项名称输入"督办"→ 0 条（空态"暂无数据"）；输入"清空"→ 1 条命中；点「重置」恢复全部。搜索即输即查+查询按钮均可用。截图 `03_search_title.png`、`03b_search_empty.png`。顺畅；但发现统计标签不随搜索变化（P1-1）。
+- 任务 3：查看详情 / 展开办理情况
+  - 点事项名称打开详情弹窗（标题"详情"，19 字段回显）→ 点行首箭头展开"办理情况"子表（含统计与附件下载列）→ 收起。截图 `05_expand_feedback.png`、`06_detail_modal.png`、`08_detail_modal_closeup.png`。顺畅；发现详情字段被透明遮罩拦截点击（P1-2）。
+- 任务 4：筛选（含展开"完成状态"）
+  - 点工具栏「展开」→ 出现"完成状态"筛选 → 折叠。截图 `04_expand_filter.png`。发现状态筛选藏折叠里（P2-5）。
+- 任务 5：导出 / 下载模板 / 模板校验 / 模板导入
+  - 「下载模板」成功下载"党委会-导入模板.xls"（截图 `12_template_download.png`）；「导出」点击后无任何反应，后端 500（截图 `13_export.png`，证据见 05/06 json）→ P0-1；「模板校验/模板导入」点开是文件选择（headless 无法完成真实选文件，见待实测）。
+- 任务 6：流程操作（发起/查询）
+  - 行内"更多"→「再次督办」打开发起流程弹窗「发起流程（清空后测试 第二次督办）」，部门已预填（截图 `16_flow_modal.png`、`07_row_dropdown.png`）；「查询督办流程」打开流程列表（含流程图/审批历史等，截图 `17_query_process.png`）。顺畅。
+- 任务 7：新增→校验→删除（建数实测）
+  - 新增弹窗空表单提交 → 8 个必填校验（截图 `10_add_validation_dupe.png`）；填全（含部门"选择"弹窗选 DD、密级选"非密"）后提交 → 列表出现 `QA_UX_BGPM_003 测试`（序号自动生成 `20260811-9`，完成状态默认"未开始"）→ 无成功 toast（P2-1）；删除该记录 → toast「删除成功!」→ 列表无残留。截图 `19_add_filled.png`、`20_list_after_add.png`、`21_list_after_delete.png`。**已建数实测并清理，无残留。**
+
+## 待实测 / 代码推断项（不列入 P0/P1）
+
+| # | 项目 | 为什么没实测 | 现有线索 |
+|---|------|------------|---------|
+| 1 | 「模板校验」「模板导入」完整流程（选真实 Excel → 校验通过/报错提示） | 两者是文件上传按钮，headless 无头浏览器无法模拟系统文件选择框；实测对隐藏 input 设置一个 .txt 文件后无任何 toast，结果不明确 | `BgPartymatterList.vue:746-784`；后端 `getCheckExcelByEasyExcelUrl`/`getImportExcelByEasyExcelUrl` |
+| 2 | 详情模式字段的视觉"只读感" | 已用 vision 实读 `08_detail_modal_closeup.png` 确认：下拉控件未灰化、cursor=pointer，截图视觉上无任何只读/不可编辑提示 → "看似可编辑"从 DOM 推断升级为**实测确认**（即 P1-2），不再待实测 | DOM：遮罩 `.jeecg-form-detail-effect` 拦截点击、表单项 cursor=not-allowed、下拉控件 opacity=1/cursor=pointer |
+| 3 | 所务会（office）页「导出」是否同样 500 | 所务会与党委会是同一组件复用（`meetingType=office`），未单独实测导出 | 同一 exportConfig 与后端 `exportXls` 接口，推断大概率同错（P0-1 同源），待实测 |
+| 4 | 表格过宽的中部列是否需要"冻结/固定"常用列 | 业务上哪些列最常用需人工确认 | 实测 scrollWidth 2808 vs 可视 1200，仅"操作"列固定右侧 |
+| 5 | 键盘 Tab/回车完整走查、超长文本/快速连点等边界 | 时间盒内未逐项执行 | 未发现专项问题，列为常规复核项 |
+| 6 | `BgPartymatterFeedbackList.vue` 独立反馈页的用户可达性 | 菜单 SQL（`V20260416_1__menu_insert_BgPartymatter.sql`）只注册了"党委会"，反馈功能在主列表"办理情况"展开面板内操作 | 独立路由 `/bg/bgpartymatter/BgPartymatterFeedbackList` 能打开（渲染了应用壳），但未见独立菜单入口 |