cfc

亿图腾（北京）科技有限公司 — 浠艾福（Care Family）

企业官网

企业官网位于 web/ 目录，纯静态 HTML+CSS+JS，通过 nginx 部署。

• 域名： www.etotem.com.cn（HTTPS）
• 设计主色： #4A9BD7（Sky Blue） | 浅蓝背景 #F5FAFE | PingFang SC 字体
• 五维色系： 身 #FF8C42/土 · 智 #6366F1/金 · 富 #F59E0B/水 · 行 #10B981/木 · 心 #FF6B9D/火

---

项目简介

浠艾福（Care Family）— 给全家的一站式幸福提案

亿图腾科技倾力打造的家庭健康成长俱乐部，围绕 身·智·富·行·心 五大核心领域，以五行智慧为根基，以五维能量为引擎，为每个家庭定制全生命周期解决方案。

在充满变化的时代，一个家庭最顶级、最稳固的幸福——是身体的舒服长久，是下一代的大智慧，是长辈与家族的爱心传承，是知行合一的活力，更是衣食无忧的底气。

技术栈： Java 8 + Spring Boot 2.7.18 + MyBatis-Plus / uni-app Vue 2 小程序 / Vue 2 + Element UI Web管理端

---

幸福三支柱

三大目标支柱指引家庭幸福方向，扩展至五维行动体系落地执行：

目标支柱	映射五维（行动层）	核心解读
衣食无忧 （物质生存基础）	➡️ 身（主动健康）+ 富（利他创富）	身是无忧的根基——无病无灾才有底气；富是无忧的源泉——持续进账才有保障。两者结合，既保命又保财，构成家庭坚实的物理底盘。
受人尊敬 （社会价值认同）	➡️ 智（赋能未来）+ 行（人际和谐）	智是受人尊敬的内核——真才实学与健全人格赢得认可；行是受人尊敬的外显——和睦友善与广结善缘积累声望。内外兼修，社会价值自然彰显。
子女传承 （生命延续与期望）	➡️ 心（大爱相随）+ 智（赋能未来）	传承不仅是血脉，更是爱与智慧。心负责凝聚家族情感纽带，让子女感受温暖与归属；智负责赋予子女立足未来的核心竞争力，让传承有质量。

---

浠艾福 · 五维全景幸福矩阵

平台围绕五大维度构建完整的家庭成长指标体系，维度顺序遵循五行相生关系：

维度	五行	核心释义	核心功能
🌏 身	土 #FF8C42	主动健康 — 用最适合、最简单的方法（好水与精准营养），从根源调理家人体质，享受高质量的舒服长寿生活	精准营养推荐、健康报告解析、体质调理方案
⚔️ 智	金 #6366F1	赋能未来 — 通过专业心智测评与综合素质培养，开启青少年面向未来的大智慧、健全人格与核心竞争力	专业心智测评、综合素质培养、成长档案追踪
💧 富	水 #F59E0B	利他创富 — 依托低门槛创客成长生态，在利他分享中顺便实现家庭的"第二收入曲线"	创客成长生态、积分奖励体系、服务套餐市场
🌿 行	木 #10B981	人际和谐 — "行"的核心是人与人的关系：亲子关系、夫妻关系、同事关系、朋友关系，以和谐关系滋养家庭幸福	亲子关系建设、夫妻情感经营、社交与人脉拓展
🔥 心	火 #FF6B9D	大爱相随 — 以心理学视角解读自我与家人，用理解与包容滋养家庭情感，将长辈陪护与亲子之爱升华为以"心"传心的家族纽带	情绪认知与疏导、家庭关系心理学、人格与性格探索

五行相生相克 · 五维动态平衡

五维幸福并非各自孤立，而是像一个有机生态系统——相生让系统前进，相克让系统不翻车：

相生关系（身→智→富→行→心→身）：

• 身生智 → 智生富 → 富生行 → 行生心 → 心生身

相克关系（身克富、智克行、富克心、行克身、心克智）：

• 健康是最大财富，莫用健康换金钱
• 算计人际关系得失不如真诚以待
• 勿让铜臭掩盖温情，财富服务于家庭
• 人际有度，关爱有方，莫因取悦他人透支自身健康
• 大爱需留理性空间，不过度保护

每个服务实例可影响多个维度，能量值按比例分配至各维度，综合计算健康指数，直观呈现家庭成长状态。

---

业务模型

客户（家长）──消费──→ 服务商（规划师/活动方/供应商）
    │                        │
    │ 授权监护                │ 交付服务
    ▼                        ▼
  孩子（附属）──执行任务/接受服务──

  平台运营（管理员）── 审核 · 配置 · 数据支撑 ──→ 全链路

