DFD-003:顾客小程序首选与备选原型收敛
历史决策:保留当时批准记录。f894dc7固定后,用户进一步授权清理其他原型,当前只维护一套消费者展示;redesign的展示资产已退役,业务资料与Git恢复保留。现行去留见清理记录。
状态:approved 日期:2026-09-21 决策人:对话中的人类(本轮确认) 适用模块:Customer Miniapp 前置记录:
docs_bak/design/decisions/DFD-002.md(历史输入)
1. 决策
顾客小程序活动设计只保留两套方向:
- 首选:
docs/design/prototypes/customer-miniapp/,最新同步的 H5 Concept Demo; - 备选:
docs/design/prototypes/customer-miniapp-redesign/,保留为可回退、可比较的 HTML/故事/动线场景包。
旧顾客端基线和组件化实验不作为活动入口;后台、团长和作业端原型是不同产品模块,不受本决策影响。
2. 依据与取舍
| 结论 | 依据 | 影响 |
|---|---|---|
| 最新 H5 作为首选 | 覆盖移动端核心体验、计划/配送确认和异常演示,并可由仓库内源码独立运行 | 顾客端后续体验讨论默认从 customer-miniapp/ 开始 |
| redesign 作为备选 | 已有完整 HTML、故事、动线和场景文件,适合作为回退与结构对照 | 不再作为默认方向,但保留完整可审查包 |
| H5 不等于产品实现 | H5 是 Vinext/Vite + React 概念 Demo,交易、支付、订单和售后均为 mock | 不把 H5 源码或 mock 业务逻辑直接放入 apps/customer-miniapp/ |
3. 门禁与边界
customer-miniapp/已按docs/rules/ui-prototype.md补齐模块入口、页面证据、stories、flows、scenario 四件套、fixture contract 和 cross-matrix。- 页面证据描述的是当前设计目标;真实 UI REQ 仍必须执行完整模块回归,不能以本决策代替 S2/S5/S7 证据。
- REQ-001 仍只实现工程骨架、五 Tab、悬浮购物车、PortalHost 和后台布局;H5 中的交易/支付/履约演示不进入该 REQ 的产品实现。
4. 恢复路线与残余风险
| 风险 / 触发条件 | 责任 | 恢复路线 |
|---|---|---|
| H5 的三 Tab/业务演示语义与小程序五 Tab 目标冲突 | PM / Architect | 以 customer-miniapp-redesign/ 的结构和场景包为回退基线,新增决策后再收敛 |
| 首选 H5 与后续真实 UI REQ 不一致 | Design / Document Verifier | 先更新当前模块包和回归证据,未完成前不得锁定受影响合同 |
| 外部 Sites 地址失效 | Design / Maintainer | 使用仓库内 source/dingwei-meat-market/ 本地运行快照;不依赖外部托管元数据 |
5. 变更记录
| 日期 | 决策 | 影响 |
|---|---|---|
| 2026-09-21 | 人类确认最新 H5 为首选、redesign 为备选,并将旧顾客端包移出活动目录 | 顾客端默认入口切换到 customer-miniapp/ |
| 2026-09-22 | 最新 commit 的 H5 源回填到 v0.2.0 活动模块包 | customer-miniapp/ 成为可审查 current-truth 包;历史完整备选仍留在 docs_bak/ |