docs: sync report media model with current implementation

This commit is contained in:
malei 2026-04-16 23:44:34 +08:00
parent 9ee31e6f95
commit c431de023c

View File

@ -91,8 +91,6 @@
|------|------|------| |------|------|------|
| id | BIGINT | 主键 | | id | BIGINT | 主键 |
| appointment_id | BIGINT | 预约ID | | appointment_id | BIGINT | 预约ID |
| before_photo | VARCHAR | 服务前照片URL |
| after_photo | VARCHAR | 服务后照片URL |
| remark | TEXT | 备注 | | remark | TEXT | 备注 |
| user_id | BIGINT | 技师ID | | user_id | BIGINT | 技师ID |
| store_id | BIGINT | 店铺ID | | store_id | BIGINT | 店铺ID |
@ -104,6 +102,18 @@
| create_time | DATETIME | 创建时间 | | create_time | DATETIME | 创建时间 |
| update_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服务类型表 ### t_service_type服务类型表
| 字段 | 类型 | 说明 | | 字段 | 类型 | 说明 |
|------|------|------| |------|------|------|
@ -174,12 +184,15 @@
**填写报告(进行中状态可操作):** **填写报告(进行中状态可操作):**
- 服务前照片(必填) - 服务前照片(必填)
- 服务后照片(必填) - 服务后照片(必填)
- 服务过程中素材(选填,支持补充照片/短视频)
- 备注(选填) - 备注(选填)
- 技师 = 开始服务时分配的用户 - 技师 = 开始服务时分配的用户
- 提交后锁死,不可再修改 - 提交后锁死,不可再修改
- 一约一份报告 - 一约一份报告
> **规划延伸:** 洗美报告可增加「过程短视频 + 自动生成短视频成片」,产品边界与分镜见子文档 [《洗美报告短视频成片方案MVP](./洗美报告短视频成片方案.md)。 > **规划延伸:** 洗美报告可增加「过程短视频 + 自动生成短视频成片」,产品边界与分镜见子文档 [《洗美报告短视频成片方案MVP](./洗美报告短视频成片方案.md)。
>
> **实现对齐备注2026-04**:当前服务端已落库过程素材,报告查询接口对 `duringMedia` 的统一回传正在完善中。
### 5.4 发送报告v1 核心功能) ### 5.4 发送报告v1 核心功能)
@ -206,6 +219,7 @@
- 品牌头部:店铺 Logo + 店铺名称 + 联系电话 + 地址 - 品牌头部:店铺 Logo + 店铺名称 + 联系电话 + 地址
- 服务信息卡片:宠物名、服务项目、服务时间、技师名 - 服务信息卡片:宠物名、服务项目、服务时间、技师名
- 前后对比照片(并排展示) - 前后对比照片(并排展示)
- 服务过程中素材区(照片/短视频)
- 技师备注 - 技师备注
- 底部品牌信息(即使链接被转发,店铺信息持续透出) - 底部品牌信息(即使链接被转发,店铺信息持续透出)
@ -256,9 +270,11 @@
| P0 | 预约创建 | ✅ | | P0 | 预约创建 | ✅ |
| P0 | 开始服务(分配技师) | ✅ | | P0 | 开始服务(分配技师) | ✅ |
| P0 | 报告填写 | ✅ | | P0 | 报告填写 | ✅ |
| P0 | 报告过程素材上传(照片/短视频) | ✅ 基础能力已接入 |
| P0 | 发送报告(复制链接+下载二维码) | 🔨 本次 | | P0 | 发送报告(复制链接+下载二维码) | 🔨 本次 |
| P0 | H5报告页品牌信息强化 | 🔨 本次 | | P0 | H5报告页品牌信息强化 | 🔨 本次 |
| P0 | H5报告页链接+二维码) | ✅ | | P0 | H5报告页链接+二维码) | ✅ |
| P1 | 报告过程素材回传duringMedia | 🔨 进行中 |
| P0 | 老板后台(员工管理+邀请码) | ✅ 已合并到index.html | | P0 | 老板后台(员工管理+邀请码) | ✅ 已合并到index.html |
| P0 | 老板后台(预约概览) | ✅ 已合并到index.html | | P0 | 老板后台(预约概览) | ✅ 已合并到index.html |
| P1 | 服务类型管理(老板后台) | ✅ | | P1 | 服务类型管理(老板后台) | ✅ |
@ -292,6 +308,18 @@ INSERT INTO t_service_type (store_id, name, create_time) VALUES
(NULL, '洗澡+美容', NOW()), (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)
);
``` ```
--- ---