feat(M03-A): 完成门店与房间基础管理

2026-06-18 14:55:04 +08:00
parent 47094d5309
commit 15139b3962
17 changed files with 1013 additions and 13 deletions
@@ -0,0 +1,26 @@
+# M03-A 门店与房间 API
+
+## 门店
+
+- `GET /admin-api/stores`
+- `POST /admin-api/stores`
+- `PUT /admin-api/stores/:id`
+- `DELETE /admin-api/stores/:id`：软删除；存在有效房间时拒绝。
+
+门店支持地址、经纬度、营业状态、时区、客服电话、Wi-Fi、通知地址、排序和每周营业时间。列表不返回 Wi-Fi 密码。
+
+## 房间
+
+- `GET /admin-api/stores/:storeId/rooms`
+- `POST /admin-api/rooms`
+- `PUT /admin-api/rooms/:id`
+- `DELETE /admin-api/rooms/:id?storeId=...`：软删除。
+- `POST /admin-api/rooms/:id/disabled-periods`
+
+房间支持类别、整数分价格、工作日/节假日/通宵价、押金、最低时长、提前规则、标签、图片和禁用时段。配置状态与运营状态独立保存。
+
+## 权限
+
+- 租户管理员管理本租户全部门店。
+- 门店管理员仅能读写授权门店。
+- 所有写操作记录审计日志。
@@ -0,0 +1,11 @@
+# M03-A 门店与房间数据库变更
+
+- 迁移版本：`2026061807`
+- 新表：`qipai_store_business_hours`
+- 新表：`qipai_room_categories`
+- 新表：`qipai_room_disabled_periods`
+- 扩展：`qipai_stores`、`qipai_rooms`
+
+价格与押金统一使用整数分，营业时间使用星期和分钟数。房间的 `configuration_status` 表示配置启停，`operational_status` 表示空闲、维修、预订、使用中或待清洁。
+
+回滚先删除禁用时段和房型表，再移除房间及门店新增字段；旧 `status` 字段继续保留兼容既有读取。
@@ -0,0 +1,29 @@
+# M03-A 门店与房间基础
+
+- 日期：2026-06-18
+- 起始 commit：`47094d5`
+- 工程 commit：本阶段工程提交
+- ENGINEERING_DELTA=YES
+- 子阶段状态：待 push 与远端校验
+
+## 工程增量
+
+- 门店 CRUD、每周营业时间、经纬度、时区、电话、Wi-Fi、通知地址和排序。
+- 房型与房间 CRUD，工作日/节假日/通宵价、押金、预约限制、标签和图片。
+- 房间配置状态与运营状态分离，支持维修禁用时段。
+- 租户管理员和门店管理员数据范围鉴权；写操作审计。
+- 数据删除采用软删除，门店仍有有效房间时禁止归档。
+
+## 验证
+
+- Windows `npm test`：M01-A 至 M03-A 全量测试通过。
+- WSL MySQL 8.4.9 临时库：`up → verify → down → up → verify` 通过。
+- 真实迁移语句：up 40、verify 23、down 37。
+- 实测营业时间、房型、价格、状态分离、禁用时段、审计和跨门店拒绝。
+
+## 影响
+
+- 数据库迁移：`2026061807_m03a_store_room_domain`。
+- API：新增门店与房间后台管理接口。
+- 配置：无新增环境变量或秘密。
+- 部署：生产迁移前必须备份，通过 Ubuntu 菜单执行。