武术赛事管理系统 - 后端 API

基于 BladeX 4.0.1 企业级框架构建的武术比赛管理系统后端服务。

在线访问

服务	地址	说明
后端 API	https://martial-api.aitisai.com	Spring Boot 服务
管理后台	https://martial-admin.aitisai.com	Web 管理端
用户端	https://martial.aitisai.com	报名小程序 H5
裁判端	https://martial-mini.aitisai.com	裁判评分小程序
OSS 存储	https://martial-oss.aitisai.com	MinIO 对象存储
MinIO 控制台	https://martial-minio.aitisai.com	MinIO 管理界面

技术栈

• 框架: Spring Boot 3.2.4 + BladeX 4.0.1
• 语言: Java 17
• 数据库: MySQL 8.0 + Redis 7
• ORM: MyBatis-Plus
• 数据库迁移: Flyway
• 对象存储: MinIO
• 反向代理: Caddy
• 容器化: Docker Compose

快速开始

环境要求

• JDK 17+
• Maven 3.8+
• Docker & Docker Compose

Docker Compose 部署（推荐）

# 克隆项目
git clone https://git.waypeak.work/martial/martial-master.git
cd martial-master

# 启动所有服务
docker compose up -d

# 查看服务状态
docker compose ps

服务启动后：

• API 服务: http://localhost:8123
• API 文档: http://localhost:8123/doc.html

本地开发

# 编译项目
mvn clean package -DskipTests

# 运行（需要先启动 MySQL 和 Redis）
mvn spring-boot:run -Dspring-boot.run.profiles=dev

项目结构

martial-master/
├── src/main/java/org/springblade/
│   ├── modules/martial/          # 武术比赛核心业务
│   │   ├── controller/           # 接口控制器
│   │   ├── service/              # 业务逻辑
│   │   ├── mapper/               # 数据访问
│   │   └── pojo/                 # 实体类
│   └── ...                       # BladeX 框架模块
├── src/main/resources/
│   ├── application.yml           # 主配置
│   ├── application-dev.yml       # 开发环境
│   ├── application-prod.yml      # 生产环境
│   └── db/migration/             # Flyway 迁移脚本
├── database/                     # 数据库初始化脚本
├── docs/                         # 项目文档
├── docker-compose.yml            # Docker 编排配置
└── Dockerfile                    # 镜像构建文件

Docker Compose 服务

服务	端口	说明
martial-api	8123	后端 API 服务
martial-mysql	3306	MySQL 数据库
martial-redis	6379	Redis 缓存
minio	9000/9001	对象存储

数据库迁移

项目使用 Flyway 管理数据库版本，应用启动时自动执行迁移。

添加新迁移：

# 在 src/main/resources/db/migration/ 创建脚本
# 命名规范: V{版本号}__{描述}.sql
# 示例: V3__add_new_table.sql

详细说明：docs/DATABASE_MIGRATION.md

开发文档

文档	说明
CLAUDE.md	项目完整说明
docs/开发指南.md	开发规范
docs/架构说明.md	架构设计
docs/DATABASE_MIGRATION.md	数据库迁移指南

相关仓库

仓库	说明
martial-master	后端 API
martial-web	管理后台前端
martial-mini	用户端小程序
martial-admin-mini	裁判端小程序

许可协议

本项目基于 BladeX 商业框架 构建，需遵守 BladeX 商业授权许可协议。

---

最后更新: 2024-12-29