业务角色	系统角色	说明
客户	parent	付费决策者，管理家庭、审批任务、消费服务
客户附属	child	在家长监护下执行任务、接受服务
服务商	teacher / vendor_type	成长规划师、活动规划师、商品供应商等
平台运营	admin	审核、系统配置、数据管理

---

项目结构

cfc/
├── cfc-backend/                       # Spring Boot 后端
│   └── src/main/java/com/etotem/cfc/
│       ├── controller/                # 48 个控制器，按 15 个功能子包分组
│       │   ├── admin/                 # 运营管理（管理员）
│       │   ├── guide/                 # 服务商（规划师）服务
│       │   ├── auth/                  # 认证
│       │   ├── family/                # 家庭管理
│       │   ├── task/                  # 任务
│       │   ├── growth/                # 成长档案
│       │   ├── assessment/            # 测评预约/订单
│       │   ├── reward/ | wish/        # 心愿/奖励
│       │   ├── energy/                # 五维能量系统
│       │   ├── sncp/                  # 社区
│       │   ├── market/ | product/     # 商城/商品
│       │   ├── vendor/                # 服务商入驻
│       │   └── ...                    # payment, stats, streak 等
│       ├── service/                   # 业务逻辑层
│       ├── entity/                    # MyBatis-Plus 实体
│       ├── mapper/                    # MyBatis-Plus Mapper
│       ├── dto/                       # 数据传输对象
│       ├── config/                    # JWT / 多数据源 / 数据库初始化
│       └── common/                    # Result / JwtUtil
│
├── cfc-frontend/                      # uni-app 微信小程序（~50 页面）
│   ├── pages/                         # 页面组件
│   │   ├── index/                     # 角色分流首页（parent-index / child-index / teacher-index）
│   │   ├── parent/                    # 客户（家长）端
│   │   ├── child/                     # 附属（孩子）端
│   │   ├── teacher/ | guide/          # 服务商（规划师）端
│   │   ├── assessment/ | growth/      # 测评 / 成长档案
│   │   ├── tasks/ | rewards/ | wishes/# 任务 / 心愿
│   │   ├── games/                     # 小游戏（舒尔特/猜数字/数独）
│   │   ├── discover/ | shop/          # 发现 / 商城（TabBar）
│   │   ├── vendor/                    # 服务商入驻
│   │   └── profile/ | login/          # 个人 / 登录
│   ├── components/                    # 可复用组件（地址选择器、RelationshipPicker、wuxing-sandbox 等）
│   ├── store/                         # Vuex 角色状态管理
│   ├── pages.json                     # 页面注册（5 TabBar：行/身/智/心/富）
│   └── uni.scss                       # 设计 Token 体系
│
├── cfc-web/                           # Vue 2 + Element UI Web 管理端（29 页面）
│   └── src/
│       ├── views/                     # admin/* + teacher/*
│       ├── router/                    # 角色权限守卫路由
│       └── store/                     # 认证状态
│
├── web/                               # 企业官网（静态 HTML+CSS+JS）
│   ├── index.html                      # 官网主页面（导航/关于/产品/五维能量/幸福矩阵/功能/角色/联系方式）
│   ├── css/style.css                   # 完整响应式样式（品牌色 #FF8C42）
│   ├── js/main.js                      # 交互 + Canvas 五行图绘制
│   └── logo.png                        # 品牌 Logo
├── docs/                              # 需求 / 设计 / 测试文档
├── tests/                             # 分层测试（unit / integration / e2e）
└── .opencode/                         # AI 开发工具配置 + 角色定义

---

快速开始

环境要求

• JDK 1.8+ / Maven 3.6+ / MySQL 8.0+
• Node.js 14+ / 微信开发者工具

启动

# 1. 数据库
mysql -u root -p -e "CREATE DATABASE cfc CHARACTER SET utf8mb4"
mysql -u root -p cfc < cfc-backend/src/main/resources/schema.sql

# 2. 后端
cd cfc-backend
mvn clean install
mvn spring-boot:run          # localhost:9082

# 3. 小程序
cd cfc-frontend
npm install
npm run dev:mp-weixin

# 4. Web 管理端
cd cfc-web
npm install
npm run serve                # localhost:8082

---

核心功能模块

