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

## 企业官网

企业官网位于 [`web/`](./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管理端

---

## 幸福三支柱

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

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

---

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

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

| 维度 | 五行 | 核心释义 | 核心功能 |
|:----:|:----:|----------|----------|
| 🌏 **身** | 土 `#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+ / 微信开发者工具

### 启动

```bash
# 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/*` — 概览/流水/配置 |
| 测评 | `DanAssessmentController` | `/api/dan-assessment/*` — 测评全链路(订单/预约/支付/结果) |
| 测评 | `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/`](./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