# TaskMaster

**Repository Path**: luqi269317/task-master

## Basic Information

- **Project Name**: TaskMaster
- **Description**: 定时任务管理工具，支持精准计时、任务调度与自动化执行，适用于开发者的日常项目管理和系统运维。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: dev
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-16
- **Last Updated**: 2025-09-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🚀 BitStorm 微服务项目

## 📖 项目介绍

BitStorm是一个基于Spring Boot和Spring Cloud的微服务架构项目，提供多种服务组件，包括定时任务调度、秒杀、抽奖、短URL等功能模块。项目采用了现代化的微服务设计理念，具有高可用性、可扩展性和可维护性。

## 🛠️ 技术栈

- **🔄 基础框架**：Spring Boot 2.7.7、Spring Cloud 2021.0.5
- **🌱 微服务生态**：Spring Cloud Alibaba 2021.0.4.0
- **📋 服务注册与配置**：Nacos 2.2.0
- **💾 数据持久化**：MyBatis、MySQL
- **⚡ 缓存**：Redis
- **⏲️ 任务调度**：Quartz 2.3.2
- **🔌 连接池**：Druid
- **🔧 其他工具**：Lombok、Hutool等

## 📂 项目结构

```
├── bitstorm-svr-api            # API接口定义
├── bitstorm-svr-common         # 公共组件
├── bitstorm-svr-demo           # 示例服务
├── bitstorm-svr-seckill        # 秒杀服务
├── bitstorm-svr-mqtry          # 消息队列服务
├── bitstorm-svr-improve        # 性能改进模块
├── bitstorm-svr-testconsumer   # 测试消费者
├── bitstorm-svr-xtimer         # 分布式定时器服务
├── bitstorm-svr-asyncflow      # 异步流程服务
├── bitstorm-svr-shorturlx      # 短URL服务
├── bitstorm-svr-lottery        # 抽奖服务
├── bitstorm-svr-gateway        # 网关服务
├── bitstorm-svr-user           # 用户服务
├── bitstorm-svr-auth           # 认证服务
├── bitstorm-svr-leaf           # 分布式ID生成服务
└── db                          # 数据库脚本
```

## 🔍 核心功能模块

### 1. ⏰ xTimer 分布式定时器

提供基于Cron表达式的分布式定时任务调度功能，支持任务创建、管理和执行。采用分片机制和分布式锁确保任务的可靠执行。

**主要特性**：
- ⏱️ 支持Cron表达式定义任务执行时间
- 🌐 分布式架构，支持水平扩展
- 🧩 任务分片机制，提高并发处理能力
- 🔒 基于Redis的分布式锁，避免任务重复执行
- 🔄 任务执行状态跟踪和失败重试机制

### 2. ⚡ 秒杀服务

提供高并发秒杀场景的解决方案，包括流量控制、库存管理、订单处理等功能。

### 3. 🔗 短URL服务

提供URL缩短服务，将长URL转换为短URL，支持访问统计和重定向。

### 4. 🎲 抽奖服务

提供多种抽奖算法和策略，支持奖品管理、中奖概率控制等功能。

### 5. 🔢 分布式ID生成服务

提供高性能的分布式ID生成服务，支持多种ID生成策略。

## 🚀 快速开始

### 🔧 环境要求

- ☕ JDK 1.8+
- 🔧 Maven 3.6+
- 🗄️ MySQL 5.7+
- 🔥 Redis 5.0+
- 🌐 Nacos 2.0+

### 🏗️ 构建与运行

1. 克隆项目

```bash
git clone https://github.com/yourusername/bitstorm-svr.git
cd bitstorm-svr
```

2. 初始化数据库

```bash
# 导入数据库脚本
mysql -u username -p < db/bitstorm-svr-demo.sql
mysql -u username -p < db/bitstorm-svr-leaf.sql
mysql -u username -p < db/bitstorm-svr-seckill.sql
mysql -u username -p < db/bitstorm-svr-xtimer.sql
```

3. 配置Nacos

启动Nacos服务，并配置相应的命名空间和配置项。

4. 构建项目

```bash
mvn clean package -DskipTests
```

5. 运行服务

```bash
java -jar bitstorm-svr-gateway/target/bitstorm-svr-gateway.jar
# 启动其他所需服务
```

## 📊 性能测试

项目提供了多个性能测试脚本，位于各模块的`wrkbench`目录下，可用于测试服务的性能和稳定性。

## 👥 贡献指南

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](LICENSE)

## 📞 联系方式

- 👨‍💻 项目维护者：孔令原
- 📧 邮箱：2693176405@qq.com