出口预警自动化平台

Cross-Border Export Alert Automation · 跨境物流预警监控与自动化推送:定时同步数据、分级增量统计、中英双语图文简报、AI 分析,飞书卡片 + 邮件双通道精准推送。
NestJS Drizzle ORM PostgreSQL React 19 TypeScript Tailwind CSS 飞书 OpenAPI SMTP AI 分析

项目简介

面向跨境物流业务的预警监控与自动化推送平台,为经理级 / 工程师级人员提供差异化的双语预警简报,替代人工整理报表。

🔄

数据同步

定时从出口预警报表同步原始数据 → 提取预警明细 → 增量聚合到分级统计库。

📊

分级统计

经理级(中/高风险)与工程师级(低/中/高风险)两套独立统计口径,按快照追加历史。

🌐

双语简报

中英对照排版(中文在上英文在下):统计表 + 工厂卡片 + 类型分面图 + 趋势图。

🤖

AI 分析

后端预计算全部指标,AI 仅做语言组织,输出固定 5 点中英对照分析,数字零误差。

✈️

飞书推送

Interactive 卡片(图片经 image_key 上传),按人员 push_content / push_method 精准分发。

📧

邮件推送

SMTP 邮件,内嵌图表附件(cid 内联),统计表 → 图表 → 分析完整排版。

定时调度

平台 cron 每 30 分钟触发 + 数据库任务表命中判断:一次性 / 每周重复,自动停用,容忍调度漂移。

🎨

服务端绘图

@napi-rs/canvas 生成图表,内置 NotoSansCJK 中文字体,适配无中文字体的 Linux 容器。

简报效果展示

以下为系统实际生成的简报内容与图表(示例数据)。

双语简报样张
中英双语简报样张 — 统计表 + 固定 5 点 AI 分析(中文在上英文在下)
工厂预警结构卡片图
各工厂预警结构 / Factory Alert Structure
预警数量按类型分面图
预警数量(按类型分面) / Alert Count by Type
工厂预警数量趋势图
工厂预警数量趋势 / Factory Alert Trend

技术架构

全栈应用,构建于妙搭(Miaoda / Spark)aPaaS 平台之上。

前端 · React 19 TypeScript Tailwind CSS shadcn/ui 后端 · NestJS Drizzle ORM PostgreSQL @Automation / @BindTrigger 飞书 OpenAPI SMTP @napi-rs/canvas

数据链路

从原始报表到精准推送的完整流水线。

出口预警报表 原始库 daily_raw_records 预警明细 alert_details 分级统计库 简报生成 飞书 + 邮件
AI 数字零误差设计:总量 / 主类型 / 占比 / 集中度等全部由后端预计算,prompt 强制 AI 引用现成数字、禁止计算与思考过程泄漏,从工程上杜绝 LLM 幻觉。
定时调度方案(平台限制下的设计):平台 cron 最小 30 分钟且不可动态启停 → 采用「固定高频调度器 + 数据库任务表命中判断」,支持一次性 / 每周重复、触发自动停用、lastFiredAt 防重、时区统一 Asia/Shanghai。