# 文档变更记录

## 2026-06-14 — 文档归档整理

### 变更说明

为消除开发干扰，将历史需求和设计文档迁移至 `docs/backup/`，主目录仅保留最新版本的文档。

### 保留的文档

| 目录 | 文件 | 说明 |
|------|------|------|
| `需求分析/` | `底签页面详细设计.md` | 5个 TabBar 页面详细设计 v2.0（含首页/身泰/心智/行远/富沛） |
| | `TabBar重构需求.md` | 5-Tab 重构原始需求 |
| | `健康能量设计.md` | 五维能量系统设计 |
| | `会员与分销体系设计.md` | 会员等级与分销体系 |
| `系统设计/` | `小程序页面重设计划.md` | 小程序页面改造规划 |
| `设计/` | `角色权限-UC矩阵-v2.md` | 角色权限矩阵 |
| `superpowers/specs/` | `2026-06-13-five-dimension-pages-redesign.md` | **三页统一改造设计**（含堆叠图、游客模式、权限模型） |
| | `2026-06-04-pre-login-discovery-design.md` | 登录前浏览设计 |
| | `2026-06-02-care-family-club-design.md` | 平台升级设计规格（哲学/架构） |
| | `2026-06-05-five-dimension-energy-design.md` | 五维能量系统设计 |
| | `2026-06-08-article-publishing-system-design.md` | 文章发布系统设计 |
| | `2026-06-08-five-dimension-wuxing-philosophy.md` | 五行哲学对照 |
| `superpowers/plans/` | `2026-06-13-five-dimension-pages-redesign.md` | **三页改造实施计划**（10 Task） |
| | `2026-06-13-guest-mode-implementation.md` | **游客模式实施计划**（10 Task） |
| | `2026-06-12-danshop-integration-design.md` | DanShop 电商集成设计（P0） |
| | `2026-06-11-5-tab-pages.md` | 5 TabBar 页面实施计划 |

## 2026-06-14 — 行远页新增「重要关系维护」功能

### 变更说明

行远（行动/木）页新增关系维护模块，用于管理用户的重要人际关系（家人/朋友/伴侣/同事等），支持从手机通讯录导入联系人。

### 新增文件

| 文件 | 类型 | 说明 |
|------|:----:|------|
| `docs/superpowers/specs/2026-06-14-action-page-relationship-design.md` | 设计 | 关系维护功能设计 |
| `docs/superpowers/plans/2026-06-14-action-page-relationship.md` | 计划 | 关系维护实施计划 |
| `cfc-backend/.../entity/Contact.java` | entity | 通讯录关系实体 |
| `cfc-backend/.../service/ContactService.java` | service | 关系 CRUD + 导入逻辑 |
| `cfc-backend/.../controller/ContactController.java` | controller | 关系 API 接口 |
| `cfc-frontend/components/ContactCard.vue` | component | 关系卡片组件 |
| `cfc-frontend/components/ContactImport.vue` | component | 通讯录导入浮层 |
| `cfc-frontend/pages/action/contact-detail.vue` | page | 关系详情/编辑页 |

### 核心设计决策

| 决策 | 选择 |
|------|------|
| 关系归属维度 | **行远（行动）** — 五行属木，对应"关系践行、社群连接" |
| 联系人导入 | 微信 `wx.chooseContact` + 后端查重 + 补充信息浮层 |
| 亲密度 | 0-100 数值，根据 contactCount / lastContactAt 自动计算 + 用户可 ±20 微调 |
| 关系区块位置 | 行远页「今日待办」与「热门活动」之间 |
| 生日提醒 | 近期生日在卡片上标注"还有 N 天"，后续可扩展推送 |
| 互动记录 | 后端记录每次查看/编辑联系人（可选手动标记"联系了"） |

---

### 核心设计决策（最新）

| 决策 | 选择 |
|------|------|
| TabBar 5页 | 首页 / 身泰 / 心智 / 行远 / 富沛（始终可见） |
| 首页角色分流 | 游客→发现页 / parent-index / child-index / teacher-index→收归 parent-index |
| 心智双维度展示 | **堆叠图**：一根柱叠加心能量+智能量 |
| 私密活动可见性 | `visibility` + `visibleScope`(family/role/user) + `visibleTo` 三字段 |
| 游客价格 | 隐藏数值，显示"登录查看" |
| 游客空数据 | 显示「登录后查看更多」占位 |
| 后端过滤 | 根据 JWT + userId/role/familyId 统一过滤 |
| 行远页新增 | 重要关系维护 + 通讯录导入 |

### 已归档（移至 `docs/backup/`）

| 原位置 | 文件 |
|--------|------|
| 需求分析/ | v1.2-心智增强-版本计划/阶段总结, 底签页面内容设计(旧版), 需求分析文档, 领域对比分析×4 |
| 系统设计/ | 心知家庭-系统设计报告(.docx/.md) |
| superpowers/specs/ | 2026-03/05/06月历史specs 共13个 |
| superpowers/plans/ | 2026-03/05/06月历史plans 共23个 |
| docs/根目录 | requirements-analysis.md, API-INTEGRATION.md, badge/dan/guide/report/task-requirements, 参考资料, product-plan, plans |