# 天气推送

**Repository Path**: xiaoliang-practice/weather-push

## Basic Information

- **Project Name**: 天气推送
- **Description**: 企业微信：安飞的企微天气推送
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-27
- **Last Updated**: 2026-03-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Weather Push

> 系统默认每日7.30推送天气。支持用户自定义推送时间~



## 系统功能简介

Weather Reminder 是一个面向企业微信场景的天气提醒系统，支持用户订阅、定时/手动推送、失败追踪与运营管理。

### 核心能力

- 用户管理：支持新增、编辑、删除用户，并维护用户启用状态
- 订阅配置：支持按用户设置城市、推送时间、订阅开关
- 天气获取：按城市查询当日天气数据（温度、降雨概率、紫外线、风力等）
- 智能建议：根据天气阈值生成出行与穿搭提醒
- 企业微信推送：支持企业微信应用消息推送（Markdown）
- 推送日志：记录每位用户每日推送状态（成功/失败）及失败原因
- 幂等保障：同一用户同一日期日志唯一，避免重复写入冲突
- 任务触发：支持定时任务和手动触发（正常触发/强制触发）

### Web 控制台功能

- 用户管理页
  - 用户增删改查
  - 用户列表搜索与状态筛选
  - 启用/停用状态可视化
- 手动触发页
  - 正常触发与强制触发（含二次确认）
  - 推送执行结果反馈
  - 推送日志表格展示（时间、用户、状态、失败码、失败原因）

### 推送消息内容（企业微信 Markdown）

- 天气卡片（日期、星期、城市、天气、温度）
- 出行指标（降雨概率、紫外线、风力）
- 风险等级标签（低/中/高）
- 智能提醒文案
- 每日语录与风格化展示

## 业务亮点（表格版）

| 业务亮点 | 解决的问题 | 当前实现方式 | 业务价值 |
| --- | --- | --- | --- |
| 精准触达 | 用户消息千人一面、触达时机不稳定 | 按用户配置城市与推送时间，支持定时与手动触发 | 提升触达相关性与打开意愿 |
| 运营可控 | 突发天气时无法快速干预 | 提供正常触发与强制触发，并带二次确认 | 关键时段可快速全量触达 |
| 内容更有吸引力 | 纯文本提醒单调、阅读完成率低 | 企业微信 Markdown 卡片 + 指标 + 语录 + 风险标签 | 提升阅读体验与行动转化 |
| 智能提醒 | 用户难以从原始天气数据提炼行动建议 | 基于温度/降雨/紫外线规则自动生成建议 | 降低用户决策成本，提升服务感知 |
| 全链路可追踪 | 失败原因不透明，难定位问题 | 推送日志记录成功/失败、错误码、错误信息并在 Web 展示 | 提升排障效率和运营复盘能力 |
| 幂等与稳定性 | 重复执行可能导致日志冲突和数据不一致 | 同用户同日期唯一约束 + upsert 写入策略 | 保证数据一致性，降低重复推送风险 |





## 图片介绍：



> 消息推送效果

![](images/卡片-17746017000881.png)



> Web管理

![](images/web管理.png)



> 在线推送



![](images/手动推送.png)