diff --git a/docs/design/README.md b/docs/design/README.md index 86ca761..0368d7a 100644 --- a/docs/design/README.md +++ b/docs/design/README.md @@ -6,7 +6,9 @@ | [brand-directions.html](brand-directions.html) | 三个视觉方向对比(A 校样 / B 卷宗 / C 检验单) | 已选 A | | [logo/](logo/) | Logo 正式资产、使用规范、构建脚本、历史版本 | v5.1 定稿 | | [vi/](vi/) | VI 视觉识别规范 PDF 与 HTML 源文件 | v1.1 | -| design-system.md | 产品界面设计规范:组件、设计 token、问题级别配色 | 下一步 | +| [design-system.md](design-system.md) | 产品界面设计规范:原则、颜色与对比度、字体字阶、布局、17 个组件、交互模式、文案规范 | v0.1(U1–U4 已确认) | +| [system/tokens.css](system/tokens.css) | 设计变量(原型和前端直接引用) | v0.1 | +| [system/components.html](system/components.html) | 组件预览页(用样本条款演示) | v0.1 | ## 速查 diff --git a/docs/design/design-system.md b/docs/design/design-system.md new file mode 100644 index 0000000..168fd02 --- /dev/null +++ b/docs/design/design-system.md @@ -0,0 +1,509 @@ +# 标博士 · 产品界面设计规范(v0.1 · 2026-11-02) + +> 范围:MVP 的 Web 界面(读标 M2、查标 M3、项目工作台与额度 M6)和检查报告 PDF。 +> 依据:视觉方向 A「校样」(决策 B1)、VI 手册 v1.1、品牌策略的语气规则、`docs/analysis/03-functional-requirements.md`。 +> 配套文件: +> - `system/tokens.css`:设计变量(颜色、字体、字阶、间距、圆角、尺寸),原型和前端都直接引用; +> - `system/components.html`:组件预览页,用真实样本条款演示(起本地服务后打开,见第 13 节)。 +> +> 第 12 节的 U1–U4 已于 2026-11-02 全部按建议确认(`docs/decisions.md`)。 + +--- + +## 1. 设计原则 + +| 原则 | 意思 | 落到界面上 | +|---|---|---| +| **出处看得见** | 每条结论都能回到原文,这是产品原则(B5) | 出处是问题和清单项的固定组成部分,默认展开,不藏在「详情」里 | +| **颜色说明谁说的** | 蓝铅笔 = 系统(AI)说的,墨 = 人确认过的,绿 = 确认署名 | AI 产出一律带蓝色标记;人确认后变成墨色正文 + 绿色署名 | +| **红色只给致命问题** | 界面上看到红色,就意味着有可能导致投标无效的问题 | 表单错误、系统故障、额度用完、截止临近都**不用红**,用赭色 | +| **沉着,不阻断** | 截止前不添乱;决定权在用户 | 不闪烁、不弹窗打断、不用惊叹号;致命问题没处理完也能导出 | +| **密度优先** | 投标专员一次要过几十上百条 | 正文 14px,列表行紧凑,支持键盘逐条处理和批量处理 | + +--- + +## 2. 调研依据(为什么这样定) + +| 问题 | 依据 | 结论 | +|---|---|---| +| 正文字号 | 国内 B 端设计体系的通行值:TDesign `font-body-medium` 14/22,Ant Design 主字号 14、行高 22,字阶控制在 3–5 种 | 正文 14/22;同一屏不超过 5 个字号 | +| 中文成段阅读的行高 | 中文字面满格,行高比西文需要更大;招标原文引用是成段阅读 | 引用原文用 14/24(约 1.7 倍) | +| 宋体能用多小 | 思源宋体横画细,Windows 下 ClearType 渲染小字号时横画发虚;投标人大多用 Windows | 宋体只用于 ≥20px 的标题,界面正文一律黑体 | +| 字体从哪加载 | Google Fonts 在国内访问不稳定;数据不出境(T1)的要求也延伸到前端资源 | 字体全部**自托管**;中文宋体用 Fontsource 的 `@fontsource/noto-serif-sc`(OFL,按 unicode-range 切片,页面只下载用到的字);正文黑体用系统字体,不下载 | +| 数字对齐 | 实测 Barlow Semi Condensed 的数字**默认是比例宽度**(「1」宽 309、「0」宽 507 字体单位),字体带 `tnum` 特性 | 表格、金额、页码列必须开 `font-variant-numeric: tabular-nums` | +| 对比度 | WCAG 2.x:正文 ≥ 4.5:1,大字(≥18px,或 ≥14px 粗体)≥ 3:1,控件边框等识别所需的图形 ≥ 3:1(1.4.11) | 见第 3.2 节的实测值。赭色 #A66300 在校样纸上只有 4.4:1,小字改用深一级的 #8A5200;装饰分隔线可以浅,输入框边框必须 ≥ 3:1 | +| 色弱 | 用 Machado 2009 模型模拟后算色差(ΔE,CIELAB):红色弱下「致命红 / 定稿绿」只差 11.4,绿色弱下「致命红 / 赭」只差 15.9,都接近分不出来 | **问题级别和确认状态不能只靠颜色区分**,必须同时用文字和形状(实心 / 描边 / 无框、✓ 符号),见 3.3 | +| 打印 | 检查报告会被打印给主管或老板看,常常是黑白打印 | 报告里的级别标签在灰度下也要能分辨(同样靠形状和文字) | + +--- + +## 3. 颜色 + +### 3.1 色板 + +| 名称 | 变量 | HEX | 用途 | +|---|---|---|---| +| 校样纸 | `--c-paper` | #F5F6F3 | 页面底色(冷灰白,不是米色) | +| 白 | `--c-white` | #FFFFFF | 卡片、表格、输入框、原文页面 | +| 凹陷灰 | `--c-sunken` | #ECEEEA | 表头、「提示」级底色、只读区 | +| 墨 | `--c-ink` | #1D2733 | 正文、标题、主按钮、人工确认后的内容、焦点环 | +| 辅助灰 | `--c-sub` | #5C6670 | 次要文字、说明、「提示」级 | +| 禁用灰 | `--c-muted` | #7A838C | **只用于**禁用文字和控件边框 | +| 分隔线 | `--c-rule` | #D9DDD8 | 装饰性分隔线 | +| 蓝铅笔 | `--c-pencil` | #2F5BD3 | AI 标注、出处、跳转原文的链接 | +| 蓝铅笔浅 | `--c-pencil-soft` | #E7EDFB | 原句高亮 | +| 致命红 | `--c-fatal` | #C4122F | **只用于「致命」级问题** | +| 赭 | `--c-ochre` | #A66300 | 「重要」级边框和图标、系统提醒、表单错误、截止临近 | +| 赭(小字) | `--c-ochre-ink` | #8A5200 | 18px 以下的赭色文字 | +| 定稿绿 | `--c-green` | #2E6B4F | 人工确认的署名和 ✓ | + +每个功能色都有一个浅色底(`-soft`),只用作背景,文字仍用对应的深色。 + +**不进界面的颜色**:印章红 #D9291C 和藏青 #1C2554 只属于 logo(VI 手册第 03 章)。 + +### 3.2 对比度实测 + +| 文字色 | 校样纸 | 白 | 用法限制 | +|---|---|---|---| +| 墨 #1D2733 | 13.9 | 15.1 | 无 | +| 辅助灰 #5C6670 | 5.4 | 5.9 | 无 | +| 蓝铅笔 #2F5BD3 | 5.4 | 5.9 | 在高亮底 #E7EDFB 上 5.0,仍达标 | +| 致命红 #C4122F | 5.6 | 6.0 | 白字压红底 6.0 | +| 定稿绿 #2E6B4F | 5.8 | 6.3 | — | +| 赭 #A66300 | **4.4** | 4.8 | 校样纸上只能用于 ≥18px 的字、边框、图标 | +| 赭小字 #8A5200 | 5.9 | 6.4 | 18px 以下的赭色文字都用它 | +| 禁用灰 #7A838C | 3.6 | 3.9 | 只用于禁用状态和控件边框,**不能用于正文和占位符**(占位符用辅助灰) | + +分隔线 #D9DDD8 只有 1.3:1,所以它只能做装饰性分隔;需要用户看清边界的控件(输入框、复选框、次按钮)用 `--border-control`(#7A838C,3.6:1)。 + +### 3.3 不能只靠颜色 + +| 要区分的东西 | 颜色 | 形状 / 文字(必须同时有) | +|---|---|---| +| 致命 | 致命红 | **实心**标签,白字「致命」 | +| 重要 | 赭 | **描边**标签(1.5px),赭色字「重要」 | +| 提示 | 辅助灰 | **无边框**,灰底灰字「提示」 | +| AI 产出 | 蓝铅笔 | 「AI」小标签或「AI 摘要 / AI 初稿」字样,左侧虚线竖线 | +| 人工确认 | 墨 + 定稿绿 | ✓ 符号 + 「王敏 11月2日 14:20 确认无误」署名行 | +| 待确认区 | 蓝铅笔 | 虚线框 + 区块标题「待确认」 | + +### 3.4 颜色禁忌 + +- 不用红色做按钮(包括删除按钮)、表单错误、系统错误、倒计时、额度用完提示。删除这类操作靠二次确认,不靠颜色吓人。 +- 不用定稿绿表示「通过 / 合格」。绿色只表示「有人确认过」,不表示结论好。 +- 不用蓝铅笔做普通导航链接、主按钮。蓝色只属于系统说的话和出处。普通链接用墨色加下划线。 +- 不用渐变、不用大面积彩色底。一屏之内彩色面积越少,致命红越显眼。 + +--- + +## 4. 字体 + +### 4.1 字体栈与加载 + +| 用途 | 变量 | 字体 | 加载方式 | +|---|---|---|---| +| 界面正文 | `--font-sans` | 苹方 → 微软雅黑 → 思源黑体(Noto Sans SC) | 系统字体,不下载 | +| 标题 | `--font-serif` | 思源宋体 SemiBold(Noto Serif SC 600) | 自托管 `@fontsource/noto-serif-sc`,只引 600 字重 | +| 数字 | `--font-figures` | Barlow Semi Condensed 500 / 600 | 自托管 `@fontsource/barlow-semi-condensed` | + +- 不用 Google Fonts 等境外 CDN;字体文件随前端一起部署。 +- 检查报告 PDF 在服务端生成,**嵌入**思源黑体和思源宋体,保证不同电脑打开效果一致。 +- 三套字体都是 SIL OFL 1.1,许可证文件在 `logo/licenses/`。 + +### 4.2 字阶 + +| 级别 | 字号 / 行高 | 字体与字重 | 用在 | +|---|---|---|---| +| H1 | 24 / 32 | 宋体 600 | 工作台标题、项目名、报告标题 | +| H2 | 20 / 28 | 宋体 600 | 页面标题(「采购包 2 的检查结果」) | +| Title | 16 / 24 | 黑体 600 | 问题标题、区块标题、对话框标题 | +| Body | 14 / 22 | 黑体 400 | 界面正文、表格 | +| Read | 14 / 24 | 黑体 400 | 招标原文、投标原文的引用 | +| Caption | 12 / 20 | 黑体 400 | 时间戳、脚注、表单说明;**最小字号**,正文不用 | +| Figure | 30 / 36 | Barlow 600 | 工作台统计数字、额度剩余 | + +- 字重只用 400 和 600 两档(黑体在 Windows 上 500 和 400 几乎看不出区别)。 +- 强调用加粗,不用斜体(中文没有真斜体)、不用彩色。 + +### 4.3 数字与中英文混排 + +- **独立出现的数字**用 Barlow:表格里的金额 / 参数值、页码「第 41 页」、倒计时、统计数字、额度。表格列加 `tabular-nums`,金额右对齐。 +- **句子里的数字**跟着正文黑体走,不换 Barlow,避免一句话里字形忽宽忽窄。 +- 中文与数字、英文之间加一个半角空格:「第 41 页」「≥ 512G」「采购包 2」。比较符号与数值之间也加空格。 +- 招标原文引用**照录原文**,不加空格、不改标点、不改 ★ ▲ 等符号。 + +--- + +## 5. 间距、圆角与布局 + +### 5.1 基础 + +- 间距以 4px 为基准:4 / 8 / 12 / 16 / 20 / 24 / 32 / 40 / 48 / 64(`--sp-*`)。 +- 组件内部用 4–12,组件之间 16–24,区块之间 32–48。 +- 圆角:控件和卡片 2px(纸张感,接近直角),对话框和浮层 4px。不用大圆角和胶囊形。 +- 层次靠分隔线和底色区分,不靠阴影。阴影只用于浮层(下拉、对话框、提示)。 + +### 5.2 平台与尺寸 + +- **MVP 只做桌面 Web**,设计基准宽度 1440,最小支持 1280(1366×768 笔记本在国内政企仍常见)。小于 1280 时页面横向滚动,不做手机适配(见 U2)。 +- 浏览器:Chrome、Edge 和国产双核浏览器的极速模式(Chromium 内核)。不支持 IE 和兼容模式,检测到时提示切换。 +- 不做暗色模式(U2);变量按语义分层,以后加暗色只需重新赋值语义变量。 + +### 5.3 页面框架 + +``` +┌──────────┬──────────────────────────────────────────────┐ +│ 侧边栏 │ 顶栏:面包屑 · 项目名 · 截止倒计时 · 额度 · 账号 │ +│ 216px ├──────────────────────────────────────────────┤ +│ 工作台 │ │ +│ 项目 │ 页面内容(最大宽度 1200px,三种主布局见下) │ +│ 资质库 │ │ +│ 额度 │ │ +└──────────┴──────────────────────────────────────────────┘ +``` + +| 布局 | 页面 | 结构 | +|---|---|---| +| 列表 | 工作台、资质库、额度流水 | 筛选栏 + 表格,单栏 | +| 对照 | 读标(清单)、查标(问题列表) | 左:分类导航 200px;中:列表;右:**原文查看器**,宽度可拖动(默认 45%) | +| 批注 | 查标结果的默认视图 | 问题列表 + 右侧 280px 页边批注栏(出处);窄于 1440 时批注收进问题下方 | + +点出处时,对照布局的右栏直接翻到对应页并高亮;批注布局下从右侧滑出原文查看器,不跳页面。 + +--- + +## 6. 图标 + +- 用 **Lucide**(ISC 许可,可商用)线性图标,描边 1.5px,尺寸 16 / 20px,颜色跟随文字色。 +- 图标只做辅助,必须和文字一起出现;只有图标的按钮要有 `aria-label` 和悬停提示。 +- ★ ▲ 是招标文件里的标注符号,按文字显示,不换成图标。 +- 不用笑脸、奖杯、盾牌对勾这类暗示「保证」的图形。 + +--- + +## 7. 组件 + +每个组件写明:用途、结构、状态、规则。示意见 `system/components.html`。 + +### 7.1 按钮 + +| 类型 | 样式 | 用于 | +|---|---|---| +| 主按钮 | 墨底白字 | 一屏只有一个:「发起检查」「导出报告」「确认清单」 | +| 次按钮 | 白底墨字,控件边框 | 其他操作,包括问题处理三按钮 | +| 文字按钮 | 墨字,无边框,悬停出底色 | 表格行内、次要操作 | + +- 高度 32(默认)/ 28(表格行内)/ 40(登录页、空状态)。左右内边距 12 / 8 / 16。 +- **没有红色的危险按钮**。删除项目、删除文件用次按钮 + 确认对话框;删除项目要输入项目名才能确认。 +- 会扣点的按钮,旁边直接写扣多少、还剩多少(见 8.3),不放在弹窗里才说。 +- 状态:悬停(主按钮变浅 8%,次按钮出 `--bg-hover`)、按下、禁用(禁用灰字、无边框底色)、加载中(文字换成「正在…」,按钮宽度不变)。 +- 按钮文字是动词短语,和结果状态用同一个词(品牌策略第 4 节)。 + +### 7.2 问题级别标签 + +``` +[致命] 实心,白字压致命红 +[重要] 1.5px 赭色描边,赭色小字 +[提示] 无边框,凹陷灰底,辅助灰字 +``` + +- 字号 12,字重 600,高 20,左右内边距 6,圆角 2。 +- 级别由规则决定(FR-M3-03 的级别表),用户不能改级别;不同意可以「反馈:判断有误」。 +- 计数徽标也用同一套形状:「致命 2」实心、「重要 5」描边、「提示 11」无框。 + +### 7.3 出处(页边批注) + +出处是标博士最重要的组件。 + +``` +│ 招标文件 · 第 41 页 ← 蓝铅笔,Barlow 页码,可点击 +│ ★ 2U 机架式服务器,CPU:配置≥2颗… ← 原句照录,14/24,墨色字 + 蓝铅笔浅高亮 +│ 投标文件 技术册 · 第 12 页 ← 第二个出处(投标方) +│ 内存:256G DDR4 +``` + +- 左侧 2px 蓝铅笔竖线;在批注布局里,用一条虚线连到对应的问题。 +- 一条结论可以有多个出处,按「招标原文 → 投标原文」排序,最多默认展开 2 条,其余「另有 N 处」。 +- **「未找到」也是一种出处**:写明找过哪些分册、哪些章节,例如「已查找:商务册、技术册(全部章节)、资格证明册;未找到对应响应」。 +- 引用超过 3 行时截断,「展开原文」显示全句;原句必须完整可见,不能只给页码。 +- 出处无法定位的结果不进正式清单,进「待确认」区(FR-M2-06/07);界面上**不出现没有出处的结论**。 +- 扫描件 OCR 识别出的原句,前面加「OCR」小字,提醒用户核对原图。 + +### 7.4 问题行(查标) + +``` +[致命] 报价超过采购包 2 的最高限价 新增 +开标一览表报价 133.60 万元,最高限价 132.00 万元,超出 1.60 万元。 +这一项会导致投标无效。请核对开标一览表的报价。 +[确认无误] [已修改] [忽略并注明原因] 判断有误? +``` + +- 结构:级别标签 → 标题(结论)→ 说明(事实 + 后果 + 改法)→ 处理按钮 → 出处(右侧或下方)。 +- 标题写结论,不写规则名:「报价超过采购包 2 的最高限价」,不写「报价限价规则命中」。 +- 复查标记放在标题行右侧:「新增」「沿用」「本次已解决」(FR-M3-08),用辅助灰小字,不用颜色。 +- 处理后:按钮收起,换成署名行「✓ 王敏 11月2日 14:20 已修改」(绿),可「撤销」。忽略的署名行带原因。 +- 「致命」行左侧加 3px 致命红竖线,方便在长列表里扫读;「重要」「提示」不加。 +- 已处理的问题默认折叠到列表底部「已处理(N)」,避免干扰。 +- 每行都有「判断有误?」文字链接,打开反馈表单(FR-M3-07 / J5)。 +- 「致命」级点「确认无误」时,展开一个必填的说明输入框(U4),说明同时作为误报反馈提交。 + +**三个处理动作的含义**(按钮下方悬停提示要写清楚,避免误解): + +| 按钮 | 含义 | 结果状态 | +|---|---|---| +| 确认无误 | 我核对过,投标文件这里没问题(例如响应写在别处) | 已确认无误 | +| 已修改 | 我已经在投标文件里改了,复查时会再查 | 已修改 | +| 忽略并注明原因 | 我知道这个问题,决定不处理(必须填原因) | 已忽略 | + +### 7.5 清单项(读标) + +- 一行:重要性符号(★ / ▲ / 空)→ 标题 → 类别标签(可多个,灰色描边小标签)→ 所属包 → 来源 → 出处。 +- 来源标注:「AI 提取」(蓝铅笔)、「人工添加」(墨)、「补遗 2」(墨)。 +- 被用户改过的条目显示「已修改 · 查看记录」,打开修改历史(谁、何时、改前、改后)。 +- 「已被补遗 N 更新」的旧值加删除线,新值旁边写来源,用户确认后去掉提示(FR-M2-10)。 +- 清单整体状态显示在页头:「草稿」(辅助灰描边)/「已确认 · 王敏 11月2日」(绿色署名)。 + +### 7.6 待确认区 + +- 虚线蓝铅笔边框的独立区块,标题「待确认(N)」,说明一句:「这些结果没有找到可靠出处,或系统把握不大。确认之前,不参与检查。」 +- 每条三个动作:「补上出处后采纳」「修改后采纳」「丢弃」。没有出处也要采纳时,标注「人工确认、无出处」。 +- 待确认区不和正式清单混排,放在清单顶部,有条目时默认展开。 + +### 7.7 参数对照表 + +技术参数的检查结果用表格(借鉴方向 C「检验单」的写法): + +| 参数项 | 要求 | 投标响应 | 判断 | 出处 | +|---|---|---|---|---| +| ★ 内存 | ≥ 512G DDR4 | 256G DDR4 | **疑似不满足** | 第 41 页 ↔ 技术册 第 12 页 | + +- 要求和响应列用 Barlow + `tabular-nums`,数值左对齐(参数是「数 + 单位 + 说明」,右对齐反而难读)。 +- 「判断」列只用四个词:**满足 / 疑似不满足 / 未找到响应 / 需人工判断**。不用「合格 / 不合格 / 通过」。 +- 「疑似不满足」用所在行的问题级别标签颜色;「满足」用墨色普通字,不用绿色(绿色只表示人工确认)。 +- 表头凹陷灰底、2px 墨色底线;行间 1px 分隔线;行高 40。 + +### 7.8 原文查看器 + +- 白色页面,按规范化 PDF 显示(出处页码以它为准)。 +- 高亮:原句用蓝铅笔浅底 + 1px 蓝铅笔描边框;当前选中的出处描边加粗为 2px,并自动滚动到可见区域。 +- 顶部:文件名、文件类型(招标文件 / 补遗 N / 投标分册)、页码跳转「第 41 / 186 页」、上一处 / 下一处高亮。 +- OCR 页面显示「扫描页 · 文字由 OCR 识别」,高亮按 OCR 坐标。 +- 原文只读,不允许在查看器里改文字。 + +### 7.9 项目行(工作台) + +| 列 | 内容 | 规则 | +|---|---|---| +| 项目 | 项目名(16/24 600)+ 采购人(辅助灰) | | +| 所投包 | 「采购包 2」或「全部」 | | +| 截止 | 倒计时 | 见下 | +| 状态 | 跟进中 / 编制中 / 已检查 / 已递交 / 已归档 | 中性描边标签,不用彩色 | +| 就绪 | 只在「已检查」显示 | 见下 | +| 致命 | 待处理的致命问题数 | 实心标签「致命 2」;为 0 时显示「—」 | + +**倒计时**(以投标截止时间为准): + +| 剩余时间 | 显示 | 颜色 | +|---|---|---| +| > 72 小时 | 「11月20日 09:30 · 剩 17 天」 | 墨 | +| ≤ 72 小时 | 「剩 2 天 5 小时」 | 赭小字 | +| ≤ 24 小时 | 「今天 09:30 截止」/「剩 6 小时」 | 赭小字,加粗 | +| 已过 | 「已截止」 | 辅助灰 | + +**就绪状态**:「未就绪」(墨色普通字,致命数量看「致命」列)/「就绪」(墨色描边标签)。项目详情页的页头合在一起写:「未就绪 · 2 项致命问题待处理」。「就绪」悬停说明:「只表示致命问题都已处理,不代表投标文件没有问题。」 + +### 7.10 额度 + +- 顶栏常驻:「解析 37 · 检查 12」(Barlow),点开额度页。 +- 额度条:已用部分墨色,80% 起变赭色并出现一行提醒,100% 时提醒「本期检查额度已用完,续费或下期发放后可继续」。**不用红色**。 +- 流水表:时间、类型(发放 / 预扣 / 结算 / 退回 / 过期 / 人工调整)、数量(+ / −,Barlow 等宽)、关联项目和任务、原因。退回的记录和对应的预扣记录相邻显示。 + +### 7.11 异步任务进度(解析 / 检查) + +- 分阶段列表:「识别文件格式 → 提取文字 → 识别分包 → 提取清单 → 核对出处」,当前阶段有进度,已完成的打 ✓。 +- 明确告诉用户可以离开:「可以离开本页,完成后会发站内通知。」 +- 失败时说清楚原因和扣点情况:「解析失败:文件已加密。已退回 1 次解析额度。」赭色提醒,不用红。 + +### 7.12 提醒与通知 + +| 类型 | 样式 | 例子 | +|---|---|---| +| 信息 | 白底,墨色左边线 | 「清单未确认,检查结果以当前清单为准。」 | +| 提醒 | 赭浅底,赭色左边线,赭小字标题 | 额度 80%、截止 ≤ 72 小时、解析失败、上传文件超限 | +| 完成 | 白底,绿色 ✓ | 「报告已导出」 | + +- 页内提醒(Alert)放在相关内容上方,不自动消失;轻提示(Toast)只用于操作结果,4 秒后消失,可悬停暂停。 +- 不用弹窗打断。只有不可撤销的操作(删除、标记已递交)才用确认对话框。 + +### 7.13 表单 + +- 标签在输入框上方,必填项在标签后写「(必填)」,不用红色星号。 +- 错误提示:输入框边框变赭色 + 下方赭小字说明 + 「!」图标。说明写清楚怎么改:「手机号应为 11 位数字」。 +- 校验时机:离开输入框时校验,提交时汇总。 +- 「忽略并注明原因」的原因输入框:至少 5 个字,给 3 个常用原因快捷选项(「招标文件允许」「已在其他分册响应」「与本项目无关」)。 + +### 7.14 对话框 + +- 宽 480(确认)/ 640(表单),圆角 4,浮层阴影。 +- 标题写要做的事:「删除项目「智慧规划资源 2025 标段三」?」;正文写后果;按钮「删除项目」「取消」,主操作在右。 +- 删除项目要输入项目名才能点删除;说明删除后 30 天内可在回收站恢复(以 G10 定稿为准)。 + +### 7.15 空状态、加载与错误 + +- 空状态写下一步做什么,带一个主按钮:「还没有招标文件。上传后,标博士会逐条提取要求。」 +- 加载用骨架屏,不用转圈占满屏。 +- 系统错误:「出了点问题,请稍后重试。本次操作未扣额度。」带错误编号,便于客服查询。 + +### 7.16 AI 标识 + +- 系统生成的文字(摘要、说明、初稿)前面加「AI 摘要」「AI 初稿」标签:蓝铅笔 1px 描边、蓝铅笔字。 +- 人修改或确认后,标签换成署名行,文字变为墨色。 + +### 7.17 检查报告 PDF + +- A4 竖版,页边距 20mm,思源黑体正文 10.5pt / 行距 1.6,标题思源宋体。 +- 页眉:左侧小号横版 logo(干净版),右侧「投标文件辅助检查报告」。**logo 只出现在页眉**,不放在任何结论、汇总数字或签名旁边(红线:logo 不能当「通过」章)。 +- 首页:项目信息、投标文件版本、检查时间、规则版本、**检查覆盖范围**(查了什么 / 没查什么)、免责声明。 +- 问题明细的级别标签和界面一致(实心 / 描边 / 无框),黑白打印也能分辨。 +- 页脚:页码「3 / 12」+「本报告为辅助检查结果,不构成对投标结果的保证」。 +- 全文不出现「通过」「合格」「保证」。 + +--- + +## 8. 交互模式 + +### 8.1 AI 产出 → 人工确认 → 留痕 + +所有 AI 产出都走同一个流程,视觉上一以贯之: + +1. **AI 产出**:蓝铅笔标记(「AI 提取」「AI 摘要」、出处蓝色)。 +2. **人处理**:三个动作之一,忽略要填原因。 +3. **署名**:绿色 ✓ + 姓名 + 时间 + 动作,文字变墨色。 +4. **留痕**:每条都能打开「处理记录」,看到全部历史。 + +### 8.2 键盘逐条处理 + +问题列表和清单支持键盘,方便一次过几十条: + +| 键 | 动作 | +|---|---| +| J / K | 下一条 / 上一条 | +| O 或 Enter | 在原文查看器里打开当前出处 | +| 1 / 2 / 3 | 确认无误 / 已修改 / 忽略(3 会打开原因输入框) | +| U | 撤销当前条的处理 | +| ? | 显示快捷键说明 | + +批量处理只开放给「提示」级(FR-M3-07):勾选后「批量确认无误」。 + +### 8.3 扣点前先告知 + +- 会扣点的按钮旁边写:「扣 1 次检查 · 剩 12 次」。24 小时内复查不扣点时写:「24 小时内复查,不扣额度」。 +- 失败、超时、取消的任务,在结果里写明「已退回」。 +- 额度不足时按钮仍可点,点击后说明不足并给续费入口,不提前把按钮置灰(用户需要知道原因)。 + +### 8.4 不阻断 + +- 致命问题没处理完时,「导出报告」仍可用;导出前在按钮旁提示「还有 2 项致命问题待处理,报告会如实列出」。 +- 「标记已递交」同理,只提示,不拦截。 + +--- + +## 9. 文案规范 + +### 9.1 术语跟着法律体系和采购方式走 + +| 概念 | 政府采购 · 公开招标 | 政府采购 · 竞争性磋商 / 谈判 | 招标投标体系 | +|---|---|---|---| +| 用户提交的文件 | 投标文件 | 响应文件 | 投标文件 | +| 被判无效 | 投标无效 | 无效响应 | 否决投标 | +| 招标方文件 | 招标文件 | 磋商文件 / 谈判文件 | 招标文件 | +| 分组 | 采购包 | 采购包 | 标段 | + +界面文案用变量写(如 `{投标文件}`),按项目识别出的体系和采购方式替换,不在代码里写死。 + +### 9.2 禁用词 + +| 不用 | 原因 | 改为 | +|---|---|---| +| 保证、确保、零废标、100%、万无一失 | 产品红线 3 | 辅助检查、风险提示 | +| 通过、合格、审核通过、检查通过 | 暗示结论担保 | 已处理、就绪(附说明)、满足(仅参数对比) | +| 智能引擎、规则命中、要素、实体 | 不是投标人的话 | 用具体的业务词 | +| 建议报价、报价区间、合理报价 | 产品红线 6 | (不出现) | +| 真伪、伪造、有效印章 | 产品红线 7 | 「有无签章」「签章位置」 | +| !(惊叹号)、「请注意」「警告」开头 | 品牌性格「沉着」 | 直接写事实和后果 | + +### 9.3 格式 + +| 内容 | 写法 | +|---|---| +| 页码 | 「第 41 页」;带文件时「招标文件 · 第 41 页」「技术册 · 第 12 页」 | +| 金额 | 沿用招标文件的单位,保留两位小数:「132.00 万元」;不换算单位 | +| 日期时间 | 界面:「11月2日 14:20」(跨年时带年份);报告和留痕:「2026-11-02 14:20」 | +| 数量 | 「致命 2 项」「共 186 页」 | +| 标点 | 中文用全角标点,引用原文照录 | + +### 9.4 常用句式 + +| 场景 | 写法 | +|---|---| +| 未找到响应 | 「未找到对 ★ 条款的响应。已查找:商务册、技术册、资格证明册。」 | +| 疑似不满足 | 「技术偏离表第 12 行响应「内存 256G」,要求「≥512G」。」 | +| 后果 | 「这一项会导致投标无效。」(体系为招标投标时:「这一项会导致投标被否决。」) | +| 改法 | 「请在技术偏离表第 12 行补充响应。」 | +| 签章 | 「投标函第 2 页的签章位置未发现盖章。本检查只看有无,不鉴定真伪。」 | + +--- + +## 10. 无障碍检查清单 + +- [ ] 文字对比度 ≥ 4.5:1(大字 ≥ 3:1),控件边框 ≥ 3:1 —— 见 3.2 +- [ ] 级别、状态不只靠颜色 —— 见 3.3 +- [ ] 所有操作可用键盘完成;焦点环 2px 墨色 + 2px 间隙,任何背景上都看得见 +- [ ] 只有图标的按钮有 `aria-label` +- [ ] 原文高亮除颜色外还有描边框 +- [ ] 尊重「减少动态效果」系统设置;动效时长 120–200ms,不闪烁 +- [ ] 浏览器缩放到 200% 时内容不丢失(可以横向滚动) + +--- + +## 11. 产品红线自查(对应 AGENTS.md) + +| 红线 | 本规范怎么落实 | +|---|---| +| 1 辅助定位四件套 | AI 标识(7.16)、清单(7.5)、处理按钮与署名(7.4、8.1)、处理记录(7.5、8.1) | +| 2 可复核 | 出处组件是固定组成部分(7.3);无出处进待确认区(7.6) | +| 3 禁用绝对化表述 | 禁用词表(9.2);报告首页覆盖范围与免责声明(7.17) | +| 4 不阻断用户 | 8.4;就绪状态只提示(7.9) | +| 5 不编造 | 资质只来自资质库;缺失时显示占位「待补录」,不生成 | +| 6 不生成报价 | 参数表与报价检查只显示投标文件读出的数字;禁用词表 | +| 7 签章只看有无 | 签章句式(9.4) | +| 9 额度即货币 | 扣点前告知、退回可见(7.10、8.3) | +| logo 不当「通过」章 | 报告 logo 只在页眉(7.17);绿色不表示「通过」(3.4) | + +--- + +## 12. 已确认的事项(U1–U4,2026-11-02) + +| 编号 | 事项 | 结论 | 理由 | +|---|---|---|---| +| U1 | 表单错误、系统错误、额度用完、截止临近都不用红色,统一用赭色 | 采纳 | 让红色只代表「可能导致投标无效」;色弱测试显示红 / 赭本来就靠形状区分,错误提示照样有文字和图标 | +| U2 | MVP 只做桌面 Web(最小 1280 宽),不做手机适配和暗色模式 | 采纳 | 读标和查标需要原文并排,手机屏放不下;变量已按语义分层,以后可加 | +| U3 | 图标用 Lucide(ISC 许可) | 采纳 | 线性风格和校样方向一致,图标全,可商用 | +| U4 | 「致命」级问题点「确认无误」时,也要求写一句说明(目前需求只要求「忽略」填原因) | 采纳 | 对致命问题说「没问题」,等于认为系统判断错了:留下说明既便于审计,也是最有价值的误报反馈。会改动 FR-M3-07 | + +组件库(TDesign / Ant Design / Arco 等)由技术架构阶段选定;本规范的正文 14/22、4px 间距与这些组件库一致,选定后把 `tokens.css` 映射到它的主题配置即可。 + +--- + +## 13. 预览与维护 + +- 预览组件页(字体从 `logo/.work/fonts` 加载,没有该目录时会退回系统字体): + + ```bash + cd docs/design && python3 -m http.server 8765 + # 浏览器打开 http://127.0.0.1:8765/system/components.html + ``` + +- 改颜色、字号、间距:只改 `system/tokens.css`,再同步本文的表格。 +- 新增组件:先在本文第 7 节写用途、结构、状态、规则,再加到预览页。 +- 本规范变化影响 VI 手册(颜色、字体)时,同步更新 `vi/vi-manual.html` 并重出 PDF。 diff --git a/docs/design/system/components.html b/docs/design/system/components.html new file mode 100644 index 0000000..a5a602d --- /dev/null +++ b/docs/design/system/components.html @@ -0,0 +1,473 @@ + + + + + +标博士 组件预览 + + + + +
+

