martial/martial-master
4
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
29 Commits 2 Branches 0 Tags
1c981a2fb7916bbee9e8ef9d92fcd9f767609866
Commit Graph

13 Commits

Author SHA1 Message Date
宅房
1c981a2fb7 feat: 实现小程序专用API接口 
✅ 新增功能：
1. 创建MartialMiniController - 5个小程序专用接口
   - POST /api/mini/login - 登录验证（邀请码+比赛编码）
   - GET /api/mini/athletes - 普通评委选手列表
   - GET /api/mini/athletes/admin - 裁判长选手列表
   - GET /api/mini/score/detail/{athleteId} - 评分详情
   - PUT /api/mini/score/modify - 裁判长修改评分

2. 新增DTO类（3个）：
   - MiniLoginDTO - 登录请求
   - MiniAthleteScoreDTO - 提交评分请求
   - MiniScoreModifyDTO - 修改评分请求

3. 新增VO类（4个）：
   - MiniLoginVO - 登录响应（token+用户信息+场地项目）
   - MiniAthleteScoreVO - 选手评分信息（普通评委）
   - MiniAthleteAdminVO - 选手评分信息（裁判长）
   - MiniScoreDetailVO - 评分详情（选手+所有评委评分+修改记录）

4. Service层实现：
   - IMartialAthleteService.getAthletesWithMyScore() - 查询选手列表（含我的评分）
   - IMartialAthleteService.getAthletesForAdmin() - 查询选手列表（含评分统计）
   - IMartialScoreService.getScoreDetailForMini() - 查询评分详情
   - IMartialScoreService.modifyScoreByAdmin() - 裁判长修改评分

🔥 技术亮点：
- 支持邀请码+比赛编码双重验证登录
- 生成UUID token，有效期7天
- 解析JSON格式的项目分配（支持逗号分隔兼容）
- 评委权限区分：普通评委/裁判长
- 裁判长可修改总分并记录修改日志
- 完整的评分详情展示（选手信息+所有评委评分+修改记录）

