akmon/doc_eldercare/eldercare_pages_routing_guide.md

# Eldercare系统页面路由配置指南

## 概述
本文档描述了智慧养老服务系统的页面路由配置，包括不同用户角色的页面访问权限和导航结构。

## 页面配置文件说明

### 1. `pages_eldercare_complete.json` - 完整页面配置
包含系统所有页面的完整配置，适用于开发和测试环境。

### 2. `pages_eldercare_admin.json` - 管理员页面配置
专为系统管理员设计的页面配置，包含：
- 管理控制台 (`/pages/eldercare/admin/dashboard`)
- 长者管理 (`/pages/eldercare/admin/elder-management`)
- 护工管理 (`/pages/eldercare/admin/caregiver-management`)
- 健康监测 (`/pages/eldercare/admin/health-monitoring`)
- 财务管理 (`/pages/eldercare/finance/management`)
- 设备管理 (`/pages/eldercare/equipment/management`)
- 活动管理 (`/pages/eldercare/activity/management`)
- 访客管理 (`/pages/eldercare/visitor/management`)
- 数据分析 (`/pages/eldercare/analytics/dashboard`)
- 事件管理 (`/pages/eldercare/incident/report`)

**主题色：** #1976D2 (蓝色)

### 3. `pages_eldercare_caregiver.json` - 护工/护士页面配置
专为护理人员设计的页面配置，包含：
- 护工工作台 (`/pages/eldercare/caregiver/dashboard`)
- 任务执行 (`/pages/eldercare/caregiver/task-execution`)
- 长者详情 (`/pages/eldercare/caregiver/elder-details`)
- 护士工作台 (`/pages/eldercare/nurse/dashboard`)
- 事件报告 (`/pages/eldercare/incident/report`)
- 设备检查 (`/pages/eldercare/equipment/management`)
- 活动协助 (`/pages/eldercare/activity/management`)

**主题色：** #2E7D32 (绿色)

### 4. `pages_eldercare_family.json` - 家属页面配置
专为家属设计的页面配置，包含：
- 家属中心 (`/pages/eldercare/family/dashboard`)
- 长者状态 (`/pages/eldercare/family/elder-status`)
- 护理记录 (`/pages/eldercare/family/care-records`)
- 沟通交流 (`/pages/eldercare/family/communication`)
- 预约探视 (`/pages/eldercare/visitor/management`)
- 活动安排 (`/pages/eldercare/activity/management`)
- 费用查询 (`/pages/eldercare/finance/management`)

**主题色：** #FF6B35 (橙色)

### 5. `pages_eldercare_doctor.json` - 医生页面配置
专为医生设计的页面配置，包含：
- 医生工作台 (`/pages/eldercare/doctor/dashboard`)
- 健康监测 (`/pages/eldercare/admin/health-monitoring`)
- 患者详情 (`/pages/eldercare/caregiver/elder-details`)
- 医疗分析 (`/pages/eldercare/analytics/dashboard`)
- 医疗事件 (`/pages/eldercare/incident/report`)
- 医疗设备 (`/pages/eldercare/equipment/management`)

**主题色：** #7B1FA2 (紫色)

### 6. `pages_eldercare_elder.json` - 长者本人页面配置
专为长者本人设计的简化页面配置，包含：
- 我的生活 (`/pages/eldercare/elder/dashboard`)
- 我的健康 (`/pages/eldercare/family/elder-status`)
- 联系家人 (`/pages/eldercare/family/communication`)
- 我的活动 (`/pages/eldercare/activity/management`)
- 访客预约 (`/pages/eldercare/visitor/management`)

**主题色：** #4CAF50 (亮绿色)

### 7. `pages_eldercare_general.json` - 通用页面配置
包含各角色的主要入口页面，适用于多角色切换的场景。

## 页面结构说明

### 系统入口页面
- **路径：** `/pages/eldercare/index`
- **功能：** 角色选择和系统介绍
- **特色：** 
  - 渐变背景设计
  - 角色卡片式选择界面
  - 系统特色功能展示
  - 加载动画效果