标博士 · 组件预览

+

配合 design-system.md v0.1 阅读。条款原文取自苏采云样本 S02、S10;为了演示,S10 的分包限价和 S02 的设备参数放在了同一个示意项目里。页码、投标响应值、人名都是示意数据。

+ + +
+
01

颜色

规范 §3
+
+
校样纸#F5F6F3
页面底色
+
墨#1D2733
正文、人工确认
+
辅助灰#5C6670
次要文字、提示级
+
蓝铅笔#2F5BD3
AI 标注、出处
+
致命红#C4122F
只用于致命问题
+
赭#A66300 / #8A5200
重要级、提醒、错误
+
定稿绿#2E6B4F
确认署名
+
禁用灰#7A838C
禁用、控件边框
+
+

印章红 #D9291C、藏青 #1C2554 只属于 logo,不出现在界面变量里。

+
+ + +
+
02

字体与字阶

规范 §4
+ + + + + + + + +
H1 · 24/32 宋体智慧规划资源 2025 标段三
H2 · 20/28 宋体采购包 2 的检查结果
Title · 16/24报价超过采购包 2 的最高限价
Body · 14/22开标一览表报价 133.60 万元,最高限价 132.00 万元,超出 1.60 万元。
Read · 14/24★ 支持硬件BFD,最小报文发送间隔≤50ms,提供相关证明材料(包含但不限于产品官网公开参数截图证明等)。
Caption · 12/20王敏 11月2日 14:20 · 第 3 次检查
Figure · 30/36132.00 第 41 页 ≥ 512G
+
+ + +
+
03

