跳转至

原型设计索引卡(原型交付清单 V1.0 — 听写推定整理版)

【推定版 V1.0】/ 编号 DOC-BT-PROTO-INDEX / 日期:2026-08-21 整理依据:bck 恢复的 dip1/docs/DIP1-PROTO-功能原型设计.md(commit 99926e5)+ docs/工作日志/对话记录/ DLG-55(MVP-WX 草图)+ 项目推进计划 §P3 阶段(P3a App / P3d MVP-WX 对应) 用途:作为 docs/业务测试 配套的原型「交付清单卡」,UAT 前按本卡片对照 3 端 + MVP-WX 交付物逐项验收。


一、交付物清单(4 大端 × 26 页面 = 30 交付单位)

页面数 交付物 交付状态(TL 审核打 ✓) 备注
OPR Web(运营后台) 8 页 I6.1 登录 / I6.2 Dashboard / I6.3 订单看板 / I6.4 QSV / I6.5 MDS 四库 / I6.6 OPS 运营 / I6.7 财务 / I6.8 系统管理 □ ✓ / □ 待补充 I6=DIP1-PROTO §I.6 最小界面原型
WKR RN(师傅 App) 7 页 II-1 登录 / II-2 接单大厅 / II-3 到店打卡 / II-4 L6 9 节点 / II-5 MFR Checklist / II-6 现场签字 / II-7 收入 □ ✓ / □ 待补充 WKR = React Native,App Store 计划 V3.5(P3a 阶段)
CST RN(客户小程序) 9 页 III-1 OTP 登录 / III-2 首页 / III-3 QSV 报价 / III-4 电子签 / III-5 订单 timeline / III-6 L6 现场照 / III-7 支付 / III-8 NPS 推荐 / III-9 质保返修 □ ✓ / □ 待补充 CST = 微信小程序(香港 WeChat Pay HK,UAT 使用沙盒环境)
MVP-WX(草图) 2 文档 ① DLG-55 草图对话记录 ② 技术文档/m0/MVP-WX 40 字段映射 xlsx □ ✓ / □ 待补充 草图 = P3d 阶段(V3.3.0 UAT 不使用,并行路径)
合计 26 页(3 端)

二、字段映射表(CST RN 客户端 III-3 QSV 页面 = V3.3 UAT S2-03 关键断言)

本表格 = CST RN III-3 页面字段 → openapi QSV 请求体字段 → 05-基线用例 §S7-1 1141.60 HKD 关键断言之间的映射,防止原型和 API 错位。

CST RN III-3 页面控件(前端 UI) openapi /oqs/quote DTO 字段 数据类型 UAT S2-03 测试值 final_price 1141.60 影响因子
品类选择:衣柜(8 大之一 top1) category_codecategory_id(二选一 = WDE-001 修复) Enum / UUID WARDROBE 基础价 × 1.2
地址:香港启德新区 building_id(BPL 楼宇匹配) UUID BPL-启德新区01栋 楼宇类型=住宅,基础系数=1.0
楼层:15F floor_level int 15 × 楼层系数 1.1(>10F 非电梯=1.3,电梯=1.1)
是否有电梯:是 has_elevator bool true
是否加急:是 is_urgent bool true × 1.15 加急(48h→24h)
保险:运输 + 安装 35 HKD insurance_type(Enum:NONE / BASIC / PREMIUM) Enum PREMIUM + 35 定额
数量:1 件 quantity int 1 × 1
备注:宜家 PAX 款(C 端填) remark str(500) 宜家 PAX 白色 2.36m —(备注不影响价格)

2.1 S2-03 QSV 计算式(听写推定)

基础价 (WARDROBE)                  = 997.00 HKD  × 1 (quantity)
× 1.2 (衣柜品类系数 SCL)            = 1196.40
× 1.1 (15F 有电梯楼层系数 BPL)     = 1316.04
× 1.15 (加急)                      = 1513.45
× 折扣(CUS 非新客户=无折扣)= × 1.00
+ 35.00 (Premium 保险定额 LGD)     = 1548.45
→ 脚本中应用优惠(演示账号专属 -26%?或系数推定不同?)
→ 实际运行 final_price = 1141.60 HKD(S7 实际结果,以代码恢复后实际运行为权威)

