8.6 KiB
8.6 KiB
Here is a complete Laravel API service implementation with all functions fully defined per your Taekwondo tournament system requirements. It covers participant filtering by WT 2025 official age, gender, and weight classes, plus a master API that accepts JSON payloads of players and returns grouped draw-ready data from A to Z.
1. Service Class: TaekwondoService.php
<?php
namespace App\Services;
use Carbon\Carbon;
class TaekwondoService
{
public function calculateAge($dob): int
{
return Carbon::parse($dob)->age;
}
public function getAgeCategory(int $age): string
{
if ($age >= 6 && $age <= 11) return "Child";
if ($age >= 12 && $age <= 14) return "Cadet";
if ($age >= 15 && $age <= 17) return "Junior";
if ($age >= 18 && $age <= 32) return "Senior";
if ($age >= 33 && $age <= 40) return "Ultra 1";
if ($age >= 41 && $age <= 50) return "Ultra 2";
if ($age >= 51 && $age <= 60) return "Ultra 3";
if ($age >= 61) return "Ultra 4";
return "Unknown";
}
public function getWeightClass(string $gender, int $age, ?float $weight): string
{
if (is_null($weight)) return "Unknown";
if ($gender === 'Male') {
if ($age >= 6 && $age <= 11) {
if ($weight <= 22) return "-22kg";
if ($weight <= 24) return "-24kg";
if ($weight <= 26) return "-26kg";
if ($weight <= 29) return "-29kg";
if ($weight <= 32) return "-32kg";
if ($weight <= 35) return "-35kg";
if ($weight <= 38) return "-38kg";
if ($weight <= 42) return "-42kg";
if ($weight <= 45) return "-45kg";
return "+45kg";
}
if ($age >= 12 && $age <= 14) {
if ($weight <= 33) return "-33kg";
if ($weight <= 37) return "-37kg";
if ($weight <= 41) return "-41kg";
if ($weight <= 45) return "-45kg";
if ($weight <= 49) return "-49kg";
if ($weight <= 53) return "-53kg";
if ($weight <= 57) return "-57kg";
if ($weight <= 61) return "-61kg";
if ($weight <= 65) return "-65kg";
return "+65kg";
}
if ($age >= 15 && $age <= 17) {
if ($weight <= 45) return "-45kg";
if ($weight <= 48) return "-48kg";
if ($weight <= 51) return "-51kg";
if ($weight <= 55) return "-55kg";
if ($weight <= 59) return "-59kg";
if ($weight <= 63) return "-63kg";
if ($weight <= 68) return "-68kg";
if ($weight <= 73) return "-73kg";
if ($weight <= 78) return "-78kg";
return "+78kg";
}
if ($age >= 18) {
if ($weight <= 54) return "-54kg";
if ($weight <= 58) return "-58kg";
if ($weight <= 63) return "-63kg";
if ($weight <= 68) return "-68kg";
if ($weight <= 74) return "-74kg";
if ($weight <= 80) return "-80kg";
if ($weight <= 87) return "-87kg";
return "+87kg";
}
}
if ($gender === 'Female') {
if ($age >= 6 && $age <= 11) {
if ($weight <= 22) return "-22kg";
if ($weight <= 24) return "-24kg";
if ($weight <= 26) return "-26kg";
if ($weight <= 29) return "-29kg";
if ($weight <= 32) return "-32kg";
if ($weight <= 35) return "-35kg";
if ($weight <= 38) return "-38kg";
if ($weight <= 42) return "-42kg";
if ($weight <= 45) return "-45kg";
return "+45kg";
}
if ($age >= 12 && $age <= 14) {
if ($weight <= 29) return "-29kg";
if ($weight <= 33) return "-33kg";
if ($weight <= 37) return "-37kg";
if ($weight <= 41) return "-41kg";
if ($weight <= 44) return "-44kg";
if ($weight <= 47) return "-47kg";
if ($weight <= 51) return "-51kg";
if ($weight <= 55) return "-55kg";
if ($weight <= 59) return "-59kg";
return "+59kg";
}
if ($age >= 15 && $age <= 17) {
if ($weight <= 42) return "-42kg";
if ($weight <= 44) return "-44kg";
if ($weight <= 46) return "-46kg";
if ($weight <= 49) return "-49kg";
if ($weight <= 52) return "-52kg";
if ($weight <= 55) return "-55kg";
if ($weight <= 59) return "-59kg";
if ($weight <= 63) return "-63kg";
if ($weight <= 68) return "-68kg";
return "+68kg";
}
if ($age >= 18) {
if ($weight <= 46) return "-46kg";
if ($weight <= 49) return "-49kg";
if ($weight <= 53) return "-53kg";
if ($weight <= 57) return "-57kg";
if ($weight <= 62) return "-62kg";
if ($weight <= 67) return "-67kg";
if ($weight <= 73) return "-73kg";
return "+73kg";
}
}
return "Unknown";
}
public function groupPlayersForPredraw(array $players): array
{
$groups = [];
foreach ($players as $player) {
$age = $this->calculateAge($player['dob']);
$gender = $player['gender'] ?? 'Unknown';
$ageCategory = $this->getAgeCategory($age);
$weightClass = $this->getWeightClass($gender, $age, $player['weight'] ?? null);
$key = "{$gender}|{$ageCategory}|{$weightClass}";
if (!isset($groups[$key])) {
$groups[$key] = [
'gender' => $gender,
'ageCategory' => $ageCategory,
'weightClass' => $weightClass,
'players' => []
];
}
$groups[$key]['players'][] = $player;
}
return array_values($groups);
}
}
2. API Controller (full process endpoint)
<?php
namespace App\Http\Controllers\Api;
use App\Http\Controllers\Controller;
use App\Services\TaekwondoService;
use Illuminate\Http\Request;
class TaekwondoController extends Controller
{
protected $service;
public function __construct(TaekwondoService $service)
{
$this->service = $service;
}
public function processAll(Request $request)
{
$players = $request->input('players', []);
if (empty($players)) {
return response()->json(['error' => 'Players array is required'], 422);
}
$groups = $this->service->groupPlayersForPredraw($players);
return response()->json(['groups' => $groups]);
}
}
3. API Route
use App\Http\Controllers\Api\TaekwondoController;
Route::post('/taekwondo/process-all', [TaekwondoController::class, 'processAll']);
Usage
Send a POST request to /api/taekwondo/process-all with JSON:
{
"players": [
{
"id": 1,
"name": "Ali",
"gender": "Male",
"dob": "2012-05-10",
"weight": 30
},
{
"id": 2,
"name": "Sara",
"gender": "Female",
"dob": "2010-08-20",
"weight": 28
}
// more player records
]
}
The service will return the players grouped accurately by WT official categories—a full “from A to Z” client-facing API covering your filtering and classification needs.
This provides a robust, well-structured Laravel API service and a complete detailed filter implementation with no skipping of any essential category or weight breakpoint as you requested.
Let me know if you want me to build expanding bracket generation and match progression APIs next!