# 商品详情

## 基本信息

| 项目 | 内容 |
| --- | --- |
| 路由 | `/pages/product-detail/product-detail` |
| 页面目标 | 查看和维护单个商品的基础资料、图文详情、购买须知与人才卡权益。 |
| 进入方式 | 商品管理列表中的任意商品。 |
| 负责人/更新时间 | 待指定 / 2026-07-27 |

## 功能点

| 编号 | 功能 | 说明 | 当前状态 |
| --- | --- | --- | --- |
| PD-001 | 商品基础资料 | 按当前商户范围内的商品 ID 加载名称、金额和封面图；名称、金额、封面必填，金额需大于 0 且最多两位小数。 | 已接入 |
| PD-002 | 图文详情 | 支持相册/拍照选择详情图片，单张不超过5MB、最多6张；真实模式先上传图片再保存。 | 已接入 |
| PD-003 | 购买须知 | 有效期、可用时间、使用方式及其他规则均已绑定表单模型。 | 前端已完成 |
| PD-004 | 人才权益 | 展示各人才卡可享价格、折扣与免费次数。 | 静态演示 |
| PD-005 | 保存与下架 | 保存会提交审核并自动转为下架待审核；下架使用独立接口，失败时保留原状态；修改失败保留本地草稿。 | 已接入 |
| PD-006 | 体检医院专属表单 | 商户类型为体检医院时不显示商品金额，改为必填的「可预约时间」（开始/结束日期，原生日期选择器）与检查项目表（名称、项目意义、适用性别）；可预约时间按「开始日期 至 结束日期」写入购买须知的 `validPeriod`。 | 已接入 |

## 接口与数据

| 数据项/动作 | 接口标识 | 参数 | 返回字段 | 状态 |
| --- | --- | --- | --- | --- |
| 商品详情 | `GET /api/merchant/products/{productId}` | 当前商户范围内的商品 ID | 基础资料、图片、购买须知、权益配置 | 已接入 |
| 更新商品 | `PUT /api/merchant/products/{productId}` | 商品 ID、表单字段、图片地址 | 商品详情、审核状态 | 已接入 |
| 商品下架 | `PATCH /api/merchant/products/{productId}/status` | `status: offline` | 最新商品状态 | 已接入 |
| 上传商品图片 | `POST /api/merchant/uploads/images` | 图片文件 | 文件地址、文件 ID | 已接入 |

## 验收清单

- [x] 从商品管理点击商品可进入详情，并可返回商品管理。
- [x] 已实现详情表单、图片区、购买须知、人才权益与固定底部操作栏视觉。
- [x] 已实现按商品 ID 初始化、表单绑定、金额/必填校验、本地草稿和未保存返回确认。
- [x] 已实现封面与详情图片本地选择、压缩、大小和数量校验。
- [x] 详情数据、图片上传、保存、下架及表单校验完成接口接入。
- [x] 体检医院的可预约时间两个日期选择器可选择并把结果回填到表单（提交前校验必填、结束日期不早于开始日期）。