TARGETF4B2 PARTIALQA 0/5 VERIFIEDR04 · 5/21 PASS COMPLETEWeb · 选择服务和时段并提交联系与问卷信息的消费者

三步预约与提交

让服务选择、服务端时段、动态问卷和提交回执成为一条可恢复、可防重复的预约事务

/t/:publishHashpublic-booking-platform对照 CURRENT · booking-wizard →
R04 · KNIFE 5 / 21

三步预约与提交 · 页面级细化任务包

按服务、服务端时段、联系人和动态问卷完成一条可恢复、防重复的预约提交。

ENTRY

店铺 ServiceSelection、私密链接或受信宿主 deep link;项目、服务和链接状态由服务端重新校验。

SUCCESS OUTPUT

服务端返回 pending BookingReceipt 和私密状态入口;受理不冒充商家确认或服务履约。

TRANSACTION MODEL

BookingDraft → ServiceSelection → Availability → 目标 AvailabilityQuote → IntakeSchema → BookingSubmission → BookingReceipt;容量只在服务端判定。

RESPONSIVE + A11Y

桌面工作区 + 固定摘要;移动端三步纵向、主操作避开键盘,错误聚焦首个字段,返回修改不清空合法输入。

TELEMETRY

booking_wizard_view · step_change · slot_select · intake_error · submit_confirm · receipt_view;手机号、地址、问卷和 status token 不进埋点。

CURRENT SOURCE TRUTH6f3e62a
  • public-booking-platform 源码与 order.reits.tech EC2 immutable release 均为 6f3e62a
  • 生产 reits-order systemd 服务运行于 127.0.0.1:3210
  • 当前源码目录包含 111 个分类、109 个 demo family / 218 个 demo shops;生产 DiscoveryHome 当前曝光 51 分类、12 ranked、36 deals 与 50 shop-strip
  • 当前 Availability 返回 slots,但没有 quote_id/expires_at 冻结报价
  • 公共 POST `/api/projects/:projectId/bookings` 仍设置 requireIdempotency=false
IMPLEMENTATION GAPNOT PRODUCT UI
  • 公共 BookingSubmission 必须补强制 Idempotency-Key 与持久唯一约束
  • AvailabilityQuote 的 id、过期时间和 payload hash 尚未产品化
  • 容量竞态、未知网络结果、动态 Intake 和三视口证据未登记
目标事务合同与生产 current-sha 分开记录;未通过 B3/B4 不能作为产品完成证据。
45-STATE PROGRAM / THIS SCREEN

五页分别改变目录、店铺、容量、私密状态和宿主信任边界

QA 0 / 5 VERIFIED
READY预约草稿可以继续

草稿、服务、时段、问卷与摘要

BOOKING-WIZARD-READY→ 继续填写信息
LOADING正在恢复预约与服务端时段

BookingDraft + Availability

BOOKING-WIZARD-LOAD→ 返回店铺
EMPTY所选日期没有可用时段

Availability slots

BOOKING-WIZARD-NO-SLOTS→ 选择其他日期
PARTIAL ERROR时段可用,部分问卷说明加载失败

IntakeSchema 辅助字段

BOOKING-WIZARD-INTAKE-PARTIAL→ 重试问卷定义
ERROR提交未完成:容量或请求状态已变化

BookingSubmission / capacity

BOOKING-WIZARD-CAPACITY-CONFLICT→ 获取最新时段
OFFLINE离线保留非敏感预约草稿

Local BookingDraft

BOOKING-WIZARD-OFFLINE→ 重新连接
FORBIDDEN预约项目或私密链接不可用

Project / PrivateLink

BOOKING-WIZARD-LINK-DENY→ 返回公开店铺
CONFIRM提交这次预约请求?

BookingSubmission

BOOKING-WIZARD-SUBMIT-CONFIRM→ 确认提交预约
SUCCESS预约请求已受理

BookingReceipt

