cfc/docs/guide-requirements.md

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

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. 结算佣金
   - 按订单计算佣金
   - 团队业绩汇总