15 KiB
质量数据分析平台设计规范
更新:2026-11-02
- 月度趋势数据表提供“关键指标 / 完整指标”切换,完整列与主汇总表共用字段口径与顺序。黑片、亮片页面首次默认完整指标,其余四类查询首次默认关键指标;各缓存页保留用户选择,查询和重置不改写选择,不增加数据请求。
智能分析正文与运行反馈(2026-11-02)
-
历史正文与会话列表分别读取,指定会话链接不等待列表;只有从查询条件创建会话时才加载选项。加载提示放在对应面板内部,首次读取不得显示欢迎空状态,也不得用通用大高度加载块推移会话框和输入区;列表失败不阻止已授权正文读取。
-
原生 AI 会话及报告以模型完整原文为正文,保留段落、表格和顺序,正式查询图表穿插在相关章节后;取消二次改写和统计兜底报告替换。历史兜底报告仅在保存的模型原文可恢复时恢复,原文缺失不伪造补齐。
-
会话只显示一次最终回答,运行过程保留思考与工具步骤;运行中默认展开,可手动收起。发送立即显示等待状态和计时,收到服务器开始时间后显示运行计时和旋转图标。
-
不在会话追加范围说明、进度句、错误或“部分完成”提示;真实失败、证据缺口和完成状态仍保存在后台,恢复及重试入口保留。
-
合格率变化统一为本期减比较期:下降为负 pp,上升为正 pp。用于筛选和排序的降幅指标保持原有语义,转换仅作用于展示值;图表、数据表和导出一致。
已确认方向
- 保持现有导航宽度、模块顺序、筛选承载、指标横条、表格及趋势位置。(用户确认)
- 午夜黑采用第03轮的06号 Gemini G3「午夜深蓝」作为视觉参考。(用户确认)
- 其他主题同步相同的组件细节,保留各主题原有配色方向。(用户确认)
- 当前只做本地修改与预览,发布须另行授权。(用户确认)
品牌资产
- 保留质量数据分析平台名称、现有三斜条标识和 Ant Design 图标体系。(沿用现状)
- 黑片使用蓝紫/蓝色,亮片使用青绿色;不交换阶段颜色。(沿用现状)
共享实现
- 颜色语义与主题标识在
web/src/ui-themes.ts;保留dark标识以兼容原有主题偏好。 web/src/main.tsx同时向 CSS 变量和 Ant Design 提供表面、文字、边框、强调色;不分别硬编码两套深色表面。web/src/workspace-finish.css定义各主题共用的控件、指标横条、网格与选中状态细节。- 控件圆角4px、面板圆角5px;网格线保持1px,不用大投影和霓虹发光。(Agent推断)
- 全局缩放保留;查询页筛选/表格13px、辅助12px、区块标题14px、主指标32px/其他指标30px。中文优先苹方/微软雅黑,业务数字使用Arial/Helvetica Neue及等宽数字特性,指标字重700、表格数字500/重点600。(Agent推断)
- 午夜黑使用蓝黑画布、略亮的内容表面、银白正文;蓝紫/青绿分组表头均采用低亮度底色。(用户确认方向,具体色值由Agent推断)
- 主按钮在深色模式使用深色字以确保可读,亮蓝主题的按钮背景适当加深。(Agent推断)
- 既有悬停、聚焦和切换过渡沿用原时长,不新增位移动效。(Agent推断)
样板与验收范围
- 总体汇总:已验证六种主题、12个月明细、侧栏及控件位置。
- 计算口径弹窗与智能分析初始页:已检查午夜黑主题的表面、文字和输入区。
- 本地预览使用已保存的汇总快照,未用于验证线上业务数据或真实模型分析。
不要做
-
不照抄生成图中的失真文字、业务数字或额外图表。
-
不因换主题重排页面、移动原操作或改变指标计算逻辑。
-
不在业务界面增加制作说明、风格编号或无用的副标签。
-
2026-10-30:用户要求字体也参照G3修改;已同步六主题中文与业务数字字体,代码/JSON仍使用等宽代码字体。(用户确认方向,具体字体选择由Agent推断)
-
查询页字号比例追加调整:适当放大筛选与表格、收小指标,四项指标标签统一13px/600;已按用户要求发布并同步源码。(用户反馈字号不协调,具体取值由Agent推断)
-
查询页趋势图与柏拉图同步使用页面字体变量:图例与单位使用界面字体、数值刻度使用数字字体,悬浮提示略大;抵消图表局部缩放,保持与表格文字协调。已检查趋势图深浅主题,类型检查与8项相关回归通过;底部预览已补入当前线上全年筛选的真实快照,33个细分字段齐全;已核对不良构成与柏拉图深浅主题,阶段标题14px、分类与数值13px、辅助表头12px,保留原有数据核对提示。2026-10-30 已按用户要求发布。
-
查询表格语义配色:黑片黑色、亮片沿用原黑片的主题蓝色、综合合格率沿用原亮片绿色,覆盖总体/产业部/业务分组/产品/黑片/亮片汇总及月度数据表;顶部指标同步。午夜黑主题中黑片文字以中性浅灰保证对比度。2026-10-31 已按用户要求发布。(用户指定颜色,深色适配由Agent推断)
-
查询字号进一步调整:顶部综合合格率42px(移动端沿用现有自适应),月份及产业部对象16px、表内综合合格率15px、所有查询表头14px/600;布局与其他业务数字字号不变。已检查深浅主题,无指标截断或页面横向溢出,2026-10-31 已按用户要求发布。(用户指定层级,具体取值由Agent推断)
-
查询列顺序:综合合格率移至操作列之前,桌面端两列固定右侧;完整字段模式采用重量112px、阶段合格率96px、不良分类100px,综合合格率120px、操作96px。对象列按月份/组织/产品分别设置;月度趋势数据表综合合格率也置于最右。导出沿用显示列顺序。已实测横向滚动右侧位置不变,2026-10-31 已发布。
-
跨两行查询表头字重700,单行表头600;右侧冻结综合合格率列补充独立左边框,贯穿表头与数据行。深浅主题与左右滚动已验证,2026-10-31 已发布。
-
指标卡片与顶部筛选栏同步冻结,按筛选栏实际高度定位,展开筛选与换行自动更新,并为小屏保留阅读空间。删除“亮片本部报废调整”说明,保留口径切换。
-
关键指标、完整字段与月度数据表的两阶段总重量均置于合格重量之前。黑片总重量增加悬浮规则提示,说明利用料/废品库扣减与过账外废处理;直接展示已发布数据结果。
-
原口径下本部报废列紧随扩散废;去本部报废时隐藏该列,并在卡片、表格、趋势、Excel中统一扣减亮片报废重量。不改来源数据、总重量与后端合格率公式;缺失分量时显示不可用。
-
指标名称保持“亮片合格率”“综合合格率”,切换后增加11px/400的“(去本部报废)”小字。顶部卡片与跨行综合表头分行显示,亮片二级表头单行显示以维持行高;说明图标样式与黑片总重一致,保留原有计算口径入口。
-
所有查询页导出按钮显示下载图标与“Excel导出”文字。
-
2026-10-31 已按用户要求发布;构建及31项相关检查通过,线上字段顺序、口径切换、导出入口与顶部冻结已核对。
-
后续本地调整:顶部指标卡片恢复随页面滚动,移除其标题下的“(去本部报废)”,保留表头口径提示及切换功能;口径切换与卡片共用一行,移除上方独占空行并压缩卡片内边距。顶部筛选栏及表格冻结列不变。实际滚动检查、类型检查及31项相关检查通过,2026-10-31 已发布。
-
原口径隐藏亮片与综合合格率的说明图标,去本部报废口径保留图标;黑片总重量规则图标始终保留。构建及32项检查通过,已实测线上切换,2026-10-31 已发布。
2026-11-01:趋势柱形 01 轻度加深(用户确认)
- 保留现有布局、堆叠、坐标轴、目标线及三条合格率折线的颜色和算法。
- 浅蓝主题合格重量柱:默认 #99A8E3,选中 #7F92DA,悬停 #6078CE;报废重量柱:默认 #E49A70,选中 #DB8656,悬停 #CD7546。
- 未选中月份保色 50%,替代原来的 28%;既有 340 毫秒过渡及再次点击取消选择保持。
- 六主题共用 web/src/trendBarPalette.ts;其他浅色主题沿用各自蓝色方向,午夜黑同步增强对比度。
- 方案已获用户明确发布授权。候选预览控制栏和其他深度候选不进入正式页面。
2026-11-01:查询结果连续更新与阅读顺序
- 按用户要求调整为:指标卡、趋势图、汇总表、不良具体构成;总体、产业部、业务分组、产品、黑片和亮片查询保持一致。
- 查询期间保留最后一次成功的卡片数据和表格及其期间、视图信息;旧结果暂时禁止打开明细及导出,新响应到达后恢复操作。
- 卡片和已存在的表格单元格数字、表格高度采用 520 毫秒连续过渡;减少动态效果设置下直接更新。
- Excel 始终使用最终服务端数值,不导出动画中的中间值。六主题逐帧检查、黑片与亮片实际页面检查及 42 项相关检查通过;当前仅本地修改,待用户发布。
2026-11-01:默认可用月份与页面切换(本地)
- 无显式查询期间的新页面默认进入月度:优先上个月;上个月未出现在已发布月份列表时,仅回退到上上个月。重置和切回月度采用同一规则。
- 复用
/api/options的periods/latestDataPeriod,不额外拉取完整报表判断。手动选择、分享链接、已缓存查询期间不被自动覆盖。 - 不同页面之间采用 280ms 新旧内容交叉淡化,取消整页位移,顶部和侧栏保持稳定。目标页面先提交内容及滚动位置,再交接画面;首次加载等待最多 900ms,内容稳定 32ms 后提前开始。连续导航立即打断上一次切换,返回保留筛选及滚动位置。减少动态效果或浏览器不支持时直接切换。
- 六个查询页默认月份、六主题切换、手动选择的慢加载保护、显式年月和返回时的筛选/滚动位置均已在本地验证。页面转场补充快速连续点击、取消等待及不可见控件保护验证,53 项相关检查通过,尚未发布。
- 黑片与亮片页移除指标卡下方的来源统计与计算口径整行,回收空隙;计算说明仍可从指标卡或表头查看。趋势图关联已生效的月份/季度,默认月份及查询后同步选中加深,年度取消月份高亮。六主题选中效果已检查。
- 2026-11-01 发布前生产构建与 57 项相关检查通过;此次仅更新前端,不修改计算逻辑或业务数据。
2026-11-01:取消内部缩放(本地)
- 保留侧栏、指标卡、趋势图、表格和不良构成的现有结构与顺序,移除整页 80% 缩放。字号采用原有真实尺寸,不再通过整体缩放压缩内容。
- 图表移除反向缩放与字体补偿,趋势图和柏拉图使用正常坐标尺寸;页面高度直接对应浏览器视口。
- 顶部栏、筛选栏及管理页签共享冻结起点,桌面 53px、手机 40px;管理页签每级追加 47px,保留表格左右冻结列。
- 本地已检查 1920×1080、1536×864、1366×768、390×844 视口、六个查询页、六主题、图表点击和完整字段的冻结列。实际 Windows 硬件尚未验收,使用隔离演示数据预览,未发布。
2026-11-01:黑片与亮片更多筛选(本地)
- 黑片与亮片查询页将项目组、添加来源筛选字段及其条件行统一收入“更多筛选”,默认收起,主行保留期间、产业部、业务分组和产品。
- 复用其他查询页的展开/收起样式、已选条件数量及清除入口;收起保留筛选,仍按原方式点击查询生效。
- 本地实测两页展开收起、条件保留及实际查询参数、清除后查询;类型检查与阶段查询回归通过,未发布。
2026-11-01:侧栏内容字号(本地)
- 侧栏菜单从 13px 调到 14px,分组标题与账户主文字从 12px 调到 13px,菜单图标从 16px 调到 18px;侧栏宽度和主内容字号不变。
- 已检查六种主题、长菜单名称和折叠状态,无文字换行或图标裁切,未发布。
2026-11-01:统一查询指标卡高度
- 六个查询页桌面端指标卡统一最小高度 96px,避免黑片与亮片页因没有辅助说明而矮一截;保留手机端原有 84px 最小高度。
- 六个查询页和六种主题的卡片高度已实测一致;数据、字号、卡片排列与口径切换保持原有行为。
2026-11-01:筛选框统一与钻取趋势过渡(本地)
- 黑片、亮片取消独立的筛选框最小宽度与间距,年份、月份、季度复用其他查询页的尺寸规则;月份统一为两位显示,原查询方式保留。
- 钻取时保留上次成功的趋势及目标线,新数据返回后使用同一图表实例进行 520ms 更新动画;减少动态效果时直接更新。
- 旧范围图表在更新或失败时禁止交互;加载失败保留原图并允许重试。已取消的请求不能覆盖后续相同范围的新请求。
- 本地复现原钻取存在 23 帧空白,修复后三级钻取与六主题均为零空白帧;快速返回重入、失败保留、实际筛选框尺寸及相关检查通过,未发布。
2026-11-01:查询操作强调与底部精简
- 各级返回按钮统一为带左箭头的“返回上一级”,沿用原有父级路径,使用主题色描边与浅底;Excel 导出使用实色主按钮,两者统一加粗。
- 趋势数据表取消底部分页统计与月份汇总链接,直接展示已返回的期间;保留月份行的筛选操作。各查询页删除“点击期间筛选”类提示。
- 本地实测三级返回、月份行筛选及六主题按钮效果;主汇总表分页和 Excel 导出行为保持原有方式。
2026-11-02:全系统统一加载(用户批准方案)
- 维持现有布局、主题及 280/520 毫秒过渡;150 毫秒后显示区域加载提示。首次失败、更新失败、成功空结果分别呈现,更新时保留已生效范围的结果。
- 更新中的旧范围结果不能钻取、查看明细或导出;区域独立重试。任务使用真实阶段,写入即时忙碌并防重复,不显示虚构百分比或新增常驻说明。
- 返回页面保留筛选、页码、滚动位置及表格高度;隐藏页面和未选管理页签不主动刷新。业务分页、全范围搜索排序和导出不变。
- 实现与验证详见 docs/全系统统一加载实现与验收_20261102.md。