qipai/docs/devlogs/2026-06-24-M08-A-顾客端.md

M08-A 顾客端

本次工程增量

• 后端新增顾客端公开门店详情和房间列表接口：GET /app-api/stores/:storeId、GET /app-api/stores/:storeId/rooms，继续通过 x-wechat-appid 与可选 tenant-id 解析租户，房间只返回未删除且启用的公开数据。
• 小程序新增登录态封装，所有需登录接口自动携带 Authorization: Bearer <token>；首页门店卡片可进入门店详情。
• 门店详情页加载门店资料、公开房间列表和受控 Wi-Fi；Wi-Fi 只在登录后请求 /app-api/stores/:storeId/wifi。
• 房间详情页接入报价、预占、测试支付创建和测试支付回调完成，形成顾客端下单链路的本地可验证入口。
• 新增 scripts/check-miniapp-m08-a.mjs，检查小程序页面注册、固定生产 API 域名、登录和 M08-A 关键接口调用。

验收结果

• node scripts/check-miniapp-m08-a.mjs：PASS。
• npm run build（backend/）：PASS。
• node tests/store-discovery.test.mjs：PASS。
• node tests/pricing.test.mjs：PASS。
• node tests/payment.test.mjs：PASS。
• npm test（backend/）：PASS。

状态

M08-A 仍为 PARTIAL。本次完成顾客端第一段工程闭环，但订单列表、开门、续费、取消、换房、分享、余额、优惠券、套餐、个人中心、生产微信支付调起和真机合法域名验证仍未完成，游标继续停留在 M08-A。

提交

• 工程提交：4ac2c96
• 远端校验：push 后执行 HEAD == origin/main。

2026-06-24 续接：订单列表与详情

• 后端新增顾客端订单查询服务和路由：GET /app-api/orders、GET /app-api/orders/:orderId，按本人 qipai_order_user_access 与门店管理范围裁剪数据。
• 小程序新增 pages/orders/list 与 pages/orders/detail，可查看我的订单、订单详情、状态历史、取消测算和取消订单入口；房间预占成功后可直接进入订单详情。
• scripts/check-miniapp-m08-a.mjs 扩展检查订单页注册和订单相关真实 API 调用。

验收：

• node scripts/check-miniapp-m08-a.mjs：PASS。
• npm test（backend/）：PASS。

状态：

• M08-A 仍为 PARTIAL；开门、续费、换房、分享、余额、优惠券、套餐、个人中心、真实微信支付调起和真机合法域名验证待继续。