# 成长规划师模块需求规格文档

## 1. 模块概述

成长规划师模块是知心益家系统的核心组成部分，为成长规划师提供家庭服务管理、套餐销售、团队管理等功能。成长规划师可以基于系统提供的服务内容模板，创建自己的服务套餐并销售给家庭用户。

## 2. 核心功能

### 2.1 服务内容管理（系统级）

#### 2.1.1 服务类型
- 支持服务分类（DAN测评、专属咨询、成长报告、家庭培训等）
- 每个类型有对应图标和描述
- 管理员可启用/停用服务类型

#### 2.1.2 服务内容（富文本）
- 每个服务有详细的内容说明，支持图文混排
- 包含：标题、内容（富文本HTML）、建议时长、适用年龄、参考价格
- 支持图片、视频嵌入
- 管理员可管理所有服务内容

### 2.2 套餐管理

#### 2.2.1 系统套餐模板（管理员）
- 系统提供标准套餐模板供成长规划师选择
- 模板包含：名称、有效期、参考价格、最低售价、包含服务项列表
- 模板状态：启用/停用

#### 2.2.2 成长规划师套餐
- 成长规划师基于系统模板创建自己的套餐
- 可自定义：套餐名称、销售价格
- 可勾选：包含哪些服务内容
- 套餐状态：草稿/已发布/已暂停

### 2.3 成长规划师工作台

#### 2.3.1 小程序端
- 成长规划师中心首页：展示个人信息、快捷入口、今日概览
- 我的家庭：服务家庭列表，可查看详情、发送消息
- 我的团队：下级成长规划师列表、团队业绩
- 消息中心：家长咨询、系统通知
- 套餐管理：创建/编辑/发布套餐
- 切换家长端：成长规划师可切换到家长身份

#### 2.3.2 Web管理端
- 成长规划师工作台：数据统计（服务家庭数、销售额、佣金等）
- 我的家庭：家庭列表、任务管理
- 我的团队：团队成员、业绩统计
- 消息中心：聊天界面
- 订单与佣金：订单列表、佣金明细

## 3. 数据模型

### 3.1 服务类型 (service_type)
| 字段 | 类型 | 说明 |
|------|------|------|
| id | Long | 主键 |
| name | String | 类型名称 |
| icon | String | 图标 |
| description | String | 描述 |
| sort_order | Integer | 排序 |
| status | String | ACTIVE/DISABLED |

### 3.2 服务内容 (service_content)
| 字段 | 类型 | 说明 |
|------|------|------|
| id | Long | 主键 |
| type_id | Long | 关联服务类型 |
| title | String | 内容标题 |
| content | String | 富文本内容(HTML) |
| duration | Integer | 建议时长(分钟) |
| age_range | String | 适用年龄 |
| price | Decimal | 参考价格 |
| status | String | DRAFT/ACTIVE |
| created_at | DateTime | 创建时间 |

### 3.3 套餐模板 (guide_package_template)
| 字段 | 类型 | 说明 |
|------|------|------|
| id | Long | 主键 |
| name | String | 模板名称 |
| validity_months | Integer | 有效期(月) |
| reference_price | Decimal | 参考价格 |
| min_price | Decimal | 最低售价 |
| description | String | 说明 |
| status | String | ACTIVE/DISABLED |

### 3.4 套餐模板服务项 (package_template_service)
| 字段 | 类型 | 说明 |
|------|------|------|
| id | Long | 主键 |
| template_id | Long | 关联模板 |
| content_id | Long | 关联服务内容 |
| quantity | Integer | 数量 |
| unit | String | 单位 |

### 3.5 成长规划师套餐 (guide_package)
| 字段 | 类型 | 说明 |
|------|------|------|
| id | Long | 主键 |
| teacher_id | Long | 成长规划师ID |
| template_id | Long | 关联模板 |
| name | String | 套餐名称 |
| price | Decimal | 销售价格 |
| validity_months | Integer | 有效期(月) |
| description | String | 套餐说明 |
| status | String | DRAFT/PUBLISHED/PAUSED |
| sales_count | Integer | 销量 |
| created_at | DateTime | 创建时间 |

### 3.6 成长规划师套餐服务项 (guide_package_service)
| 字段 | 类型 | 说明 |
|------|------|------|
| id | Long | 主键 |
| package_id | Long | 关联套餐 |
| content_id | Long | 关联服务内容 |
| quantity | Integer | 数量 |
| unit | String | 单位 |