级别标签与按钮

规范 §7.1 · §7.2
+
+
+
致命重要提示
+
致命2重要5提示11
+
编制中已检查AI 摘要资格条件无效条款
+

级别靠「实心 / 描边 / 无框」区分,色弱和黑白打印也分得清。

+
+
+
扣 1 次检查 · 剩 12 次
+
+
普通链接用墨色下划线
+

没有红色危险按钮;删除靠确认对话框,不靠颜色。

+
+
+
+ + +
+
04

问题行与出处批注

规范 §7.3 · §7.4
+
+
+

采购包 2 的检查结果

智慧规划资源 2025 标段三 · 第 3 次检查 +
致命2重要1提示4
+
+ +
+
+
致命报价超过采购包 2 的最高限价新增
+

开标一览表报价 133.60 万元,最高限价 132.00 万元,超出 1.60 万元。

+

这一项会导致投标无效。请核对开标一览表的报价。

+
+
+ +
+ +
+
+
致命★ 条款疑似不满足:服务器内存沿用
+

技术偏离表第 12 行响应「内存 256G」,要求「≥512G」。

+
✓王敏11月2日 14:20已修改撤销
+
+ +
+ +
+
+
重要缺少 ★ 参数的证明材料:硬件 BFD
+

已响应「支持硬件 BFD」,但没有找到官网参数截图等证明材料。请在技术册补充证明材料。

