Переглянути джерело

docs: 新增五维五行哲学体系设计规范,更新能量设计文档对照

User 3 місяців тому
батько
коміт
6054b47784

+ 30 - 28
docs/superpowers/specs/2026-06-05-five-dimension-energy-design.md

@@ -8,6 +8,8 @@
 
 本项目服务于身、心、智、行、富五个维度,服务内容包括活动、课程、商品、任务、咨询五大类。每个服务实例可影响多个维度,能量值按比例分配。能量系统为全新独立系统,与现有积分系统并行但解耦。
 
+> **哲学基础:** 五维之间的相生相克关系详见 [`2026-06-08-five-dimension-wuxing-philosophy.md`](./2026-06-08-five-dimension-wuxing-philosophy.md)。所有维度顺序、健康指数算法、内容推荐策略均以此为依据。
+
 ### 关键决策
 
 | 决策项 | 结论 |
@@ -32,14 +34,14 @@
 | sort_order | INT | 显示顺序 |
 | status | TINYINT DEFAULT 1 | 1启用/0禁用 |
 
-种子数据:
+种子数据(排序遵循相生链:智→富→行→心→身,详见[五维五行哲学体系](./2026-06-08-five-dimension-wuxing-philosophy.md))
 
 | code | name | icon | element | sort_order |
-|------|------|------|---------|------------|
-| mind | 心 | 🔥 | 火 | 1 |
-| action | 行 | 🌿 | 木 | 2 |
-| wealth | 富 | 💧 | 水 | 3 |
-| wisdom | 智 | ⚔️ | 金 | 4 |
+|------|------|------|---------|:----------:|
+| wisdom | 智 | ⚔️ | 金 | 1 |
+| wealth | 富 | 💧 | 水 | 2 |
+| action | 行 | 🌿 | 木 | 3 |
+| mind | 心 | 🔥 | 火 | 4 |
 | body | 身 | 🌏 | 土 | 5 |
 
 ### 1.2 energy_source_config — 服务-维度比例配置表
