Files

176 lines
20 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 质量数据分析平台设计规范
更新: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。
- 2026-11-02:趋势折线使用用户选定的 A 轻度平滑(0.15),沿横轴约束曲线;查询合格率、不良率、智能分析与导出统一。柏拉图累计线保持直线,数据点、缺失断点和计算口径不变。
## 2026-11-03:指标与目标(本地预览)
- 采用用户确认的“指标说明、质量目标、计算设置”顺序,默认显示中文指标与当前生效公式。
- 指标说明的修改公式动作定位到同一计算设置表单;名称、别名与说明独立编辑。
- 目标默认表格查看,表单修改年度、范围和百分比;展示既有匹配优先级得出的沿用值,保持保存目标的现有接口与即时生效行为。
- 计算设置默认从黑片计算开始,黑片、亮片各一张表,每个结果只占一行,各自从1开始编号,不分组、不重复展示完整执行顺序;完整公式包含默认值和全部条件分支,长内容使用共享悬浮全文。来源字段收进高级设置,仅用于旧数据兼容。保留原始行数组、所有公式及特殊处理。
- 英文变量放入表单参考详情;率值1解释为100%。延续现有主题、控件、弹窗及切换过渡,不新增位移动效。
- 本次预览使用配置只读快照,保存及失败重试在预览中模拟;未发布线上,未修改计算后端及正式配置。
- 用户反馈行高偏大:指标说明、质量目标、计算设置统一复用现有管理表格的紧凑样式(表头34px、内容行36px),不单独覆盖字号、行距或单元格间距;长内容通过共享悬浮全文与详情查看。
- 调整顺序以完整结果及其分支为单位,只发生在当前阶段内,限制合计早于分量等依赖冲突;编辑在同一窗口维护默认取值、条件和各自特殊策略,分支同时命中时上方优先。编辑与保存前检查不可用变量、重复冲突条件及指标前向引用。校验只作用于维护操作,不改写或求值正式公式;来源变量按对应阶段的服务端字段字典显示中文。
- 2026-11-03:用户确认“一个结果一条完整公式”,本地将黑片13条执行规则呈现为8个结果、亮片9条执行规则呈现为7个结果。相同取值的条件可用“或”展示,底层不合并求值、不改优先级;未修改直接应用须保持原22条规则、位置、数值类型和空值策略完全一致。原有表头34px、行高36px及共享悬浮全文保持。未发布线上。
## 2026-11-03:中文公式编辑与账号入口精简(本地)
- 黑片、亮片及合格率公式共用中文公式编辑器,使用 `[中文字段名]` 引用;可搜索选择字段、在光标处插入、替换选中文字、插入四则运算、括号、逗号和求和。也接受直接输入中文字段名。
- 字段列表区分来源字段和计算结果;重名字段用中文类别消歧,条件用文本字段不进入数值公式列表。合格率只提供已计算的前序指标。
- 保存前将中文引用转换为原有引擎字段,检查结构、参数数量、嵌套与长度,不在浏览器求值,不引入新的计算语言或改变条件与空值策略。不改动时保存须保留原公式文字及全部元数据。
- 删除左下角重复账号区域,保留右上角个人账户菜单及原有资料、密码、退出操作。
- 沿用现有表格密度、主题、弹窗与浮层风格,未发布线上。
- 条件公式编辑按阅读顺序展示:先列条件分支和满足时取值,再列“以上条件均不满足时取值”;无条件结果仍显示“计算公式”。仅调整表单展示顺序,底层初始化位置、条件优先级和特殊策略不变。
- 计算设置移除“配置说明”折叠区和说明编辑框,仅保留隐藏字段以沿用既有保存数据;公式维护和保存入口不变。
- 2026-11-03:本轮指标与目标、完整结果公式、中文字段编辑、条件优先布局、重复账号与配置说明精简,已按用户授权发布为 `20261103-082040Z-rules-workspace`。分母策略的条件隐藏已撤销,线上保持始终显示;正式计算、后端与业务数据未改动。68项检查和线上桌面/窄屏验收通过。
## 2026-11-13:不良率分类钻取
- 点击有细项的分类曲线进入该分类,保留总废率淡虚线、细项曲线及“全部分类”返回;不良率曲线和横轴取消月份筛选,其他趋势保留原交互。
- 表格局部展开当前阶段的分类和细项,另一阶段收拢为关键指标,Excel 跟随当前列;返回恢复原字段和重量/废率选择。
- 年份和产品变化保留分类,阶段变化退出。加载或失败不混用旧范围行与新细项,完成前禁止导出。
- 缺失与零区分,无细项类别不可钻取;覆盖不一致时仅给出简短提示。
- 2026-11-13:不良率钻取“全部分类 › 当前分类”移至趋势标题旁,不再在筛选项与图例之间单独占一行;所有查询页面共用。