+
+
+ +
+ +
+
+
提示投标函落款日期晚于投标截止日
+

投标函落款「2026年11月25日」,投标截止时间是 2026年11月20日 09:30。

+
+
+ +
+
已处理(9)· 本次已解决(3)
+
+
+ + +
+
05

清单项与待确认区

规范 §7.5 · §7.6
+
+
+

待确认(2)

+

这些结果没有找到可靠出处,或系统把握不大。确认之前,不参与检查。

+
+ +
投标保证金:不收取
AI 提取 · 未找到出处
+
+ +
+
+ ★ +
核心产品需提供原厂授权
AI 提取 · 把握不大第 38 页
+
+ +
+
+
+

无效条款(14)

草稿
+
+ ★ +
设备采用国产自主可控 CPU 芯片,提供国产化适配承诺函
无效条款技术参数采购包 2
+
AI 提取
第 43 页
+
+
+ +
提交投标文件截止时间:2026年11月20日 09:30 2026年11月27日 09:30
关键日期已被补遗 1 更新 · 待确认
+
补遗 1
第 1 页
+
+
+ +
联合体各方须签订《联合体协议》并明确牵头单位
资格条件已修改 · 查看记录
+
人工添加
+
+
+
+
+ + +
+
06

参数对照表与原文查看器

