L-20260821-05 新增需求：报价单灵活部分 + MFR 开放报价功能¶
日志类型：DTL（听写任务日志，docs/工作日志/dtl/） 编号：L-20260821-05 日期：2026-08-21 维护人：听写（DT） 触发来源：TL 2026-08-21 TraeCode 对话会话新增 2 项需求 Git commit 哈希：⏳ 写本 DTL 后立即回填
一、TL 新增需求全文（VERBATIM 摘录）¶
1.1 需求 1：报价单灵活部分¶
「面向MFR和CST的最终报价单，涉及无法提前确定的现场环境或者服务需求（例如：客户可以配合的时间，现场环境等），可以报价单中的灵活部分列出，提供明确的单价和整体计价规则，计价规则要包括设定的最高限价。」
1.2 需求 2：MFR 开放报价功能¶
「面向MFR的开放报价功能（web端），这个功能中MFR的员工以个人名义注册，可以绑定MFR，也可以不绑定，注册后，只需要提供报价必要信息（产品类型，规格型号，客户地址，安装服务服务需求，等），系统即可生成详细报价，还可以下载pdf文档，让mfr直接提供给最终客户（cst）。」
1.3 执行指令¶
「请根据上述内容，更新需求，设计，原型等文档。」
二、执行任务清单（9 大任务）¶
2.1 任务 #1：RQD-B 业务级需求更新（V2.0→V2.1）¶
新增需求条目： - QSV-09：报价单「灵活部分」机制（独立区块+单价+计价规则+最高限价）P0 - QSV-10：MFR 开放报价功能（个人注册+可选绑定+自动报价+PDF下载）P0
新增章节： - §1.4 报价单灵活部分机制详述（背景+设计要求 5 项） - §1.5 MFR 开放报价功能详述（定位+核心流程 5 步+业务约束 3 项）
产物：docs/需求分析/业务级需求.md V2.1
2.2 任务 #2：RQD-O 执行级需求更新¶
新增需求条目： - MFR-11：开放报价功能（Web 端）P0 - QTE-08：报价单灵活部分机制 P0 - QTE-09：MFR 开放报价入口 P0
2.3 任务 #3：QSV-D 报价服务设计更新（V1.0→V1.1）¶
新增内容： - §二 设计原则新增第 5 条「灵活可控」 - §三 服务边界：§3.1 报价场景表（含 MFR 开放报价）+ §3.2 报价单结构 Mermaid 图（确定+灵活）+ §3.3 灵活部分设计规范（5 字段）+ §3.4 MFR 开放报价服务边界 - §四 对接方案：MDS/CPT/OPS 三方对接表 - §五 后续规划新增 3 项待办
产物：docs/报价服务/报价服务设计.md V1.1
2.4 任务 #4：QMD 报价模型设计更新（V3.0→V3.1）¶
新增章节： - §十三 报价单灵活部分参数体系： - §13.1 P10 灵活费用参数 6 项（F01~F06）：客户配合等待费/现场环境勘察附加/拆旧不确定费/隐蔽工程不确定费/材料补购费/二次上门费 - 每项含：费用名称/单价/计价规则/最高限价/结算依据 - §13.2 计价总规则公式（LaTeX）+ 4 项核心约束 - §13.3 报价单展示格式示例 - §十四 MFR 开放报价参数精简版： - §14.1 开放报价输入字段 10 项（OQ-01~10） - §14.2 与 CST 端询价差异对比表 - §14.3 PDF 模板结构（含品牌+徽章+报价明细+灵活部分） - §14.4 转订单流程 Mermaid 序列图 - §十五 待校准新增 3 项待办 - §十六 修订记录追加 V3.1 条目
产物：docs/报价服务/报价模型设计.md V3.1（504→672 行）
2.5 任务 #5：新建原型 mfr-portal/open-quote.html¶
页面结构（6 大区块）： 1. 账户信息（个人注册+可选绑定 MFR+信任徽章展示） 2. 产品信息（品类+型号+数量，对齐 OQ-01~03） 3. 客户地址与楼宇（区域+楼宇+楼层+电梯，对齐 OQ-04~07） 4. 安装服务需求（需求描述+拆旧+配送，对齐 OQ-08~10） 5. 生成报价按钮（触发 QMD 模型计算） 6. 报价结果（确定部分+灵活部分 6 项+客户价格上限+PDF 下载按钮）
产物：docs/业务测试/原型/mfr-portal/open-quote.html
2.6 任务 #6：新建原型 cst-app/quote-detail.html¶
页面结构： - 报价单详情卡片（报价编号+元信息） - 确定部分明细（安装费+物流费+管理费） - 灵活部分 6 项（P10-F01~F06：每项含单价+计价规则+最高限价） - 报价总计（确定部分+灵活最高限价=客户价格上限） - 报价说明（5 条规则） - 操作按钮（接受报价并下单+返回首页）
产物：docs/业务测试/原型/cst-app/quote-detail.html
2.7 任务 #7：原型索引 index.html 更新¶
- MFR 门户描述更新：8 页→9 页（含开放报价）
- CST 客户端描述更新：8 页→9 页（含报价单+灵活部分）
2.8 任务 #8：本 DTL 日志¶
产物：docs/工作日志/dtl/L-20260821-05_新增需求报价单灵活部分+MFR开放报价功能.md（本文件）
三、本轮全部产物清单¶
| # | 文件路径 | 操作类型 | 说明 |
|---|---|---|---|
| 1 | docs/需求分析/业务级需求.md |
V2.0→V2.1 修改 | 新增 QSV-09/QSV-10 + §1.4/§1.5 详述 |
| 2 | docs/需求分析/执行级需求.md |
修改 | 新增 MFR-11 + QTE-08/QTE-09 |
| 3 | docs/报价服务/报价服务设计.md |
V1.0→V1.1 修改 | 新增灵活部分+开放报价服务边界+对接方案 |
| 4 | docs/报价服务/报价模型设计.md |
V3.0→V3.1 修改 | 新增 §十三 灵活部分参数体系 + §十四 开放报价参数精简版 |
| 5 | docs/业务测试/原型/mfr-portal/open-quote.html |
新建+修正 | MFR 开放报价页（6 区块完整流程 + sidebar 调用修正） |
| 6 | docs/业务测试/原型/cst-app/quote-detail.html |
新建 | CST 报价单详情页（含灵活部分展示） |
| 7 | docs/业务测试/原型/index.html |
修改 | 更新 MFR/CST 页面计数描述 |
| 8 | docs/业务测试/原型/assets/js/data.js |
修改 | WEAVELY_DATA.mfrMenu 追加「📄 开放报价」菜单项（id: MFR-OQ） |
四、修正记录（用户反馈后补齐）¶
4.1 问题现象¶
TL 反馈：进入 MFR 门户 dashboard.html 后，左侧 sidebar 看不到新增的「开放报价」功能链接入口。
4.2 根因定位¶
经排查共两处问题：
1. data.js 菜单缺失：WEAVELY_DATA.mfrMenu 数组（MFR 门户 sidebar 数据源）在新增 open-quote.html 后未追加对应菜单项，导致所有 MFR 页面 sidebar 均无法渲染该入口。
2. open-quote.html 调用错误：该页自行调用了不存在的函数 renderSidebar('open-quote') 与 renderTopbar()，正确应调用通用组件 renderWebSidebar(WEAVELY_DATA.mfrMenu, 'MFR-OQ') 与 renderWebTopbar(WEAVELY_DATA.brand, WEAVELY_DATA.accounts.mfr_01)，因此即使页面单独访问也无法渲染顶栏与侧栏。
4.3 修复动作¶
- 在
data.js的 mfrMenu「数据看板」分组内追加菜单项： - id:
MFR-OQ、name:开放报价、icon:📄、path:open-quote.html、reqIds:QSV-10,MFR-11,F-MFD-011 - 将
open-quote.html末尾的 sidebar/topbar 渲染代码替换为正确的通用组件调用，并传入 activeId=MFR-OQ以确保该页访问时菜单项高亮。
4.4 验证结果（浏览器自动化 4 项全通过）¶
| # | 用例 | 结果 |
|---|---|---|
| 1 | 访问 mfr-portal/dashboard.html，页面正常加载 | ✅ PASS |
| 2 | dashboard sidebar 在「📊 品牌驾驶舱」下方出现「📄 开放报价」菜单项，链接指向 open-quote.html | ✅ PASS |
| 3 | 点击该菜单项成功跳转至 open-quote.html 页面（标题更新正确） | ✅ PASS |
| 4 | open-quote.html sidebar 中「📄 开放报价」菜单项 class 为 web-sidebar-item active（高亮选中） |
✅ PASS |
4.5 Git commit 哈希¶
- 本轮产物首次提交：044eecb（已回填）
- DTL-05 哈希回填 + 日志完成：8cae650（已回填）
- sidebar 入口补齐修正：✅ 2b847e6（已回填，3 files changed, 45 insertions, 9 deletions）
五、关键设计决策¶
4.1 灵活部分费用项设计¶
| 决策点 | 听写方案 | 理由 |
|---|---|---|
| 灵活费用项数量 | 6 项（F01~F06） | 覆盖主要不确定场景，不过度复杂化 |
| 每项最高限价 | HKD 200~1,000 不等 | 按风险等级差异化设定 |
| 灵活部分总限价 | HKD 3,500（6 项之和） | 客户价格上限明确可控 |
| 结算依据 | CPT L6 现场证据 | 与 CPT-D 闭环对齐 |
| 管理费 | 灵活部分不参与平台管理费率乘法 | 按实际发生金额结算，避免双重计费 |
4.2 MFR 开放报价设计¶
| 决策点 | 听写方案 | 理由 |
|---|---|---|
| 注册方式 | 个人注册（手机/邮箱），不强制绑定企业 | 降低使用门槛 |
| 绑定 MFR | 可选，关联 PPL 档案 | 绑定后展示品牌徽章，激励 MFR 绑定 |
| 报价模型 | 与 CST 端共享 QMD 模型 | 确保报价一致性 |
| 输入字段 | 10 项精简输入（OQ-01~10） | 适合 MFR 员工快速操作 |
| 输出格式 | 页面展示 + PDF 下载 | PDF 供 MFR 直接发给 CST |
| 报价效力 | 参考报价，需 CST 确认后转订单 | 不直接生成订单，CST 有决策权 |
| 转订单流程 | CST 确认 → CPT L1 线索 → 正式订单 | 对齐 CPT 生命周期 |
六、Git Commit 哈希占位¶
执行：
git add docs/ && git commit -m "DTL-20260821-05: 新增QSV-09报价单灵活部分+QSV-10 MFR开放报价功能(需求/设计/原型全链路更新)"
commit 短哈希（7位）：✅ 044eecb（2026-08-21 19:45 已回填，8 files changed, 945 insertions, 14 deletions）
七、TL 下一步审阅指引¶
指引 1：需求与设计审阅¶
- 审阅重点：① QMD §十三 灵活部分 6 项费用项是否合理（单价/限价/结算依据）；② QMD §十四 开放报价输入字段 10 项是否完整；③ QSV-D §三 服务边界是否清晰
- 如需调整：听写下一轮按反馈修改
指引 2：原型审阅¶
- 审阅重点：① mfr-portal/open-quote.html 开放报价流程是否顺畅；② cst-app/quote-detail.html 灵活部分展示是否清晰
- 原型访问：从
docs/业务测试/原型/index.html进入，MFR 门户→开放报价；CST 客户端→报价单详情
本日志 L-20260821-05 = TL 新增 2 项需求（报价单灵活部分 + MFR 开放报价功能）的全链路落地工作留痕。需求→设计→原型三层文档同步更新。