From 725028cb2dacda53a6ac20c985005bb76a8323a7 Mon Sep 17 00:00:00 2001 From: Codex Date: Thu, 18 Jun 2026 16:07:48 +0800 Subject: [PATCH] =?UTF-8?q?docs(M04-A):=20=E8=AE=B0=E5=BD=95=E5=AE=9A?= =?UTF-8?q?=E4=BB=B7=E9=A2=84=E5=8D=A0=E9=AA=8C=E6=94=B6=E5=B9=B6=E6=8E=A8?= =?UTF-8?q?=E8=BF=9B=E6=B8=B8=E6=A0=87?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 6 +++--- docs/current-baseline.md | 2 +- docs/devlogs/2026-06-18-M04-A-定价与时段预占.md | 4 ++-- docs/feature-status.md | 1 + docs/module-status.md | 12 ++++++------ 5 files changed, 13 insertions(+), 12 deletions(-) diff --git a/README.md b/README.md index 09a2b81..bd25f9d 100644 --- a/README.md +++ b/README.md @@ -120,9 +120,9 @@ WSL 已验证：EMQX `5.8.9`、MQTTX CLI `1.13.0`、EMQX 服务 `active (running 项目已开发部分模块。具体完成度不得从 README 猜测，必须以现有代码、测试、数据库迁移、Git 历史以及 `docs/current-baseline.md`、`docs/module-status.md`、`docs/feature-status.md` 为准。 -- 当前执行游标：`M04-A` -- 最近工程提交：`d563078`，完成 M03-D 场景码、NFC 页面跳转和受控 Wi-Fi。 -- 下一工程目标：M04-A 统一定价、价格快照、并发时段锁和未支付预占释放。 +- 当前执行游标：`M04-B` +- 最近工程提交：`af7a45d`，完成 M04-A 定价快照、并发时段预占和过期释放。 +- 下一工程目标：M04-B 完整订单状态机、状态迁移历史和来源/原因审计。 ## 版本递进 diff --git a/docs/current-baseline.md b/docs/current-baseline.md index 75fc9bf..4647aaa 100644 --- a/docs/current-baseline.md +++ b/docs/current-baseline.md @@ -2,7 +2,7 @@ > V5.0 首次核验日期：2026-06-16 > audited_commit: `df373fa` -> next_engineering_target: M04-A 建立统一定价、价格快照、并发时段锁和未支付预占释放 +> next_engineering_target: M04-B 建立完整订单状态机、状态迁移历史和来源/原因审计 > 事实源：当前工作区、Git 历史、状态文档、Windows/WSL 检查脚本。 ## 总体结论 diff --git a/docs/devlogs/2026-06-18-M04-A-定价与时段预占.md b/docs/devlogs/2026-06-18-M04-A-定价与时段预占.md index 166c25d..7d6ccda 100644 --- a/docs/devlogs/2026-06-18-M04-A-定价与时段预占.md +++ b/docs/devlogs/2026-06-18-M04-A-定价与时段预占.md @@ -2,9 +2,9 @@ - 日期：2026-06-18 - 起始 commit：`6be7fa7` -- 工程 commit：本阶段工程提交 +- 工程 commit：`af7a45d` - ENGINEERING_DELTA=YES -- 子阶段状态：待 push 与远端校验 +- 子阶段状态：DONE，已 push 且 `HEAD == origin/main` ## 工程增量 diff --git a/docs/feature-status.md b/docs/feature-status.md index 9a97c69..01f282f 100644 --- a/docs/feature-status.md +++ b/docs/feature-status.md @@ -32,3 +32,4 @@ | MAP-001 | 地图选店和最近门店 | M03-C/M08 | PARTIAL | `df373fa` | 已实现 AppID/tenant 隔离门店发现、城市/营业筛选、按门店时区判断营业中、后端 Haversine 距离排序；小程序支持定位和手工城市降级。 | 地图 SDK 可视化和真机定位授权尚未验收。 | M08 接入地图界面并完成真机验证。 | | QR-001 | 门店/房间场景码与 NFC | M03-D/M08 | PARTIAL | `d563078` | 已实现场景码生成、重建失效、撤销、扫码统计和二维码/NFC 统一页面解析；返回权限固定为空，旧码失效已在 MySQL 8.4.9 实测。 | 真实微信小程序码图片生成依赖可用 AppSecret 与真机环境。 | M08 接入微信小程序码接口并完成真机扫描验收。 | | WIFI-001 | 受控 Wi-Fi 凭据 | M03-D/M04 | PARTIAL | `d563078` | 管理员按门店范围、顾客按有效订单授权和时间窗返回 Wi-Fi；无订单拒绝、有订单放行及审计不含密码已在 MySQL 8.4.9 实测。 | M04 尚未建立正式订单创建流程，当前先提供订单用户授权桥接表。 | M04 创建订单时写入/撤销用户访问授权，并补订单全生命周期测试。 | +| ORD-001 | 预约下单与多方式支付 | M04/M05 | PARTIAL | `af7a45d` | 已实现服务端小时/工作日/节假日/通宵/包场定价、最低消费、押金、价格快照、并发时段预占、过期释放和订单用户授权；MySQL 8.4.9 并发实测同一时段仅一个成功。 | 完整订单状态机、支付方式、优惠/套餐权益校验和支付回调尚未完成。 | M04-B 建立状态机和迁移历史，M05 接入可信支付与权益抵扣。 | diff --git a/docs/module-status.md b/docs/module-status.md index d409c9b..a5f6786 100644 --- a/docs/module-status.md +++ b/docs/module-status.md @@ -3,15 +3,15 @@ ```yaml execution_cursor: current_module: M04 - current_stage: M04-A + current_stage: M04-B stage_status: TODO - last_completed_stage: M03-D - next_stage: M04-A - last_engineering_commit: d563078 + last_completed_stage: M04-A + next_stage: M04-B + last_engineering_commit: af7a45d last_push_verified: true base_branch: main blocked_reason: "" - updated_at: 2026-06-18T15:57:38+08:00 + updated_at: 2026-06-18T16:07:11+08:00 ``` | 模块 | 状态 | 最近提交 | 最近开发日志 | 备注 | @@ -20,7 +20,7 @@ execution_cursor: | M01 后端 API 基础工程 | DONE | `2b90d1f` | docs/devlogs/2026-06-18-M01-C-轻量异步任务基础.md | 已完成 Fastify 后端骨架、数据库迁移兼容层，以及 MySQL outbox、幂等任务、租约领取、失败重试、人工补偿状态和独立 PM2 worker；WSL MySQL 8.4.9 往返迁移与 worker 重启持久性验证通过。 | | M02 登录、租户、权限 | DONE | `5a300a8` | docs/devlogs/2026-06-18-M02-D-用户与员工管理.md | M02-A/B/C/D 已完成租户、身份、可撤销会话、RBAC、门店数据范围、员工管理、禁用、会话重置和审计；Windows 全量测试与 WSL MySQL 8.4.9 往返迁移通过。 | | M03 门店、房间、价格、营业时间 | DONE | `d563078` | docs/devlogs/2026-06-18-M03-D-场景码NFC与WiFi.md | M03-A/B/C/D 已完成门店房间、装修广告、媒体、地图选店、场景码/NFC 页面导航和受控 Wi-Fi；真实微信小程序码图片生成留待 M08 真机联调。 | -| M04 订单、时段锁定、支付闭环 | TODO | - | - | 下一阶段 M04-A 统一定价、价格快照、并发时段锁和未支付预占释放。 | +| M04 订单、时段锁定、支付闭环 | PARTIAL | `af7a45d` | docs/devlogs/2026-06-18-M04-A-定价与时段预占.md | M04-A 已完成统一定价、不可变价格快照、事务房间锁、重叠预占拒绝和过期释放；下一阶段 M04-B 订单状态机。 | | M05 会员、余额、套餐、优惠券 | TODO | - | - | - | | M06 设备、MQTT 与真实硬件联动 | TODO | - | - | - | | M07 保洁、通知、任务和语音播报 | TODO | - | - | - |