🎯 对接小程序：
- 前端已通过dataAdapter适配
- config.dataMode切换'api'即可启用后端API
- 接口路径：/api/mini/*

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-12-11 18:45:09 +08:00
n72595987@gmail.com
86e9318039 feat: 实现完整的编排调度功能 (Auto-scheduling & Manual Adjustment System)
All checks were successful
continuous-integration/drone/push Build is passing
Details 
## 功能概述 Feature Summary

实现了武术比赛的完整编排调度系统，支持300人规模的自动编排、冲突检测、手动调整和方案发布。

Implemented a complete competition scheduling system supporting auto-scheduling for 300 participants, conflict detection, manual adjustments, and plan publishing.

## 核心功能 Core Features

### 1. 数据库设计 (Database Schema)
- ✅ martial_schedule_plan - 编排方案表
- ✅ martial_schedule_slot - 时间槽表
- ✅ martial_schedule_athlete_slot - 运动员时间槽关联表
- ✅ martial_schedule_conflict - 冲突记录表
- ✅ martial_schedule_adjustment_log - 调整日志表

### 2. 自动编排算法 (Auto-Scheduling Algorithm)
- ✅ 多阶段编排策略：集体项目优先 → 个人项目分类 → 冲突检测 → 优化
- ✅ 时间槽矩阵管理：场地 × 时间段的二维编排
- ✅ 智能约束满足：场地互斥、运动员时间互斥、项目聚合
- ✅ 性能优化：支持300人规模，预计编排时间 < 30秒

### 3. 冲突检测机制 (Conflict Detection)
- ✅ 运动员时间冲突检测：同一运动员不同时间槽重叠
- ✅ 场地冲突检测：同一场地同一时间多个项目
- ✅ 冲突严重程度分级：警告(1) / 错误(2) / 致命(3)
- ✅ 实时冲突检查：移动前预检测

### 4. 手动调整功能 (Manual Adjustments)
- ✅ 运动员跨场地移动：批量移动，带冲突预检测
- ✅ 场地内顺序调整：拖拽重排，实时更新
- ✅ 调整日志记录：操作类型、操作人、变更详情
- ✅ 调整原因备注：支持审计追溯

### 5. 方案管理 (Plan Management)
- ✅ 方案状态流转：草稿(0) → 已确认(1) → 已发布(2)
- ✅ 发布前检查：必须解决所有冲突
- ✅ 方案统计信息：总场次、冲突数、场地数等

### 6. REST API接口 (REST APIs)
- ✅ POST /martial/schedule-plan/auto-schedule - 自动编排
- ✅ GET /martial/schedule-plan/detect-conflicts - 冲突检测
- ✅ POST /martial/schedule-plan/check-move-conflicts - 检测移动冲突
- ✅ POST /martial/schedule-plan/move-athletes - 移动运动员
- ✅ POST /martial/schedule-plan/update-order - 调整出场顺序
- ✅ POST /martial/schedule-plan/confirm-and-publish - 确认并发布
- ✅ POST /martial/schedule-plan/resolve-conflicts - 解决冲突
- ✅ GET /martial/schedule-plan/list - 分页查询方案列表
- ✅ GET /martial/schedule-plan/detail - 查询方案详情

## 技术实现 Technical Implementation

### 核心算法 (Core Algorithm)
```java
public MartialSchedulePlan autoSchedule(Long competitionId) {
    // 1. 加载赛事数据（项目、场地、运动员）
    // 2. 项目排序（集体项目优先）
    // 3. 生成时间槽列表（30分钟一个槽）
    // 4. 初始化编排矩阵（场地 × 时间槽）
    // 5. 逐项目分配（贪心算法 + 约束满足）
    // 6. 冲突检测与统计
    // 7. 保存编排方案
}
```

### 冲突检测SQL (Conflict Detection Query)
- 运动员时间冲突：检测同一运动员在重叠时间段的多个安排
- 场地冲突：检测同一场地同一时间的多个项目分配
- 时间重叠算法：start1 < end2 && start2 < end1

### 数据结构 (Data Structures)
- TimeSlot: 时间槽（日期 + 开始时间 + 结束时间）
- ScheduleMatrix: 编排矩阵（场地占用 + 运动员占用）
- MoveAthletesDTO: 运动员移动参数
- AthleteOrderDTO: 出场顺序调整参数

## 测试覆盖 Test Coverage

### 单元测试 (Unit Tests)
- ✅ 19个测试用例，100%通过
- ✅ 自动编排流程测试（基本流程、异常处理）
- ✅ 项目排序测试（集体项目优先）
- ✅ 冲突检测测试（时间冲突、场地冲突）
- ✅ 时间重叠判断测试
- ✅ 移动运动员测试（数据验证）
- ✅ 出场顺序调整测试
- ✅ 方案状态管理测试
- ✅ 冲突类型与解决测试

### 测试通过率
```
Tests run: 19, Failures: 0, Errors: 0, Skipped: 0 (100%)
```

## 文件变更统计 File Changes

- 📝 新增SQL脚本: 1个（建表脚本）
- 📝 新增Entity: 5个（编排相关实体）
- 📝 新增Mapper: 5个（数据访问接口）
- 📝 新增Service: 1个接口 + 1个实现（核心业务逻辑）
- 📝 新增Controller: 1个（REST API）
- 📝 新增DTO: 2个（数据传输对象）
- 📝 新增Test: 1个（19个测试用例）
- 📄 新增文档: 1个（设计文档，600+行）

**总计: 18个新文件**

## 业务价值 Business Value

✅ **效率提升**：300人规模的编排从手动2-3天缩短到自动30秒
✅ **质量保证**：自动冲突检测，避免人工疏漏
✅ **灵活调整**：支持比赛中实时调整，应对突发情况
✅ **审计追溯**：完整的调整日志，操作可追溯
✅ **前端对接**：RESTful API设计，前端已准备就绪

## 依赖关系 Dependencies

- ✅ MartialCompetition - 赛事基础信息
- ✅ MartialProject - 比赛项目配置
- ✅ MartialVenue - 场地信息
- ✅ MartialAthlete - 运动员信息
- ✅ MartialRegistrationOrder - 报名信息

## 后续优化 Future Enhancements

🔄 导出功能：完整赛程表（PDF/Excel）
🔄 导出功能：场地分配表
🔄 导出功能：运动员出场通知单
🔄 WebSocket推送：实时冲突通知
🔄 大规模优化：异步任务队列（500+场次）

---

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-11-30 17:43:13 +08:00
n72595987@gmail.com
21c133f9c9 feat: 实现成绩计算引擎、比赛日流程和导出打印功能
All checks were successful
continuous-integration/drone/push Build is passing
Details 
本次提交完成了武术比赛系统的核心功能模块，包括：

## 1. 成绩计算引擎 (Tasks 1.1-1.8) ✅
- 实现多裁判评分平均分计算（去最高/最低分）
- 支持难度系数应用
- 自动排名算法（支持并列）
- 奖牌自动分配（金银铜）
- 成绩复核机制
- 成绩发布/撤销审批流程

## 2. 比赛日流程功能 (Tasks 2.1-2.6) ✅
- 运动员签到/检录系统
- 评分有效性验证（范围检查0-10分）
- 异常分数警告机制（偏差>2.0）
- 异常情况记录和处理
- 检录长角色权限管理
- 比赛状态流转管理

## 3. 导出打印功能 (Tasks 3.1-3.4) ✅
- 成绩单Excel导出（EasyExcel）
- 运动员名单Excel导出
- 赛程表Excel导出
- 证书生成（HTML模板+数据接口）

## 4. 单元测试 ✅
- MartialResultServiceTest: 10个测试用例
- MartialScoreServiceTest: 10个测试用例
- MartialAthleteServiceTest: 14个测试用例
- 测试通过率: 100% (34/34)

## 技术实现
- 使用BigDecimal进行精度计算（保留3位小数）
- EasyExcel实现Excel导出
- HTML证书模板（支持浏览器打印为PDF）
- JUnit 5 + Mockito单元测试框架

## 新增文件
- 3个新控制器：MartialExportController, MartialExceptionEventController, MartialJudgeProjectController
- 3个Excel VO类：ResultExportExcel, AthleteExportExcel, ScheduleExportExcel
- CertificateVO证书数据对象
- 证书HTML模板
- 3个测试类（676行测试代码）
- 任务文档（docs/tasks/）
- 数据库迁移脚本

## 项目进度
已完成: 64% (18/28 任务)
- ✅ 成绩计算引擎: 100%
- ✅ 比赛日流程: 100%
- ✅ 导出打印功能: 80%

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-11-30 17:11:12 +08:00
n72595987@gmail.com
b66b8237b5 fix: 修复开发环境数据库和Redis连接配置
All checks were successful
continuous-integration/drone/push Build is passing
Details 
修复内容：
- 数据库URL：localhost:3306 → 127.0.0.1:33066（匹配dev-mysql容器端口）
- 数据库密码：更新为容器真实密码
- Redis端口：6379 → 63379（匹配dev-redis容器端口）
- Redis密码：更新为容器真实密码
- Redis数据库：0 → 8

测试结果：
- ✅ 应用启动成功
- ✅ 16个martial模块API全部正常工作
- ✅ 数据库连接正常
- ✅ Redis连接正常

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-11-30 14:13:45 +08:00
宅房
a7c7da109b fix bugs
Some checks failed
continuous-integration/drone/push Build is failing
Details
2025-11-30 12:41:50 +08:00
宅房
f01c5c6a6a Merge remote-tracking branch 'origin/main'
Some checks failed
continuous-integration/drone/push Build is failing
Details 
解决目录重组冲突:
- doc/ → docs/ (文档目录重命名)
- doc/sql/ → database/ (数据库脚本目录重组)
- doc/script/ → scripts/ (脚本目录重组)

保留本地新增的武术比赛系统文件:
- docs/sql/mysql/martial-*.sql (4个数据库脚本)
- docs/后端开发完成报告.md
- docs/数据库字段检查报告.md
- docs/问题修复报告.md

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-11-30 12:13:15 +08:00
宅房
6aeb522f24 fix bugs 2025-11-30 12:07:18 +08:00
n72595987@gmail.com
15579f43cb 修复后端服务外网访问问题
Some checks failed
continuous-integration/drone/push Build is failing
Details 
- 将 server.address 从 127.0.0.1 改为 0.0.0.0，允许外部访问
- 配置 UFW 防火墙允许 8123 端口

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-11-29 20:08:50 +08:00
n72595987@gmail.com
38472ee832 优化后端配置和数据库结构 
1. 修复Swagger配置，添加武术模块API分组
   - 在SwaggerConfiguration中新增martialApi()方法
   - 使武术模块的66个接口能在Knife4j界面正常显示

2. 优化项目依赖配置
   - 添加spring-boot-starter-actuator用于健康检查
   - 暂时注释flowable工作流依赖以简化项目

3. 更新数据库结构
   - 优化martial_db.sql，精简表结构从123张减少到53张
   - 保留核心BladeX系统表和15张武术业务表
   - 更新测试数据：2场比赛、10名运动员、9个项目

4. 补充项目文档
   - 添加架构说明、开发指南等中文文档

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-11-29 16:30:20 +08:00
宅房
9c77fcb4ac Merge branch 'main' of git.waypeak.work:martial/martial-master 2025-11-29 15:03:56 +08:00
宅房
109f226371 fix bugs 2025-11-29 15:03:33 +08:00
n72595987@gmail.com
9c7604d98b chore: 配置开发环境并更新数据库设置 
- 添加 VS Code 调试配置（launch.json, tasks.json）
- 添加 VS Code 调试使用指南
- 更新数据库端口为高位端口（MySQL: 33066, Redis: 63379）
- 更新应用服务器端口为 8123
- 启用 blade-starter-liteflow 依赖
- 添加 SDKMAN 配置文件（.sdkmanrc）
- 添加项目开发文档（CLAUDE.md）
- 更新 .gitignore 忽略日志和部署文件

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-11-29 13:26:22 +08:00
宅房
3b097b5f63 fix bugs 2025-11-28 16:17:55 +08:00