## 4. 用户交互

### 4.1 小程序端页面

| 页面 | 路由 | 功能 |
|------|------|------|
| 成长规划师中心 | /pages/teacher/index | 个人信息、快捷入口、数据概览、切换家长端 |
| 我的家庭 | /pages/teacher/families | 服务家庭列表 |
| 我的团队 | /pages/teacher/team | 下级成长规划师、团队业绩 |
| 消息中心 | /pages/teacher/messages | 消息列表、聊天 |
| 套餐列表 | /pages/guide/packages/index | 我的套餐 |
| 创建套餐 | /pages/guide/packages/create | 基于模板创建套餐 |
| 套餐详情 | /pages/guide/packages/detail | 查看/分享套餐 |

### 4.2 Web端页面

| 页面 | 路由 | 功能 |
|------|------|------|
| 成长规划师工作台 | /teacher-dashboard | 数据统计、概览 |
| 我的家庭 | /teacher-families | 家庭列表、管理 |
| 我的团队 | /teacher-team | 团队成员、业绩 |
| 消息中心 | /teacher-messages | 消息、聊天 |
| 我的套餐 | /teacher-packages | 套餐管理 |
| 订单与佣金 | /teacher-orders | 订单、佣金 |
| 服务类型管理 | /admin/service-types | 系统服务类型 |
| 服务内容管理 | /admin/service-contents | 系统服务内容 |
| 套餐模板管理 | /admin/package-templates | 系统套餐模板 |

## 5. API接口

### 5.1 服务类型
- `GET /api/admin/service-types` - 获取服务类型列表
- `POST /api/admin/service-types` - 创建服务类型
- `PUT /api/admin/service-types/{id}` - 更新服务类型
- `DELETE /api/admin/service-types/{id}` - 删除服务类型

### 5.2 服务内容
- `GET /api/admin/service-contents` - 获取服务内容列表
- `POST /api/admin/service-contents` - 创建服务内容
- `PUT /api/admin/service-contents/{id}` - 更新服务内容
- `DELETE /api/admin/service-contents/{id}` - 删除服务内容

### 5.3 套餐模板
- `GET /api/guide/package-templates` - 获取套餐模板列表
- `GET /api/guide/package-templates/{id}` - 获取模板详情(含服务项)

### 5.4 成长规划师套餐
- `GET /api/guide/packages` - 获取我的套餐列表
- `POST /api/guide/packages` - 创建套餐
- `PUT /api/guide/packages/{id}` - 更新套餐
- `PUT /api/guide/packages/{id}/status` - 更新套餐状态
- `DELETE /api/guide/packages/{id}` - 删除套餐

### 5.5 成长规划师家庭
- `GET /api/guide/families` - 获取服务家庭列表
- `GET /api/guide/families/{id}` - 获取家庭详情

### 5.6 成长规划师团队
- `GET /api/guide/team` - 获取我的团队
- `GET /api/guide/team/invite-code` - 获取我的邀请码

### 5.7 消息
- `GET /api/guide/messages` - 获取消息列表
- `GET /api/guide/messages/{conversationId}` - 获取会话消息
- `POST /api/guide/messages` - 发送消息

### 5.8 订单
- `GET /api/guide/orders` - 获取订单列表
- `GET /api/guide/orders/stats` - 获取订单统计

## 6. 角色权限

| 角色 | 权限 |
|------|------|
| 管理员 | 服务类型/内容管理、套餐模板管理、成长规划师审核 |
| 成长规划师 | 创建套餐、管理家庭、团队管理、消息、查看订单佣金 |
| 家长 | 购买套餐、咨询成长规划师、查看服务内容 |

## 7. 业务流程

```
1. 管理员配置系统资源
   - 创建服务类型
   - 创建服务内容（富文本）
   - 创建套餐模板

2. 成长规划师创建套餐
   - 选择模板
   - 勾选服务内容
   - 设置价格（≥最低价）
   - 发布

3. 家长购买
   - 查看成长规划师套餐
   - 购买并支付
   - 获得服务

4. 成长规划师服务
   - 核销服务
   - 记录服务日志

5. 结算佣金
   - 按订单计算佣金
   - 团队业绩汇总
```