182 lines
4.4 KiB
Markdown
182 lines
4.4 KiB
Markdown
# Zeodao任务提醒系统 v2.0
|
||
|
||
一个基于Spring Boot的多群企业微信任务提醒系统，支持多个团队群组、多种任务管理系统和自定义提醒时间。系统可以同时为使用禅道、智能表格、Jira等不同任务管理工具的团队提供个性化的任务状态提醒服务。
|
||
|
||
## 功能特性
|
||
|
||
- ✅ **多群组支持** - 同时支持多个企业微信群组
|
||
- ✅ **多任务系统** - 支持禅道、智能表格、Jira、Trello等任务管理系统
|
||
- ✅ **自定义时间** - 每个群组可配置不同的提醒时间
|
||
- ✅ **个性化消息** - 根据任务管理系统生成专属操作指引
|
||
- ✅ **动态调度** - 根据配置文件动态创建定时任务
|
||
- ✅ **自动排除节假日** - 智能跳过周末和法定节假日
|
||
- ✅ **企业微信集成** - 支持Webhook消息推送和Markdown格式
|
||
- ✅ **REST API** - 提供完整的管理和监控接口
|
||
- ✅ **实时监控** - 任务状态监控和日志记录
|
||
|
||
## 技术栈
|
||
|
||
- Java 21
|
||
- Spring Boot 2.7.14
|
||
- Maven
|
||
- 企业微信Webhook API
|
||
|
||
## 快速开始
|
||
|
||
### 1. 环境要求
|
||
|
||
- JDK 21 或更高版本
|
||
- Maven 3.6+
|
||
|
||
### 2. 配置企业微信Webhook
|
||
|
||
在 `src/main/resources/application.yml` 中配置您的企业微信Webhook地址：
|
||
|
||
```yaml
|
||
wechat:
|
||
webhook:
|
||
url: https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=YOUR_WEBHOOK_KEY
|
||
```
|
||
|
||
### 3. 编译和运行
|
||
|
||
```bash
|
||
# 编译项目
|
||
mvn clean compile
|
||
|
||
# 运行项目
|
||
mvn spring-boot:run
|
||
```
|
||
|
||
或者打包后运行：
|
||
|
||
```bash
|
||
# 打包
|
||
mvn clean package
|
||
|
||
# 运行jar包
|
||
java -jar target/task-reminder-1.0.0.jar
|
||
```
|
||
|
||
### 4. 验证系统
|
||
|
||
系统启动后，可以通过以下API进行测试：
|
||
|
||
```bash
|
||
# 健康检查
|
||
curl http://localhost:8080/api/reminder/health
|
||
|
||
# 发送测试消息
|
||
curl -X POST http://localhost:8080/api/reminder/test
|
||
|
||
# 手动触发早上提醒
|
||
curl -X POST http://localhost:8080/api/reminder/morning
|
||
|
||
# 手动触发晚上提醒
|
||
curl -X POST http://localhost:8080/api/reminder/evening
|
||
|
||
# 获取提醒信息
|
||
curl http://localhost:8080/api/reminder/info
|
||
```
|
||
|
||
## 配置说明
|
||
|
||
### 时间配置
|
||
|
||
在 `application.yml` 中可以自定义提醒时间：
|
||
|
||
```yaml
|
||
task:
|
||
reminder:
|
||
morning:
|
||
time: "0 0 9 * * MON-FRI" # Cron表达式：工作日早上9点
|
||
message: "早上好！请及时更新您的任务状态，开始新的一天工作！"
|
||
evening:
|
||
time: "0 30 17 * * MON-FRI" # Cron表达式：工作日下午5:30
|
||
message: "下班前提醒：请更新今日任务完成状态，为明天做好准备！"
|
||
```
|
||
|
||
### 节假日配置
|
||
|
||
系统内置了2024年和2025年的法定节假日，可以在 `HolidayUtil.java` 中修改或添加自定义节假日。
|
||
|
||
## API文档
|
||
|
||
### 健康检查
|
||
- **URL**: `GET /api/reminder/health`
|
||
- **描述**: 检查系统运行状态
|
||
|
||
### 发送测试消息
|
||
- **URL**: `POST /api/reminder/test`
|
||
- **描述**: 发送一条测试消息到企业微信群
|
||
|
||
### 手动触发早上提醒
|
||
- **URL**: `POST /api/reminder/morning`
|
||
- **描述**: 手动触发早上任务提醒
|
||
|
||
### 手动触发晚上提醒
|
||
- **URL**: `POST /api/reminder/evening`
|
||
- **描述**: 手动触发晚上任务提醒
|
||
|
||
### 获取提醒信息
|
||
- **URL**: `GET /api/reminder/info`
|
||
- **描述**: 获取下次提醒时间和系统状态信息
|
||
|
||
## 日志
|
||
|
||
系统会在 `logs/task-reminder.log` 文件中记录详细的运行日志，包括：
|
||
- 定时任务执行记录
|
||
- 消息发送状态
|
||
- 错误信息
|
||
- 系统健康检查
|
||
|
||
## 部署建议
|
||
|
||
### 生产环境部署
|
||
|
||
1. 修改 `application.yml` 中的日志级别为 `INFO`
|
||
2. 配置合适的JVM参数
|
||
3. 使用systemd或其他进程管理工具管理应用
|
||
4. 配置日志轮转策略
|
||
|
||
### Docker部署
|
||
|
||
可以创建Dockerfile进行容器化部署：
|
||
|
||
```dockerfile
|
||
FROM openjdk:21-jre-slim
|
||
COPY target/task-reminder-1.0.0.jar app.jar
|
||
EXPOSE 8080
|
||
ENTRYPOINT ["java", "-jar", "/app.jar"]
|
||
```
|
||
|
||
## 故障排除
|
||
|
||
### 常见问题
|
||
|
||
1. **消息发送失败**
|
||
- 检查企业微信Webhook地址是否正确
|
||
- 检查网络连接是否正常
|
||
- 查看日志文件中的错误信息
|
||
|
||
2. **定时任务不执行**
|
||
- 检查Cron表达式是否正确
|
||
- 确认当前时间是否为工作日
|
||
- 查看系统日志确认定时任务是否启动
|
||
|
||
3. **节假日判断错误**
|
||
- 检查 `HolidayUtil.java` 中的节假日配置
|
||
- 确认系统时间是否正确
|
||
|
||
## 贡献
|
||
|
||
欢迎提交Issue和Pull Request来改进这个项目。
|
||
|
||
## 许可证
|
||
|
||
MIT License
|
||
|
||
## 联系方式
|
||
|
||
如有问题，请联系开发团队。
|