规范 §7.7 · §7.8
+
+
+ + + + + + + + +
参数项要求投标响应判断出处
★ 内存≥ 512G DDR4256G DDR4疑似不满足第 41 页 ↔ 技术册 12
★ CPU≥ 2 颗 32C 2.7GHz2 颗 32C 2.7GHz满足第 41 页 ↔ 技术册 12
▲ 存储盘≥ 4 块 3.84T SSD—未找到响应第 41 页
万兆光口≥ 4 个 10GbE4 个 10GbE(不含光模块)需人工判断第 41 页 ↔ 技术册 13
+

判断只用四个词:满足 / 疑似不满足 / 未找到响应 / 需人工判断。「满足」用墨色,不用绿色。

+
+
+
招标文件JSZC-320300-XZCG-G2026-0053
第 41 / 186 页
+
+

采购包 2:服务器设备

+

★ 2U机架式服务器,CPU:配置≥2颗海光架构32C 2.7GHz,内存: ≥512G DDR4,系统盘: 2块≥480G SSD,存储盘: ≥2块8T SATA、≥4块3.84T SSD……

+

阵列卡:1块8204 2G,网络:配置≥4个1GbE 接口,≥4个10GbE 光接口(含光模块)……

+

备注:加★为核心技术参数;加▲为重要技术参数;其他为通用技术参数。

