fade61ac21
## 后端 - 健康档案: 新增手术状态字段 + EF 迁移; HealthArchiveService 新增查询方法 - 健康记录: HealthRecordService 新增批量/统计方法; 契约扩展 - 用药: 新增 MedicationScheduleStatus 枚举; MedicationService 排班逻辑调整 - 通知: EfUserNotificationPipeline 重构; 新增 EfReminderCatchUpService; 通知管线支持更多场景 - 用户: UserService 账号删除逻辑; 新增 local_account_file_cleanup; EfUserRepository 扩展 - AI: medication_agent_handler 微调; prompt_manager 优化; AiConversationService 上下文处理 - Endpoint: doctor/medication/exercise/health/notification/user 等多接口调整 - BackgroundService: health_record_reminder_service 重构, 提醒补漏逻辑 - 测试: 新增 account_deletion/doctor_endpoint/medication_schedule/medication_update/prompt_manager 测试 ## 前端 - UI 系统: app_theme 大幅重构; app_colors/app_design_tokens/app_module_visuals 调整; 二级页面色彩刷新 - 主页: home_page 背景渐变 + 消息列表提取 _HomeMessages + 通知检查逻辑; chat_messages_view 全面重构 - 用药: medication_list/edit/checkin 三页重构, 新增 medication_ui_logic 抽取 - 通知: notification_prefs_page 重构, 新增 notification_prefs_logic; notification_center 优化 - 设备: device_management 重构, 新增 device_sync_ui_logic; device_scan 优化 - 趋势图: trend_page 大幅重构 - 登录: login_page 重构 - 个人资料: 新增 profile_edit_page; profile_page 优化 - 运动: 新增 exercise/ 目录 + care_plan_ui_logic - 其他: remaining_pages/report_pages/health_drawer/admin/doctor 等多页面调整 - 组件: common_widgets/app_empty_state/app_error_state/app_future_view/app_toast/ai_content 优化 - Provider: chat_provider/consultation_provider/data_providers/auth_provider 调整 - AndroidManifest: 移除多余权限 - 测试: 新增 ai_content/care_plan/home_message/login_flow/medication_checkin/medication_ui/notification_prefs/profile_device/secondary_page/swipe_delete 等大量测试 ## 文档 - 新增 ui-design-system.md 设计系统文档 - 新增 secondary-page-color-refresh 计划 + specs 目录
48 lines
2.4 KiB
Markdown
48 lines
2.4 KiB
Markdown
# 通知设置改造设计
|
|
|
|
## 目标
|
|
|
|
让通知设置展示真实的服务端状态，保存失败时明确提示并恢复原值；将五个健康指标开关收纳到底部选择弹窗中，同时修复通知总开关未真正参与后端投递判断的问题。
|
|
|
|
## 页面结构
|
|
|
|
主页面保持四个区域：通知总开关、通知类型、健康录入提醒、免打扰时段。
|
|
|
|
健康录入提醒区域只展示：
|
|
|
|
- “每日健康录入提醒”总开关。
|
|
- “提醒指标”入口，副标题展示当前已选指标摘要。
|
|
|
|
点击“提醒指标”后打开底部弹窗。弹窗使用复选框选择血压、心率、血糖、血氧和体重，至少保留一项，点击“保存”后一次性提交全部指标设置。
|
|
|
|
## 状态与保存
|
|
|
|
前端使用明确的通知偏好状态对象，不再直接使用无类型的 Map。状态区分首次加载、单项保存、指标批量保存和错误信息。
|
|
|
|
- 首次加载成功后才展示设置内容。
|
|
- 首次加载失败展示错误页和重试按钮，不使用默认值冒充服务端数据。
|
|
- 普通开关修改时只锁定当前操作，后端成功后采用响应中的完整偏好更新页面。
|
|
- 保存失败恢复原值并显示错误提示。
|
|
- 指标弹窗先维护本地草稿，点击保存时一次提交五个字段，避免连续请求和部分成功。
|
|
- 免打扰时间采用相同的真实保存与失败恢复规则。
|
|
|
|
## 后端行为
|
|
|
|
保留现有 `/api/notification-prefs` GET 和 PUT 接口。PUT 继续支持部分字段更新并返回保存后的完整偏好。
|
|
|
|
通知发送管线必须优先检查 `PushEnabled`。总开关关闭时，不生成或投递任何用户通知；健康录入、用药、随访、医生回复和异常提醒继续读取各自开关，免打扰规则继续生效。
|
|
|
|
## 错误处理
|
|
|
|
- 网络或服务错误显示后端可读信息，无法解析时使用统一提示。
|
|
- 保存过程中禁止同一设置重复提交。
|
|
- 指标未选择任何一项时，弹窗内提示至少选择一项，不发送请求。
|
|
- 后端返回失败时不显示成功状态。
|
|
|
|
## 测试
|
|
|
|
- Flutter 单元测试覆盖偏好解析、指标摘要、至少选择一项和失败回滚。
|
|
- Flutter 组件测试覆盖加载失败、指标弹窗批量选择和保存中禁用。
|
|
- 后端测试覆盖 `PushEnabled=false` 时所有通知类型均不投递，以及各分类开关和免打扰继续生效。
|
|
- 运行 `flutter analyze`、Flutter 全量测试和相关 .NET 测试。
|