Appearance
公告消息 NoticeMessage
概述
NoticeMessage 是官方公告与系统消息的统一主数据对象,不直接保存用户已读态。
业务含义
- 用于承载官方公告与系统消息
- 作为统一消息主模型使用
- 仅保存消息本身的数据,不包含用户已读状态
数据结构
| 字段名 | 类型 | 必填 | 默认值 | 说明 | 枚举值 |
|---|---|---|---|---|---|
messageId | string | 是 | - | 消息 ID | - |
type | enum | 是 | official | 消息类型 | official, system |
title | string | 是 | - | 标题 | - |
subtitle | string | 否 | null | 副标题 | - |
coverImage | string | 否 | null | 封面图 | - |
content | text | 否 | null | 富文本正文或系统文案 | - |
relatedBizType | enum | 否 | null | 关联业务类型 | order, lottery, badge, atlas |
relatedBizId | string | 否 | null | 关联业务 ID | - |
publishTime | datetime | 是 | 当前时间 | 发布时间 | - |
字段说明
基础字段
messageId:消息唯一标识type:消息类型,区分官方公告和系统消息title:消息主标题subtitle:消息副标题,可为空
展示字段
coverImage:消息封面图地址,可为空content:消息正文内容,可为富文本或系统文案
业务关联字段
relatedBizType:消息关联的业务类型relatedBizId:关联业务的唯一 ID
当消息需要跳转或关联具体业务时,可结合以下字段使用:
relatedBizType:order/lottery/badge/atlasrelatedBizId:对应业务对象 ID
时间字段
publishTime:消息发布时间,默认取当前时间
枚举定义
type
official:官方公告system:系统消息
relatedBizType
order:订单lottery:抽奖badge:徽章atlas:图集
设计要点
- 官方公告与系统消息使用统一数据模型管理
- 主数据对象不承担用户已读状态存储职责
- 支持与订单、抽奖、徽章、图集等业务对象关联