BOOKING-WIZARD-ACCEPTED→ 查看预约状态
BOOKING TRANSACTION BOUNDARY本刀只细化 developer.reits.tech 的预约消费者目标 UI;不创建生产预约,不读取私密状态 token,不调用客户动作,不把目标 AvailabilityQuote、幂等或宿主信任能力冒充为当前产品事实。
UI STUDIOtarget-booking-wizard
Web1440 × 900100%
100%
/t/:publishHash
TARGET UI1440 × 900FIT 100%
RREITS 服务可信本地服务我的
← 返回世田谷 CareDoor
BOOKING TRANSACTION · tokyo-care-setagaya上门护理 · CURRENT SERVICE
设计草稿 · Asia/Tokyo
STEP 2 OF 3 · TARGET TRANSACTION CONTRACT

选择上门时间

当前 Availability 返回 slots;提交前必须再次由服务端校验。

一二三四五六日
123456789101112131415161718192021222324252627282930313233
7 月 18 日 · 设计态时段 fixtureJST · 6 slots
当前接口以 slots 返回TARGET quote_id / expires_at · 尚未实现
R04 DESIGN CANDIDATE · target-booking-wizard · NOT PRODUCT UI
REFERENCE VIEWPORT1440 × 900Desktop first · responsive
PRIMARY TASK选择服务主操作、权限与完成反馈必须同屏可验证
DATA CONTRACTBookingDraftready / loading / empty / error 使用同一 fixture
ACCESSIBILITYKeyboard + WCAG AA焦点顺序、可读名称、对比度进入 UI CI
VISUAL BASELINETARGET · 2026-07-17桌面/移动、浅色/错误态按稳定 Screen ID 留档

IMPLEMENTATION MAP

目标定义与下一轮逐页细化入口

当前处于 B1/B2:可以拆出架构、设计、交互和 QA 任务,但完成 D01–D12、通过 B3/B4 之前,不得宣称页面已经可以照稿实现。

01

页面区域

  • 店铺与返回上下文
  • 步骤进度
  • 服务/时间/信息工作区
  • 容量状态
  • 动态问卷
  • 价格时长摘要
  • 政策确认
  • 主操作与结果
02

用户动作

  • 选择服务
  • 选择日期和时段
  • 填写 Intake
  • 返回修改
  • 确认政策
  • 幂等提交预约
03

必须状态

  • 预约草稿就绪
  • 服务/时段加载
  • 没有可用时段
  • 部分 Intake 失败
  • 提交或容量冲突
  • 离线草稿
  • 项目/链接受限
  • 提交预约确认
  • 预约已受理
04

数据契约

  • BookingDraft
  • AvailabilityQuote
  • ServiceSelection
  • IntakeSchema
  • BookingSubmission
  • IdempotencyKey
  • BookingReceipt
  • CapacityConflict

TARGET MODULES

目标页面必须交付的模块

  1. 01三步进度与草稿
  2. 02服务选择
  3. 03服务端日历与时段
  4. 04Availability quote 倒计时
  5. 05动态 Intake 字段
  6. 06联系人与通知同意
  7. 07订单摘要
  8. 08幂等提交与回执

PRODUCT ROUTE INDEX

预约平台 的 21 个稳定 Screen ID

同一产品内的页面共享 token、导航和状态语言,但每个 Screen ID 保留自己的字段、数据契约和 QA 基线。

01
发现好店/
Web
02
店铺详情/shop/:publishHash
Web
03
三步预约/t/:publishHash
Web
04
订单与预约状态/booking-status
Web
05
商家工作台/console?t=:hash
Admin
06
移动发现入口/mini
Miniapp
07
官方介绍页/official
Web
08
安全与隐私/security
Web
09
商家登录/console?t=:hash
Admin
10
本地服务发现/
Web
11
店铺与服务详情/shop/:publishHash
Web
12
三步预约与提交/t/:publishHash
Web
13
我的预约与自助管理/booking-status
Web
14
Mini App 宿主预约/mini
Miniapp
15
商家身份与店铺选择/merchant/sign-in
Admin
16
商家今日工作台/merchant/:projectId/today
Admin
17
预约审核与决策/merchant/:projectId/bookings
Admin
18
排班与容量规划/merchant/:projectId/schedule
Admin
19
服务与价目目录/merchant/:projectId/services
Admin
20
店铺内容与发布/merchant/:projectId/storefront
Admin
21
店铺设置与渠道治理/merchant/:projectId/settings
Admin