Files
quality_analyse/DESIGN.md
T

7.1 KiB

质量数据分析平台设计规范

更新:2026-10-30

已确认方向

  • 保持现有导航宽度、模块顺序、筛选承载、指标横条、表格及趋势位置。(用户确认)
  • 午夜黑采用第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;其他浅色主题沿用各自蓝色方向,午夜黑同步增强对比度。
  • 方案已获用户明确发布授权。候选预览控制栏和其他深度候选不进入正式页面。