Chet.QuartzNet.EFCore.SqlServer 2.2.0

Chet.QuartzNet.UI 可视化作业调度管理系统

Chet.QuartzNet.UI 是一个基于 .NET 8.0 和 VbenAdmin 框架开发的可视化作业调度管理系统，提供了完整的任务调度管理功能，支持文件存储和数据库存储两种模式。该组件库旨在简化 Quartz.Net 的使用门槛，提供直观、易用的可视化管理界面，使开发人员能够轻松地创建、管理、监控和调试定时作业，无需深入了解 Quartz.Net 的复杂 API。

通过 Chet.QuartzNet.UI，您可以快速集成任务调度功能到现有项目中，实现作业的可视化配置、实时监控和历史记录查询，大大提高开发效率和运维便利性。

✨ 功能特性

• 🔧 可视化管理 Quartz 作业：通过 Web 界面管理 Quartz 作业、触发器和调度器
• 📊 实时监控：实时查看作业执行状态和日志
• 🎯 ClassJob 模式支持：支持基于类的作业定义，简化作业创建
• ✅ ClassJob 自动注册：自动扫描和注册带有特定特性的作业类
• 💾 多种存储方式：支持文件存储和数据库存储（MySQL、PostgreSQL、SQL Server、SQLite）
• 📝 作业执行历史：记录作业执行历史和结果
• 🔔 PushPlus 通知集成：支持多种渠道的通知推送（微信、企业微信、钉钉、邮件等）
• 📋 通知模板支持：支持 HTML、Markdown、纯文本三种通知模板
• 🎛️ 灵活的通知策略：可配置作业成功/失败、调度器异常时的通知规则
• 📜 通知历史管理：完整的通知发送历史记录
• 🔐 认证保护：提供 JWT 认证保护管理界面
• 📦 RCL 打包：使用 Razor Class Library 打包，无侵入集成
• 🚀 快速集成：简单配置即可集成到现有项目
• 🎨 现代化 UI：基于 VbenAdmin 框架，界面美观易用
• 📱 响应式设计：支持移动端访问

📦 安装

NuGet 安装

根据需要选择安装的包：

# 主包（包含核心功能和文件存储）
dotnet add package Chet.QuartzNet.UI

# 如果需要数据库存储支持（核心包）
# 数据库扩展包（根据需要选择其中一个）
dotnet add package Chet.QuartzNet.EFCore.MySql        # MySQL 支持
dotnet add package Chet.QuartzNet.EFCore.PostgreSql    # PostgreSQL 支持
dotnet add package Chet.QuartzNet.EFCore.SqlServer   # SQL Server 支持
dotnet add package Chet.QuartzNet.EFCore.SQLite      # SQLite 支持

依赖要求

• .NET 8.0 或 .NET 10.0
• ASP.NET Core 8.0+ 或 ASP.NET Core 10.0+

🚀 快速开始

1. 存储模式选择

系统支持两种存储模式：文件存储和数据库存储，均可通过同一套 API 进行配置和使用。

1.1 文件存储模式（轻量级应用）

添加代码 需要再 Program.cs 中添加以下代码：

// Program.cs
// 添加 Quartz UI 服务（文件存储模式）
builder.Services.AddQuartzUI(builder.Configuration);
// 可选：ClassJob 自动扫描注册
builder.Services.AddQuartzClassJobs();
// 启用中间件
app.UseQuartz();

配置说明： 需要在 appsettings.json 中添加以下配置：

// appsettings.json
  "QuartzUI": {
    "JwtSecret": "Y2V0aFF1YXJ6TmV0VUlBdXRoZW50aWNhdGlvblNlY3JldA==",
    "JwtExpiresInMinutes": 360,
    "JwtIssuer": "Chet.QuartzNet.UI",
    "JwtAudience": "Chet.QuartzNet.UI",
    "UserName": "Admin",
    "Password": "123456"
  }

配置说明：

• 文件存储模式无需额外配置，系统会自动使用文件存储
• 自动读取 QuartzUI 节中的 JWT 认证配置
• 作业数据存储在应用目录下的 App_Data/QuartzJobs/ 文件夹下

1.2 数据库存储模式（中大型应用）

添加代码 需要再 Program.cs 中添加以下代码：

// Program.cs
// 添加 Quartz UI 服务（数据库存储模式）
builder.Services.AddQuartzUI(builder.Configuration);
// 可选：ClassJob 自动扫描注册
builder.Services.AddQuartzClassJobs();
// 启用中间件
app.UseQuartz();

配置说明： 需要在 appsettings.json 中添加以下配置：

// appsettings.json
  "ConnectionStrings": {
    "QuartzUI": "Server=localhost;Database=quartzui;User=root;Password=123456;" //MySQL 数据库连接字符串
    //"QuartzUI": "Data Source=quartzui.db"
  },
  "QuartzUI": {
    "StorageType": "Database", // 指定使用数据库存储
    "DatabaseProvider": "mysql", // 可选，数据库提供者：mysql、postgresql、sqlserver、sqlite
    "JwtSecret": "Y2V0aFF1YXJ6TmV0VUlBdXRoZW50aWNhdGlvblNlY3JldA==",
    "JwtExpiresInMinutes": 360,
    "JwtIssuer": "Chet.QuartzNet.UI",
    "JwtAudience": "Chet.QuartzNet.UI",
    "UserName": "Admin",
    "Password": "123456"
  }