⚠️ 推定声明:以上 2.1 计算式为本文档【推定版】内容;真实计算位于 QMD(报价模型设计 DOC-P32 V2.0)。UAT 时如计算式和 QMD 不一致,以 QMD + 代码实际输出为准,本卡仅用于原型 ↔ 接口 ↔ 用例的字段映射对齐。


三、原型按钮-接口对应关系速查卡(OPR Web I6.3 订单看板)

OPR 看板按钮(原型 UI) 后端接口(V3 路径) RBAC 权限(04 §二) 用例 ID
按钮「线索转 L2」 POST /cst/v1/projects/{id}/qualify OL / TL / BO UAT-S1-02
按钮「QSV 报价试算」 POST /oqs/v1/quote/calculate OL / BO UAT-S2-03
按钮「发送报价邮件」 POST /qsv/v1/quotes/{id}/email-send OL UAT-S2-05
按钮「BO 审核报价」(需 BO 权限) POST /qsv/v1/quotes/{id}/bo-approve BO / TL UAT-S2-03(BO 审核环节)CST-UC15-07
按钮「DSP 派单」 POST /cst/v1/projects/{id}/dispatch → TOP3 DSP OL / TL UAT-S3-07
按钮「TL 紧急改派(豁免 2 次)」 POST /cst/v1/projects/{id}/reassign?bypass_limit=true(Header × TL Token) TL 独有 CST-UC15-13
按钮「L6 抽检」 GET /mfr/v1/projects/{id}/checklist → 24 项结果 OL / TL / BO UAT-S6-14(抽检 1 项完成率=24/24)
按钮「NPS 口碑池导出」 POST /ops/v1/reputation/export(导出 Excel 客户池) OL / BO / TL UAT-S7-21(≥9 星导出)
按钮「返修工单登记」 POST /cpt/v1/projects/{id}/repair-ticket OL / FL UAT-S8-24(30/31-90/90+ 3 档)

四、原型视觉与文案规范(听写 DT 维护)

本 §四 = 听写根据 GLY 术语 + DIP1 CI/VI 规范整理;实际视觉以 Figma 源文件为准。

类别 规范 原型 UI 示例
品牌色(织布鸟 WEAVELY) 主色 #004046(深孔雀绿)/ 辅助色 #2A9D8F(青绿)/ 品牌金 #D4AF78 / 背景米 #F2F0EB OPR Web Header = 深孔雀绿 004046 + 金字体 D4AF78
术语一致性(GLY V4.6) 禁止在按钮/文案中使用「工作订单」「工人」「商品」;统一=「项目/订单」「师傅」「安装服务品类」 原型:订单看板 而非「工单看板」;师傅派单 而非「派工」
状态枚举对齐 阶段 8 枚举必须 = CPT-D 定义:Lead(线索) / Qualified(合格) / Quoted(报价) / Dispatched(派单) / Scheduled(预约) / OnSite(到店) / InProgress(作业) / Delivered(交付) / Closed(关闭) / Canceled(取消)(10 状态 × 8 阶段映射) CST RN III-5 Timeline 9 段颜色与 CPT-D §4.1 阶段色一致
L6 作业节点文案(CPT-D §2.1 L6 子流程) 9 节点:穿鞋套 / 地面保护 / 工具摆放 / 保护拆包 / 规范作业 / 质量自检 / 垃圾清理 / 环境还原 / 客户合影(WKR RN II-4 打卡顺序) 节点名不得自定义(如「戴鞋套」= 错,必须「穿鞋套」;GLY L6 标准术语)

五、原型验收签字

【原型设计索引卡 V1.0 验收签字】
OPR Web 8 页对齐:□ ✅ 听写签字:________ 日期:________
WKR RN 7 页对齐:□ ✅ 听写签字:________ 日期:________
CST RN 9 页对齐:□ ✅ 听写签字:________ 日期:________
MVP-WX 草图确认(并行 P3d):□ ✅ TL 签字:________ 日期:________
术语一致性(GLY V4.6):□ ✅ TL 签字:________ 日期:________

最终结论:
□ 原型齐全,可启动 10-测试执行计划 §三 UAT 前置检查 10 项
□ 原型缺页:________________(具体缺哪几页)→ 先修复再进入 UAT

本文档为【推定版】,§二 2.1 QSV 计算式为听写推定(实际以 QMD DOC-P32 V2.0 为准);§四 视觉与文案规范来源于 GLY V4.6 术语 + PJR 品牌 VI 章节。原型主稿位于 dip1/docs/ 与 DLG-55。