You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
7.5 KiB
7.5 KiB
06 已知缺陷「仅展示现象」的展示设计
Type: task Status: resolved Blocked by: —
Question
纪律：已知 P1/P2 缺陷在 Demo 中仅展示现象，不修复代码。设计并产出「缺陷展示清单」：
- 从台账中筛出 UI 可见现象项：gap-report.md（P2 G1-G6、P3×6、豁免 9 类）+ contact-graph D-G1（batchEdit 空串语义不可达）+ incr I-06（pool·board 漂移）+ heavy F-15（Job 落待发数据残留，属环境非缺陷）。P1 两项（导入预检必填前移、assignable 超时）已修复，不在展示列。
- 每项决定呈现方式，三选一：
- 渲染即现象：按后端实际返回渲染，不加掩饰（缺列就缺列）；
- 角标/标注：现象处加「已知缺陷 Gx」角标，hover 出说明；
- 缺陷说明面板：Demo 顶栏一个「已知缺陷」入口，列全台账（含 UI 不可见项）。
- 产出表格：缺陷 id → 现象位置（Demo 哪个入口）→ 呈现方式 → 文案。
Pointers
- 台账：
.scratch/customer-frontend-handover/gap-report.md（主）、.scratch/customer-contact-graph/e2e-report.md§三、.scratch/customer-e2e-r2/e2e-incr-checks.jsonI-06。 - 02/04 号票会补公海池配置未实现、saved-view/board 的现象呈现事实（若已 resolve 先读）。
Answer
（2026-09-11，AFK 决断。输入：gap-report.md 全文 + contact-graph e2e-report §三 D-G1 + heavy-r2 F-15 原文 + 02/03/04 号票 Answer。）
呈现策略：三档全用，各有分工
| 档 | 机制 | 适用规则 |
|---|---|---|
| ① 渲染即现象（默认档） | 后端返回什么渲染什么：缺列不造假、null/未暴露字段显 --、空集显空态。不加任何修饰 |
一切「数据形态类」现象（缺列、恒 null、空态）。缺席本身就是如实展示 |
| ② 角标标注 | <span class="dbadge" data-defect="<id>" title="<一句话文案>">⚠<id></span>——固定样式小角标，原生 title 悬浮出说明（低保真即可，不自造浮层） |
仅加在「验收人易误认为 Demo 出错」的位置；①的补充不是替代 |
| ③ 缺陷说明面板 | 顶栏固定按钮「⚠ 已知缺陷」→ 弹层，由 JS 常量 DEFECT_LEDGER 纯静态渲染（零网络请求，保 console error=0），四分区收全台账（含 UI 不可见项） |
台账权威视图；验收人对着 gap-report 逐条核对的总入口 |
文案纪律：中性事实句式「已知现象：X。依据：台账 Y。本 Demo 按纪律仅展示不修复。」不用「bug/错误」定性词（I-06 用「漂移」、公海池用「未实现」、F-15 用「环境观察」）；不写修复建议。断言钩子：所有角标/占位卡/面板行带 data-defect="<id>"，冒烟直接按属性选择器断言存在性；面板容器 data-defect-panel。
A 区 · 开放现象项（UI 可见，14 条）
| id | 级别 | 现象 | Demo 位置 | 呈现 | 文案（title/面板正文） |
|---|---|---|---|---|---|
| G1 | P2 | 跟进筛选无「操作人」 | 详情页签3 筛选区 | ①+②（筛选器只做 followWay/时间范围） | 后端 FollowPageParam 无操作人参数（G1），操作人筛选暂不可用 |
| G2 | P2 | 关联商机 7 字段 vs 原型 13 列 | 详情页签4 | ①（按 03 票定稿 7 真名列渲染，缺列不补）+② | 原型期望 13 列，后端契约 7 字段（G2，挂账跨模块票）；本页按实际契约渲染 |
| G3 | P2 | 团队成员缺职务/加入时间两列 | 详情页签7 | ①+② | 后端 CustomerMemberDTO 未暴露（G3）；真源在实体，待 DTO 补列 |
| G4 | P2 | 系统信息四件套（创建/更新时间·人）恒 "--" | 详情页签1 系统信息区 | ①+② | 后端 CustomerDetailDTO 未暴露（G4），恒显 -- |
| G5 | P2 | 联系人列表缺「负责人」列 | 详情页签2 列表 | ①+② | ContactDTO 未暴露负责人快照（G5） |
| G6 | P2 | 联系人维度操作日志无数据源 | 联系人独立页·日志子页签 | ①（空态占位）+② | 后端 CustomerOplog 无 contact 维度列（G6），本页签空态 |
| P3-6 | P3 | 头部金额汇总卡 5 字段恒 null | 详情头部 4 张金额卡 | ①（恒 "--"）+② | 金额字段装配未接（P3-6，§5.3 有 port 扩展路径），恒显 -- |
| P3-3 | P3 | 原型「触发校验规则后确认执行」复选框 | 客户导入弹窗 footer | ②小字注记（不放复选框） | 原型幻影控件（P3-3）：实现语义=确认即执行，预检已含校验 |
| P3-4 | P3 | 操作日志导出：原型有按钮、无端点 | 详情页签8 头部 | ②（不放按钮） | 导出无后端端点（P3-4），按钮按豁免不放，避免无效控件 |
| P3-5 | P3 | 「显示完整金额」开关 | 详情头部金额区 | ② | 三档脱敏定稿划出完整金额展示（P3-5），开关随划出不放 |
| D-G1 | P2 | batchEdit「空串=清空」不可达（空串绑定成 null=不改） | 联系人批量编辑弹窗 | ②注记 | 空值提交=不修改（D-G1 绑定语义）；清空手机号本期无 UI 入口，先 reveal 取明文再提交可改号 |
| I-06 | 漂移 | pool+board：形态偏好记忆成功、看板数据端点拒绝 | 客户公海 workspace 汇总条 | 静态双现象注记（不实际调用，保 console 干净；pool 形态下拉不给 board 选项） | 公海无看板（数据端点 67001）；形态偏好接口对 pool+board 记忆成功（I-06 契约漂移，非缺陷，验收可翻案） |
| POOL-CFG | 未实现 | 客户公海池配置：brief 规则族点名，后端无端点、v29 原型无此页 | 设置页·规则区 | 只读禁用占位卡+② | 客户公海池配置：后端未实现、原型无此配置页（02 票核实）；客户公海=固定准入规则的虚拟池，非可配置池 |
| STUB-LOOKUP | 豁免(现象可见) | 工商联想恒 NO_HIT | 新建客户表单联想输入 + F6 批量更新 | ①+②小字 | 工商信息源为 stub（企查查真实源豁免），恒无命中；seam 已接线、换真实源即通 |
B 区 · 已修复 / 本次接线（面板仅列名，防验收疑惑，不摆现象）
- P1-1 导入预检必填前移——已修复（defectfix，单测 20/20 绿）。
- D-07 assignable 超时——已修复（2026-09-06，0.42s 实证）。
- P3-1 形态偏好 / P3-2 saved-view 未接——本 Demo 接线翻正（新增 #7/#8/#9/#10）。
- 联系人子表导入「划出 V1」豁免——已被 contact-graph 票 05 实现推翻，六端点本 Demo 全接线（矩阵 #36）。
C 区 · 豁免清单（入口不出现的依据，面板表格化）
照抄矩阵「豁免台账引用汇总」14 项（A4-6 独立查重页/客户合并/已被合并态、附件位、OCR、企查查真实源、图谱展开折叠/跨客户人脉、联系人扩展档案字段、batchEdit 空串语义、客户导出、换负责人独立入口、日志导出、完整金额开关、导入触发校验复选框、P2 记档字段级五件）——每行「豁免项 + 依据」两列。验收人在原型里看得到而 Demo 里没有的入口，一律在此区可查到豁免依据。
D 区 · 环境观察（非缺陷）
- F-15 Job 待发残留——重跑时历史待发行残留（每轮补下一条，链长 5 属正常），属共享库测试数据残留非缺陷，无 UI 现象，仅面板记档。
面板头部固定声明（纪律可视化）
本 Demo 为「正确传参照」：已知 P1/P2 缺陷按台账仅展示现象，不修复代码；以下现象均可在对应入口实地复核（角标 ⚠+编号），处置依据见各条。验收翻案请联系后端台账（gap-report / 各 effort e2e-report）。