# DFD-003：顾客小程序首选与备选原型收敛

> 历史决策：保留当时批准记录。f894dc7固定后，用户进一步授权清理其他原型，当前只维护一套消费者展示；redesign的展示资产已退役，业务资料与Git恢复保留。现行去留见[清理记录](../prototypes/CLEANUP.md)。

> 状态：approved
> 日期：2026-09-21
> 决策人：对话中的人类（本轮确认）
> 适用模块：Customer Miniapp
> 前置记录：`docs_bak/design/decisions/DFD-002.md`（历史输入）

## 1. 决策

顾客小程序活动设计只保留两套方向：

1. **首选**：`docs/design/prototypes/customer-miniapp/`，最新同步的 H5 Concept Demo；
2. **备选**：`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/` |