+
+
+
+
+ + +
+
07

项目工作台

规范 §7.9
+ + + + + + + + +
项目所投包截止状态就绪致命
智慧规划资源 2025 标段三
南京市规划和自然资源局
采购包 2今天 17:00 截止已检查未就绪致命2
2026 年信息化设备采购项目
国家税务总局徐州市税务局
全部剩 2 天 5 小时已检查就绪—
数据中心运维服务项目
某市大数据管理局
标段 111月20日 09:30 · 剩 17 天编制中——
智慧校园一期
某区教育局
全部已截止已递交——
+

截止临近用赭色,不用红;「就绪」悬停说明:只表示致命问题都已处理,不代表投标文件没有问题。

+
+ + +
+
08

额度、提醒、表单、进度

规范 §7.10–7.13
+
+
+
+
+
解析剩余
37/ 50 次
+
检查剩余
4/ 20 次
+
+ + + + + + + +
时间类型数量关联
11-02 14:31退回+1解析失败:文件已加密
11-02 14:28预扣−1解析 · 补遗 1
11-02 10:05结算−1检查 · 智慧规划资源 2025 标段三
+
+
+
!手机号应为 11 位数字
+
+
+
+
+
i

清单未确认,检查结果以当前清单为准。

+
!

本期检查额度已用 80%。剩 4 次,11月30日 发放下期额度。

