diff --git a/AGENTS.md b/AGENTS.md index 09e63e0..cc2efbb 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -7,7 +7,7 @@ - **产品名**：标博士（代码仓库名 `bid-doctor`） - **一句话定位**：站在**投标方**一侧，贯穿「寻标 → 读标 → 写标 → 查标 → 投标」全生命周期的 AI 辅助工具。产品是「副驾驶」，不是「自动驾驶」。 - **口号**：标博士，你的AI投标专家（固定写法，见决策 B5）。 -- **当前阶段**：需求分析、品牌与 VI 已完成，尚无代码。工作流：需求分析 ✅ → 主题 / 品牌设计 ✅ → 产品界面设计规范 → 原型设计 → UI 设计 → 技术架构 → 实现 → 测试。 +- **当前阶段**：需求分析、品牌与 VI 已完成，产品界面设计规范 v0.1 已完成，尚无代码。工作流：需求分析 ✅ → 主题 / 品牌设计 ✅ → 产品界面设计规范 ✅ → 原型设计 → UI 设计 → 技术架构 → 实现 → 测试。 - **需求来源**：当前有效版本是 `docs/招投标AI工具PRD-v0.9.1.html`（`docs/招投标AI工具PRD.html` 是 v0.9 原稿，保留作对照），再加上 `docs/decisions.md` 和 `docs/analysis/` 里已确认的 MVP 细化需求。三者冲突时：decisions.md > analysis > PRD。发现矛盾或缺失时，记录问题并向用户确认，不要自行假设。 - **工作语言**：文档、界面文案、提交说明默认使用简体中文；代码标识符、文件名使用英文。 @@ -75,6 +75,7 @@ - **视觉方向**：A「校样」。蓝铅笔 #2F5BD3 = AI 标注 / 出处，墨 #1D2733 = 正文 / 人工确认，校样纸 #F5F6F3 = 底色。 - **两种红色不能混用**：印章红 #D9291C **只用于 logo**；致命红 #C4122F **只用于界面里的致命问题**。 +- **界面规范**：`docs/design/design-system.md`；写界面代码时颜色、字号、间距只用 `docs/design/system/tokens.css` 里的变量。 - **字体**（均为 OFL，可免费商用）：思源宋体（标题、字标）、思源黑体 / 系统黑体（界面正文）、Libre Caslon（英文品牌字）、Barlow Semi Condensed（数字）。 - **Logo**：正式文件在 `docs/design/logo/svg/`、`png/`。要改 logo，改 `docs/design/logo/scripts/logo_lib.py` 里的参数，再运行 `scripts/build_assets.sh`，**不要手改 SVG**。工具环境（`logo/.work/`）不进 git，搭建方法见 `logo-spec.md` 第 6 节。 - **VI 手册**：`docs/design/vi/标博士-VI视觉识别规范-v1.1.pdf`，源文件是同目录的 `vi-manual.html`，重新导出方法见 `docs/design/vi/README.md`。logo 或口号变化后要同步重出。 @@ -92,7 +93,8 @@ docs/ brand-directions.html# 三个视觉方向对比（已选 A 校样） logo/ # logo 正式资产、规范、构建脚本、历史版本 vi/ # VI 视觉识别规范（PDF + HTML 源文件） - design-system.md # （下一步）产品界面设计规范：组件、token + design-system.md # 产品界面设计规范：原则、颜色、字体、组件、文案 + system/ # tokens.css（设计变量）+ components.html（组件预览） prototype/ # 原型（低保真 / 高保真 HTML） architecture/ # 技术架构、ADR（docs/architecture/adr/NNNN-*.md） decisions.md # 产品与工程决策记录（含 D1–D4 的拍板结果） @@ -119,4 +121,5 @@ samples/ - 品牌策略：定位「投前审校员」，口号「标博士，你的AI投标专家」（B5）；视觉方向选 A「校样」（B1）。 - Logo v5.1：AI 生成的白文印「标」+ 思源宋体 SemiBold / Libre Caslon 字标，比例 H2、英文视觉内缩 C2（B3、B4）。中间经历的 v1–v4（Codex 精细化、SVG 程序化模拟印泥）归档在 `docs/design/logo/archive/`，教训见 `logo/seal-research.md`：印泥质感本质上是位图，不要再用 SVG 程序化模拟。 - VI 视觉识别规范 v1.1（A4 横版 24 页，含名片、信封、信纸、报告、演示文稿、网站等应用），见 `docs/design/vi/`。 -- 下一步：产品界面设计规范 `docs/design/design-system.md`，然后进入原型设计。 +- 2026-11-02：产品界面设计规范 v0.1（`docs/design/design-system.md` + `system/tokens.css` + `system/components.html`）。要点：红色只给致命问题（表单错误、额度、截止临近都用赭色）；问题级别靠实心 / 描边 / 无框区分，不只靠颜色（色弱模拟验证过）；字体全部自托管；出处是固定组件。U1–U4 全部按建议确认（只做桌面 Web、图标用 Lucide、致命问题确认无误也要写说明）。 +- 下一步：原型设计（`docs/prototype/`）。 diff --git a/docs/analysis/03-functional-requirements.md b/docs/analysis/03-functional-requirements.md index d9ba9c5..d24d6a0 100644 --- a/docs/analysis/03-functional-requirements.md +++ b/docs/analysis/03-functional-requirements.md @@ -159,6 +159,7 @@ ### FR-M3-07 人工确认 · P0 - 每个问题的状态：待处理 → 已确认无误 / 已修改 / 忽略（必须填原因）。 +- 「致命」级问题选「已确认无误」时，也必须填一句说明（决策 U4）；说明同时进入误报反馈。 - 还有没处理的「致命」问题时，项目就绪状态是「未就绪」，但**不阻止导出**。 - 支持批量处理（仅限「提示」级）；每次处理都记录处理人和时间。 - 每个问题都可以「反馈：判断有误」（J5）。 diff --git a/docs/decisions.md b/docs/decisions.md index feab691..63d1446 100644 --- a/docs/decisions.md +++ b/docs/decisions.md @@ -4,6 +4,15 @@ --- +## U1–U4 · 2026-11-02 · 产品界面设计规范 v0.1 的待确认事项：全部按建议 + +规范见 `docs/design/design-system.md`（第 12 节）。 + +- **U1 红色只给致命问题**：表单错误、系统错误、额度用完、截止临近都用赭色（小字 #8A5200），不用红。理由：让红色只代表「可能导致投标无效」；色弱模拟显示红 / 赭本来就要靠形状和文字区分，错误提示照样有文字和图标。 +- **U2 只做桌面 Web**：MVP 最小宽度 1280，不做手机适配和暗色模式。理由：读标和查标需要原文并排；变量已按语义分层，以后可加暗色。 +- **U3 图标用 Lucide**（ISC 许可）：线性风格和校样方向一致，可商用。 +- **U4 致命问题「确认无误」也要写说明**：对致命问题说「没问题」等于认为系统判断错了，说明既用于审计，也作为误报反馈。**影响**：FR-M3-07 已同步修改。 + ## B5 · 2026-11-02 · 口号改为「标博士，你的AI投标专家」 - **决策**：品牌口号由「每一条，都有出处。」改为 **「标博士，你的AI投标专家」**，固定写法：AI 两侧不加空格，结尾不加标点。