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.
74 lines
7.5 KiB
74 lines
7.5 KiB
2 days ago
|
# 06 已知缺陷「仅展示现象」的展示设计
|
||
|
|
|
||
|
|
Type: task
|
||
|
|
Status: resolved
|
||
|
|
Blocked by: —
|
||
|
|
|
||
|
|
## Question
|
||
|
|
|
||
|
|
纪律：已知 P1/P2 缺陷在 Demo 中**仅展示现象，不修复代码**。设计并产出「缺陷展示清单」：
|
||
|
|
|
||
|
|
1. 从台账中筛出 **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 超时）已修复，不在展示列。
|
||
|
|
2. 每项决定呈现方式，三选一：
|
||
|
|
- **渲染即现象**：按后端实际返回渲染，不加掩饰（缺列就缺列）；
|
||
|
|
- **角标/标注**：现象处加「已知缺陷 Gx」角标，hover 出说明；
|
||
|
|
- **缺陷说明面板**：Demo 顶栏一个「已知缺陷」入口，列全台账（含 UI 不可见项）。
|
||
|
|
3. 产出表格：缺陷 id → 现象位置（Demo 哪个入口）→ 呈现方式 → 文案。
|
||
|
|
|
||
|
|
## Pointers
|
||
|
|
|
||
|
|
- 台账：`.scratch/customer-frontend-handover/gap-report.md`（主）、`.scratch/customer-contact-graph/e2e-report.md` §三、`.scratch/customer-e2e-r2/e2e-incr-checks.json` I-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）。
|