通知中心管理插件

插件简介

本插件用于在 Hertz System 中集中管理系统内的各种通知，包括审核结果、任务进度、告警推送等，让运维和业务同学可以在一个统一的通知中心中查看历史消息。

• 支持站内信、邮件、短信等多通道通知的统一入口；
• 支持模板配置、变量占位和多语言文案管理；
• 支持查看发送记录与状态，便于排查通知发送失败问题。

安装步骤

1. 后端安装（Django）

在部署 Hertz System 的后端虚拟环境中，通过公司私有 PyPI 源安装通知中心插件依赖：

pip install hertz-studio-django-notice -i https://username:password@hzpypi.hzsystems.cn/simple/

安装完成后，在项目的 settings.py 中注册应用：

INSTALLED_APPS += [
    "hertz_studio_django_notice",
]

保存配置并重新启动后端服务（如有需要执行 python manage.py migrate），使通知中心插件生效。

若插件需要暴露独立路由，可在 urls.py 中按插件文档说明 include 对应 urls。

2. 前端集成

在管理端菜单中增加「通知中心」「我的消息」等入口，并指向通知列表页面，支持按时间、类型、状态筛选。

可以在页面中为重要操作（如审核通过、导出完成、任务失败等）配置通知触发逻辑，将消息推送到指定用户或角色。

3. 配置环境变量（可选示例）

根据实际情况，在 .env 或配置中心中补充通知相关配置，例如：

NOTICE_CENTER_ENABLED=true
NOTICE_DEFAULT_CHANNEL=email
NOTICE_RETENTION_DAYS=30

上述配置仅为示例，可根据项目需要调整默认通道、保留天数等参数，具体以实际后端实现为准。

使用教程

1. 规划通知类型

在通知中心中定义常见通知类型，如：系统告警、流程审批、任务结果、运营公告等。

2. 配置通知模板

为每类通知配置对应的标题与内容模板，支持占位变量（如用户名、任务名称、时间等），并为不同渠道配置不同模板。

3. 在业务流程中触发

在后端业务代码中，在关键节点调用通知发送接口，将模板 + 参数写入通知中心，由插件负责路由到具体渠道。