数据库支持：

• ✅ MySQL
• ✅ PostgreSQL
• ✅ SQL Server
• ✅ SQLite

2. 访问管理界面

启动应用后，访问 /quartz-ui 即可进入管理界面。

📋 ClassJob 使用示例

创建 ClassJob

使用 [QuartzJob] 特性定义作业类：

using Chet.QuartzNet.Core.Attributes;
using Quartz;

[QuartzJob("SampleJob", "DEFAULT", "0 0/5 * * * ?", Description = "示例作业，每5分钟执行一次")]
public class SampleJob : IJob
{
    private readonly ILogger<SampleJob> _logger;

    public SampleJob(ILogger<SampleJob> logger)
    {
        _logger = logger;
    }

        public async Task Execute(IJobExecutionContext context)
        {
            _logger.LogInformation("SampleJob开始执行，执行时间: {ExecuteTime}", DateTime.Now);
            try
            {
                // 模拟业务逻辑处理
                await Task.Delay(1000);

                // 获取作业数据
                var jobDataJson = context.JobDetail.JobDataMap.GetJobDataJson();
                var jobData = context.JobDetail.JobDataMap.GetJobData<SampleParam>();
                if (!string.IsNullOrEmpty(jobDataJson))
                {
                    _logger.LogInformation("获取到作业数据JSON: {JobDataJson}", jobDataJson);

                }

                _logger.LogInformation("SampleJob执行完成");
            }
            catch (Exception ex)
            {
                _logger.LogError(ex, "SampleJob执行失败");
                throw;
            }
        }
}

注册 ClassJob

// 自动扫描并注册所有标记了 QuartzJob 特性的类
builder.Services.AddQuartzClassJobs();

🎯 界面功能

分析页

• 📊 作业统计概览：总作业数、启用/禁用作业数、正在执行作业数、成功/失败执行次数
• 📈 作业状态分布：各状态作业数量和百分比的饼图展示
• 📋 作业类型分布：各类型作业数量和百分比的饼图展示
• 📉 作业执行趋势：作业执行趋势的折线图展示
• ⏱️ 作业执行耗时：作业执行耗时的柱状图展示

作业管理

• 📋 作业列表展示（支持分页、搜索、筛选）
• ➕ 添加新作业（支持 Cron 表达式验证）
• ✏️ 编辑现有作业
• 🔄 触发作业（立即执行）
• ⏸️ 暂停/恢复作业
• 🗑️ 删除作业
• 📊 查看作业状态（正常、暂停、完成、错误、阻塞）

日志管理

• 📜 查看作业执行历史
• 🔍 按状态筛选日志（运行中、成功、失败）
• ⏱️ 查看执行耗时
• ❌ 查看错误信息
• 📋 分页显示日志记录
• 🗑️ 删除日志记录

通知管理

• 🔔 通知配置：配置 PushPlus Token、推送渠道、消息模板等
• 🎛️ 通知策略：设置作业成功/失败、调度器异常时的通知规则
• 📋 通知历史：查看所有通知发送记录
• 🔍 通知筛选：按状态、触发来源筛选通知
• 🗑️ 通知清理：删除单条或批量清空通知记录
• 📤 测试通知：发送测试通知验证配置是否正确

调度器状态

• 🟢 实时显示调度器运行状态
• 📈 自动刷新状态信息
• 📊 显示当前活跃作业数量

作业类型支持

• 🎯 DLL 模式：基于类的作业定义
• ⚙️ API 模式：基于 API 调用的作业定义

🔧 数据库配置

系统支持通过不同的扩展包来支持多种数据库。您需要根据实际使用的数据库安装对应的扩展包：

数据库类型	扩展包名称	安装命令
MySQL	Chet.QuartzNet.EFCore.MySql	Install-Package Chet.QuartzNet.EFCore.MySql 或 dotnet add package Chet.QuartzNet.EFCore.MySql
PostgreSQL	Chet.QuartzNet.EFCore.PostgreSQL	Install-Package Chet.QuartzNet.EFCore.PostgreSQL 或 dotnet add package Chet.QuartzNet.EFCore.PostgreSQL
SQL Server	Chet.QuartzNet.EFCore.SqlServer	Install-Package Chet.QuartzNet.EFCore.SqlServer 或 dotnet add package Chet.QuartzNet.EFCore.SqlServer
SQLite	Chet.QuartzNet.EFCore.SQLite	Install-Package Chet.QuartzNet.EFCore.SQLite 或 dotnet add package Chet.QuartzNet.EFCore.SQLite

📝 更新说明

[2.2.0] - 2026-05-29

新增

