80 lines
7.3 KiB
Markdown
80 lines
7.3 KiB
Markdown
# 故障管理 BI 设计验收
|
||
|
||
final result: passed
|
||
|
||
## 最新调整：总览视觉与多维分析对齐
|
||
|
||
管理总览复用多维分析的页面色板与标题布局，统一浅蓝背景、白色7px圆角面板、蓝色标题标记、细边框按钮、日期控件和表格。趋势图已闭环/未闭环使用与分布分析一致的蓝/橙色；周报新增/解决仍用蓝/绿语义色。统计和排列顺序不变。
|
||
|
||
- 桌面：`../outputs/fault-overview-theme-20261013/desktop.jpg`（1448×1086）；手机：`../outputs/fault-overview-theme-20261013/mobile.jpg`（390×844），均已目视检查。
|
||
- 两页背景均为 rgb(248,251,255)，共用主蓝、文字及边框变量；手机四卡132px等高，scrollWidth=390，无横向溢出。
|
||
- 页签往返、手机日期选择打开/关闭正常，趋势和周报导出入口保留。类型检查、生产构建和diff检查通过；本次验证控制台无新增error/warn。
|
||
- 未改动数据接口或统计口径；未重复执行数据库测试与下载导出文件。
|
||
|
||
## 最新调整：管理总览与处理效率合并
|
||
|
||
按用户最新要求，管理总览恢复原来的页面及 `/overview` 统计，依次展示实时汇总、故障处理趋势、故障运维周报；移除独立处理效率页签，保留多维分析、故障明细。以下原参考设计验收为历史记录，管理总览以本段及最新截图为准。
|
||
|
||
- 桌面证据：`../outputs/fault-overview-merged-20261013/desktop.jpg`，1448×1086。
|
||
- 手机证据：`../outputs/fault-overview-merged-20261013/mobile.jpg`，390×844；四卡均为132px，无页面横向溢出。
|
||
- 验证原今日新增、本日解决、当前在办及累计台账，当前在办下钻27单；页签往返正常，三个统计区同页出现，周报恢复默认业务周。
|
||
- TypeScript、生产构建、diff检查通过；本次未修改后端统计口径。页面非空、无框架覆盖层，最终验证期间控制台无新增error/warn。
|
||
- 保留趋势与周报的独立日期、下钻和导出按钮；本次未重复下载导出文件。已清除临时viewport覆盖。
|
||
|
||
## 对照依据
|
||
|
||
- 来源：`/var/folders/3b/z3fk0dm9419dk7qffdvrwmfh0000gn/T/codex-clipboard-1efea2c0-2930-4600-b725-874c3c2a1f4f.png`
|
||
- 实现：`http://127.0.0.1:4310/asset#faults`
|
||
- 桌面截图：`../outputs/fault-dashboard-20261013/desktop.jpg`
|
||
- 同图左右对照：`../outputs/fault-dashboard-20261013/comparison.jpg`（左参考，右实现）
|
||
- 局部对照：`../outputs/fault-dashboard-20261013/comparison-filters-kpis.jpg`（筛选、指标、提示条）
|
||
- 参考和实现各 1448×1086 像素；CSS viewport 1448×1086，DPR 1，无密度缩放。比较图片由两份截图并排组成，展示工具可能缩小，局部图另行检查。
|
||
- 状态：浅色、管理总览、2026-09-14 至 2026-10-13、全部授权数据。参考使用示例数据，实现使用实际数据库；数值、分类数量和客户名称不要求与示例相同。
|
||
- 手机：390×844 `mobile.jpg`；320×844 `mobile-320.jpg`。另有 `efficiency.jpg`、`drilldown.jpg`。
|
||
|
||
## Findings / 比较与修复历史
|
||
|
||
1. [P2，已修复] 现有应用顶部浮动面包屑与新标题重叠。通过仅作用于故障页面的 shell 选择器隐藏重复面包屑；最终桌面、手机截图无重叠。
|
||
2. [P2，已修复] 第一版分析面板和列表过长，重点跟进过度后移。车型默认前三、客户默认前四、跟进默认前三，提供全部入口；减小图表行距、等级间距和桌面表格单元格内边距。最终 `comparison.jpg` 显示完整指标、分析面板及跟进入口。
|
||
3. [P2，已修复] 分布图自动跳过部分区域标签。YAxis interval=0；补充柱尾数量，包括未闭环为零的组，保留精确数量表与下钻。
|
||
4. [P2，已修复] 320px 下标题和导出挤占，原生筛选框太窄。标题操作区换行，筛选单列，指标标题字号适配。`mobile-320.jpg` 显示全部入口及所选值，没有横向页面溢出。
|
||
5. 最终对照无未解决的 P0/P1/P2。以下为有意保留的业务差异，而非像素复刻：现有导航品牌与功能、页面水印、今日新增/本日解决/累计台账、未标注等级及部位、真实长车型名称和运维处置人第二列。实际内容略长，重点跟进明细需继续向下滚动；避免通过隐藏未知数据或缩小明细字体模拟示例高度。
|
||
|
||
## 必查表面
|
||
|
||
- 字体：沿用应用中文无衬线回退，桌面标题 24px、面板标题 14px、指标 29px，层级与参考一致；重点检查筛选、数字与窄屏换行。没有以图片模拟文字。
|
||
- 间距：四指标等高、两行双列分析面板、统一边框与圆角；手机两列指标、分析面板单列，宽表内部横滚。
|
||
- 颜色：浅蓝页面、白底面板、蓝色主操作；橙色未闭环、红色逾期，未知等级灰色。等级与实际停运含义分开说明。
|
||
- 图像与图标：参考主要为数据图表。使用现有 Lucide 图标及真实数据图表；沿用产品已有品牌导航，未自行绘制替代参考 ONE OS 标识。无新增位图资产或虚构装饰图。
|
||
- 文案与数据：使用真实口径和实际分类；“当前在办=待处理+处理中”，逾期为在办子集；“处置记录”避免把 solve_process 当作当前工作流阶段。发生频率缺分母，停运与修复时长缺数据，明确显示待补。
|
||
|
||
## 功能与数据验收
|
||
|
||
- 新增 3 项后端测试；故障模块与报表导出测试合计 32 项全部通过。
|
||
- TypeScript 检查、生产构建、git diff --check 通过。
|
||
- 实库只读核对 63 个分组、48 个车型×部位单元格，汇总与下钻一致；在办 26=17+9，逾期5，本期106，车辆去重89。
|
||
- 浏览器验证：华东筛选后总览39单，趋势39单，周报新增39/解决125；按月切换及报表下载；等级20单下钻、交叉单元格3单下钻、单条故障明细、十二维分析默认运维处置人/故障工单状态。
|
||
- 手机更多筛选 L1-特急得到本期1单；其他区域空数据正确显示0和空态。320/390px 页面 scrollWidth 等于 viewport width。
|
||
- 总览 Excel 下载成功，重新读取工作簿确认6张表、日期/筛选说明、冻结表头和数字106/26与页面一致。
|
||
- 处理效率保留既有柱图、周报折线图、今日行提示、报表导出与下钻。
|
||
- 最终验证时间段（08:40 UTC 后）无浏览器 error/warn；开发编辑过程曾有一次已修复的 HMR 导入错误，未计为运行期问题。
|
||
- 浏览器测试后恢复管理总览、全部筛选，并清除临时 viewport override。
|
||
|
||
## Open Questions / 残余限制
|
||
|
||
- 故障发生频率需要同期服务车辆规模；实际停运、修复时长需要业务定义和数据来源，未捏造这些指标。
|
||
- 未进行不同浏览器引擎实机测试；已验证当前 in-app 浏览器桌面和移动断点。
|
||
- 只读接入，未修改业务数据库；本次改动未提交或推送。
|
||
|
||
## Implementation Checklist
|
||
|
||
- [x] 参考布局落地并绑定真实数据。
|
||
- [x] 汇总、业务筛选、分布、矩阵、客户和重点跟进下钻。
|
||
- [x] 趋势/周报继承筛选并保留导出。
|
||
- [x] 数据权限、空数据、移动端与导出验证。
|
||
- [x] 同图对照、局部检查、问题修复和最终证据保存。
|
||
|
||
## Follow-up Polish
|
||
|
||
- P3：后续如提供统一品牌资产，可单独统一应用级导航标识；当前保持现有产品导航。
|