petstore-docs/产品设计文档.md

宠伴生活馆 - 产品设计文档

版本：v1.7 日期：2026-04-18 状态：产品设计确认中；本期迭代重点：洗美过程短视频自动成片（15s MVP）

相关子文档：

• 洗美报告短视频成片方案（MVP） — 本期迭代主方案：过程短视频与 15s 自动成片（与 §5.3 服务报告延伸能力对应）
• 产品改进建议 — 中长期方向库；§〇 为本期重点说明

---

一、产品定位

平台定位： 宠物店服务管理 SaaS 平台，支持多家宠物店入驻

目标用户（v1）：

• 宠物店老板 / 员工（管理预约 + 填写报告）
• 宠主通过微信查看服务报告（v2）

登录方式：

• 微信授权登录（老板/员工主要登录方式）
• 手机号+短信验证码（备用）

---

二、核心功能闭环（v1）

预约创建（宠主/老板/员工，下单即生效）→ 待开始(new) → 开始服务（剪毛/正式开做时点击，谁点谁技师）→ 进行中(doing) → 填写报告 → 发送报告 → 已完成(done)
                                                                                              ↘ 已取消(cancel) → 在「已完成」Tab 与完成单并列展示

报告分享流程（v1 重点）：

填写报告（照片+备注）→ 点击「发送报告」→ 选择发送方式
                                         ├── 复制链接（发给宠主微信）
                                         └── 下载二维码（现场扫码）

---

三、数据模型

t_store（店铺表）

字段	类型	说明
id	BIGINT	主键
name	VARCHAR	店铺名称
logo	VARCHAR	店铺Logo
phone	VARCHAR	联系电话
address	VARCHAR	地址
intro	TEXT	简介
owner_id	BIGINT	老板用户ID
invite_code	VARCHAR	员工邀请码（8位）
create_time	DATETIME	创建时间
update_time	DATETIME	更新时间

t_user（用户表）

字段	类型	说明
id	BIGINT	主键
username	VARCHAR	用户名
password	VARCHAR	密码
name	VARCHAR	姓名/技师名
phone	VARCHAR	手机号
avatar	VARCHAR	头像
store_id	BIGINT	所属店铺
role	VARCHAR	boss / staff
create_time	DATETIME	创建时间
update_time	DATETIME	更新时间

t_appointment（预约表）

字段	类型	说明
id	BIGINT	主键
pet_name	VARCHAR	宠物名称
pet_type	VARCHAR	宠物类型（猫/狗/其他）
service_type	VARCHAR	服务类型
appointment_time	DATETIME	预约时间（无限制，随便选）
status	VARCHAR	new（待开始）/ doing（服务中）/ done（已完成）/ cancel（已取消）
store_id	BIGINT	店铺ID
user_id	BIGINT	创建人ID（谁建的）
assigned_user_id	BIGINT	技师ID（开始服务时赋值）
remark	TEXT	备注
create_time	DATETIME	创建时间
update_time	DATETIME	更新时间

t_report（报告表）

字段	类型	说明
id	BIGINT	主键
appointment_id	BIGINT	预约ID
remark	TEXT	备注
user_id	BIGINT	技师ID
store_id	BIGINT	店铺ID
report_token	VARCHAR	报告访问令牌（UUID，永久有效）
pet_name	VARCHAR	宠物名（冗余）
service_type	VARCHAR	服务类型（冗余）
appointment_time	DATETIME	服务时间（冗余）
staff_name	VARCHAR	技师名（冗余）
create_time	DATETIME	创建时间
update_time	DATETIME	更新时间

t_report_image（报告媒体表）

字段	类型	说明
id	BIGINT	主键
report_id	BIGINT	关联报告ID
photo_url	VARCHAR(500)	媒体URL
photo_type	VARCHAR(20)	before / after / during
sort_order	INT	同类型内排序序号
create_time	DATETIME	创建时间

说明：当前后端已按 photo_type 存储前后图与过程素材；media_type（photo/video）为前端语义，后端字段化会在后续迭代补齐。

t_service_type（服务类型表）

字段	类型	说明
id	BIGINT	主键
store_id	BIGINT	店铺ID（NULL表示系统默认）
name	VARCHAR	服务名称
create_time	DATETIME	创建时间

---

四、角色权限

功能	老板（boss）	员工（staff）
预约列表	✅	✅
新建预约	✅	✅
开始服务/填写报告	✅	✅
发送报告	✅	✅
员工管理	✅	❌
邀请码	✅	❌
店铺设置	✅	❌
服务类型管理	✅	❌

页面入口

• index.html（统一入口）：老板/员工同一套页面，通过「我的」页面区分功能
  • 老板「我的」：员工管理 / 服务类型 / 店铺设置 / 我的订单
  • 员工「我的」：我的订单

---

五、核心功能详解

5.1 登录体系

微信授权登录（主）

• 老板/员工均可使用微信授权登录

手机号+短信验证码登录（备用）

员工入职流程：

• 老板后台生成邀请码 → 员工点链接注册 → 自动关联店铺
• 老板后台直接新增员工 → 系统生成随机6位密码 → 员工用手机号+密码登录

5.2 预约管理

创建预约：

• 老板/员工均可手动创建
• 字段：宠物名字、宠物类型（猫/狗/其他）、服务类型、预约时间、备注
• 建档人 = 当前登录用户
• 预约时间无限制，随便选

服务类型：

• 系统默认：洗澡、美容、洗澡+美容、剪指甲、驱虫
• 老板可在默认基础上新增/编辑/删除自定义服务类型
• 员工只能使用，不能管理

