# dailyLove

## 公众号每日问候推送系统

一个基于 Spring Boot 4 和响应式编程的微信公众号每日问候推送系统，可定时推送天气、节日、纪念日等个性化信息。

## 功能特性

- **定时推送**：每日早上7:30推送早安问候，晚上22:00推送晚安问候
- **天气信息**：实时获取并推送当地天气情况
- **纪念日提醒**：自动计算恋爱纪念日、结婚纪念日及生日倒计时
- **节日祝福**：支持农历节日和节气提醒
- **个性化内容**：彩虹话、每日一言、贴心小提示等
- **响应式架构**：使用 WebFlux 和 WebClient 实现高性能异步处理
- **配置灵活**：支持外部配置和环境变量

## 技术栈

- **后端框架**：Spring Boot 4.x
- **响应式编程**：Spring WebFlux + WebClient
- **JSON处理**：Jackson 3
- **工具库**：Hutool
- **构建工具**：Maven
- **JDK版本**：JDK 25
- **原生镜像**：GraalVM Native Image

## 快速开始

### 环境要求

- JDK 25+
- Maven 3.6+
- 微信公众平台账号
- 天行数据API密钥

### 配置说明

在 `application.yml` 中配置以下参数：

```yaml
# 微信相关配置
wechat:
  app-id: "your-app-id"           # 微信公众号AppID
  app-secret: "your-app-secret"   # 微信公众号AppSecret
  open-id: "user-open-id"         # 接收推送的用户OpenID
  template-id-morning: "template-id-for-morning"  # 早安模板消息ID
  template-id-night: "template-id-for-night"      # 晚安模板消息ID

# 天行数据API配置
daily-love:
  data:
    tianxin-key: "your-tianxin-api-key"  # 天行数据API密钥
    city-id: "101270106"               # 城市ID
    girl-birthday: "1995-06-28"        # 女方生日
    boy-birthday: "1995-03-30"         # 男方生日
    cat-birthday: "2022-10-23"         # 宠物生日
    love-day: "2022-07-16"             # 恋爱纪念日
    wedding-day: "2025-10-08"          # 结婚纪念日
```

### 启动应用

```bash
# 编译项目
mvn clean package

# 运行应用
java -jar target/dailylove.jar

# 或使用Maven运行
mvn spring-boot:run
```

## 项目结构

```
src/
├── main/
│   ├── java/com/bamanker/dailylove/
│   │   ├── config/           # 配置类
│   │   ├── controller/       # 控制器
│   │   ├── domain/           # 数据模型
│   │   ├── service/          # 业务服务
│   │   ├── utils/            # 工具类
│   │   └── DailyLoveApplication.java
│   └── resources/
│       └── application.yml   # 应用配置
└── test/
```

## 核心功能模块

### 1. 推送控制器

- [PushDailyController](file:///D:/myWork/dailyLove/src/main/java/com/bamanker/dailylove/controller/PushDailyController.java)：处理早安/晚安推送逻辑
- 支持 `/pushMorning` 和 `/pushNight` 接口手动触发推送

### 2. 定时任务

- [PushTask](file:///D:/myWork/dailyLove/src/main/java/com/bamanker/dailylove/config/PushTask.java)：配置定时推送任务
- Cron表达式：`0 30 7 * * ?` (早上7:30) 和 `0 0 22 * * ?` (晚上22:00)

### 3. 外部服务调用

- 使用 WebClient 调用微信API获取访问令牌
- 调用天行数据API获取天气、彩虹话、每日一言等信息

## 配置项说明


| 配置项                      | 描述                 | 示例        |
| --------------------------- | -------------------- | ----------- |
| wechat.app-id               | 微信公众号AppID      | wx123456789 |
| wechat.app-secret           | 微信公众号AppSecret  | abc123...   |
| wechat.open-id              | 接收消息的用户OpenID | oABC123...  |
| daily-love.data.tianxin-key | 天行数据API密钥      | 123abc...   |
| daily-love.data.city-id     | 城市ID               | 101270106   |

## 自定义推送内容

系统会根据以下情况进行智能提醒：

- **恋爱纪念日**：显示恋爱天数及特殊纪念日提醒
- **生日提醒**：推送生日倒计时
- **节日祝福**：农历节日、节气等
- **天气预报**：当日/次日天气情况
- **个性化内容**：彩虹话、每日一言等

## 部署方式

### Docker部署

```bash
# 构建Docker镜像
docker build -t dailylove .

# 运行容器
docker run -d -p 13145:13145 --name dailylove dailylove
```

### 原生镜像部署

项目支持GraalVM原生镜像构建，启动速度更快：

```bash
# 构建原生镜像
./mvnw native:compile -Pnative

# 运行原生镜像
./target/dailylove
```

## 更新日志

### **v3.1.1-native**

- 优化了响应式编程实现，避免阻塞操作
  · 移除了 PushDailyController 中的 .block() 阻塞操作 
  · 重构了异步数据处理逻辑，使用 Mono.zip 并发获取多个数据源 
  · 改善了错误处理机制 

- 重构了配置管理，使用@ConfigurationProperties替代静态字段
  · 创建了 DailyLoveProperties 类使用 @ConfigurationProperties 注解 
  · 更新了配置文件结构，使用更清晰的层次结构 
  · 添加了环境变量支持，提高了配置的灵活性 
- 修复了定时任务失效问题
  · 启用了 PushTask 定时任务类，使用 @Component 注解 
  · 添加了日志记录以便跟踪任务执行 
- 改进了错误处理，增加全局异常处理器 
  · 创建了专门的 PushException 异常类 
  · 更新了全局异常处理器 GlobalExceptionHandler 
  · 在关键位置添加了错误映射和处理 
- 增强了配置文件，支持环境变量
  · 更新了 application.yml 文件，采用新的配置结构 
  · 添加了日志级别配置 
  · 为配置项提供了默认值和环境变量支持 

### **v2.4.0-native**

- 升级到Spring Boot 4
- 使用WebClient替代OpenFeign
- 支持原生镜像构建

## 贡献指南

1. Fork 本仓库
2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启 Pull Request

## 许可证

此项目采用 MIT 许可证。