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

> 版本：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）：历史报告汇总、宠主登录