# 前端执行票 —— 统一分页批次二：点位摘要两级清单（设备卡片、关联设备图层清单） ## Question 按 [全局分页规范](../specs/2026-10-18-global-list-pagination.md) 落地批次二：`PointDetailCard.vue` 两个全量直渲清单接入共享 pager——「设备卡片」（`data-device-cards`，详情端点 `devices[]`）与「关联设备图层清单」（`data-device-layer-list`，票 42 的快照 `deviceCodes` 全量保留）。前端集合分页，每页 10 条、页码直达/前后页，两清单各自独立页码；换点位/设备时复位。 ## Acceptance - 两清单每页 ≤10 条、`pageCount <= 1` 不画控件、到边禁用保占位。 - **票 42 口径不变**：关联设备清单数据仍保留全部编码（含待确认），分页只是窗口化渲染；互斥归类（已上图/无地图位置/模式隐藏/待确认）与差额可追溯不受影响。 - 换点位/设备/返回第一级时页码复位；数据刷新（freshness tick）不复位，越界夹回。 - 空态文案沿用既有（「该监测点当前没有关联设备」等）；新增闸门 + 变异打红；既有相关闸门按成例改写后全绿。 ## Context 共享 pager 由批次一提供（`domain/pagination.js` + `PagerNav.vue`）。教训复用：票 43（稳定标量键）；票 42（清单总数只认当前快照、每台设备恰好落一类）。 ## Related spec [`../specs/2026-10-18-global-list-pagination.md`](../specs/2026-10-18-global-list-pagination.md) ## 进度 - [x] 认领（Assignees: Qoder；阻塞票 #59 已关闭，处于 frontier） - [x] 读票全（正文/评论/标签/认领/父 00/阻塞边 #59）+ 规范 + 票 59 成例 + 既有闸门断言面 - [x] 调查：仓内资料足以回答，未新开 research 笔记；两处票面未写死的分叉已向维护者裁定（未命中子清单分页 / 不画计数行），记在开工说明评论 - [x] 实施：`PagerNav.vue` 新增 `showCount`（默认 true，既有消费方零改动）；`PointDetailCard.vue` 三清单接共享 pager + `pages` 稳定标量键 + 复位 watch - [x] 新增闸门 [t60-point-detail-lists.mjs](../verify/t60-point-detail-lists.mjs) 42/42 + 变异 [t60-mutations.mjs](../verify/t60-mutations.mjs) 10/10 打红并按字节还原 - [x] 回归全绿：t59 37/37 + 变异 13/13、t46 54/54 + 变异 12/12、t10 57/57、t41 SSR 9/9、t42 39/39、t43 40/40、t44 47/47、并行票 64 61/61 - [x] 规范「修订记录」补两条当次裁定（口径只留一份） - [x] 收口（本票 resolved） - [x] **入库并推送（2026-10-21）**：维护者选定「批次一+二合并提交」边界，限定提交 `18263a6`（feat(cockpit): shared pager batch1+2 … (#59 #60)）已推 `origin/master`（`b7c8137..18263a6`）。足迹＝`pagination.js`+`PagerNav.vue`+`equipmentDetailView.js`+`EquipmentDetailSections.vue`+`PointDetailCard.vue`+ t59/t60 新闸门 + t46/t12 成例改写 + 票面 57/59/60 + 规范 + map（外科式 blob，只摘 57/59/60 hunks，并行 map 编辑留在工作树未提交）。**纯提交内容 worktree 复验**：t60 42/42、t59 37/37 + 变异 13/13、t46 54/54 + 变异 12/12、t10 57/57、t41 SSR 9/9 全绿。如实记：`pagination.js` 按选定边界整文件入库，含票 64 的槽位函数（其消费方面板未在本 commit 内，属并行在制品）；推送同时带上了并行会话先前的三个已提交工作（`cee2bda`/`2ff20d7`/`60cecf6`）。 Status: resolved Assignees: Qoder Type: task Blocked by: #59（已关闭） Labels: wayfinder:task ## Comments - 批次二开工说明 + 维护者当次两条裁定（见本票 Answer 的「两条当次裁定」节；已读资料路径与一句话结论逐条记在该评论）。 ### local — 2026-10-20T16:51:39.623Z （收口时正文整篇替换误覆盖此条，补回以保留 provenance）已读资料与一句话结论： - 规范 `specs/2026-10-18-global-list-pagination.md` — 条文 2/3/4/6/7/11 + 三分法「前端集合」明列本票两清单。 - 票 59 Answer — 共享件已就位：`domain/pagination.js`（pagedRows/pageWindow/clampPage）+ `PagerNav.vue`（受控、唯一 @page 出口携带绝对页码）；接线成例 = `pages` 组件本地状态 + `pagedOf()` + `gotoPage()`，复位在组件 watch。 - `components/PointDetailCard.vue`、`stores/deviceLayerStore.js`、`domain/detailFlow.js` — 设备卡片读 `pointData.devices[]`；关联清单读 store `rows`（保留全部编码），总数读 `total`（只认当前快照 `deviceCodes`），归类/图例读 `counts`/`legend`，票 14 未命中行读 `placement === 'unmatched'`。 - 既有闸门/走查断言面：t42 B1b（总数 ≠ 清单行数）、t43 F9（卡片与清单 hover/select 绑定）、t44 F7/F10/F12、t46 E5/E6/E7b/E8、t59 S7/C 组、t18/t44/t45 走查探针（`data-device-layer-row`/`data-device-more` 读行）。 调查结论：仓内既有资料足以回答本次全部问题，未新开 research 笔记。两条票面未写死分叉已向维护者裁定（见 Answer「两条当次裁定」）。 ## Answer **已实施、闸门 + 变异闭环并关闭（2026-10-19）。按 AGENTS.md 跳过 build/dev/浏览器验证。** ### 交付物 | 文件 | 内容 | |---|---| | `src/modules/cockpit/components/PointDetailCard.vue` | 三个清单接入共享 pager：「设备卡片」（`data-device-cards`，详情端点 `devices[]`）、「关联设备图层清单」（`data-device-layer-list`，命中子集）、「未命中设备清单」（票 14 展开子清单，当次裁定 1）。窗口行 `pagedCards/pagedLayerRows/pagedUnmatchedRows` 全部经 `pagedOf()` → `domain/pagination.js` 的 `pagedRows`（条文 11 单源，组件零 `Math.*`/零 `.slice(`）；页码是视图本地状态 `pages = { cards, layer, unmatched }`（稳定标量键，票 43 教训），唯一出口 `gotoPage(key, target)`；复位 watch 的 getter 收成**一个标量字符串** `` `${pointCode}|${deviceCode}` `` | | `src/modules/cockpit/components/PagerNav.vue` | 新增 `showCount` prop（`Boolean`，**默认 `true`**）：计数行是唯一受它门控的块（`v-if="showCount"`），前后页/页码直达/跳页能力不受影响。批次一既有消费方（设备详情三清单）不传该 prop ⇒ 形态逐字不变 | | `.scratch/.../specs/2026-10-18-global-list-pagination.md` | 「修订记录」追加票 60 两条当次裁定（规范是唯一口径来源，不在别处另写第二份） | ### 两条当次裁定（票面未写死，已向维护者确认后按此实施） 1. **票 14 的「另有 N 台 · 未命中当前筛选」展开子清单同样 ≤10/页，第三套独立页码。** 规范判据一视同仁（可能拉长页面就分页）；`pageCount<=1` 时共享层自己 v-if 掉 ⇒ 常态界面零新增控件。「另有 N 台」的 N 仍读**全量** `unmatchedDeviceRows.length`（`data-device-more-count` 不变），差额可追溯是票 14 的口径。 2. **本组件三处 pager 不画计数行**（`:show-count="false"`）。理由：上方已各有权威总数——设备卡片侧是 KPI「设备合计」（读后端统计），关联清单侧是标题「总数 X 台（已上图 Y）」（只认当前快照）；再并排放一个「共 N 条」（窗口口径）就是并排的第二个总数，且窗口条数 ≠ 快照总数正是票 42 明写的「总数 ≠ 清单行数」。 > 实施中途的一次自我纠正：pager 容器在 `

