# hamza2024-code/worldskills-algeria architecture

> Architecture diagram of the GitHub repository hamza2024-code/worldskills-algeria, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hamza2024-code/worldskills-algeria
- Repository: https://github.com/hamza2024-code/worldskills-algeria

## Overview

This is a WorldSkills Algeria event-management platform built with Laravel and Livewire. The principal country workflow is managing an edition’s delegation and members, with related skill selection and dietary information; public-facing pages expose event and skill information. Separate operational areas cover accreditation/access control, event logistics, administration, and content. The graph also shows settings and access-rule internals. The README is the stock Laravel README, so product capabilities are inferred from the source tree; unsampled feature links are omitted or marked unverified.

Main entry points: [`app/Livewire/Country/DelegationManager.php`](https://github.com/hamza2024-code/worldskills-algeria/blob/main/app/Livewire/Country/DelegationManager.php) (Delegation management), [`app/Services/Rules/WsapAccessRulesEngine.php`](https://github.com/hamza2024-code/worldskills-algeria/blob/main/app/Services/Rules/WsapAccessRulesEngine.php) (Access rules engine), [`app/Livewire/Public/Skills.php`](https://github.com/hamza2024-code/worldskills-algeria/blob/main/app/Livewire/Public/Skills.php) (Skills catalogue), [`app/Livewire/Admin/PlatformAppearanceManager.php`](https://github.com/hamza2024-code/worldskills-algeria/blob/main/app/Livewire/Admin/PlatformAppearanceManager.php) (Appearance settings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_delegation["Delegation &amp; Skills"]
  node_delegation_manager["Delegation management"]
  node_dietary_manager["Dietary management<br/>[DietaryManager.php]"]
  node_skill_selection["Skill selection"]
  node_country["Country records<br/>[Country.php]"]
  node_edition["Event editions<br/>[Edition.php]"]
  node_delegation_record["Delegation records"]
  node_delegation_member["Delegation members"]
  node_skill["Competition skills<br/>[Skill.php]"]
end

subgraph group_public["Public Experience"]
  node_public_skills["Skills catalogue<br/>[Skills.php]"]
  node_public_event["Event information<br/>[Home.php]"]
end

subgraph group_operations["Event Operations"]
  node_admin_cms["Homepage content"]
  node_admin_appearance["Appearance settings"]
  node_accreditation["Accreditation badges<br/>[Badge.php]"]
  node_access_rules["Access rules engine"]
  node_access_log["Access decisions"]
end

subgraph group_platform["Platform Services"]
  node_user["User accounts<br/>[User.php]"]
  node_settings["Settings engine<br/>[SettingsEngine.php]"]
  node_global_settings["Global settings<br/>[GlobalSetting.php]"]
  node_audit["Audit service<br/>[AuditService.php]"]
end

node_country_admin(("Country administrator"))
node_public_visitor(("Public visitor"))
node_admin(("Platform administrator"))

node_country_admin -.->|"manages"| node_delegation_manager
node_delegation_manager -->|"loads"| node_country
node_delegation_manager -->|"manages"| node_delegation_record
node_delegation_manager -->|"creates and updates"| node_delegation_member
node_delegation_manager -->|"loads"| node_edition
node_delegation_manager -->|"loads"| node_skill
node_delegation_manager -->|"authenticates via"| node_user
node_dietary_manager -->|"manages dietary data"| node_delegation_member
node_public_visitor -.->|"browses"| node_public_skills
node_public_skills -->|"queries"| node_skill
node_public_skills -.->|"presents event skills"| node_edition
node_public_visitor -.->|"views"| node_public_event
node_admin -.->|"manages"| node_admin_cms
node_admin_cms -->|"uses"| node_settings
node_admin -.->|"manages"| node_admin_appearance
node_admin_appearance -->|"uses"| node_settings
node_settings -->|"reads and writes"| node_global_settings
node_admin_appearance -->|"records changes through"| node_audit
node_access_rules -->|"checks badge"| node_accreditation
node_access_rules -->|"checks account"| node_user
node_access_rules -->|"checks member status"| node_delegation_member
node_access_rules -->|"records decisions"| node_access_log

click node_delegation_manager "https://github.com/hamza2024-code/worldskills-algeria/blob/main/app/Livewire/Country/DelegationManager.php"
click node_dietary_manager "https://github.com/hamza2024-code/worldskills-algeria/blob/main/app/Livewire/Country/DietaryManager.php"
click node_skill_selection "https://github.com/hamza2024-code/worldskills-algeria/blob/main/app/Livewire/Country/SkillSelectionManager.php"
click node_country "https://github.com/hamza2024-code/worldskills-algeria/blob/main/app/Models/Country.php"
click node_edition "https://github.com/hamza2024-code/worldskills-algeria/blob/main/app/Models/Edition.php"
click node_delegation_record "https://github.com/hamza2024-code/worldskills-algeria/blob/main/app/Models/CountryDelegation.php"
click node_delegation_member "https://github.com/hamza2024-code/worldskills-algeria/blob/main/app/Models/DelegationMember.php"
click node_skill "https://github.com/hamza2024-code/worldskills-algeria/blob/main/app/Models/Skill.php"
click node_public_skills "https://github.com/hamza2024-code/worldskills-algeria/blob/main/app/Livewire/Public/Skills.php"
click node_public_event "https://github.com/hamza2024-code/worldskills-algeria/blob/main/app/Livewire/Public/Home.php"
click node_admin_cms "https://github.com/hamza2024-code/worldskills-algeria/blob/main/app/Livewire/Admin/CmsHomepageManager.php"
click node_admin_appearance "https://github.com/hamza2024-code/worldskills-algeria/blob/main/app/Livewire/Admin/PlatformAppearanceManager.php"
click node_accreditation "https://github.com/hamza2024-code/worldskills-algeria/blob/main/app/Models/Badge.php"
click node_access_rules "https://github.com/hamza2024-code/worldskills-algeria/blob/main/app/Services/Rules/WsapAccessRulesEngine.php"
click node_access_log "https://github.com/hamza2024-code/worldskills-algeria/blob/main/app/Models/AccessDecisionLog.php"
click node_user "https://github.com/hamza2024-code/worldskills-algeria/blob/main/app/Models/User.php"
click node_settings "https://github.com/hamza2024-code/worldskills-algeria/blob/main/app/Services/SettingsEngine.php"
click node_global_settings "https://github.com/hamza2024-code/worldskills-algeria/blob/main/app/Models/GlobalSetting.php"
click node_audit "https://github.com/hamza2024-code/worldskills-algeria/blob/main/app/Services/AuditService.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_delegation_manager,node_dietary_manager,node_skill_selection,node_country,node_edition,node_delegation_record,node_delegation_member,node_skill toneBlue
class node_public_skills,node_public_event toneAmber
class node_admin_cms,node_admin_appearance,node_accreditation,node_access_rules,node_access_log toneMint
class node_user,node_settings,node_global_settings,node_audit toneRose
class node_country_admin,node_public_visitor,node_admin toneIndigo
```

## Components

### Delegation & Skills

- [Delegation management](https://github.com/hamza2024-code/worldskills-algeria/blob/main/app/Livewire/Country/DelegationManager.php): `app/Livewire/Country/DelegationManager.php`
- [Dietary management](https://github.com/hamza2024-code/worldskills-algeria/blob/main/app/Livewire/Country/DietaryManager.php): `app/Livewire/Country/DietaryManager.php`
- [Skill selection](https://github.com/hamza2024-code/worldskills-algeria/blob/main/app/Livewire/Country/SkillSelectionManager.php): `app/Livewire/Country/SkillSelectionManager.php`
- [Country records](https://github.com/hamza2024-code/worldskills-algeria/blob/main/app/Models/Country.php): `app/Models/Country.php`
- [Event editions](https://github.com/hamza2024-code/worldskills-algeria/blob/main/app/Models/Edition.php): `app/Models/Edition.php`
- [Delegation records](https://github.com/hamza2024-code/worldskills-algeria/blob/main/app/Models/CountryDelegation.php): `app/Models/CountryDelegation.php`
- [Delegation members](https://github.com/hamza2024-code/worldskills-algeria/blob/main/app/Models/DelegationMember.php): `app/Models/DelegationMember.php`
- [Competition skills](https://github.com/hamza2024-code/worldskills-algeria/blob/main/app/Models/Skill.php): `app/Models/Skill.php`

### Public Experience

- [Skills catalogue](https://github.com/hamza2024-code/worldskills-algeria/blob/main/app/Livewire/Public/Skills.php): `app/Livewire/Public/Skills.php`
- [Event information](https://github.com/hamza2024-code/worldskills-algeria/blob/main/app/Livewire/Public/Home.php): `app/Livewire/Public/Home.php`

### Event Operations

- [Homepage content](https://github.com/hamza2024-code/worldskills-algeria/blob/main/app/Livewire/Admin/CmsHomepageManager.php): `app/Livewire/Admin/CmsHomepageManager.php`
- [Appearance settings](https://github.com/hamza2024-code/worldskills-algeria/blob/main/app/Livewire/Admin/PlatformAppearanceManager.php): `app/Livewire/Admin/PlatformAppearanceManager.php`
- [Accreditation badges](https://github.com/hamza2024-code/worldskills-algeria/blob/main/app/Models/Badge.php): `app/Models/Badge.php`
- [Access rules engine](https://github.com/hamza2024-code/worldskills-algeria/blob/main/app/Services/Rules/WsapAccessRulesEngine.php): `app/Services/Rules/WsapAccessRulesEngine.php`
- [Access decisions](https://github.com/hamza2024-code/worldskills-algeria/blob/main/app/Models/AccessDecisionLog.php): `app/Models/AccessDecisionLog.php`

### Platform Services

- [User accounts](https://github.com/hamza2024-code/worldskills-algeria/blob/main/app/Models/User.php): `app/Models/User.php`
- [Settings engine](https://github.com/hamza2024-code/worldskills-algeria/blob/main/app/Services/SettingsEngine.php): `app/Services/SettingsEngine.php`
- [Global settings](https://github.com/hamza2024-code/worldskills-algeria/blob/main/app/Models/GlobalSetting.php): `app/Models/GlobalSetting.php`
- [Audit service](https://github.com/hamza2024-code/worldskills-algeria/blob/main/app/Services/AuditService.php): `app/Services/AuditService.php`

### Other components

- **Country administrator**
- **Public visitor**
- **Platform administrator**

## Connections

- Country administrator → Delegation management: manages
- Delegation management → Country records: loads (evidence: `app/Livewire/Country/DelegationManager.php`)
- Delegation management → Delegation records: manages (evidence: `app/Livewire/Country/DelegationManager.php`)
- Delegation management → Delegation members: creates and updates (evidence: `app/Livewire/Country/DelegationManager.php`)
- Delegation management → Event editions: loads (evidence: `app/Livewire/Country/DelegationManager.php`)
- Delegation management → Competition skills: loads (evidence: `app/Livewire/Country/DelegationManager.php`)
- Delegation management → User accounts: authenticates via (evidence: `app/Livewire/Country/DelegationManager.php`)
- Dietary management → Delegation members: manages dietary data (evidence: `app/Livewire/Country/DietaryManager.php`)
- Public visitor → Skills catalogue: browses
- Skills catalogue → Competition skills: queries (evidence: `app/Livewire/Public/Skills.php`)
- Skills catalogue → Event editions: presents event skills
- Public visitor → Event information: views
- Platform administrator → Homepage content: manages
- Homepage content → Settings engine: uses (evidence: `app/Livewire/Admin/CmsHomepageManager.php`)
- Platform administrator → Appearance settings: manages
- Appearance settings → Settings engine: uses (evidence: `app/Livewire/Admin/PlatformAppearanceManager.php`)
- Settings engine → Global settings: reads and writes (evidence: `app/Services/SettingsEngine.php`)
- Appearance settings → Audit service: records changes through (evidence: `app/Livewire/Admin/PlatformAppearanceManager.php`)
- Access rules engine → Accreditation badges: checks badge (evidence: `app/Services/Rules/WsapAccessRulesEngine.php`)
- Access rules engine → User accounts: checks account (evidence: `app/Services/Rules/WsapAccessRulesEngine.php`)
- Access rules engine → Delegation members: checks member status (evidence: `app/Services/Rules/WsapAccessRulesEngine.php`)
- Access rules engine → Access decisions: records decisions (evidence: `app/Services/Rules/WsapAccessRulesEngine.php`)
