docs: 补充架构边界中文注释

2026-07-03 15:32:34 +08:00
parent 940bbf4ec6
commit 8048c6ee11
1 changed files with 7 additions and 0 deletions
--- a/README.md
+++ b/README.md
@@ -73,18 +73,25 @@ frontend-miniapp/

 ```text
 static nav-assets / static guide-data / SGS API / audio API
+原始数据源：本地导览资源包、讲解静态数据、SGS 后端接口、音频播放接口
        ↓
 Providers
+数据提供层：负责读取静态文件或请求后端接口，处理加载、缓存、错误和基础可用性
        ↓
 Adapters
+数据适配层：把不同来源的字段、ID、楼层和分类转换成统一的博物馆领域模型
        ↓
 Repositories
+数据访问边界：向业务用例暴露稳定查询能力，隐藏静态包、API、SDK 响应差异
        ↓
 UseCases
+业务用例层：组织导览、讲解、搜索、位置预览、路线 readiness 和音频选择等业务规则
        ↓
 ViewModels / Page State
+页面状态/视图模型层：把领域数据整理成页面和组件可直接渲染的轻量结构
        ↓
 Vue Components
+展示组件层：只负责交互和呈现，不直接解析源数据、不直接调用后端或 SDK 原始协议
 ```

 关键文件：