模块	功能	客户	附属	服务商	运营
认证	微信/手机登录、角色切换	●	●	●	—
家庭	家庭创建、成员邀请/管理、关系类型编辑、家庭关系图	●	○	○	●
任务	创建/下发、执行（含小游戏）、审核	●	●	●	●
积分	余额、流水、手动调整	●	●	—	●
心愿	创建心愿、兑换、审批	●	●	—	●
五维能量	能量发放/消耗、维度配置、健康指数	●	●	●	●
测评	预约、支付、结果录入、报告	●	●	●	●
成长档案	成长记录、成长计划	●	●	●	—
套餐市场	浏览、购买、服务套餐	●	—	●	●
消息	客户→服务商沟通	●	—	●	—
小游戏	舒尔特方格/猜数字/数独	—	●	—	—
商城	商品/服务浏览购买	●	●	●	●
运营管理	审核/配置/数据迁移	—	—	—	●

---

角色系统

客户（家长） role=parent

管理家庭、创建审批任务、购买套餐、预约测评、管理孩子账号、审批心愿兑换、查看家庭五维成长报告。

客户附属（孩子） role=child

在家长监护下执行任务、玩小游戏、兑换心愿、查看个人五维能量与成长报告。

服务商 role=teacher / vendor_type

• 成长规划师 teacher：创建套餐、绑定家庭、下发任务、录入测评结果
• 活动规划师 / 商品供应商 vendor_type：商品管理、订单处理

平台运营 role=admin

用户管理、家庭管理、审核入驻/套餐/商品、系统配置、数据迁移、操作日志。

---

API 接口概览

模块	控制器	端点
认证	AuthController	/api/auth/* — 登录/注册/切换角色
家庭	FamilyController	/api/family/* — 邀请码/绑定
家庭成员	FamilyMembersController	/api/family/member/* — 添加/编辑/切换/移除成员
任务	TaskController	/api/tasks/* — CRUD/审核/小游戏
心愿	WishController	/api/wishes/* — 创建/审批/兑换
五维能量	EnergyController	/api/energy/* — 概览/流水/配置
测评	AssessmentOrderController	/api/assessment/order/* — 订单/支付
测评	AssessmentAppointmentController	/api/assessment/appointment/* — 预约/确认
成长	GrowthRecordController	/api/growth/* — 记录/外部同步
服务商	GuideController	/api/guide/* — 入驻/套餐/邀请
服务商	GuideFamilyTaskController	/api/guide/families/* — 任务下发/批量审核
商城	ProductController	/api/product/* — 商品/订单
服务商入驻	VendorController	/api/vendor/* — 申请/状态
运营	AdminController	/api/admin/* — 审核/用户/配置

完整 API 清单见后端 Swagger 文档（启动后访问 http://localhost:9082/swagger-ui.html）。

---

UI 设计体系

小程序前端已建立统一设计 Token 体系：

Token	值	用途
--color-primary	#F97316 暖橙	主色调
--color-accent	#0EA5E9 蓝色	辅助色
--bg	#FFF7ED 暖白	背景色
--shadow-clay	双阴影	儿童端 Claymorphism 卡片
--shadow-md	单阴影	家长端/服务商端扁平卡片

---

开发规范

• 接口： 统一 @PostMapping，禁止 @GetMapping/@PutMapping/@DeleteMapping
• ORM： MyBatis-Plus @TableName + @TableId
• 响应： 统一 Result<T>（code / message / data）
• 认证： JWT Bearer Token，JwtInterceptor 拦截 /api/**（8 个公开路径除外）
• DI： @Resource，字段名匹配 Bean Name
• 角色控制： 控制器内手动检查 @RequestAttribute("role")
• 小程序限制： 禁止可选链 ?.（用 && 替代）、禁止 CSS Grid（用 flexbox）
• 小程序设计： Vue 2 Options API，不引入 Composition API

---

数据库

配置	值
主机	192.168.16.251:3306
库名	cfc
账号	cfc / cfc@123
角色	ENUM('parent','child','teacher','admin') + 多角色字段 roles
次级	vendor_type（planner / activity_provider / product_supplier）

---

企业官网部署

企业官网位于 web/ 目录，通过 nginx 部署：

域名	协议	指向	说明
www.etotem.com.cn	HTTPS	/app/cfc/web/	官网首页
www.etotem.com.cn/admin/	HTTPS	cfc-web/dist/	管理后台 SPA
cfc.etotem.com.cn	HTTPS	127.0.0.1:9082	后端 API 代理
111.228.6.214	HTTP	/app/cfc/web/	IP 直访官网

自签名证书位于 /etc/ohttps/certificates/etotem/。

小程序信息

• AppID： wx5ba8038ef16fb245
• TabBar： 行 / 身 / 智 / 心 / 富（对应五行相生：木·土·金·水·火）
• 自定义 TabBar： 角色感知（客户/附属/服务商显示不同内容）

---

许可证

MIT License