message-center Specification

Purpose

提供普瑞互联网医院智慧医院小程序 V2.0 的消息列表、分类筛选、消息详情、已读/删除、未读徽标和动态跳转白名单能力。

Requirements

Requirement: 消息列表与未读

系统 MUST 提供 pages/tabBar/message/message 一级 tab，支持：

调用 03100201 获取消息列表与未读数；请求参数至少包含 receiveUser, receiveTypeCode, hospCode, messageTypeCode，分页参数 pageNo / pageSize。
响应字段归一：messageList, unreadNmber, unreadObj, remainingQty。
列表卡片显示图标（按类型 4 色）、标题、摘要单行省略、时间、未读红点；已读态透明度 0.72、标题字重 600。
分类筛选 chip：全部 / 就诊 / 缴费 / 系统，按 messageTypeCode 关键词归一，未命中归入"其他"。
下拉刷新 / 触底加载下一页；分页数据 remainingQty === 0 时停止触底。
失败/空/未登录/未选医院/跳转越界五种状态全部覆盖。

Scenario: 拉取首页未读

Given 用户已登录且 appReady=true, hospitalReady=true
When 消息页 onShow 触发
Then 顺序执行 fetchMessageList({ messageTypeCode: '' }) 与 fetchHomeUnreadCount()；未读数写入 tabBarSettings.messageUnreadCount 并 getTabBar().refresh()。

Scenario: 分类筛选

Given 列表已加载
When 用户点击"缴费" chip
Then 重新调用 fetchMessageList({ messageTypeCode: <缴费 code> })，列表与 chip 选中态同步更新，未读徽标按 categorizeMessageType 重算。

Requirement: 消息详情 / 分类详情

系统 MUST 提供 pages/message/messageDetail/messageDetail 二级页：

路由参数：messageID（单条）/ messageTypeCode（分类），可附带 jumpPages。
单条详情进入即调用 03100098 标记已读；失败保留未读态并展示重试。
分类详情复用消息卡渲染逻辑，渲染该分类下消息列表。
底部"查看原文"按钮：调用 messageJumpRouter.resolveJumpTarget(jumpPages)；命中走白名单，未命中走兜底。
右上角"更多"：删除（带二次确认）。

Scenario: 进入单条详情

Given 消息有 messageID
When 页面 onLoad
Then 调 markMessageRead({ messageID })，同时渲染消息体；若 jumpPages 存在则底部展示"查看原文"。

Scenario: 进入分类详情

Given 仅有 messageTypeCode，无 messageID
When 页面 onLoad
Then 调 fetchMessageList({ messageTypeCode }) 渲染分类列表；底部不展示"查看原文"。

Requirement: 已读 / 已处理

系统 MUST 通过接口 03100098 支持消息已读/已处理。
系统 MUST 在详情页 onLoad 自动调用；列表长按菜单也可手动调用。
系统 MUST 在失败时 toast 提示，保留未读态，不删除消息项。

Scenario: 标记消息已读

Given 用户打开未读消息详情
When markMessageRead({ messageID }) 调用成功
Then 系统 MUST 将该消息视为已读并同步未读徽标。

Requirement: 删除消息

系统 MUST 通过接口 03100212 支持删除消息。
系统 MUST 在列表删除操作和详情页右上角更多菜单提供删除入口。
系统 MUST 使用 wx.showModal 二次确认，标题"确认删除"，内容"删除后将不再展示该消息"。
系统 MUST 在失败时 toast 提示，并保留或恢复消息项。

Scenario: 删除消息

Given 用户在列表或详情页点击删除消息
When 用户确认删除且接口成功
Then 系统 MUST 从当前列表中移除该消息并刷新未读徽标。

Requirement: 动态跳转白名单

所有 jumpPages MUST 经过 utils/messageJumpRouter.js 的 resolveJumpTarget(jumpPages)。
命中规则：优先匹配 eventCode === '2004' → /pages/tabBar/order/order；否则 routePath 必须在 utils/homeRoute.js 的白名单内。
非法路径：toast 提示"暂不支持打开该消息"，不跳转，不暴露原始路径。
01030009 菜单：仅渲染 routePath 在白名单内的项；其余项隐藏。

Scenario: eventCode 2004 命中订单 tab

Given 后端返回 { eventCode: '2004', params: { ... } }
When 用户点击消息
Then resolveJumpTarget 返回 { kind: 'tab', path: '/pages/tabBar/order/order', params }，调用 navigateToRoute 走 wx.switchTab。

Scenario: 非法 routePath 兜底

Given 后端返回 { routePath: '/pages/unknown/page' }
When 用户点击消息
Then resolveJumpTarget 返回 null；调用方展示 wx.showToast({ title: '暂不支持打开该消息', icon: 'none' })。

Requirement: tabBar 徽标

系统 MUST 使用 unreadBadge.syncMessageUnread(count) 写入 getApp().globalData.tabBarSettings.messageUnreadCount。
系统 MUST 触发 getTabBar().refresh() 刷新徽标。
系统 MUST 在列表加载完成、详情已读回调、删除成功后同步未读数。

Scenario: 同步 tabBar 未读徽标

Given 消息列表加载完成并返回未读数
When 系统调用 syncMessageUnread(count)
Then tabBar MUST 展示最新消息未读徽标。