# P52 消息通知、站内信、推送模板与告警体系

版本：v1.0　日期：2026-11-20

## 一、定位

打通客户、供应商、平台运营/品质/客服三端的消息触达，覆盖订单变更、BOM/PCB/SMT 报价、售后 CAR、授信账单、库存预警与系统通知。站内信为必达通道，短信、邮件、企业微信按用户订阅开关发送。

## 二、消息模板（msg_template）

| 字段 | 说明 |
| --- | --- |
| template_code | 模板唯一编码，如 ORDER_PAY_SUCCESS、CREDIT_OVERDUE、CAR_NOTIFY |
| biz_type | 1 订单 / 2 BOM / 3 PCB 报价 / 4 SMT 报价 / 5 授信账单 / 6 售后 CAR / 7 库存预警 / 8 系统通知 |
| channel_json | 支持渠道：inner / sms / email / wecom |
| title / content | 站内与邮件标题、正文，支持 ${order_no} ${amount} ${due_date} 变量 |
| sms_content | 短信精简模板，控制在 70 字内 |
| is_enable | 启停开关，停用模板不再发送 |

## 三、站内信与发送日志

- `msg_inner`：接收人（客户 / 供应商 / 后台账号）、模板编码、业务类型与业务 ID、标题正文、跳转链接、已读与软删除标记。
- `msg_send_log`：全渠道发送流水，记录渠道、目标地址、渲染后内容、发送状态、失败原因、重试次数与最大重试。
- `msg_user_subscribe`：用户按模板 × 渠道维度的订阅开关，唯一键（用户、模板、渠道）。
- `ws_online`：实时会话登记（会话 ID、用户、设备、最后心跳），用于在线推送与红点；离线消息落站内信。
- `sys_alarm`：平台告警工单（告警编码、等级、业务关联、处理人、状态、闭环备注）。

说明：实时推送需长连接服务，当前站点以「站内信 + 轮询刷新」实现，未接入 WebSocket 服务；发送通道（短信、邮件、企业微信）需平台接入对应服务后启用，页面开关仅记录偏好。

## 四、触发场景

客户侧：BOM 解析完成、报价生成与即将过期、Gerber 解析完成与工程异常、SMT 报价完成、支付成功、生产/发货/签收状态变更、CAR 受理与结案、授信出账与逾期、优惠券与积分变动。

供应商侧：新询价工单、新生产/采购工单、工单异常、CAR 扣款、结算单与对账、付款完成。

平台侧：授信逾期、库存低于安全水位、Gerber 解析失败率异常、新增 CAR、批量不良、供应商超时未回。

## 五、发送策略

1. 站内信必达；在线时优先即时提示，离线统一落站内信。
2. 多渠道按订阅配置发送，用户可关闭短信与邮件。
3. 同一业务单短时间不重复推送，短信单独做频率控制。
4. 模板变量统一渲染，支持中英文两套文案。
5. 失败按最大重试次数重试，超出后生成告警工单。

## 六、未读与红点

- 按接收人统计未读数量，分类聚合。
- 点击消息自动标记已读，支持全部已读与清理已读。
- 消息带业务跳转链接，直接定位订单、报价、售后工单。

## 七、告警分级

| 等级 | 场景 | 触达 |
| --- | --- | --- |
| L1 提示 | 库存临近安全线、报价即将到期 | 站内 + 企业微信 |
| L2 一般 | 账单逾期、新增 CAR 客诉 | 推送品质 / 财务待认领 |
| L3 紧急 | 批量工程异常、供应商失联 | 强提醒责任人 |
| L4 严重 | 支付回调异常、接口与数据库故障 | 运维即时告警 |

## 八、前端实现

- `/message-center`：分类标签、未读统计、标记已读、清理已读、订阅开关。
- `/alarm-center`：等级与状态筛选、认领、闭环备注、忽略。
- 后端模板管理、批量测试发送、告警统计看板由平台内容管理承接。

## 九、边界

- 实时长连接、短信/邮件/企业微信实际下发不在当前平台能力范围。
- 告警与消息记录当前存于本机，接入数据库后统一由后台维护。