原型设计索引卡(原型交付清单 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_code 或 category_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。