全局架构/ORDER/预约与本地服务交易

ARCHITECTURE DOSSIER · 05

预约与本地服务交易

发现、发布店铺、容量、预约状态与商家运营

MIXEDORDERCODE + RUNTIME + QA

ORDER · COMPONENT TOPOLOGYowner / runtime / truth state

01Client

Discovery / Shop / Wizardrunning

50 类目发现、服务选择、时间与客户信息

Booking WebHTML/JS web

02Edge

order.reits.techrunning

公开页面、API 路由与限流

Platform OpsNginx

03Service

Booking APIrunning

storefront、availability、booking、status token

Commerce Platformsystemd service

Merchant consolerunning

预约队列、容量、服务、审核与运营

Commerce Platformweb + API

Auth / Billing / Notificationrisk

身份、收费与触达

Shared platformsmixed / mock

04State

Booking PostgreSQLrisk

店铺、服务、容量、预约和状态

Commerce Platformsingle EC2

CRITICAL SEQUENCE

真实主链与事务边界

每一步都必须能回到调用方、契约、状态 owner 与失败证据；UI 只显示服务端已经确认的真值。

01
Discovery 返回类目、店铺与推广内容
02
用户打开 publishHash 店铺和服务
03
Availability 计算日期/时段与剩余容量
04
用户提交 intake 与幂等 key
05
事务复核价格、时段并创建预约
06
status token、商家队列与通知同步推进状态

INTERFACE REGISTER

跨项目接口与安全条件

producer、consumer、契约和 guard 同时登记；其中任何一列缺失都不能进入多团队并行开发。

ProducerVersioned contractConsumerSecurity / consistency guard

Discovery UIGET /api/discovery/*Booking API

public rate limit

Booking wizardPOST /bookings {service,slot,intake,idempotency}Booking API

schema + capacity transaction

Merchant consoleCustomerAction / OpsPacketBooking API

merchant session + project scope

STATE OWNERSHIP

数据真值与恢复

Storefront / services / capacitypublic-booking

STOREPostgreSQL

RETENTION商家生命周期

RECOVERY≤1h RPO target

Bookings / intakepublic-booking

STOREPostgreSQL

RETENTION隐私与业务策略

RECOVERYtransactional backup

Discovery eventspublic-booking

STOREanalytics tables

RETENTION最小化

RECOVERY可丢弃/重算

FAILURE MODEL

故障必须怎样收敛

TRIGGER时段在提交前被占用

SYMPTOM选择有效但创建冲突

CONTAIN事务返回可恢复冲突并刷新相邻时段

capacity conflict code

TRIGGER重复提交

SYMPTOM可能生成两笔预约

CONTAINidempotency key 返回原结果

request/result trace

TRIGGER通知失败

SYMPTOM预约成功但双方未收到

CONTAIN状态真值不回滚，通知异步重试

notification job

QA RELEASE GATES

不是画完架构图就算完成

这些门禁连接 UI 状态、接口负向路径、运行证据与可恢复性；发布证据必须绑定 exact commit。

ORDER-01

容量并发与幂等

高优先级集成测试

ORDER-02

客户字段最小化与脱敏

API + log audit

ORDER-03

商家跨项目访问拒绝

authz negative suite

ORDER-04

50 类目发现视觉回归

desktop + mobile

← 实时通信与端侧状态行情、策略与量化研究 →