From 4076621e04aee59852998787fed269240213ad99 Mon Sep 17 00:00:00 2001
From: xcs <xcs@xcsdeMac-mini.local>
Date: Sun, 30 Aug 2026 19:32:15 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E4=BA=A4=E6=8E=A5=E4=BB=B6=20=E2=80=94?=
 =?UTF-8?q?=E2=80=94=20input-supplement=20=E6=8D=A2=E7=89=88=E9=9D=A2?=
 =?UTF-8?q?=E7=9A=84=E8=AE=BE=E8=AE=A1=E4=B8=8E=E5=89=8D=E6=8F=90(?=
 =?UTF-8?q?=E4=B8=BA=E4=B8=8A=E4=B8=8B=E6=96=87=E5=8E=8B=E7=BC=A9=E8=80=8C?=
 =?UTF-8?q?=E5=86=99)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

用户已批准的 bounded 改动:把 S1 数据工单那一屏的视图层换成
docs/ss02-act-05-new/ACT-WORK-05-数据工单-PN主数据创建.html 的版面,绑定与功能不动。

用户已定三件事(压缩后不必再问):两条并列轨道 · 新增类型面板每行扩四格且去掉独立字段表 ·
不动平台每步骤卡一道闸。

文档里落了压缩后会用到的全部事实:目标件结构、现有件四个片段的行号与绑定、
P08_CSS 的位置、ViewContainer 的 editable/bodyOf/addRow 机制、gateLedgers 四张表、
必须留着的终审 C1 修复(那个 disabled 的 data-col=type_id)、
以及一条要先验证再往下写的风险(步骤③ 两组瓷贴共用一个宿主时 cellsOf/rowOf 能否正确归行 ——
bodyOf 只找得到一个宿主,认错会把两颗料的参数值混成一行)。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LKMZDwMbyKzjw6Hembwvet
---
 .../2026-08-30-input-supplement-view-swap.md  | 232 ++++++++++++++++++
 1 file changed, 232 insertions(+)
 create mode 100644 docs/superpowers/plans/2026-08-30-input-supplement-view-swap.md

