# iffwat/microbit-innovation-robotic-competition architecture

> Architecture diagram of the GitHub repository iffwat/microbit-innovation-robotic-competition, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/iffwat/microbit-innovation-robotic-competition
- Repository: https://github.com/iffwat/microbit-innovation-robotic-competition

## Overview

This repository appears to implement a robotics-tournament management application: administrators register or import teams, check them in, organize groups, manage matches and knockout brackets, while public-facing pages expose live and results views. The excerpts show team import, group generation, standings, and bracket generation, but not the web routes or most display components; those links are therefore not asserted. The README is Laravel boilerplate and does not document application-specific capabilities.

Main entry points: [`app/Models/Category.php`](https://github.com/iffwat/microbit-innovation-robotic-competition/blob/main/app/Models/Category.php) (Categories), [`app/Models/Group.php`](https://github.com/iffwat/microbit-innovation-robotic-competition/blob/main/app/Models/Group.php) (Groups and standings), [`app/Models/TournamentMatch.php`](https://github.com/iffwat/microbit-innovation-robotic-competition/blob/main/app/Models/TournamentMatch.php) (Tournament matches), [`app/Models/Team.php`](https://github.com/iffwat/microbit-innovation-robotic-competition/blob/main/app/Models/Team.php) (Teams)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Application entry"]
  node_webapp["Laravel web app<br/>[index.php]"]
  node_web_routes["Web routes<br/>[web.php]"]
  node_auth_routes["Auth routes<br/>[auth.php]"]
  node_registration["Registration"]
end

subgraph group_admin["Tournament administration"]
  node_teams["Team management<br/>[TeamController.php]"]
  node_csv_import["CSV import"]
  node_import_admin["Import administration"]
  node_group_manager["Group manager"]
  node_knockout_manager["Knockout manager"]
  node_match_admin["Match operations"]
  node_checkin["Check-in"]
  node_attendance["Attendance dashboard"]
end

subgraph group_domain["Competition domain"]
  node_category[("Categories<br/>[Category.php]")]
  node_team[("Teams<br/>[Team.php]")]
  node_group[("Groups and standings<br/>[Group.php]")]
  node_group_team[("Group memberships<br/>[GroupTeam.php]")]
  node_match[("Tournament matches")]
  node_knockout_slot[("Knockout slots<br/>[KnockoutSlot.php]")]
end

subgraph group_audience["Public and user views"]
  node_public_live["Live TV<br/>[live-tv.blade.php]"]
  node_public_results["Results lookup<br/>[semakan.blade.php]"]
  node_official_results["Official results"]
end

node_operator(("Administrator"))
node_user(("Account user"))

node_webapp -->|"loads routes"| node_web_routes
node_webapp -.->|"loads routes"| node_auth_routes
node_operator -.->|"manages teams"| node_teams
node_operator -.->|"imports teams"| node_import_admin
node_import_admin -->|"delegates import"| node_csv_import
node_csv_import -->|"resolves category"| node_category
node_csv_import -->|"creates teams"| node_team
node_teams -->|"creates and queries"| node_team
node_teams -->|"queries categories"| node_category
node_group_manager -->|"selects checked-in teams"| node_team
node_group_manager -->|"creates groups"| node_group
node_group_manager -->|"creates memberships"| node_group_team
node_knockout_manager -->|"reads groups"| node_group
node_knockout_manager -->|"creates brackets"| node_match
node_group -->|"reads memberships"| node_group_team
node_group -->|"uses tie-break results"| node_match
node_match -->|"recalculates standings"| node_group_team
node_category -->|"relates categories"| node_team
node_category -->|"relates categories"| node_group
node_category -->|"relates categories"| node_match
node_category -->|"relates slots"| node_knockout_slot
node_user -.->|"registers account"| node_registration
node_registration -->|"serves registration"| node_auth_routes

click node_webapp "https://github.com/iffwat/microbit-innovation-robotic-competition/blob/main/public/index.php"
click node_web_routes "https://github.com/iffwat/microbit-innovation-robotic-competition/blob/main/routes/web.php"
click node_auth_routes "https://github.com/iffwat/microbit-innovation-robotic-competition/blob/main/routes/auth.php"
click node_teams "https://github.com/iffwat/microbit-innovation-robotic-competition/blob/main/app/Http/Controllers/Admin/TeamController.php"
click node_csv_import "https://github.com/iffwat/microbit-innovation-robotic-competition/blob/main/app/Services/CsvImportService.php"
click node_import_admin "https://github.com/iffwat/microbit-innovation-robotic-competition/blob/main/app/Http/Controllers/Admin/ImportController.php"
click node_group_manager "https://github.com/iffwat/microbit-innovation-robotic-competition/blob/main/resources/views/components/admin/groups/%E2%9A%A1group-manager.blade.php"
click node_knockout_manager "https://github.com/iffwat/microbit-innovation-robotic-competition/blob/main/resources/views/livewire/admin/knockout-manager.blade.php"
click node_match_admin "https://github.com/iffwat/microbit-innovation-robotic-competition/blob/main/resources/views/livewire/admin/matches/field-dashboard.blade.php"
click node_checkin "https://github.com/iffwat/microbit-innovation-robotic-competition/blob/main/resources/views/components/%E2%9A%A1check-in.blade.php"
click node_attendance "https://github.com/iffwat/microbit-innovation-robotic-competition/blob/main/resources/views/livewire/attendance-dashboard.blade.php"
click node_category "https://github.com/iffwat/microbit-innovation-robotic-competition/blob/main/app/Models/Category.php"
click node_team "https://github.com/iffwat/microbit-innovation-robotic-competition/blob/main/app/Models/Team.php"
click node_group "https://github.com/iffwat/microbit-innovation-robotic-competition/blob/main/app/Models/Group.php"
click node_group_team "https://github.com/iffwat/microbit-innovation-robotic-competition/blob/main/app/Models/GroupTeam.php"
click node_match "https://github.com/iffwat/microbit-innovation-robotic-competition/blob/main/app/Models/TournamentMatch.php"
click node_knockout_slot "https://github.com/iffwat/microbit-innovation-robotic-competition/blob/main/app/Models/KnockoutSlot.php"
click node_public_live "https://github.com/iffwat/microbit-innovation-robotic-competition/blob/main/resources/views/livewire/live-tv.blade.php"
click node_public_results "https://github.com/iffwat/microbit-innovation-robotic-competition/blob/main/resources/views/livewire/semakan.blade.php"
click node_official_results "https://github.com/iffwat/microbit-innovation-robotic-competition/blob/main/resources/views/livewire/keputusan-rasmi.blade.php"
click node_registration "https://github.com/iffwat/microbit-innovation-robotic-competition/blob/main/app/Http/Controllers/Auth/RegisteredUserController.php"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_webapp,node_web_routes,node_auth_routes,node_registration,node_user toneBlue
class node_teams,node_csv_import,node_import_admin,node_group_manager,node_knockout_manager,node_match_admin,node_checkin,node_attendance toneAmber
class node_category,node_team,node_group,node_group_team,node_match,node_knockout_slot toneMint
class node_public_live,node_public_results,node_official_results toneRose
class node_operator toneIndigo
```

## Components

### Application entry

- [Laravel web app](https://github.com/iffwat/microbit-innovation-robotic-competition/blob/main/public/index.php): `public/index.php`
- [Web routes](https://github.com/iffwat/microbit-innovation-robotic-competition/blob/main/routes/web.php): `routes/web.php`
- [Auth routes](https://github.com/iffwat/microbit-innovation-robotic-competition/blob/main/routes/auth.php): `routes/auth.php`
- [Registration](https://github.com/iffwat/microbit-innovation-robotic-competition/blob/main/app/Http/Controllers/Auth/RegisteredUserController.php): `app/Http/Controllers/Auth/RegisteredUserController.php`

### Tournament administration

- [Team management](https://github.com/iffwat/microbit-innovation-robotic-competition/blob/main/app/Http/Controllers/Admin/TeamController.php): `app/Http/Controllers/Admin/TeamController.php`
- [CSV import](https://github.com/iffwat/microbit-innovation-robotic-competition/blob/main/app/Services/CsvImportService.php): `app/Services/CsvImportService.php`
- [Import administration](https://github.com/iffwat/microbit-innovation-robotic-competition/blob/main/app/Http/Controllers/Admin/ImportController.php): `app/Http/Controllers/Admin/ImportController.php`
- [Group manager](https://github.com/iffwat/microbit-innovation-robotic-competition/blob/main/resources/views/components/admin/groups/%E2%9A%A1group-manager.blade.php): `resources/views/components/admin/groups/⚡group-manager.blade.php`
- [Knockout manager](https://github.com/iffwat/microbit-innovation-robotic-competition/blob/main/resources/views/livewire/admin/knockout-manager.blade.php): `resources/views/livewire/admin/knockout-manager.blade.php`
- [Match operations](https://github.com/iffwat/microbit-innovation-robotic-competition/blob/main/resources/views/livewire/admin/matches/field-dashboard.blade.php): `resources/views/livewire/admin/matches/field-dashboard.blade.php`
- [Check-in](https://github.com/iffwat/microbit-innovation-robotic-competition/blob/main/resources/views/components/%E2%9A%A1check-in.blade.php): `resources/views/components/⚡check-in.blade.php`
- [Attendance dashboard](https://github.com/iffwat/microbit-innovation-robotic-competition/blob/main/resources/views/livewire/attendance-dashboard.blade.php): `resources/views/livewire/attendance-dashboard.blade.php`

### Competition domain

- [Categories](https://github.com/iffwat/microbit-innovation-robotic-competition/blob/main/app/Models/Category.php): `app/Models/Category.php`
- [Teams](https://github.com/iffwat/microbit-innovation-robotic-competition/blob/main/app/Models/Team.php): `app/Models/Team.php`
- [Groups and standings](https://github.com/iffwat/microbit-innovation-robotic-competition/blob/main/app/Models/Group.php): `app/Models/Group.php`
- [Group memberships](https://github.com/iffwat/microbit-innovation-robotic-competition/blob/main/app/Models/GroupTeam.php): `app/Models/GroupTeam.php`
- [Tournament matches](https://github.com/iffwat/microbit-innovation-robotic-competition/blob/main/app/Models/TournamentMatch.php): `app/Models/TournamentMatch.php`
- [Knockout slots](https://github.com/iffwat/microbit-innovation-robotic-competition/blob/main/app/Models/KnockoutSlot.php): `app/Models/KnockoutSlot.php`

### Public and user views

- [Live TV](https://github.com/iffwat/microbit-innovation-robotic-competition/blob/main/resources/views/livewire/live-tv.blade.php): `resources/views/livewire/live-tv.blade.php`
- [Results lookup](https://github.com/iffwat/microbit-innovation-robotic-competition/blob/main/resources/views/livewire/semakan.blade.php): `resources/views/livewire/semakan.blade.php`
- [Official results](https://github.com/iffwat/microbit-innovation-robotic-competition/blob/main/resources/views/livewire/keputusan-rasmi.blade.php): `resources/views/livewire/keputusan-rasmi.blade.php`

### Other components

- **Administrator**
- **Account user**

## Connections

- Laravel web app → Web routes: loads routes
- Laravel web app → Auth routes: loads routes
- Administrator → Team management: manages teams
- Administrator → Import administration: imports teams
- Import administration → CSV import: delegates import (evidence: `app/Http/Controllers/Admin/ImportController.php`)
- CSV import → Categories: resolves category (evidence: `app/Services/CsvImportService.php`)
- CSV import → Teams: creates teams (evidence: `app/Services/CsvImportService.php`)
- Team management → Teams: creates and queries (evidence: `app/Http/Controllers/Admin/TeamController.php`)
- Team management → Categories: queries categories (evidence: `app/Http/Controllers/Admin/TeamController.php`)
- Group manager → Teams: selects checked-in teams (evidence: `resources/views/components/admin/groups/⚡group-manager.blade.php`)
- Group manager → Groups and standings: creates groups (evidence: `resources/views/components/admin/groups/⚡group-manager.blade.php`)
- Group manager → Group memberships: creates memberships (evidence: `resources/views/components/admin/groups/⚡group-manager.blade.php`)
- Knockout manager → Groups and standings: reads groups (evidence: `resources/views/livewire/admin/knockout-manager.blade.php`)
- Knockout manager → Tournament matches: creates brackets (evidence: `resources/views/livewire/admin/knockout-manager.blade.php`)
- Groups and standings → Group memberships: reads memberships (evidence: `app/Models/Group.php`)
- Groups and standings → Tournament matches: uses tie-break results (evidence: `app/Models/Group.php`)
- Tournament matches → Group memberships: recalculates standings (evidence: `app/Models/TournamentMatch.php`)
- Categories → Teams: relates categories (evidence: `app/Models/Category.php`)
- Categories → Groups and standings: relates categories (evidence: `app/Models/Category.php`)
- Categories → Tournament matches: relates categories (evidence: `app/Models/Category.php`)
- Categories → Knockout slots: relates slots (evidence: `app/Models/Category.php`)
- Account user → Registration: registers account
- Registration → Auth routes: serves registration (evidence: `routes/auth.php`)
