更新文档 2026-04-18 17:36

产品改进建议.md

@@ -64,7 +64,7 @@ v1 宠主多为「链接访客」，若不沉淀 openid/手机号，门店无法
 |--------|------|------|
 | **本期** | **洗美过程短视频自动成片（15s MVP）** | **迭代重点**；与 §〇 专文一致，传播与差异化核心 |
 | P0 | 会员卡 / 储值 / 次卡 | 贴近门店现金流与粘性 |
-| P0 | 按宠物维度的消费与服务历史 | 复购与情感连接 |
+| P0 | 按宠物维度的消费与服务历史 | 复购与情感连接；**已做 MVP**：`/api/pet/history` + 我的宠物「服务记录」时间线（预约关联 `pet_id` + 报告）；**未含**金额/储值（见上条） |
 | P1 | 回访提醒池与自动化触达 | 依赖短信/公众号资质与合规 |
 | P1 | 轻收银 / 挂账 | 减少「系统 + 微信收款」双轨 |
 | P1 | 评价与口碑沉淀 | 与报告、海报寄语等联动 |

产品设计文档.md

@@ -1,6 +1,6 @@
 # 宠伴生活馆 - 产品设计文档
 
-> 版本：v1.6
+> 版本：v1.7
 > 日期：2026-04-18
 > 状态：产品设计确认中；**本期迭代重点：洗美过程短视频自动成片（15s MVP）**
 
@@ -28,8 +28,8 @@
 ## 二、核心功能闭环（v1）
 
 ```
-预约创建（老板/员工）→ 待确认 → 开始服务（谁点谁就是技师）→ 进行中 → 填写报告 → 发送报告 → 已完成
+预约创建（宠主/老板/员工，下单即生效）→ 待开始(new) → 开始服务（剪毛/正式开做时点击，谁点谁技师）→ 进行中(doing) → 填写报告 → 发送报告 → 已完成(done)
-                                                      ↘ 已取消 → 归到已完成Tab
+                                                                                              ↘ 已取消(cancel) → 在「已完成」Tab 与完成单并列展示
 ```
 
 **报告分享流程（v1 重点）：**
@@ -79,7 +79,7 @@
 | pet_type | VARCHAR | 宠物类型（猫/狗/其他） |
 | service_type | VARCHAR | 服务类型 |
 | appointment_time | DATETIME | 预约时间（无限制，随便选） |
-| status | VARCHAR | new / doing / done / cancel |
+| status | VARCHAR | new（待开始）/ doing（服务中）/ done（已完成）/ cancel（已取消） |
 | store_id | BIGINT | 店铺ID |
 | user_id | BIGINT | 创建人ID（谁建的） |
 | assigned_user_id | BIGINT | 技师ID（开始服务时赋值） |
@@ -171,15 +171,30 @@
 - 老板可在默认基础上新增/编辑/删除自定义服务类型
 - 员工只能使用，不能管理
 
-**预约状态流转：**
+**预约状态语义（与界面文案对齐）：**
-- new（待确认）→ doing（进行中）→ done（已完成）
+- **new = 待开始**：下单即占号生效，**无**门店单独「确认接单」环节；到店、洗吹等若尚未到「开剪/正式开做」，仍属待开始。
-- new（待确认）→ cancel（已取消）→ 归到「已完成」Tab显示
+- **doing = 服务中**：店员在**剪毛/正式开做**时点击「开始服务」进入本状态。
-- doing（进行中）→ done（已完成）
+- **done = 已完成**：提交服务报告时，后端将关联预约置为已完成（见 ReportService）。
+- **cancel = 已取消**：取消后在前端「已完成」Tab 中与完成单并列展示（含历史取消）。
 
 **开始服务：**
 - 点击「开始服务」→ 状态变为「进行中」
 - assigned_user_id = 当前登录用户（谁点谁服务）
 
+#### 预约状态迁移矩阵（产品规则 · 供开发/测试验收）
+
+| 当前状态 | 目标状态 | 触发 | 操作角色 | 备注 |
+|----------|----------|------|----------|------|
+| （创建） | new | 成功创建预约 | 宠主/老板/员工 | 下单即生效，占号 |
+| new | doing | 点击「开始服务」 | boss / staff | 建议在剪毛/正式开做时点击 |
+| new | cancel | 取消预约 | 宠主（C 端）/ 门店侧 | 业务可约定开始前可取消 |
+| doing | done | 提交服务报告（创建 Report） | boss / staff | 后端 `ReportService.create` 内将预约置 done |
+| doing | cancel | 取消（若允许） | 视业务 | **建议**：仅允许店长或限定条件，当前接口需防滥用 |
+| done | — | 终态 | — | 不回退 |
+| cancel | — | 终态 | — | 不回退 |
+
+**期望约束（建议在接口层逐步收紧）：** `new → doing` 仅当当前为 `new`；`doing → done` 由报告提交触发；取消仅允许自 `new` / `doing`（按产品最终规则）。当前部分接口未校验前置状态，以实际上线前补校验为准。
+
 ### 5.3 服务报告
 
 **填写报告（进行中状态可操作）：**
@@ -326,7 +341,7 @@ CREATE TABLE t_report_image (
 
 ---
 
-## 九、待确认/后续事项
+## 九、后续事项（开放清单）
 
 - [ ] 宠伴生活馆 Logo 素材
 - [ ] 图片存储方案（本地 / OSS）