diff --git a/docs/superpowers/plans/2026-08-30-input-supplement-view-swap.md b/docs/superpowers/plans/2026-08-30-input-supplement-view-swap.md
new file mode 100644
index 0000000..605e53d
--- /dev/null
+++ b/docs/superpowers/plans/2026-08-30-input-supplement-view-swap.md
@@ -0,0 +1,232 @@
+# `input-supplement` 换版面 —— 照新目标件重做数据工单那一屏
+
+> **状态**:设计已定、**已获用户批准**(2026-08-30)。这份文档是**为上下文压缩而写的交接件** ——
+> 压缩之后照它直接开工,不必重新 brainstorm、不必再问用户。
+>
+> **分类**:bounded(要改的流程仓里已经有;换版面、功能不变)。按 brainstorming 技能的 bounded 路径,
+> **不写 spec、不走 writing-plans**;这份文档只是上下文的替身,不是流程意义上的实施计划。
+
+---
+
+## 一句话
+
+把 `input-supplement`(S1 派的那张数据工单)的**视图层**换成
+`docs/ss02-act-05-new/ACT-WORK-05-数据工单-PN主数据创建.html` 的版面,**绑定面与功能一个不动**。
+
+用户原话:「功能应该是一样的」「注意页面样式要和这个模版html几乎一样」。
+
+---
+
+## 用户已定的三件事(不要再问)
+
+| # | 问题 | 用户的选择 |
+|---|---|---|
+| 1 | 目标件是单颗 PN 三步向导,而 W05 天生两颗料 | **每颗料一条轨道(两条并列)** |
+| 2 | 目标件的新增类型面板只收参数名,而 W05 的硬/软约束必填 | **面板里每行扩成四格**(参数名/说明/硬软约束/单位),**独立的「核心参数字段」表去掉** |
+| 3 | 目标件是一道总闸切整页,平台的闸按台账地址走 | **不动平台:每个步骤卡自带一道闸** |
+
+**第 1 条我提过风险**(类型要在两条轨道各选一次、而它们必须相同,容易选出不一致再被判据拦下),
+用户仍选了它 —— 按他的决定走,但**加一道无脚本护栏**(见下)。
+
+**第 2 条的连带代价**(要在实现时留意):独立字段表去掉之后,**已有类型的字段清单在件上看不到也改不了**。
+现有件那张表的第二个用途是「在库但当年参数没录全 → 给已有类型补一个字段」。
+**缓解**:把新增类型那个 `<details>` 面板对**已有类型**也开放(标题写「类型库里没有?或要给这个类型补一个字段」),
+同一个面板兼两用,版面不变而能力不丢。**这一条是我在设计里补的,用户没有单独批,但它属于「功能一样」的承诺范围。**
+
+---
+
+## 现场事实(已逐条核实,不必重查)
+
+### 目标件
+`docs/ss02-act-05-new/ACT-WORK-05-数据工单-PN主数据创建.html` —— 444 行 / 26KB。
+同目录另有 `SS02_ACT-WORK-05_差异评估_E04-I01架构版_V1.2.html` 等,**不在本次范围**。
+旧目标件在 `docs/SS02-ACT-WORK-05-html/ACT-WORK-05-数据工单-01-芯片主数据创建.html`(现有件是照它平移的)。
+
+目标件结构:
+- `.card-head`(`.badge`「数据」· `.kick`/`h1`/`.sub` · `.side` 里 tag/step/deadline)
+- 【触发原因】`.zone` + `.note`(流程 / AI 预填情况)
+- **`.jc-editgate` 带 `.gateprog` 进度条**(`.track`/`.fill`/`.pct` = `0 / 3 项`)
+- **渲染态 `.viewarea`**:`.idcard` 两格(PN 名称 / PN 类型,大号 mono 值)+ 核心参数表 `.tbl-wrap`
+- **编辑态 `.editarea`**:`.steps` 步骤轨道(`.stepbox` / `.sdot` / `.scard` / `.fld`)
+  - ① PN 名称 ② PN 类型(select 首行 `＋新增类型`)+ `.newtype` 面板 ③ 核心参数值 `.pvgrid` 瓷贴(2 列)
+- `.flow` 底部说明 + `.card-foot`
+- 尾部 `<script>` 驱动:类型库 `PN_TYPES` → 选类型即时加载参数框、新增类型面板、进度条
+
+**目标件的闸结构与平台逐字一样**(`.jc-editgate` / `.eg-open` / `.eg-cancel` / `.eg-save` / `.on`)——
+它本来就是照平台做的,只有「一道 vs 四道」这一处对不上。
+
+### 现有件
+`activities/part-substitution-assessment/src/views/report.ts`(953 行):
+
+| 片段 | 行 | 绑定 |
+|---|---|---|
+| `PART_TABLE` | :298 | `<tbody data-rows="mine:sub_eval.part" data-edit="parts.profile">` |
+| `CHIP_TYPE_TABLE` | :398 | `<table data-edit="parts.chip_type">` + `<tbody data-rows="mine:parts.chip_type" data-edit="parts.chip_type">`(**两处都写**,见下)+ `addrow` |
+| `TYPE_PARAM_TABLE` | :447 | `<table data-edit="parts.type_param">` + `<tbody data-rows="mine:parts.type_param" …>` + `addrow` |
+| `PARAMETER_TABLE` | :496 | `<tbody data-rows="mine:parts.parameter" data-edit="parts.parameter">` |
+| `INPUT_SUPPLEMENT` | :515 | `doc({ css: P08_CSS, alias: BIND_P08, badge:'数据', … })` |
+
+四道 `editGate` + 两处 `addrow`(`parts.chip_type` / `parts.type_param`)。
+
+只读态查类型人读名的写法(已验证可用):
+`<span data-rows="parts.chip_type" data-by="type_id=chip_type_id"><i data-slot="type_name" data-blank></i></span>`
+
+### 样式
+`activities/part-substitution-assessment/src/views/target-style.ts`:
+`P08_CSS`(:34,数据工单)· `ACC1_CSS`(:144,结论审核)· `ACC2_CSS`(:241,落账确认)。
+**本次只换 `P08_CSS`**,另两段不动。
+
+### 平台机制(会影响怎么写)
+- `ViewContainer.tsx:548` —— `documentElement.classList.toggle('editable', editable)`;
+  **`editable` 只让闸现身**,开不开由人按闸,开了给那张表的宿主挂 `.on`(`table.on td>.jc-vcell{display:none}`)。
+- **`bodyOf` 是单个 `querySelector`**(`ViewContainer.tsx:164-167`)——**一个地址只找得到一个宿主**。
+  这是终审 C1 与 Task 7b 的教训来源,**本次版面成立与否就卡在这一条**(见风险)。
+- `addRow` 靠克隆 `tr:last-of-type`,**零行时返回 false**(Task 7b 的旧账,已由种子行绕开)。
+- 件是**零脚本沙箱**;交互靠 CSS(`:has` / `<details>` / `:focus-within`)与外层容器。
+
+### 当前版本与闸的名单
+- `packageVersion: '2.1.9'`(`manifest.ts:57`)→ 本次改完升 **2.2.0**。
+- S1 卡的 `gateLedgers`(`case-model.ts:592`):
+  `['parts.chip_type', 'parts.type_param', 'parts.profile', 'parts.parameter']` —— **四张,不要动**。
+- 现有自测:`__tests__/activity.test.ts` 共 70 条 `it(`。
+
+---
+
+## 设计
+
+### 版面
+
+```
+卡头(数据 badge · kick/h1/sub · 右侧 tag/step/deadline)
+【触发原因】zone + note(流程 / AI 预填情况)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  原 PN 轨道                 候选 PN 轨道
+  ① 名称·在库·品牌·生命周期     ① 同左          ← 一道闸(parts.profile)
+  ② 芯片类型 [下拉]            ② 芯片类型 [下拉]
+     ▸ 类型库里没有?在这里新建 / 补字段          ← 一道闸(chip_type + type_param)
+       类型名 + 逐行四格(参数名/说明/硬软约束/单位)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  ③ 核心参数值:左右两组瓷贴,按料分              ← 一道闸(parts.parameter)
+.flow 说明 + 页脚
+```
+
+**两条并列轨道怎么出来的**:`<div class="tracks" data-rows="mine:sub_eval.part" data-edit="parts.profile">`
+里放 `<section class="track">…</section>`,`.tracks{display:grid;grid-template-columns:1fr 1fr}`。
+`data-rows` 逐项复制内部结构,CSS 把它们排成两栏 —— 这是 A2 已验证的写法
+(「`<article data-rows>` 包 `<section class="cand">`」逐颗料一张卡)。
+
+**行容器的坑**:行展开按**第一个同名闭合标签**截行内容 —— 行模版里不许再出现同名标签。
+用 `<section>` / `<tbody>` 这类行内不会重复的标签。
+
+### 无脚本翻译
+
+| 目标件(靠 `<script>`) | 平台等价物 |
+|---|---|
+| 选类型 → 即时加载参数输入框 | **保存即铺格**(配方按类型的字段清单铺出参数行,已实现且走查验过) |
+| `＋新增类型` 选中才显示面板 | **`<details>` 常驻折叠条**(A2 方法论条同款,零脚本) |
+| `.stepbox.done` 点亮 | `data-class-of` 投影 + 样式表判断(**模版不许算、不许判**) |
+| 进度条 `n / m 项` | 分母**必须是真数**:由配方算进 `sub_eval.case` 两列(如 `fill_done`/`fill_total`);<br>**算不出就只摆「还差 N 项」+ 二态条,不许编分母**(界面不撒谎) |
+| `body.editing` 整页切 | 平台的 `editable` + 每卡 `.on` —— 用户选了「每步骤卡一道闸」 |
+
+### 加的一道护栏(方案 1 的风险缓解)
+
+两条轨道各选一次类型、而它们必须相同(`distinct = 1` 那条判据)。
+基座本来就出 `sub_eval_part_distinct_chip_type_id` —— 把它投出来,
+**两处选得不一样时件上直接出红带点名**,不必等提交才被判据拦。
+用 `data-class-of` 投影 + 样式表出显隐(`v-1` 那档 `display:none`),**模版不算不判**。
+
+---
+
+## ⚠️ 要先验证再往下写的一条(这版面成立的前提)
+
+步骤③ 的两组瓷贴要共用**一个** `data-edit="parts.parameter"` 宿主
+——因为 **`bodyOf` 只找得到一个宿主**(终审 C1 / Task 7b 的教训:同一地址挂两处,
+`querySelector` 只命中第一个,后面那组的值**一格都收不上去,而且不报错**)。
+
+宿主内部靠**嵌套 `data-rows` + `data-by` 父键过滤**按料分栏。
+
+**必须先钉住的是收值归行**:`cellsOf` 按宿主内所有 `[data-col]` 取格子,`rowOf` 按行容器归行。
+嵌套之后 `rowOf` 认的是内层瓷贴组还是外层?**认错就会把两颗料的参数值混成一行**。
+
+**做法**:先写一条测试跑真实的 `cellsOf`/`rowOf`(或经 `resolveRowKey` 走一遍),
+**证明两颗料的瓷贴各归各行**。
+- 成立 → 按上面的版面写;
+- **不成立 → 退回「③ 单独一块、内部分两栏」的形状**(轨道只到 ②),并**告诉用户这一处与目标件的差别**。
+
+顺带留意 `data-by` 的已知缺陷(终审 I3,已记 debt 未修):
+**行内没有该键时会落回外层同名字段** —— `internal_pn` 在多张表上撞名,分栏过滤要用真有值的键。
+
+---
+
+## 动的文件
+
+| 文件 | 改什么 |
+|---|---|
+| `src/views/target-style.ts` | `P08_CSS` 整段换成从新目标件**机械抽取**的样式(数值不改;`ACC1_CSS`/`ACC2_CSS` 不动) |
+| `src/views/report.ts` | 重写 `INPUT_SUPPLEMENT` 与它的片段(`PART_TABLE`/`CHIP_TYPE_TABLE`/`TYPE_PARAM_TABLE`/`PARAMETER_TABLE`) |
+| `src/manifest.ts` | `packageVersion` → `2.2.0` |
+| `__tests__/activity.test.ts` | 断言跟着新版面走(**不许放松**) |
+
+**不动**:平台(`ViewContainer` / `view-render` / `desk.ts`)· 配方(`case-model.ts`)· `gateLedgers` · 另两张件。
+
+---
+
+## 必须留着的东西(动了就是回归)
+
+1. **`<input class="jc-cell mono" data-col="type_id" placeholder="由系统生成" disabled>`**(`report.ts:407` 一带)
+   —— 这是**终审 C1 的修复**:没有它,人新建的类型会被「全表一致」认成既有行、**把既有字典行改名并落进共享主数据**。
+   新版面里这一格换了位置也**必须带着走**,并保留「由系统生成」那句占位
+   (2026-08-02 立的规矩:自增列不问人,但**不能一声不吭地拿掉**)。
+2. **主键列必挂 `data-col`** —— 它不是编辑面,是**行的钥匙**;不挂,服务端按「全表一致」猜,会把两行对到同一行上互相覆盖。
+3. `CHIP_TYPE_TABLE` 那个「`data-edit` 外层 `<table>` 与内层 `<tbody>` 两处都写」的写法有原文注释解释原因
+   (`bodyOf` 要同时收到「已有行」与「加一行」出来的行)—— 换版面时**读那段注释再决定怎么摆**。
+4. `gateLedgers` 四张表与件上的可编辑面**同源** —— 闸盯的表,件上必须给得出填的手段
+   (Task 7 那颗「按不下去的确认钮」就是这么来的)。
+
+---
+
+## 验收
+
+**现有断言继续绿,一条都不许放松**:可改面只有哪几列 · 三份件用到的 class 必须都能在自己那段 CSS 里找到定义 ·
+零脚本(`not.toContain('<script')`)· 主键挂 `data-col` · 编辑闸外壳那六个属性 · `gateLedgers` 与件同源。
+
+**新增**:
+- 两条轨道各出一颗料(`mine:sub_eval.part` 两行 → 两个 `.track`);
+- **步骤③ 瓷贴按料归行正确**(上面那条风险的钉子);
+- 类型不一致时红带现身(`distinct > 1` → `data-class-of` 投影命中)。
+
+**每条新断言都要做变异验证**(拿掉修复/改坏一处 → 测试必须真红;复原 → 绿),两段输出贴进报告。
+本轮已连吃三次「测试测的是副本」「变异测试本身是空的」「夹具替被测系统干了活」的亏。
+
+**门禁**:`pnpm gates` **以退出码验,不许接管道**(`cmd | tail` 的退出码是 `tail` 的)。
+
+**最后必须做的两步**:
+1. `pnpm activities:install` 装包,**用 SQL 核库里那一行**(版本号 / 视图 HTML)—— 装完看库,不看脚本的话;
+2. **浏览器走一遍**(起单 → 数据工单 → 新建类型 → 保存即铺格 → 填参数 → 提交)——
+   **版面对不对只有真看一眼才算数**;脚本 e2e 逮不到「一个图标 946 像素高」这类事。
+   跑试跑要用 AI 服务账号或用户授权的账号,跑完 `pnpm --filter @app/api reset-runs` 清运行数据。
+
+---
+
+## 环境备忘(压缩后会用到)
+
+- 开发后端 `:8787`、前端 `:5173`;**稳定版 `:8790` 目前是停着的**(用户授权,大改期间不动它)。
+- 起后端要先 `set -a; . .stable/env; set +a`,否则「缺 KEYCLOAK_URL…」起不来。
+- **长跑的 dev 进程可能在跑几小时前的代码** —— 本轮踩过三次;`tsup --watch` 监视进程本身也可能已死,
+  `touch` 无效,要**完整重启** `pnpm dev:api`;杀进程要杀到 `--onSuccess` 拉起的那个 node(否则 `EADDRINUSE`)。
+- 查库:`docker exec jcai-postgres psql -U jcai -d jcai_wos -c "…"`(`.stable/env` 里的 `DATABASE_URL` 指向 5432,
+  而 docker 映的是 54329,直接进容器最省事)。
+- 浏览器登录走 Keycloak 用户名密码;**密码那一格我不能替用户输**,要他自己登。
+
+---
+
+## 上下文:这条分支此刻的状态
+
+`feat/w05-rewrite`,HEAD `45cec82`,**工作树干净,`pnpm gates` 退出码 0(2476 测)**。
+ACT-WORK-05 重写(Task 1–12 + 7b + 全分支终审 + 修复波 + 定向复审)**已全部完成**,
+**未合并、未推送** —— 合并方式等用户定(选项已摆给他:本地合进 `mvp-foundation` / 推送开 PR / 先放着)。
+`feat/deterministic-steps`(第一份计划)**已并在这条分支里**,合它即合两者。
+
+逐任务账本与全部裁定:`.superpowers/sdd/2026-08-29-act-work-05-rewrite/progress.md`(用户尚未决定删留)。
+
+**本次换版面是这之后的新活,与上面那条分支的收尾是两件事。**