+
!

解析失败:文件已加密。已退回 1 次解析额度。请上传未加密的文件。

+
✓

报告已导出。

+
+
    +
  1. ✓识别文件格式
  2. +
  3. ✓提取文字
  4. +
  5. 识别分包(3 个采购包)
  6. +
  7. 提取清单
  8. +
  9. 核对出处
  10. +
+

可以离开本页,完成后会发站内通知。

+
+
+
+
+ + +
+
09

检查报告首页

规范 §7.17
+
+
标博士投标文件辅助检查报告
+

智慧规划资源 2025 标段三 · 采购包 2

+
+
项目编号
JSZC-320100-JZCG-G2026-0369
+
投标文件
商务册 v3、技术册 v3、报价册 v2、资格证明册 v1
+
检查时间
2026-11-02 14:20 · 规则版本 2026.11
+
处理情况
致命2 重要1 提示4 其中待处理 1 项
+
+
检查覆盖范围查了:清单 86 条的响应完整性、形式要件(格式文件、签章位置有无、落款日期)、资质匹配、报价形式。
没查:份数、装订密封、CA 加密(见附录「需人工核对」);签章真伪;报价是否合理。
+
本报告为辅助检查结果,不构成对投标结果的保证1 / 12
+
+

logo 只在页眉,不靠近任何结论或汇总数字。

