文档变更记录

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