一、前言

在前两篇专栏中，我们完成了心晴驿站的项目定位、技术选型与开发环境搭建，搭建了一套纯净、合规、适配鸿蒙生态的原生项目底座。

本篇将深入鸿蒙Stage模型核心，从架构选型、分层设计、模块解耦、隐私安全、可扩展性五大维度，完整拆解心晴驿站的端侧分层架构设计。结合心理健康应用的高隐私特性，详解原生端侧应用架构设计思路、核心组件交互逻辑、数据安全防护方案，为后续功能开发提供清晰架构蓝图，全程实战、无空泛理论，贴合鸿蒙原生开发最佳实践。

二、鸿蒙Stage模型核心价值与选型理由

2.1 为什么弃用FA模型，首选Stage模型？

鸿蒙系统提供FA（Feature Ability）与Stage两大应用模型，二者核心差异决定了心晴驿站的选型：

• FA模型：老旧模型，架构扁平化、生命周期混乱、权限管控薄弱、组件复用性差，无法适配高隐私、高稳定的心理健康应用需求，且官方逐步淘汰，上架兼容性差；

• Stage模型：鸿蒙主推最新模型，分层清晰、生命周期独立、权限精细化、组件解耦、适配性强，完美匹配心晴驿站「离线可用、隐私优先、稳定运行、长期迭代」的核心诉求。

2.2 Stage模型核心架构逻辑

Stage模型采用**「Ability-Component-UI」**三层核心架构：

1. Ability层：应用入口，管控应用生命周期、页面路由、权限申请、全局事件，作为应用的「大脑」；

2. Component层：业务容器，承载页面组件、自定义控件、交互逻辑，实现功能模块化；

3. UI层：ArkUI声明式界面，负责页面渲染、用户交互、动画效果，与业务逻辑解耦。

心晴驿站基于Stage模型，结合端侧离线、隐私优先特性，进一步优化分层架构，实现「高内聚、低耦合、强安全」。

三、心晴驿站整体分层架构设计（端侧纯原生）

3.1 整体架构总览

心晴驿站采用四层分层架构，从上到下依次为：UI交互层 → 业务逻辑层 → 数据管理层 → 基础支撑层，各层职责单一、完全解耦，依赖单向流动，无跨层耦合，架构图如下：

┌─────────────────────────────────────────┐
│          UI交互层（ArkUI）              │
│  首页/测评/游戏/我的 页面与公共组件     │
├─────────────────────────────────────────┤
│          业务逻辑层（Service）          │
│  测评算法/游戏交互/情绪分析/路由控制    │
├─────────────────────────────────────────┤
│          数据管理层（Store/DB）         │
│  本地存储/数据加密/隐私过滤/数据校验    │
├─────────────────────────────────────────┤
│          基础支撑层（Utils/Config）     │
│  全局常量/工具函数/样式配置/权限管理    │
└─────────────────────────────────────────┘

3.2 各层职责与设计细节

1. UI交互层（ArkUI 声明式UI）

• 核心职责：负责页面渲染、用户交互、动画效果、样式展示，无任何业务逻辑，纯视图层；

• 核心组件：

  • 页面组件：首页、PHQ9测评页、GAD7测评页、游戏页、个人中心页；

  • 公共组件：底部导航栏、进度条、结果卡片、弹窗、空白占位符；

  • 交互组件：可点击卡片、滑动组件、动画容器；

• 设计原则：轻量化、低复用、样式统一，仅处理视图渲染，所有交互事件回调至业务层。

2. 业务逻辑层（Service 服务层）

• 核心职责：承载所有核心业务逻辑、算法实现、交互控制、页面路由，作为UI层与数据层的桥梁；

• 核心模块：

  • 测评服务：PHQ9/GAD7题库管理、计分算法、结果评级、情绪分析；

  • 游戏服务：吹泡泡/彩虹收集等游戏逻辑、动画控制、分数计算；

  • 路由服务：页面跳转、参数传递、返回逻辑；

  • 情绪服务：情绪匹配、推荐算法、日志管理；

• 设计原则：单一职责、高内聚、低耦合，每个服务独立封装，UI层仅调用服务方法，不感知内部逻辑。

3. 数据管理层（Store/DB 数据层）

• 核心职责：负责本地数据存储、数据加密、隐私过滤、数据校验、数据清理，心晴驿站最核心的安全层；

• 核心能力：

  • 本地存储：基于鸿蒙Preferences存储测评结果、游戏记录；

  • 隐私保护：树洞数据即时清理、零留存，敏感数据本地加密；

  • 数据校验：测评数据合法性校验、数据格式统一；

  • 数据清理：无用数据自动删除、缓存清理；

• 设计原则：隐私优先、数据隔离、加密防护，所有敏感情绪数据仅本地存储，无任何云端交互。

4. 基础支撑层（Utils/Config 基础层）

• 核心职责：提供全局通用能力、常量配置、工具方法、权限管理，支撑上层所有模块；

