From 59f099e7c8d8443e6d8d9532ffde4518684177ad Mon Sep 17 00:00:00 2001 From: MaDaLei Date: Sat, 18 Apr 2026 17:36:18 +0800 Subject: [PATCH] =?UTF-8?q?=E6=9B=B4=E6=96=B0=E6=96=87=E6=A1=A3=202026-04-?= =?UTF-8?q?18=2017:36?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 产品改进建议.md | 2 +- 产品设计文档.md | 33 ++++++++++++++++++++++++--------- 2 files changed, 25 insertions(+), 10 deletions(-) diff --git a/产品改进建议.md b/产品改进建议.md index bbf9a05..385ad8f 100644 --- a/产品改进建议.md +++ b/产品改进建议.md @@ -64,7 +64,7 @@ v1 宠主多为「链接访客」，若不沉淀 openid/手机号，门店无法 |--------|------|------| | **本期** | **洗美过程短视频自动成片（15s MVP）** | **迭代重点**；与 §〇 专文一致，传播与差异化核心 | | P0 | 会员卡 / 储值 / 次卡 | 贴近门店现金流与粘性 | -| P0 | 按宠物维度的消费与服务历史 | 复购与情感连接 | +| P0 | 按宠物维度的消费与服务历史 | 复购与情感连接；**已做 MVP**：`/api/pet/history` + 我的宠物「服务记录」时间线（预约关联 `pet_id` + 报告）；**未含**金额/储值（见上条） | | P1 | 回访提醒池与自动化触达 | 依赖短信/公众号资质与合规 | | P1 | 轻收银 / 挂账 | 减少「系统 + 微信收款」双轨 | | P1 | 评价与口碑沉淀 | 与报告、海报寄语等联动 | diff --git a/产品设计文档.md b/产品设计文档.md index 07e640f..2956483 100644 --- a/产品设计文档.md +++ b/产品设计文档.md @@ -1,6 +1,6 @@ # 宠伴生活馆 - 产品设计文档 -> 版本：v1.6 +> 版本：v1.7 > 日期：2026-04-18 > 状态：产品设计确认中；**本期迭代重点：洗美过程短视频自动成片（15s MVP）** @@ -28,8 +28,8 @@ ## 二、核心功能闭环（v1） ``` -预约创建（老板/员工）→ 待确认 → 开始服务（谁点谁就是技师）→ 进行中 → 填写报告 → 发送报告 → 已完成 - ↘ 已取消 → 归到已完成Tab +预约创建（宠主/老板/员工，下单即生效）→ 待开始(new) → 开始服务（剪毛/正式开做时点击，谁点谁技师）→ 进行中(doing) → 填写报告 → 发送报告 → 已完成(done) + ↘ 已取消(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（待确认）→ cancel（已取消）→ 归到「已完成」Tab显示 -- doing（进行中）→ done（已完成） +**预约状态语义（与界面文案对齐）：** +- **new = 待开始**：下单即占号生效，**无**门店单独「确认接单」环节；到店、洗吹等若尚未到「开剪/正式开做」，仍属待开始。 +- **doing = 服务中**：店员在**剪毛/正式开做**时点击「开始服务」进入本状态。 +- **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）