预约状态语义（与界面文案对齐）：

• 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 服务报告

填写报告（进行中状态可操作）：

• 服务前照片（必填）
• 服务后照片（必填）
• 服务过程中素材（选填，支持补充照片/短视频）
• 备注（选填）
• 技师 = 开始服务时分配的用户
• 提交后锁死，不可再修改
• 一约一份报告

本期迭代重点： 洗美报告「过程短视频 + 自动生成 15s 竖屏成片」，产品边界、分镜、成本与工程机制见子文档 《洗美报告短视频成片方案（MVP）》。成片以模板化 FFmpeg 拼接为主，成片可在报告页/H5 播放与分享。

实现对齐备注（2026-04）：服务端已落库过程素材，报告查询接口对 duringMedia 的回传需与成片任务对齐；highlight_video_* 等字段承载成片 URL 与任务状态，本期需完成发起 → 异步生成 → 成功播放 / 失败提示闭环。

5.4 发送报告（v1 核心功能）

操作入口： 报告填写完成后，点击「发送报告」按钮

发送方式：

1. 复制链接 — 生成报告链接，一键复制到剪贴板，可发给宠主微信
2. 下载二维码 — 生成报告二维码图片，保存到相册，可打印或现场扫码

报告链接：

• URL：https://域名/report.html?token=xxx
• Token = UUID，永久有效
• 宠主打开无需登录（v1 免登录）

报告二维码：

• 扫码直接打开报告页
• 打印出来可贴在墙上/前台，方便宠主扫码

5.5 H5 报告页

访问方式： 链接或二维码扫码，免登录

报告页内容：

• 品牌头部：店铺 Logo + 店铺名称 + 联系电话 + 地址
• 服务信息卡片：宠物名、服务项目、服务时间、技师名
• 前后对比照片（并排展示）
• 服务过程中素材区（照片/短视频）
• 技师备注
• 底部品牌信息（即使链接被转发，店铺信息持续透出）

分享能力：

• 长按图片可保存
• 链接可复制转发微信

5.6 老板后台（合并到「我的」页面）

员工管理：

• 员工邀请码（复制分享）
• 新增员工（姓名+手机号，系统生成密码）
• 删除员工

服务类型：

• 新增服务类型
• 删除自定义服务类型（系统默认不可删）

店铺设置：

• 店铺名称
• 店铺Logo
• 联系电话
• 地址
• 简介

---

六、技术方案

端	技术
APP前端	uniapp + Vue3
H5报告页	Vue3（独立部署）
后端	Spring Boot 3.2 + JPA
数据库	MySQL
图片存储	本地存储（后续可平滑切换OSS）

---

七、开发进度

优先级	功能	状态
P0	老板入驻/登录	✅
P0	员工邀请码注册	✅
P0	员工登录（微信+验证码）	✅
P0	预约列表	✅
P0	预约创建	✅
P0	开始服务（分配技师）	✅
P0	报告填写	✅
P0	报告过程素材上传（照片/短视频）	✅ 基础能力已接入
P0	发送报告（复制链接+下载二维码）	🔨 本次
P0	H5报告页（品牌信息强化）	🔨 本次
P0	H5报告页（链接+二维码）	✅
P1	报告过程素材回传（duringMedia）	🔨 进行中
P0	洗美过程短视频自动成片（15s、模板拼接）	🔨 本期迭代重点
P0	老板后台（员工管理+邀请码）	✅ 已合并到index.html
P0	老板后台（预约概览）	✅ 已合并到index.html
P1	服务类型管理（老板后台）	✅
P1	店铺设置（老板后台）	✅
P1	本地文件上传（替代base64）	✅
P2	宠主端（历史报告汇总）	⏳ v2

---

八、数据库变更

-- 预约表新增技师字段
ALTER TABLE t_appointment ADD COLUMN assigned_user_id BIGINT COMMENT '技师ID';

-- 店铺表新增简介字段
ALTER TABLE t_store ADD COLUMN intro TEXT COMMENT '简介';

-- 服务类型表
CREATE TABLE t_service_type (
    id BIGINT PRIMARY KEY AUTO_INCREMENT,
    store_id BIGINT COMMENT '店铺ID，NULL表示系统默认',
    name VARCHAR(50) NOT NULL,
    create_time DATETIME
);

-- 系统默认服务类型
INSERT INTO t_service_type (store_id, name, create_time) VALUES
(NULL, '洗澡', NOW()),
(NULL, '美容', NOW()),
(NULL, '洗澡+美容', NOW()),
(NULL, '剪指甲', NOW()),
(NULL, '驱虫', NOW());

-- 报告媒体表（前后图 + 过程素材）
CREATE TABLE t_report_image (
    id BIGINT PRIMARY KEY AUTO_INCREMENT,
    report_id BIGINT NOT NULL COMMENT '关联报告ID',
    photo_url VARCHAR(500) NOT NULL COMMENT '媒体URL',
    photo_type VARCHAR(20) NOT NULL COMMENT 'before/after/during',
    sort_order INT DEFAULT 0 COMMENT '同类型排序',
    create_time DATETIME DEFAULT CURRENT_TIMESTAMP,
    INDEX idx_report_image_report_id (report_id),
    INDEX idx_report_image_report_type_sort (report_id, photo_type, sort_order)
);

---

九、后续事项（开放清单）

• 宠伴生活馆 Logo 素材
• 图片存储方案（本地 / OSS）
• 短信验证码服务商接入
• 微信授权登录 AppID/AppSecret
• H5页面域名及部署方案
• 宠主端（v2）：历史报告汇总、宠主登录