• 核心内容：

  • 全局常量：配色、文案、测评题库常量、游戏配置；

  • 工具函数：时间格式化、数据转换、字符串处理；

  • 样式配置：全局字体、间距、圆角，统一治愈风格；

  • 权限管理：本地权限申请、权限校验；

• 设计原则：通用、稳定、可复用，无业务逻辑，仅提供基础支撑能力。

四、核心模块架构拆解（四大业务模块）

心晴驿站基于分层架构，拆解为四大核心业务模块，各模块独立开发、独立测试、独立迭代，模块间通过事件回调、服务调用通信，无强耦合。

4.1 首页模块架构

• 页面组成：治愈问候区、每日语录、树洞入口、功能快捷栏；

• 交互逻辑：问候语根据时段动态切换、语录随机展示、树洞入口点击跳转、快捷栏路由跳转；

• 数据依赖：无敏感数据，仅依赖全局常量、工具函数。

4.2 心理测评模块架构

• 页面组成：测评列表页、PHQ9测评页、GAD7测评页、结果页、记录页；

• 核心逻辑：题库渲染 → 答题监听 → 实时计分 → 结果评级 → 本地保存；

• 数据依赖：测评题库常量、数据存储服务、情绪分析算法；

• 安全设计：测评结果本地加密存储，无云端上传。

4.3 治愈游戏模块架构

• 页面组成：游戏列表页、吹泡泡页、彩虹收集页、雨声冥想页、涂色页；

• 核心逻辑：游戏初始化 → 交互监听 → 动画渲染 → 分数计算 → 记录保存；

• 数据依赖：游戏配置常量、动画工具、数据存储服务；

• 安全设计：游戏记录仅本地保存，无隐私数据泄露风险。

4.4 个人中心模块架构

• 页面组成：个人信息、测评记录、游戏记录、设置、免责提示；

• 核心逻辑：数据查询、历史渲染、设置交互、页面跳转；

• 数据依赖：本地存储数据、全局配置、路由服务；

• 安全设计：无个人身份信息采集，仅展示本地生成数据。

五、隐私安全架构设计（核心亮点）

心晴驿站作为心理健康应用，隐私安全是架构设计的第一优先级，基于Stage模型权限机制+端侧数据隔离，构建三层隐私防护架构：

5.1 第一层：数据输入防护

• 树洞功能：即时清空、零留存，退出页面自动删除所有输入内容，无本地缓存、无内存残留；

• 无身份采集：无需注册、无需登录、无需授权手机号/相册/位置，零隐私信息收集。

5.2 第二层：数据存储防护

• 本地隔离：所有测评、游戏记录仅存储在应用私有目录，其他应用无法访问；

• 数据加密：敏感测评结果采用鸿蒙本地加密算法，防止数据被篡改、泄露；

• 无云端交互：全程离线运行，无任何数据上传、网络请求，从根源杜绝泄露。

5.3 第三层：权限管控防护

• 最小权限原则：仅申请必要权限（如音频权限用于雨声冥想），无多余权限；

• 权限精细化：基于Stage模型权限机制，动态申请、动态校验、动态回收权限；

• 权限隔离：敏感功能（树洞、测评）无需任何额外权限，默认可用。

六、可迭代架构设计（长期扩展预留）

心晴驿站架构设计预留长期迭代空间，避免后续功能新增导致架构重构：

• 模块可插拔：新增游戏、测评量表时，直接新增服务模块、页面组件，无需修改核心架构；

• 算法可扩展：情绪分析、推荐算法独立封装，后续可升级AI算法、优化匹配逻辑；

• 适配可扩展：基于Stage模型，后续可快速适配鸿蒙平板、折叠屏等多设备；

• 合规可扩展：新增隐私政策、免责声明等合规内容，直接扩展配置层。

七、架构踩坑复盘（实战避坑）

7.1 初期耦合问题

问题：初期将UI渲染与业务逻辑混杂，页面代码臃肿、难以维护；

解决：严格遵循分层架构，UI层仅处理视图，业务逻辑全部抽离至Service层，彻底解耦。

7.2 隐私设计疏漏

问题：初期树洞数据存在内存残留，切换页面未完全清空；

解决：新增即时清理机制，页面销毁时强制清空树洞数据、释放内存，确保零留存。

7.3 模型适配偏差

问题：初期误用FA模型生命周期，导致页面跳转异常；

解决：切换Stage模型，严格遵循生命周期管理，统一路由逻辑。

八、本篇总结与下篇预告

本篇深度拆解了心晴驿站基于鸿蒙Stage模型的分层架构设计，从模型选型、四层架构、核心模块、隐私安全、可扩展性五大维度，详细讲解了纯鸿蒙端侧心理健康应用的架构设计思路，全程贴合实战、规避踩坑，为后续功能开发提供了清晰架构蓝图。

下篇预告：第四篇将聚焦ArkUI声明式UI实战——首页治愈风格页面从零开发，详解首页布局、动画交互、动态问候、语录展示的代码实现，带你落地第一个完整业务页面。