` 里必须是 `
• `（否则 HTML 非法），而普通 `
• ` 在 `PagerNav` 不渲染时会留一条空行 —— 用 `.point-detail__pager { display: contents }` 收口，**不在组件里重复判 `pageCount>1`**（那条规则仍只在共享层有一份）。复位 watch 第一版写成数组 getter，会让「重进同一点位」（`selection` 换新对象、标量同值）假复位，按票 43 教训改成标量字符串。 ### 票 42 口径未动的证明（不是声明，是断言） 分页只发生在渲染窗口：`store.rows` 仍是全量 27 行、`total` 仍是快照口径 27（15 命中 + 12 未命中）、`counts` 互斥归类之和仍 = 全量、`legend` 合计仍 = 全量；标题的两个数与图例的绑定**一字未动**。闸门 K 组五条逐条钉住（K1/K1b/K2/K3/K4），并有变异 M5「标题总数改读窗口条数 → K2 转红」证明它抓得住。 ### 验证 - **新增闸门 [t60-point-detail-lists.mjs](../verify/t60-point-detail-lists.mjs) 42/42**：真实链路灌数（mock 传输 + `mapStore.advance` + `detailStore.openPoint` + `deviceLayerStore.syncForSelection({filterActive:true})`），渲染用 Vue 自定义渲染器在纯对象树上跑**真实 patch**（票 64 成例，不引 jsdom）。 - R 组：每页 ≤10、点页码 2 逐条对编码（画的是第 11–20 台）、两清单页码互相独立、末页只画余数、到边 `disabled` 且节点仍在、上一页走同一出口；`data-device-card` **续全局下标**（第 2 页是 10..19 —— 走查/探针按「第 N 台」取数，翻页不得让它每页都从 0 数）。 - T 组：折叠钮文案仍报全量 12 台、展开后 ≤10、第三套独立 pager、翻末页只画余数、不牵连前两处。 - K 组：票 42 口径（见上）。 - Z 组（条文 5/6 正反两半）：数据刷新**不复位**（还停第 2 页）、跳 999 夹回最后一页且画的是余数、**同点位重进不误复位**、换点位回第 1 页、短列表（2 条）三处控件都不画、返回第一级复位、空态文案与「空清单不画控件」。 - S 组：`showCount` 默认 `true`、计数行是唯一受控块、`EquipmentDetailSections` 不传 `show-count`（既有计数行保留）、三处都 `:show-count="false"`、三处共用唯一出口、单源一条委托、复位键是标量、标题总数与归类仍读 store。 - C 组：三份 `.vue` 用 `@vue/compiler-sfc` 真实编译过（票 41/59 教训：拼错的绑定只有加载层判得出）。 - **变异闸 [t60-mutations.mjs](../verify/t60-mutations.mjs) 10/10 打红并按字节还原**：M1 卡片下标退回页内 0 起 / M2 关联清单退回全量直渲 / M3 未命中退回全量展开 / M4 差额读数改读窗口 / M5 标题总数改读窗口条数 / M6 `showCount` 默认改 false（批次一形态回归）/ M7 组件重长翻页算术 / M8 翻页多开一个出口 / M9 换点位不再复位 / M10 复位触发器退回数组 getter。 - **既有闸门「无需改写即全绿」**（本票未动任何既有判据，如实记）：t59 37/37 + 变异 13/13、t46 54/54 + 变异 12/12、t10 57/57、t41 SSR 9/9、t42 39/39、t43 40/40、t44 47/47、并行票 64 61/61。t59 的 S7（计数行措辞）之所以仍绿，正因为 `showCount` 默认 `true`。t11/t05 的崩溃与本票无关：改动前后同点位、同行号失败（`t11:527`、`t05:343`，均在详情静态守卫之前），属并行在制品既有红。 - **浏览器走查探针面逐条预判**（真机复验归票 18/17 联调窗口）：t45 `W4`（`rows === 2`）与 t44（`DEVICE_CODES` 2 台）都落在 ≤10 场景；t44 的行同源断言读的是引擎计划 `getAssociatedDevices().plan`（store 全量），不是 DOM 窗口；t18 `D2e`（`moreCount === '1'`、展开含 EQ-001）在未命中 1 条时 `pageCount=1` ⇒ 不画控件、行仍在；t10/t11/t12 点 `[data-device-card="0"]` 在第 1 页仍存在。**没有一条既有走查判据需要因本票改写**（多页场景的真实证据归票 18 走查窗口）。 ### 验收对照 1. ✅ 每页 ≤10（R1/R2/T2）、一页不画控件（Z4b/Z6b）、到边禁用保占位（R5/R10）。 2. ✅ 票 42 口径不变（K1/K1b/K2/K3/K4 + 变异 M4/M5）；数据仍保留全部编码含待确认，分页只窗口化渲染。 3. ✅ 复位与保持（Z1 刷新不复位、Z2 越界夹回、Z3 同点位重进不误复位、Z4 换点位、Z5 返回第一级）。 4. ✅ 空态文案沿用既有（Z6 + S9）；新增闸门 + 变异打红；既有闸门无需改写即全绿。 5. ✅ 单源：翻页算术与控件各只有一份（S4/S5/S6 + 变异 M7/M8）。 6. ✅ 按 AGENTS.md 跳过 build/dev/浏览器验证。 ### 状态与下一步 批次二收口。**留档（2026-10-21 更新）**：① **已入库并推送** —— 限定提交 `18263a6`（批次一+二合并，维护者选定边界）已推 `origin/master`；本票足迹只有 `components/PointDetailCard.vue`、`components/PagerNav.vue` 两份源文件 + `verify/t60-*.mjs` 两份脚本 + 规范修订记录，map.md 以外科式 blob 只摘本 effort（57/59/60）hunks，工作树里并行会话的 map 编辑未牵连；纯提交内容 worktree 复验 t60/t59/t46/t10/t41 全绿；② 浏览器/真机验收按项目规则未执行，归票 18/17 联调窗口（≥10 台设备的点位复验建议用 `data-point-pager="cards|layer|unmatched"` 三处包装面取数）。 后续批次（票 61–68）仍按批次一的共享件接入，无需再改本票两份源文件；**唯一例外**：若某消费方也需要「上方已有权威总数、不画计数行」，复用本票的 `show-count`（判据已写进规范修订记录，不要再在组件里另写第二份 pageCount 判断）。