### 管理员模块
```
pages/eldercare/admin/
├── dashboard.uvue          # 管理控制台主页
├── elder-management.uvue   # 长者信息管理
├── elder-form.uvue        # 长者信息表单
├── caregiver-management.uvue # 护工管理
└── health-monitoring.uvue  # 健康监测总览
```

### 护理人员模块
```
pages/eldercare/caregiver/
├── dashboard.uvue         # 护工工作台
├── task-execution.uvue    # 任务执行管理
└── elder-details.uvue     # 长者详细信息

pages/eldercare/nurse/
└── dashboard.uvue         # 护士工作台
```

### 家属模块
```
pages/eldercare/family/
├── dashboard.uvue         # 家属中心主页
├── elder-status.uvue      # 长者状态监控
├── care-records.uvue      # 护理记录查看
└── communication.uvue     # 沟通交流平台
```

### 医生模块
```
pages/eldercare/doctor/
└── dashboard.uvue         # 医生工作台
```

### 长者本人模块
```
pages/eldercare/elder/
└── dashboard.uvue         # 长者生活助手
```

### 功能模块
```
pages/eldercare/
├── incident/
│   └── report.uvue        # 事件报告管理
├── finance/
│   └── management.uvue    # 财务管理
├── equipment/
│   └── management.uvue    # 设备管理
├── activity/
│   └── management.uvue    # 活动管理
├── visitor/
│   └── management.uvue    # 访客管理
└── analytics/
    └── dashboard.uvue     # 数据分析
```

## 使用指南

### 1. 开发环境配置
在开发阶段，建议使用 `pages_eldercare_complete.json` 作为主配置文件，以便访问所有功能页面。

### 2. 生产环境部署
根据实际部署需求，可以为不同的用户角色使用对应的页面配置文件：
- 管理员版本：使用 `pages_eldercare_admin.json`
- 护理人员版本：使用 `pages_eldercare_caregiver.json`
- 家属版本：使用 `pages_eldercare_family.json`
- 医生版本：使用 `pages_eldercare_doctor.json`
- 长者版本：使用 `pages_eldercare_elder.json`

### 3. 配置文件切换
在 `manifest.json` 中指定要使用的页面配置文件：
```json
{
  "pages": "pages_eldercare_complete.json"
}
```

### 4. 主题色设计说明
- **管理员（蓝色 #1976D2）：** 专业、权威、管理
- **护理人员（绿色 #2E7D32）：** 健康、生命、关怀
- **家属（橙色 #FF6B35）：** 温暖、家庭、陪伴
- **医生（紫色 #7B1FA2）：** 专业、医疗、科学
- **长者（亮绿色 #4CAF50）：** 活力、希望、生命

## 技术特性

### 1. UTS Android兼容性
所有页面都严格遵循UTS Android兼容性要求：
- 使用UTSJSONObject进行数据访问
- 避免使用不兼容的API
- 正确的类型定义和转换

### 2. 响应式设计
- 支持不同屏幕尺寸
- 老年人友好的界面设计（大字体、高对比度）
- 简化操作流程

### 3. 无障碍设计
- 语音提示支持
- 大按钮设计
- 简化导航结构
- 紧急呼叫功能

## 扩展说明

### 添加新页面
1. 在对应模块目录下创建新的 `.uvue` 文件
2. 在相应的页面配置文件中添加路由配置
3. 更新本文档的页面结构说明

### 修改主题色
1. 在页面配置文件中修改 `navigationBarBackgroundColor`
2. 在页面样式中相应调整主题色变量
3. 确保保持良好的视觉一致性

## 注意事项

1. **安全性：** 各角色页面配置应严格按照权限控制访问
2. **性能：** 避免在单个配置文件中包含过多页面
3. **维护性：** 保持页面配置文件的清晰分类和命名规范
4. **用户体验：** 确保不同角色的用户界面简洁易用