+
+
+ + diff --git a/docs/design/system/tokens.css b/docs/design/system/tokens.css new file mode 100644 index 0000000..c455658 --- /dev/null +++ b/docs/design/system/tokens.css @@ -0,0 +1,105 @@ +/* 标博士 · 界面设计变量(design tokens)v0.1 + * 规范说明见 docs/design/design-system.md;预览见同目录 components.html。 + * 只放变量,不放组件样式。技术架构选定组件库后,把这些值映射到组件库的主题配置。 + * 对比度一律按 WCAG 2.x 公式计算,底色为校样纸 #F5F6F3(括号内为白底)。 + */ +:root { + /* ---------- 基础色板:校样色系 ---------- */ + --c-paper: #F5F6F3; /* 校样纸:页面底色 */ + --c-white: #FFFFFF; /* 卡片、表格、输入框 */ + --c-sunken: #ECEEEA; /* 表头、代码、凹陷区 */ + --c-hover: #EEF0EC; /* 行悬停 */ + --c-ink: #1D2733; /* 墨:正文、人工确认、主按钮 13.9 (15.1) */ + --c-sub: #5C6670; /* 辅助灰:次要文字、「提示」级 5.4 (5.9) */ + --c-muted: #7A838C; /* 只用于禁用文字与控件边框 3.6 (3.9),不能用于正文 */ + --c-rule: #D9DDD8; /* 装饰分隔线(不承担识别功能) */ + --c-pencil: #2F5BD3; /* 蓝铅笔:AI 标注、出处、原文链接 5.4 (5.9) */ + --c-pencil-strong: #244AB0;/* 蓝铅笔悬停 / 按下 */ + --c-pencil-soft: #E7EDFB; /* 原句高亮底色 */ + --c-fatal: #C4122F; /* 致命红:只用于「致命」问题 5.6 (6.0) */ + --c-fatal-soft: #FBE9EC; + --c-ochre: #A66300; /* 赭:「重要」级的边框、图标、≥18px 文字 4.4 (4.8) */ + --c-ochre-ink: #8A5200; /* 赭色小字(<18px) 5.9 (6.4) */ + --c-ochre-soft: #FBF0DC; + --c-green: #2E6B4F; /* 定稿绿:人工确认署名 5.8 (6.3) */ + --c-green-soft: #E5F0EA; + /* 印章红 #D9291C、藏青 #1C2554 只属于 logo,不进界面变量 */ + + /* ---------- 语义色 ---------- */ + --bg-page: var(--c-paper); + --bg-surface: var(--c-white); + --bg-sunken: var(--c-sunken); + --bg-hover: var(--c-hover); + --text-primary: var(--c-ink); + --text-secondary: var(--c-sub); + --text-disabled: var(--c-muted); + --text-on-dark: var(--c-white); + --border-subtle: var(--c-rule); + --border-control: var(--c-muted); /* 输入框等控件边框,≥3:1(WCAG 1.4.11) */ + --border-strong: var(--c-ink); + --focus-ring: var(--c-ink); + + --ai: var(--c-pencil); + --ai-strong: var(--c-pencil-strong); + --ai-soft: var(--c-pencil-soft); + --human: var(--c-ink); + --confirmed: var(--c-green); + --confirmed-soft: var(--c-green-soft); + + --sev-fatal: var(--c-fatal); + --sev-fatal-soft: var(--c-fatal-soft); + --sev-major: var(--c-ochre); + --sev-major-text: var(--c-ochre-ink); + --sev-major-soft: var(--c-ochre-soft); + --sev-hint: var(--c-sub); + --sev-hint-soft: var(--c-sunken); + + --warn: var(--c-ochre); /* 系统提醒、表单错误、额度预警:不用红 */ + --warn-text: var(--c-ochre-ink); + --warn-soft: var(--c-ochre-soft); + + /* ---------- 字体 ---------- */ + --font-sans: "PingFang SC", "Microsoft YaHei", "Noto Sans SC", "Noto Sans CJK SC", "Source Han Sans SC", system-ui, sans-serif; + --font-serif: "Noto Serif SC", "Source Han Serif SC", "Songti SC", serif; + --font-figures: "Barlow Semi Condensed", var(--font-sans); + + /* 字阶:字号 / 行高(px)。正文 14/22 与 TDesign、Ant Design 一致 */ + --fs-caption: 12px; --lh-caption: 20px; /* 时间戳、脚注;最小字号 */ + --fs-body: 14px; --lh-body: 22px; /* 界面正文 */ + --lh-read: 24px; /* 原文引用等成段阅读:14/24 */ + --fs-title: 16px; --lh-title: 24px; /* 问题标题、卡片标题、区块标题 */ + --fs-h2: 20px; --lh-h2: 28px; /* 页面标题(宋体) */ + --fs-h1: 24px; --lh-h1: 32px; /* 工作台、报告标题(宋体) */ + --fs-figure: 30px; --lh-figure: 36px; /* 统计数字(Barlow) */ + --fw-regular: 400; + --fw-medium: 500; + --fw-bold: 600; + + /* ---------- 间距:4px 基准 ---------- */ + --sp-1: 4px; --sp-2: 8px; --sp-3: 12px; --sp-4: 16px; --sp-5: 20px; + --sp-6: 24px; --sp-8: 32px; --sp-10: 40px; --sp-12: 48px; --sp-16: 64px; + + /* ---------- 圆角、线、阴影 ---------- */ + --radius-sm: 2px; /* 按钮、标签、输入框、卡片 */ + --radius-md: 4px; /* 对话框、浮层 */ + --line: 1px; + --line-sev: 1.5px; /* 「重要」标签描边 */ + --shadow-overlay: 0 4px 16px rgba(29, 39, 51, .14), 0 1px 3px rgba(29, 39, 51, .10); + + /* ---------- 尺寸 ---------- */ + --control-h: 32px; /* 默认按钮、输入框 */ + --control-h-sm: 28px; /* 表格行内 */ + --control-h-lg: 40px; /* 登录、空状态主操作 */ + --sidebar-w: 216px; + --margin-note-w: 280px; /* 页边批注栏 */ + --content-max: 1200px; + + /* ---------- 动效 ---------- */ + --dur-fast: 120ms; + --dur-base: 200ms; + --ease: cubic-bezier(.2, 0, 0, 1); +} + +@media (prefers-reduced-motion: reduce) { + :root { --dur-fast: 0ms; --dur-base: 0ms; } +}