301 lines
8.9 KiB
Markdown
301 lines
8.9 KiB
Markdown
# 宠伴生活馆 - 产品设计文档
|
||
|
||
> 版本：v1.5
|
||
> 日期：2026-04-01
|
||
> 状态：产品设计确认中
|
||
|
||
---
|
||
|
||
## 一、产品定位
|
||
|
||
**平台定位：** 宠物店服务管理 SaaS 平台，支持多家宠物店入驻
|
||
|
||
**目标用户（v1）：**
|
||
- 宠物店老板 / 员工（管理预约 + 填写报告）
|
||
- 宠主通过微信查看服务报告（v2）
|
||
|
||
**登录方式：**
|
||
- 微信授权登录（老板/员工主要登录方式）
|
||
- 手机号+短信验证码（备用）
|
||
|
||
---
|
||
|
||
## 二、核心功能闭环（v1）
|
||
|
||
```
|
||
预约创建（老板/员工）→ 待确认 → 开始服务（谁点谁就是技师）→ 进行中 → 填写报告 → 发送报告 → 已完成
|
||
↘ 已取消 → 归到已完成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 |
|
||
| before_photo | VARCHAR | 服务前照片URL |
|
||
| after_photo | VARCHAR | 服务后照片URL |
|
||
| 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_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（已完成）
|
||
- new（待确认）→ cancel（已取消）→ 归到「已完成」Tab显示
|
||
- doing（进行中）→ done（已完成）
|
||
|
||
**开始服务：**
|
||
- 点击「开始服务」→ 状态变为「进行中」
|
||
- assigned_user_id = 当前登录用户（谁点谁服务）
|
||
|
||
### 5.3 服务报告
|
||
|
||
**填写报告（进行中状态可操作）：**
|
||
- 服务前照片（必填）
|
||
- 服务后照片（必填）
|
||
- 备注（选填）
|
||
- 技师 = 开始服务时分配的用户
|
||
- 提交后锁死，不可再修改
|
||
- 一约一份报告
|
||
|
||
### 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 | H5报告页（品牌信息强化） | 🔨 本次 |
|
||
| P0 | H5报告页（链接+二维码） | ✅ |
|
||
| P0 | 老板后台（员工管理+邀请码） | ✅ 已合并到index.html |
|
||
| P0 | 老板后台（预约概览） | ✅ 已合并到index.html |
|
||
| P1 | 服务类型管理（老板后台） | ✅ |
|
||
| P1 | 店铺设置（老板后台） | ✅ |
|
||
| P1 | 本地文件上传（替代base64） | ✅ |
|
||
| P2 | 宠主端（历史报告汇总） | ⏳ v2 |
|
||
|
||
---
|
||
|
||
## 八、数据库变更
|
||
|
||
```sql
|
||
-- 预约表新增技师字段
|
||
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());
|
||
```
|
||
|
||
---
|
||
|
||
## 九、待确认/后续事项
|
||
|
||
- [ ] 宠伴生活馆 Logo 素材
|
||
- [ ] 图片存储方案（本地 / OSS）
|
||
- [ ] 短信验证码服务商接入
|
||
- [ ] 微信授权登录 AppID/AppSecret
|
||
- [ ] H5页面域名及部署方案
|
||
- [ ] 宠主端（v2）：历史报告汇总、宠主登录
|