From b86e62711e5981d4b5166b87cd3a1eaa39308b1c Mon Sep 17 00:00:00 2001 From: YANG JIANKUAN Date: Mon, 2 Nov 2026 22:02:34 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E8=AE=B0=E5=BD=95=E5=8E=9F=E5=9E=8B?= =?UTF-8?q?=E9=98=B6=E6=AE=B5=E5=86=B3=E7=AD=96=20P1=E2=80=93P2=EF=BC=8C?= =?UTF-8?q?=E5=90=8C=E6=AD=A5=20FR-M3-02/04=20=E4=B8=8E=E9=A1=B9=E7=9B=AE?= =?UTF-8?q?=E8=BF=9B=E5=BA=A6?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 5.5 --- AGENTS.md | 9 +++++---- docs/analysis/03-functional-requirements.md | 4 ++-- docs/decisions.md | 5 +++++ 3 files changed, 12 insertions(+), 6 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index cc2efbb..fb9a553 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -7,7 +7,7 @@ - **产品名**：标博士（代码仓库名 `bid-doctor`） - **一句话定位**：站在**投标方**一侧，贯穿「寻标 → 读标 → 写标 → 查标 → 投标」全生命周期的 AI 辅助工具。产品是「副驾驶」，不是「自动驾驶」。 - **口号**：标博士，你的AI投标专家（固定写法，见决策 B5）。 -- **当前阶段**：需求分析、品牌与 VI 已完成，产品界面设计规范 v0.1 已完成，尚无代码。工作流：需求分析 ✅ → 主题 / 品牌设计 ✅ → 产品界面设计规范 ✅ → 原型设计 → UI 设计 → 技术架构 → 实现 → 测试。 +- **当前阶段**：需求分析、品牌与 VI 已完成，产品界面设计规范 v0.1、MVP 可点击原型 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。发现矛盾或缺失时，记录问题并向用户确认，不要自行假设。 - **工作语言**：文档、界面文案、提交说明默认使用简体中文；代码标识符、文件名使用英文。 @@ -94,8 +94,8 @@ docs/ logo/ # logo 正式资产、规范、构建脚本、历史版本 vi/ # VI 视觉识别规范（PDF + HTML 源文件） design-system.md # 产品界面设计规范：原则、颜色、字体、组件、文案 - system/ # tokens.css（设计变量）+ components.html（组件预览） - prototype/ # 原型（低保真 / 高保真 HTML） + system/ # tokens.css（设计变量）、components.css（组件样式）、components.html（预览） + prototype/ # MVP 可点击原型（HTML，说明见 prototype/README.md） architecture/ # 技术架构、ADR（docs/architecture/adr/NNNN-*.md） decisions.md # 产品与工程决策记录（含 D1–D4 的拍板结果） samples/ @@ -122,4 +122,5 @@ samples/ - 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/`。 - 2026-11-02：产品界面设计规范 v0.1（`docs/design/design-system.md` + `system/tokens.css` + `system/components.html`）。要点：红色只给致命问题（表单错误、额度、截止临近都用赭色）；问题级别靠实心 / 描边 / 无框区分，不只靠颜色（色弱模拟验证过）；字体全部自托管；出处是固定组件。U1–U4 全部按建议确认（只做桌面 Web、图标用 Lucide、致命问题确认无误也要写说明）。 -- 下一步：原型设计（`docs/prototype/`）。 +- 2026-11-02：MVP 可点击原型 v0.1（`docs/prototype/`，13 个页面，覆盖 J1–J5）。中保真，直接用设计规范的组件；查标页可逐条处理、键盘操作、看原文。原型阶段的 P1（24 小时免扣从上一次扣点的检查算起）、P2（人工核对勾选按项目保存）已按建议确认。 +- 下一步：用原型找种子用户走查（顺带问 G15 苏采云客户端的分册对应），再进入 UI 设计精修。 diff --git a/docs/analysis/03-functional-requirements.md b/docs/analysis/03-functional-requirements.md index d24d6a0..6f5a2d9 100644 --- a/docs/analysis/03-functional-requirements.md +++ b/docs/analysis/03-functional-requirements.md @@ -107,7 +107,7 @@ ### FR-M3-02 发起检查 · P0 - 前提：项目至少有一份解析成功的招标文件。清单没确认时可以检查，但要提示「清单未确认，检查结果以当前清单为准」。 -- 按 `01-scope-roles.md` §4 的计费口径扣点；同一项目 24 小时内复查不扣点。 +- 按 `01-scope-roles.md` §4 的计费口径扣点；同一项目 24 小时内复查不扣点。24 小时从**上一次扣了额度的检查**算起，窗口内的复查不重新计时（决策 P1）。 - 每次检查产生一个「检查批次」，记下当时的清单版本、投标文件版本和规则版本。 ### FR-M3-03 响应完整性检查 · P0 @@ -138,7 +138,7 @@ 分成两类，分开显示： - **可自动检查**：投标函、授权书等格式文件是否齐全，是否改动了格式文件里的固定文字；签字 / 盖章位置**有没有**（只看有无，不鉴定真伪，界面写明）；落款日期是否合理；文件里有没有出现其他项目的名称、编号或采购人（照搬旧标书留下的）。 -- **需人工核对**：份数、装订密封、递交方式、CA 加密等，文件里看不出来。这些生成「请核对」条目，用户勾选确认。 +- **需人工核对**：份数、装订密封、递交方式、CA 加密等，文件里看不出来。这些生成「请核对」条目，用户勾选确认。勾选结果按项目保存，复查时沿用，报告写明勾选人和时间（决策 P2）。 ### FR-M3-05 资质匹配检查 · P0 diff --git a/docs/decisions.md b/docs/decisions.md index 63d1446..a8d2f41 100644 --- a/docs/decisions.md +++ b/docs/decisions.md @@ -4,6 +4,11 @@ --- +## P1–P2 · 2026-11-02 · 原型阶段的待确认事项：全部按建议 + +- **P1 24 小时免扣的起算点**：从**上一次扣了额度的检查**算起；窗口内的复查不扣点，也不重新计时。理由：如果从上一次检查算起，每天复查一次就能一直不扣点，额度规则形同虚设。**影响**：FR-M3-02。 +- **P2「需人工核对」的勾选按项目存**：整个项目共用一份勾选结果，复查时保留；报告写明勾选人和时间。理由：份数、CA 加密、递交回执这类事项和投标文件版本无关，每次检查重新勾选只会增加负担。**影响**：FR-M3-04。 + ## U1–U4 · 2026-11-02 · 产品界面设计规范 v0.1 的待确认事项：全部按建议 规范见 `docs/design/design-system.md`（第 12 节）。