|
|
@@ -1,13 +1,34 @@
|
|
|
-# 浠艾福 (XAF) - 家庭教育服务平台
|
|
|
+# 浠艾福(Care Family)— 家庭健康成长平台
|
|
|
|
|
|
## 项目简介
|
|
|
|
|
|
-浠艾福是一个三方平台型家庭教育服务系统,连接**客户(家长)**、**服务商(成长规划师/活动方/供应商)** 和**平台运营**三方角色。家长为孩子(附属用户)购买成长规划服务,服务商交付任务下发、测评、成长档案等专业服务,平台提供撮合与运营管理。
|
|
|
+浠艾福(Care Family)是一个以家庭为单位的健康成长平台,围绕**身、心、智、行、富**五个维度,通过活动、课程、商品、任务、咨询等多元服务,赋能每个家庭实现健康与幸福。平台连接**客户(家长)**、**服务商(成长规划师/活动方/供应商)** 和**平台运营**三方角色,以五维能量体系驱动全家持续成长。
|
|
|
|
|
|
**技术栈:** Java 8 + Spring Boot 2.7.18 + MyBatis-Plus / uni-app Vue 2 小程序 / Vue 2 + Element UI Web管理端
|
|
|
|
|
|
---
|
|
|
|
|
|
+## 品牌理念
|
|
|
+
|
|
|
+```
|
|
|
+浠艾福 = 浠(水润万物)艾(关爱)福(幸福)
|
|
|
+Care Family = 关爱每一个家庭
|
|
|
+```
|
|
|
+
|
|
|
+我们相信家庭的成长不只是孩子的教育,更是全家在五个维度上的共同提升:
|
|
|
+
|
|
|
+| 维度 | 代码 | 含义 |
|
|
|
+|:----:|:----:|------|
|
|
|
+| 🌏 **身** | body | 身体健康、活力充沛 |
|
|
|
+| 🔥 **心** | mind | 情绪管理、内心丰盈 |
|
|
|
+| ⚔️ **智** | wisdom | 认知提升、终身学习 |
|
|
|
+| 🌿 **行** | action | 行动力强、习惯养成 |
|
|
|
+| 💧 **富** | wealth | 财富素养、价值创造 |
|
|
|
+
|
|
|
+每个服务实例可影响多个维度,能量值按比例分配至各维度,综合计算健康指数,直观呈现家庭成长状态。
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
## 业务模型
|
|
|
|
|
|
```
|
|
|
@@ -15,7 +36,7 @@
|
|
|
│ │
|
|
|
│ 授权监护 │ 交付服务
|
|
|
▼ ▼
|
|
|
- 附属(孩子)─────执行任务/接受服务────
|
|
|
+ 孩子(附属)──执行任务/接受服务──
|
|
|
|
|
|
平台运营(管理员)── 审核 · 配置 · 数据支撑 ──→ 全链路
|
|
|
```
|
|
|
@@ -23,7 +44,7 @@
|
|
|
| 业务角色 | 系统角色 | 说明 |
|
|
|
|---------|---------|------|
|
|
|
| **客户** | `parent` | 付费决策者,管理家庭、审批任务、消费服务 |
|
|
|
-| **客户附属** | `child` | 无独立行为能力,在家长监护下执行任务、接受服务 |
|
|
|
+| **客户附属** | `child` | 在家长监护下执行任务、接受服务 |
|
|
|
| **服务商** | `teacher` / `vendor_type` | 成长规划师、活动规划师、商品供应商等 |
|
|
|
| **平台运营** | `admin` | 审核、系统配置、数据管理 |
|
|
|
|
|
|
@@ -44,6 +65,7 @@ cfc/
|
|
|
│ │ ├── growth/ # 成长档案
|
|
|
│ │ ├── assessment/ # 测评预约/订单
|
|
|
│ │ ├── reward/ | wish/ # 心愿/奖励
|
|
|
+│ │ ├── energy/ # 五维能量系统
|
|
|
│ │ ├── sncp/ # 社区
|
|
|
│ │ ├── market/ | product/ # 商城/商品
|
|
|
│ │ ├── vendor/ # 服务商入驻
|
|
|
@@ -67,7 +89,7 @@ cfc/
|
|
|
│ │ ├── discover/ | shop/ # 发现 / 商城(TabBar)
|
|
|
│ │ ├── vendor/ # 服务商入驻
|
|
|
│ │ └── profile/ | login/ # 个人 / 登录
|
|
|
-│ ├── components/ # 可复用组件(地址选择器、PlayfulButton、wuxing-sandbox 等)
|
|
|
+│ ├── components/ # 可复用组件(地址选择器、wuxing-sandbox 等)
|
|
|
│ ├── store/ # Vuex 角色状态管理
|
|
|
│ ├── pages.json # 页面注册(4 TabBar)
|
|
|
│ └── uni.scss # 设计 Token 体系
|
|
|
@@ -126,6 +148,7 @@ npm run serve # localhost:8082
|
|
|
| **任务** | 创建/下发、执行(含小游戏)、审核 | ● | ● | ● | ● |
|
|
|
| **积分** | 余额、流水、手动调整 | ● | ● | — | ● |
|
|
|
| **心愿** | 创建心愿、兑换、审批 | ● | ● | — | ● |
|
|
|
+| **五维能量** | 能量发放/消耗、维度配置、健康指数 | ● | ● | ● | ● |
|
|
|
| **测评** | 预约、支付、结果录入、报告 | ● | ● | ● | ● |
|
|
|
| **成长档案** | 成长记录、成长计划 | ● | ● | ● | — |
|
|
|
| **套餐市场** | 浏览、购买、服务套餐 | ● | — | ● | ● |
|
|
|
@@ -139,16 +162,20 @@ npm run serve # localhost:8082
|
|
|
## 角色系统
|
|
|
|
|
|
### 客户(家长) `role=parent`
|
|
|
-管理家庭、创建审批任务、购买套餐、预约测评、管理孩子账号、审批心愿兑换。
|
|
|
+
|
|
|
+管理家庭、创建审批任务、购买套餐、预约测评、管理孩子账号、审批心愿兑换、查看家庭五维成长报告。
|
|
|
|
|
|
### 客户附属(孩子) `role=child`
|
|
|
-在家长监护下执行任务、玩小游戏、兑换心愿、查看成长报告。不具备独立行为能力。
|
|
|
+
|
|
|
+在家长监护下执行任务、玩小游戏、兑换心愿、查看个人五维能量与成长报告。
|
|
|
|
|
|
### 服务商 `role=teacher` / `vendor_type`
|
|
|
+
|
|
|
- **成长规划师** `teacher`:创建套餐、绑定家庭、下发任务、录入测评结果
|
|
|
-- **活动规划师 / 活动服务商 / 商品供应商** `vendor_type`:商品管理、订单处理
|
|
|
+- **活动规划师 / 商品供应商** `vendor_type`:商品管理、订单处理
|
|
|
|
|
|
### 平台运营 `role=admin`
|
|
|
+
|
|
|
用户管理、家庭管理、审核入驻/套餐/商品、系统配置、数据迁移、操作日志。
|
|
|
|
|
|
---
|
|
|
@@ -161,6 +188,7 @@ npm run serve # localhost:8082
|
|
|
| 家庭 | `FamilyController` | `/api/family/*` — 邀请码/绑定 |
|
|
|
| 任务 | `TaskController` | `/api/tasks/*` — CRUD/审核/小游戏 |
|
|
|
| 心愿 | `WishController` | `/api/wishes/*` — 创建/审批/兑换 |
|
|
|
+| 五维能量 | `EnergyController` | `/api/energy/*` — 概览/流水/配置 |
|
|
|
| 测评 | `AssessmentOrderController` | `/api/assessment/order/*` — 订单/支付 |
|
|
|
| 测评 | `AssessmentAppointmentController` | `/api/assessment/appointment/*` — 预约/确认 |
|
|
|
| 成长 | `GrowthRecordController` | `/api/growth/*` — 记录/外部同步 |
|
|
|
@@ -169,8 +197,6 @@ npm run serve # localhost:8082
|
|
|
| 商城 | `ProductController` | `/api/product/*` — 商品/订单 |
|
|
|
| 服务商入驻 | `VendorController` | `/api/vendor/*` — 申请/状态 |
|
|
|
| 运营 | `AdminController` | `/api/admin/*` — 审核/用户/配置 |
|
|
|
-| 运营 | `AdminGuideController` | `/api/admin/guide/*` — 规划师审核 |
|
|
|
-| 运营 | `AdminPackageController` | `/api/admin/packages/*` — 套餐审核 |
|
|
|
|
|
|
完整 API 清单见后端 Swagger 文档(启动后访问 `http://localhost:8080/swagger-ui.html`)。
|
|
|
|
|
|
@@ -178,7 +204,7 @@ npm run serve # localhost:8082
|
|
|
|
|
|
## UI 设计体系
|
|
|
|
|
|
-小程序前端已完成视觉重设计,建立统一设计 Token 体系:
|
|
|
+小程序前端已建立统一设计 Token 体系:
|
|
|
|
|
|
| Token | 值 | 用途 |
|
|
|
|-------|----|------|
|
|
|
@@ -188,8 +214,6 @@ npm run serve # localhost:8082
|
|
|
| `--shadow-clay` | 双阴影 | 儿童端 Claymorphism 卡片 |
|
|
|
| `--shadow-md` | 单阴影 | 家长端/服务商端扁平卡片 |
|
|
|
|
|
|
-**已重设计页面(6页):** 客户首页、客户任务、客户心愿、家长首页、审批任务、五行能量沙盘组件
|
|
|
-
|
|
|
---
|
|
|
|
|
|
## 开发规范
|