资料文件真产出来了;E04/I01 补到验收线,顺手填了几个「墙拦住却不给路」的坑

**资料文件全链**(用户:审核资料这一步要真产出 word/excel/md/html,前端能渲、点资料名能开) 接手时这一步一个文件都产不出来 —— S3 剧本白纸黑字写着「file_ref 本 MVP 阶段可留空」。文件是台账那一行的投影,不另存一份: · 声明 `file:{titleColumn,bodyColumn,formatColumn}`,它同时是授权面(没声明就点不开) · 现造真字节 —— docx/xlsx 是自己打的 OOXML 包(zip-write:store+CRC32,零依赖) · 读回来渲 —— 解的就是造出来那份字节,渲得出来才证明文件是真的 · 件上 `data-file-of` → 工作区二级界面(Word 纸面/Excel 网格/渲好的 md/沙箱 html)+ 下载原件放行落地前把每一份冻进 `sys.task_asset_file`(迁移 0029):归档件点开的必须是签字那一刻那一份,而资料落在主数据上、试跑单不落正式表 —— 不存这一份,收工后一个都点不开。工作成果里「产出的资料」自成一摞。Markdown 富文本渲染顺带销账(仍零依赖)。 **Harness** · 画面按「这一拍办完之后」在办的那一步挑 —— 从前拿拍首的局面决定拍尾的事: 收掉 S4、发出 S5 的卡,而屏上还摆着 S4 的只读件,人无处可填(墙要配路第四次现形) · 验收「重做」真能退回重做,且打回后台账没动就不许再提交(软硬两段,不锁死单子) · 立监听的授权面是清单声明;发卡的授权面是调人预算,不是计划项 · 读工具同参重调有兜底;空转写身后还有行动就不废串;finish 的 doneWhen 按写完后的草稿算 **界面** · 翻件与翻页各归各位(从前二选一,多卡多页时页翻不动);没得翻写「—」不写 0/0 · 工作成果详情能翻份;表宽超出能横滑(E04/I01 抄版式时把 overflow-x 抄丢了) · 查看面灰底滚过一屏变白 —— 两条独立的路都治了(沙箱内不同色 / 弹性子项不长个) · 测试台「取不到」不再当成「还活着」 **活动** E04 关系覆盖、I01 品牌内容各自补到验收线:判据全读基座数、判据指向的东西摆上卡面、样例满载且名字 ≤14 字;提交前要裁的判据搬进说明书(模型会压拍,压过之后只有说明书还在)。验收:e2e i01 4/4、e04 3/3 全部 released,资料在办中渲得出、放行后存了档点得开; 门禁 typecheck/lint/depcruise/1628 测全绿。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01EEJX8Z7CHejvwmDQyPQuBX
2026-08-24 10:26:45 +08:00
parent 70e83d0b09
commit 0aa2fc11b0
92 changed files with 13984 additions and 370 deletions
@@ -0,0 +1,196 @@
+/**
+ * **手写控件嵌套多一层,`collect()` 按行归组不能错行**(2026-08-21 修死)。
+ *
+ * 自动孪生的格子是 `<td><input data-col></td>`,往上两层正好是 `<tr>`;
+ * 手写的三选一(A2 替代等级、A4 决策卡这类)套了一层分组容器
+ * (`<td><div class="jc-radiogrp"><label class="jc-rop"><input type=radio></label></div></td>`,
+ * input 到 `<tr>` 隔了 4 层)——`cell.parentElement?.parentElement` 这个定深两层的老算法
+ * 只能爬到那层 `<div class="jc-radiogrp">`,爬不到真正的行。E04 的执行回执表就是这样
+ * 栽的:一次改 3 行的完成状态,保存却只留下 1 行(其余两行的单选组各自拆成了
+ * 不带主键的伪行,服务端按"随便找到的第一行"兜底,写来写去只剩一行生效)。
+ *
+ * 修法是 `rowOf`:从格子往上走到 host(`data-edit` 容器)的**直接子元素**为止,
+ * 不管中间嵌了几层都能对上真正的那一行。这里直接用真实 DOM(jsdom,不是手搭的假对象)
+ * 复刻这个嵌套形状,断言 `collect()` 认出的是 3 行而不是被拆散的碎片。
+ *
+ * 完成状态这一列本身已经从三选一 pill 改成了原生 `<select>`(2026-08-21,见
+ * `report.ts`),不再嵌那层 `.jc-radiogrp` div——但 `rowOf` 的修法是通用的,
+ * 不管嵌几层都对;这里的 `.jc-radiogrp` 用例代表仍在用手写三选一的其余活动
+ * (A2/A4 那几张卡),证明这条路对它们同样成立。
+ */
+// @vitest-environment jsdom
+import { describe, expect, it } from 'vitest';
+import { collect, fileRefOf, unanswered } from '../src/ViewContainer.tsx';
+
+/** 三行,每行一个手写三选一(照 A2/A4 现存的 `.jc-radiogrp` 结构,input 距 <tr> 四层) */
+function radioTable(): Document {
+  const doc = document.implementation.createHTMLDocument('');
+  // name 按行缀 __rN(照 view-render.ts 的 uniqueNames())—— 不缀的话 jsdom 与真浏览器
+  // 一样,把同名 radio 当一组处理,勾选第 2 行会顺手把第 1 行刚勾的那个悄悄取消掉
+  const row = (code: string, i: number): string => `
+    <tr>
+      <td><span class="jc-vcell mono" data-slot="contact_code"></span><input class="jc-cell mono" data-col="contact_code" value="${code}"/></td>
+      <td class="req">
+        <div class="jc-radiogrp">
+          <label class="jc-rop"><input type="radio" name="cs__r${i}" class="jc-cell" data-col="completion_status" value="done"><span>完成</span></label>
+          <label class="jc-rop"><input type="radio" name="cs__r${i}" class="jc-cell" data-col="completion_status" value="partial"><span>部分完成</span></label>
+          <label class="jc-rop"><input type="radio" name="cs__r${i}" class="jc-cell" data-col="completion_status" value="skipped"><span>未执行</span></label>
+        </div>
+      </td>
+    </tr>`;
+  doc.body.innerHTML = `<table><tbody data-edit="crm_coverage.receipt">
+    ${row('CU-0142-01', 0)}${row('CU-0087-02', 1)}${row('CU-0087-01', 2)}
+  </tbody></table>`;
+  return doc;
+}
+
+describe('collect():三选一嵌了一层分组容器,三行各自的完成状态不许串行/丢主键', () => {
+  it('三行都点了不同的选项,一次 collect 认出三行,主键各自带对(老算法在这里会把三行拆成更多、且各自缺主键)', () => {
+    const doc = radioTable();
+    const rows = Array.from(doc.querySelectorAll('tr'));
+    (rows[0]!.querySelector('input[value="done"]') as HTMLInputElement).checked = true;
+    (rows[1]!.querySelector('input[value="partial"]') as HTMLInputElement).checked = true;
+    (rows[2]!.querySelector('input[value="skipped"]') as HTMLInputElement).checked = true;
+
+    const got = collect(doc, 'crm_coverage.receipt');
+
+    expect(got).toHaveLength(3);
+    const byCode = new Map(got.map((r) => [r['contact_code'], r]));
+    expect(byCode.get('CU-0142-01')?.['completion_status']).toBe('done');
+    expect(byCode.get('CU-0087-02')?.['completion_status']).toBe('partial');
+    expect(byCode.get('CU-0087-01')?.['completion_status']).toBe('skipped');
+  });
+
+  it('只点了 1 行的单选,另外两行没点(没答)—— 保存只交出那一行的新值,其余两行原值不动', () => {
+    const doc = radioTable();
+    const rows = Array.from(doc.querySelectorAll('tr'));
+    (rows[1]!.querySelector('input[value="done"]') as HTMLInputElement).checked = true;
+
+    const got = collect(doc, 'crm_coverage.receipt');
+    const byCode = new Map(got.map((r) => [r['contact_code'], r]));
+    expect(byCode.get('CU-0087-02')?.['completion_status']).toBe('done');
+    expect(byCode.get('CU-0142-01')).not.toHaveProperty('completion_status');
+    expect(byCode.get('CU-0087-01')).not.toHaveProperty('completion_status');
+  });
+});
+
+/** 照 report.ts 现在的 RECEIPT_TABLE:完成状态是原生 select,直接是 <td> 的子节点 */
+function selectTable(): Document {
+  const doc = document.implementation.createHTMLDocument('');
+  const row = (code: string): string => `
+    <tr>
+      <td><span class="jc-vcell mono" data-slot="contact_code"></span><input class="jc-cell mono" data-col="contact_code" value="${code}"/></td>
+      <td class="req">
+        <select class="jc-cell" data-col="completion_status" required>
+          <option value=""></option>
+          <option value="done">完成</option>
+          <option value="partial">部分完成</option>
+          <option value="skipped">未执行</option>
+        </select>
+        <span class="jc-tag"></span>
+      </td>
+    </tr>`;
+  doc.body.innerHTML = `<table><tbody data-edit="crm_coverage.receipt">
+    ${row('CU-0142-01')}${row('CU-0087-02')}${row('CU-0087-01')}
+  </tbody></table>`;
+  return doc;
+}
+
+describe('collect() 与 unanswered():下拉换掉三选一之后,同样的多行独立编辑要成立', () => {
+  it('三行各选一个完成状态,三行都收得到、互不串行', () => {
+    const doc = selectTable();
+    const selects = Array.from(doc.querySelectorAll<HTMLSelectElement>('select[data-col="completion_status"]'));
+    selects[0]!.value = 'done';
+    selects[1]!.value = 'partial';
+    selects[2]!.value = 'skipped';
+
+    const got = collect(doc, 'crm_coverage.receipt');
+    const byCode = new Map(got.map((r) => [r['contact_code'], r]));
+    expect(byCode.get('CU-0142-01')?.['completion_status']).toBe('done');
+    expect(byCode.get('CU-0087-02')?.['completion_status']).toBe('partial');
+    expect(byCode.get('CU-0087-01')?.['completion_status']).toBe('skipped');
+  });
+
+  it('下拉停在空占位 → unanswered() 为真,collect() 跳过这一列(没答=不改,不是清空)', () => {
+    const doc = selectTable();
+    const select = doc.querySelector<HTMLSelectElement>('select[data-col="completion_status"]')!;
+    expect(unanswered(select)).toBe(true);
+
+    const got = collect(doc, 'crm_coverage.receipt');
+    expect(got.find((r) => r['contact_code'] === 'CU-0142-01')).not.toHaveProperty('completion_status');
+  });
+
+  it('下拉选了具体值 → unanswered() 为假', () => {
+    const doc = selectTable();
+    const select = doc.querySelector<HTMLSelectElement>('select[data-col="completion_status"]')!;
+    select.value = 'done';
+    expect(unanswered(select)).toBe(false);
+  });
+
+  it('普通文本输入永远算已答(没有"没答"这一态)', () => {
+    const doc = selectTable();
+    const input = doc.querySelector<HTMLInputElement>('input[data-col="contact_code"]')!;
+    expect(unanswered(input)).toBe(false);
+  });
+});
+
+/** 照 E04 目标件的执行回执:结果摘要 / 客户反馈是 textarea(一句话装不下) */
+function textareaTable(): Document {
+  const doc = document.implementation.createHTMLDocument('');
+  const row = (code: string): string => `
+    <tr>
+      <td><span class="jc-vcell mono" data-slot="contact_code"></span><input class="jc-cell mono" data-col="contact_code" value="${code}"/></td>
+      <td class="req"><textarea class="jc-cell" data-col="result_summary" placeholder="谈了什么"></textarea></td>
+    </tr>`;
+  doc.body.innerHTML = `<table><tbody data-edit="crm_coverage.receipt">
+    ${row('CU-0142-01')}${row('CU-0087-02')}
+  </tbody></table>`;
+  return doc;
+}
+
+describe('collect():textarea 与文本输入同源同待 —— E04 回执的结果摘要照目标件是多行文本', () => {
+  it('人在 textarea 里写的话收得到,主键对得上行', () => {
+    const doc = textareaTable();
+    const areas = Array.from(doc.querySelectorAll<HTMLTextAreaElement>('textarea[data-col="result_summary"]'));
+    areas[0]!.value = '见到了产品 VP,达成样品测试意向';
+    areas[1]!.value = '技术交流完成,对方提了认证问题';
+
+    const got = collect(doc, 'crm_coverage.receipt');
+    const byCode = new Map(got.map((r) => [r['contact_code'], r]));
+    expect(byCode.get('CU-0142-01')?.['result_summary']).toBe('见到了产品 VP,达成样品测试意向');
+    expect(byCode.get('CU-0087-02')?.['result_summary']).toBe('技术交流完成,对方提了认证问题');
+  });
+
+  it('textarea 与文本输入同款:永远算已答(空着收空串,语义同 input)', () => {
+    const doc = textareaTable();
+    const area = doc.querySelector<HTMLTextAreaElement>('textarea[data-col="result_summary"]')!;
+    expect(unanswered(area)).toBe(false);
+  });
+});
+
+/**
+ * **件上的资料名点开哪一份** —— `data-file` 的解析(2026-08-23)。
+ * 认不出就不认:点不动比发一个取不回来的请求好(界面不撒谎)。
+ */
+describe('fileRefOf —— data-file 解析', () => {
+  it('域.对象/主键值 → 地址与主键各归各位', () => {
+    expect(fileRefOf('content.asset/CT-2026-0001')).toEqual({ address: 'content.asset', key: 'CT-2026-0001' });
+  });
+
+  it('主键值里带斜杠照样归主键 —— 只认第一个斜杠', () => {
+    expect(fileRefOf('content.asset/round=R/1')).toEqual({ address: 'content.asset', key: 'round=R/1' });
+  });
+
+  it('多列主键写 列=值,值 —— 原样交给服务端认', () => {
+    expect(fileRefOf('c.a/round_ref=BR-1,req_seq=2')).toEqual({ address: 'c.a', key: 'round_ref=BR-1,req_seq=2' });
+  });
+
+  it('缺一半 / 形状不对 / 空的:一律不认', () => {
+    expect(fileRefOf(null)).toBeUndefined();
+    expect(fileRefOf('')).toBeUndefined();
+    expect(fileRefOf('content.asset')).toBeUndefined();
+    expect(fileRefOf('content.asset/')).toBeUndefined();
+    expect(fileRefOf('/CT-1')).toBeUndefined();
+    expect(fileRefOf('不是地址/CT-1')).toBeUndefined();
+  });
+});