Explorar o código

docs: 品牌名统一为浠艾福(Care Family),重写README定位为家庭健康成长平台

User hai 3 meses
pai
achega
53e1e575e9
Modificáronse 1 ficheiros con 37 adicións e 13 borrados
  1. 37 13
      README.md

+ 37 - 13
README.md

@@ -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页):** 客户首页、客户任务、客户心愿、家长首页、审批任务、五行能量沙盘组件
-
 ---
 
 ## 开发规范