• 推送通知多通道支持（webhook、voice、extension、app）
• PushPlus 高级配置（option、to、callbackUrl、timestamp）
• Quartz 管理页面多语言支持（zh-CN、en-US）

优化

• 优化通知配置 UI，根据通道动态展示配置项
• 删除作业时同步删除对应作业日志
• 完善文件数据迁移逻辑，添加存储类型检查
• 统一代码格式，重构多处细节

修复

• 防止 401 错误传播到页面 catch 块
• 修复暗色模式样式选择器语法问题

兼容性

• 与现有 .NET 8.0 / 10.0 版本完全兼容

[2.1.1] - 2026-1-29

优化

• 新增编辑作业时，API超时时长调整为1-99999秒
• 调整页面默认大小为20
• 添加页面缓存，切换页面时保持当前状态

修复

• 修复新增编辑作业时输入验证失败导至的异常问题
• 修复日志切换分页时排序异常问题

兼容性

• 与现有 .NET 8.0 / 10.0 版本完全兼容

[2.1.0] - 2026-1-17

优化

• 重构分析页
• 优化详情对话框、通知配置对话框、Cron 表达式帮助对话框 UI

修复

• 修复认证过期后多次提示
• 修复 .Net 8 框架 下 SQLite 版本冲突问题

兼容性

• 与现有 .NET 8.0 版本完全兼容
• 支持 .NET 8.0 和 .NET 10.0 多框架目标

[2.0.0] - 2026-1-15

新增

• 添加 .NET 10.0 框架支持
• 升级相关依赖包至 .NET 10 兼容版本

兼容性

• 与现有 .NET 8.0 版本完全兼容
• 支持 .NET 8.0 和 .NET 10.0 多框架目标

[1.6.1] - 2026-1-12

优化

• 优化了表单布局和响应式栅格配置，调整了表格列的固定位置和宽度
• 将作业统计展示调整为近30天数据并优化默认时间范围，增强了图表的交互体验和UI样式

兼容性

• 与现有版本完全兼容

[1.6.0] - 2025-12-30

新增

• 实现批量删除作业功能
• 添加作业复制功能

优化

• 优化操作菜单样式
• 优化日志详情和通知详情信息 UI

兼容性

• 与现有版本完全兼容

[1.5.0] - 2025-12-27

优化

• 为了提升作业数据访问的便利性，现已对 JobDataMap 封装了两个扩展方法： GetJobDataJson —— 用于直接获取 JSON 字符串； GetJobData —— 可将数据反序列化为指定类型的对象

由

var jobDataMap = context.JobDetail.JobDataMap;
var json = JsonSerializer.Serialize(jobDataMap.WrappedMap);

调整为

var jobDataJson = context.JobDetail.JobDataMap.GetJobDataJson();
var jobData = context.JobDetail.JobDataMap.GetJobData<SampleParam>();

原来的方式仍然可用，但只能通过 JobDataMap 的 JobData 键值对进行访问。建议优先使用新的扩展方法来简化操作。

• 选择 API 方式时去掉了多余的作业数据输入框，对现有功能无任何影响

兼容性

• 获取作业数据方式会受影响，建议使用新的扩展方法调整
• 无需数据库迁移或配置更改

[1.4.0] - 2025-12-25

修复

• 实现作业初始化后立即调度，解决新增 ClassJob 未及时调度问题
• 修复 API 超时问题，确保按配置时间执行

优化

• 全面重构各模块日志记录，统一格式与逻辑
• 升级 Quartz 依赖至 3.15.1
• 更新前端 UI 组件与样式
• 优化作业执行结果处理与日志详情

兼容性

• 与现有版本完全兼容
• 无需数据库迁移或配置更改

[1.3.2] - 2025-12-23

修复

• 修复时间处理问题
• 修复认证过期未跳转重新登录的问题

优化

• 修改文档
• 添加 JSON 格式化功能

兼容性

• 与现有版本完全兼容
• 无需数据库迁移或配置更改

[1.3.0] - 2025-12-17

修复

• 修复使用数据库存储方式时 Nuget 包源的问题

兼容性

• 与现有版本完全兼容
• 无需数据库迁移或配置更改

[1.2.4] - 2025-12-16

优化

• 更换 Logo
• 打包时添加 README.md 文件

兼容性

• 与现有版本完全兼容
• 无需数据库迁移或配置更改

[1.1.4] - 2025-12-14

修复

• 修复使用数据库存储方式时迁移失败的问题

优化

• 操作时添加提醒

兼容性

• 与现有版本完全兼容
• 无需数据库迁移或配置更改

🤝 贡献指南

欢迎提交 Issue 和 Pull Request！

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 许可证 - 查看 LICENSE 文件了解详情。

🆘 支持与联系

如有问题或建议，请通过以下方式联系：

• 提交 Issue
• 发送邮件
• 参与讨论

🙏 致谢

• Quartz.Net - 优秀的任务调度框架
• VbenAdmin - 美观的 UI 组件库
• .NET - 强大的开发平台

---

⭐ 如果这个项目对您有帮助，请给个 Star 支持一下！