# 2026-03-27 团期日历接口 + 参与家庭数 + 好评率默认 + 摄影跟拍改版

## 一、新增：小程序团期日历接口（PR #11）

原 `/internal/product/{id}/batches/calendar` 是内部接口，前端调会404。

**新接口**：`GET /mp/product/{productId}/batches/calendar`

经网关：`/product/mp/product/{productId}/batches/calendar`

返回：
```json
[{
  "departureDate": "2026-07-01",
  "batchId": "123",
  "batchLabel": "七月第一团",
  "startingPrice": 12800.00,
  "depositAmount": 3999.00,
  "enrolledCount": 15,
  "remainingSlots": 15,
  "isConfirmed": false
}]
```

## 二、新增：参与家庭数 + 好评率默认100%（PR #12）

产品详情 `GET /mp/product/{id}` 新增/修改字段：

| 字段 | 说明 | 示例 |
|------|------|------|
| `familyCount` | **新增**，参与家庭数（所有团期enrolled_count总和） | `47` |
| `reviewApprovalRate` | **修改**，无评价时默认"100%"，有评价才算实际好评率 | `"100%"` |

## 三、摄影跟拍改为分类模式（PR #13）

与安全保障/研学收获完全一致的分类+名称+描述模式。

### 管理端接口

| 方法 | 路由 | 说明 |
|------|------|------|
| GET | `/admin/product/{productId}/photography-item` | 列表 |
| POST | `/admin/product/{productId}/photography-item` | 添加 |
| PUT | `/admin/product/{productId}/photography-item/{id}` | 更新 |
| DELETE | `/admin/product/{productId}/photography-item/{id}` | 删除 |

### 请求体

```json
{
  "category": "全程跟拍",
  "name": "全程跟拍·记录每一个精彩瞬间",
  "description": "专业摄影师全程随行跟拍",
  "icon": "camera",
  "sortOrder": 1
}
```

### 字典

分类下拉使用字典 `photography_tag`（已配置）

### 小程序端

产品详情新增 `photographyItems` 字段：`[{icon, title, description}]`

旧的 `photographyTags`（标签列表）和 `photographyImages`（作品图）保留兼容。

## 部署说明

重启：**hl-product-service**