# riuk950/vifutbol architecture

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

- Interactive diagram: https://gitdiagram.com/riuk950/vifutbol
- Repository: https://github.com/riuk950/vifutbol

## Overview

vifutbol is documented as a Flutter football-tournament management app. Its principal workflow spans tournament setup and participant registration, match logistics, referee result reporting, and standings/statistics, with public schedules, news, and role-specific performance views. The README also names Supabase and Hive. The available source excerpts cover only native platform shells, not Dart application code, so feature-level links describe documented capabilities rather than verified runtime calls; those links are dashed where wiring is unverified.

Main entry points: [`lib/main.dart`](https://github.com/riuk950/vifutbol/blob/main/lib/main.dart) (Flutter app), [`lib`](https://github.com/riuk950/vifutbol/tree/main/lib) (Tournament setup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_mobile_app["Flutter app<br/>[main.dart]"]
end

subgraph group_competition["Competition Operations"]
  node_tournament["Tournament setup"]
  node_registration["Team and player registration"]
  node_venues_schedule["Venues and schedule"]
  node_match_reporting["Match reporting"]
end

subgraph group_insight["Results and Updates"]
  node_standings_stats["Standings and statistics"]
  node_profiles["Performance views"]
  node_news_alerts["News and alerts"]
end

subgraph group_persistence["Persistence"]
  node_supabase[("Supabase PostgreSQL")]
  node_hive[("Hive local persistence")]
end

node_organizer(("Organizer"))
node_referee(("Referee"))
node_coach(("Coach"))
node_player(("Player"))
node_fan(("Fan"))

node_organizer -.->|"uses"| node_mobile_app
node_referee -.->|"uses"| node_mobile_app
node_coach -.->|"uses"| node_mobile_app
node_player -.->|"uses"| node_mobile_app
node_fan -.->|"uses"| node_mobile_app
node_mobile_app -.->|"offers"| node_tournament
node_mobile_app -.->|"offers"| node_registration
node_mobile_app -.->|"offers"| node_venues_schedule
node_mobile_app -.->|"offers"| node_match_reporting
node_mobile_app -.->|"offers"| node_standings_stats
node_mobile_app -.->|"offers"| node_profiles
node_mobile_app -.->|"offers"| node_news_alerts
node_mobile_app -.->|"uses"| node_supabase
node_mobile_app -.->|"uses"| node_hive

click node_mobile_app "https://github.com/riuk950/vifutbol/blob/main/lib/main.dart"
click node_tournament "https://github.com/riuk950/vifutbol/tree/main/lib"
click node_registration "https://github.com/riuk950/vifutbol/tree/main/lib"
click node_venues_schedule "https://github.com/riuk950/vifutbol/tree/main/lib"
click node_match_reporting "https://github.com/riuk950/vifutbol/tree/main/lib"
click node_standings_stats "https://github.com/riuk950/vifutbol/tree/main/lib"
click node_profiles "https://github.com/riuk950/vifutbol/tree/main/lib"
click node_news_alerts "https://github.com/riuk950/vifutbol/tree/main/lib"

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_mobile_app toneBlue
class node_tournament,node_registration,node_venues_schedule,node_match_reporting toneAmber
class node_standings_stats,node_profiles,node_news_alerts toneMint
class node_supabase,node_hive toneRose
class node_organizer,node_referee,node_coach,node_player,node_fan toneIndigo
```

## Components

### Application

- [Flutter app](https://github.com/riuk950/vifutbol/blob/main/lib/main.dart): `lib/main.dart`

### Competition Operations

- [Tournament setup](https://github.com/riuk950/vifutbol/tree/main/lib): `lib`
- [Team and player registration](https://github.com/riuk950/vifutbol/tree/main/lib): `lib`
- [Venues and schedule](https://github.com/riuk950/vifutbol/tree/main/lib): `lib`
- [Match reporting](https://github.com/riuk950/vifutbol/tree/main/lib): `lib`

### Results and Updates

- [Standings and statistics](https://github.com/riuk950/vifutbol/tree/main/lib): `lib`
- [Performance views](https://github.com/riuk950/vifutbol/tree/main/lib): `lib`
- [News and alerts](https://github.com/riuk950/vifutbol/tree/main/lib): `lib`

### Persistence

- **Supabase PostgreSQL**
- **Hive local persistence**

### Other components

- **Organizer**
- **Referee**
- **Coach**
- **Player**
- **Fan**

## Connections

- Organizer → Flutter app: uses
- Referee → Flutter app: uses
- Coach → Flutter app: uses
- Player → Flutter app: uses
- Fan → Flutter app: uses
- Flutter app → Tournament setup: offers (evidence: `README.md`)
- Flutter app → Team and player registration: offers (evidence: `README.md`)
- Flutter app → Venues and schedule: offers (evidence: `README.md`)
- Flutter app → Match reporting: offers (evidence: `README.md`)
- Flutter app → Standings and statistics: offers (evidence: `README.md`)
- Flutter app → Performance views: offers (evidence: `README.md`)
- Flutter app → News and alerts: offers (evidence: `README.md`)
- Flutter app → Supabase PostgreSQL: uses (evidence: `README.md`)
- Flutter app → Hive local persistence: uses (evidence: `README.md`)