@@ -97,19 +99,11 @@ GET /api/energy/overview?childId=123
   "data": {
     "dimensions": [
       {
-        "code": "mind",
-        "name": "心",
-        "icon": "🔥",
-        "element": "火",
-        "energy": 280,
-        "healthIndex": 0
-      },
-      {
-        "code": "action",
-        "name": "行",
-        "icon": "🌿",
-        "element": "木",
-        "energy": 350,
+        "code": "wisdom",
+        "name": "智",
+        "icon": "⚔️",
+        "element": "金",
+        "energy": 310,
         "healthIndex": 0
       },
       {
@@ -121,11 +115,19 @@ GET /api/energy/overview?childId=123
         "healthIndex": 0
       },
       {
-        "code": "wisdom",
-        "name": "智",
-        "icon": "⚔️",
-        "element": "金",
-        "energy": 310,
+        "code": "action",
+        "name": "行",
+        "icon": "🌿",
+        "element": "木",
+        "energy": 350,
+        "healthIndex": 0
+      },
+      {
+        "code": "mind",
+        "name": "心",
+        "icon": "🔥",
+        "element": "火",
+        "energy": 280,
         "healthIndex": 0
       },
       {
@@ -223,12 +225,12 @@ void configureSourceRatios(String sourceType, Long sourceId, String sourceName,
 
 ## 3. 前端可视化设计
 
-### 3.1 五角形布局(从顶点顺时针)
+### 3.1 五角形布局(从顶点顺时针,遵循相生链:智→富→行→心→身
 
 ```
-        顶: 心·火
-    左上: 行·木  右上: 富·水
-    左下: 智·金  右下: 身·土
+        顶: 智·金
+    左上: 富·水  右上: 行·木
+    左下: 心·火  右下: 身·土
 ```
 
 ### 3.2 三层视觉结构

+ 150 - 0
docs/superpowers/specs/2026-06-08-five-dimension-wuxing-philosophy.md

@@ -0,0 +1,150 @@
+# 五维全景 · 五行哲学体系
+
+**日期:** 2026-06-08
+**状态:** 已确认
+**版本:** v1.0
+
+---
+
+## 概述
+
+浠艾福五维全景幸福矩阵以**五行(金木水火土)**为哲学基础,建立五维之间的相生与相克关系。五维并非各自孤立,而是像一个有机生态系统——相生让系统前进,相克让系统不翻车。这套体系是后续所有能量算法、健康指数计算、产品与服务设计的理论根基。
+
+---
+
+## 1. 五维 ↔ 五行对应关系
+
+| 五维 | 五行 | 五行特性 | 相生关系 |
+|:----:|:----:|----------|----------|
+| **智**(赋能未来) | **金** | 金主义,刚健、锐利、珍贵。智慧如金石,能开凿财富之门。 | 金生水 → **智生富** |
+| **富**(利他创富) | **水** | 水主智,亦主流动、滋养、生财。财富如水,顺势而为,利他而丰。 | 水生木 → **富生行** |
+| **行**(快乐知行) | **木** | 木主生发、舒展、行动。有财富支撑,实践更自由,活力如草木生长。 | 木生火 → **行生心** |
+| **心**(子女传承) | **火** | 火主礼,光明、温暖、传递。家族大爱如火焰,以心传心,生生不息。 | 火生土 → **心生身** |
+| **身**(主动健康) | **土** | 土主承载,脾胃之本,健康之基。身心安定,方能孕育智慧。 | 土生金 → **身生智** |
+
+### 相生链
+
+```
+智(金) ──生──→ 富(水) ──生──→ 行(木) ──生──→ 心(火) ──生──→ 身(土) ──生──→ 智(金)
+```
+
+相生的核心价值:**循环促进,生生不息**。每个维度都在为下一个维度积蓄能量,形成正向螺旋上升。
+
+---
+
+## 2. 相克关系(正向解读)
+
+| 相克 | 对应五维互动 | 平衡意义("克"的正向解读) |
+|:----:|-------------|---------------------------|
+| **木克土**(行克身) | 快乐行动 对 身体健康的制约 | 运动、户外活动过度会损耗身体(如运动损伤、过度疲劳)。提醒"行"要有度,避免透支健康。 |
+| **土克水**(身克富) | 身体健康 对 财富追求的制约 | 身体若出问题,会直接消耗财富(医疗开支、收入中断)。警示不能为求富而牺牲健康,健康是财富的"刹车"。 |
+| **水克火**(富克心) | 物质财富 对 家族爱心传承的制约 | 过度追逐财富容易让人冷漠、疏于陪伴家人,冲淡温情与孝道。提醒"富"要服务于"心",莫让铜臭覆盖大爱。 |
+| **火克金**(心克智) | 情感与传承 对 智慧培养的制约 | 过分沉溺于家族情感、家长制关怀,可能会压制孩子独立智慧的成长(如过度保护、代替决策)。提醒爱心需留出理性空间。 |
+| **金克木**(智克行) | 智慧规划 对 快乐行动的制约 | 过于精密的计划、心智测评、理性分析,可能让人失去随性实践的快乐,陷入"想太多而做太少"。提醒智慧要为行动松绑。 |
+
+### 相克循环
+
+```
+行(木) ──克──→ 身(土) ──克──→ 富(水) ──克──→ 心(火) ──克──→ 智(金) ──克──→ 行(木)
+```
+
+---
+
+## 3. 相生相克总图
+
+```
+              相生 → (促进)
+              相克 → (制约)
+              
+                    智(金)
+                   ↙    ↘
+                生       克
+               ↙            ↘
+      身(土) ←                 → 富(水)
+              ↘              ↙
+                克         生
+                  ↘      ↙
+                    行(木)
+                    ↓  生
+                    ↓
+                    心(火)
+                    ↓  生
+                    ↓
+                    身(土)
+                    ↓
+                    身生智 → (循环)
+```
+
+---
+
+## 4. 核心哲学:动态平衡,过犹不及
+
+五维幸福并非各自无限放大,而是像**一辆五轮马车**:
+
+- **相生让车前进** — 各维度互相滋养,形成正向循环
+- **相克让车不翻** — 每个维度都有其制约机制,防止任何一维过度膨胀
+
+### 五条平衡法则
+
+| 法则 | 含义 | 应用场景 |
+|------|------|----------|
+| 行克身 | 不要为了活动透支体力 | 活动设计需考虑适龄、适量,避免过度消耗 |
+| 身克富 | 不要用健康换金钱 | 产品推荐需平衡健康价值与商业利益 |
+| 富克心 | 不要让财富吞噬亲情 | 创客生态需强调家庭陪伴优先于创收 |
+| 心克智 | 不要让感情遮蔽理性 | 家庭教育需平衡关爱与独立成长空间 |
+| 智克行 | 不要让计划杀死行动力 | 测评结果应导向行动建议,而非停留在分析 |
+
+---
+
+## 5. 对系统设计的指导
+
+### 5.1 维度顺序
+
+五维在系统中的默认排序遵循**相生链**:
+
+```
+智 → 富 → 行 → 心 → 身
+```
+
+### 5.2 健康指数算法原则
+
+健康指数的计算应体现相生相克关系:
+
+- **相生加分**:若某维度能量高,其"生"的目标维度可获得一定加成(如智高则富的增长有增益)
+- **相克扣分**:若某维度能量远高于其"克"的目标维度,应触发平衡扣分(反映过度失衡)
+- **理想状态**:五维能量分布相对均衡,而非某一维独大
+
+> 具体算法待定,本原则为算法设计的理论依据。
+
+### 5.3 内容与服务推荐
+
+推荐算法可参考相生关系做交叉推荐:
+
+- 用户在"智"维度参与度高 → 推荐"富"维度相关内容(智生富)
+- 用户在"行"维度活跃 → 提醒关注"身"维度状态(行克身,需平衡)
+- 用户在"富"维度获得收益 → 引导参与"行"维度活动(水生木)
+
+### 5.4 数据模型中的五行字段
+
+`energy_dimension` 表的 `element` 字段直接使用五行值:
+
+| code | element |
+|------|---------|
+| wisdom | 金 |
+| wealth | 水 |
+| action | 木 |
+| mind | 火 |
+| body | 土 |
+
+---
+
+## 6. 与品牌理念的融合
+
+```
+浠艾福 = 浠(水润万物)艾(关爱)福(幸福)
+
+五行之水对应"富"维度——利他创富,滋养家庭。
+浠字本义即为水润万物,与品牌名天然契合。
+```
+
+五维五行体系不仅是系统设计的基础,也是品牌叙事的核心。对外传播时,可将五维与五行结合呈现,增强文化深度与记忆点。