# hackerd-825/playverse architecture

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

- Interactive diagram: https://gitdiagram.com/hackerd-825/playverse
- Repository: https://github.com/hackerd-825/playverse

## Overview

PlayVerse est un hub web de mini-jeux : l’utilisateur découvre le catalogue depuis la page d’accueil, puis ouvre un jeu. Le serveur Express expose aussi les fichiers statiques et construit un catalogue à partir des pages HTML de `game`; une fonction API distincte reprend cette génération. Le README mentionne une interface animée et un lien vers PICO‑8 EDU, mais les pages HTML n’ont pas été examinées : leurs liaisons internes restent donc non vérifiées.

Main entry points: [`index.html`](https://github.com/hackerd-825/playverse/blob/main/index.html) (Accueil interactif), [`server.js`](https://github.com/hackerd-825/playverse/blob/main/server.js) (Fichiers statiques), [`api/games.js`](https://github.com/hackerd-825/playverse/blob/main/api/games.js) (API catalogue), [`game/scrap_boy.html`](https://github.com/hackerd-825/playverse/blob/main/game/scrap_boy.html) (Scrap Boy)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Expérience de jeu"]
  node_home["Accueil interactif<br/>[index.html]"]
  node_visuals["Ambiance animée<br/>[index.html]"]
  node_pico["PICO-8 EDU"]
  node_gamepages["Pages de jeux"]
  node_scrapboy["Scrap Boy<br/>[scrap_boy.html]"]
  node_scraplogic["Logique Scrap Boy<br/>[scrap_boy.js]"]
  node_assets["Images de jeux"]
end

subgraph group_catalog["Catalogue des jeux"]
  node_expresscatalog["Catalogue Express<br/>[server.js]"]
  node_vercelapi["API catalogue<br/>[games.js]"]
  node_gamefiles["Pages HTML détectées"]
  node_catalogdata["Liste des jeux"]
end

subgraph group_runtime["Serveur web"]
  node_express["Serveur Express<br/>[server.js]"]
  node_static["Fichiers statiques<br/>[server.js]"]
end

node_player(("Joueur"))

node_player -->|"ouvre"| node_home
node_home -->|"sélectionne"| node_gamepages
node_home -->|"affiche"| node_visuals
node_home -->|"propose un lien"| node_pico
node_player -->|"joue"| node_scrapboy
node_scrapboy -.->|"utilise"| node_scraplogic
node_express -->|"sert"| node_static
node_static -->|"sert"| node_home
node_static -->|"sert"| node_gamepages
node_static -->|"sert"| node_assets
node_express -->|"enregistre"| node_expresscatalog
node_expresscatalog -->|"parcourt"| node_gamefiles
node_expresscatalog -->|"renvoie"| node_catalogdata
node_vercelapi -->|"parcourt"| node_gamefiles
node_vercelapi -->|"renvoie"| node_catalogdata
node_home -.->|"charge le catalogue"| node_vercelapi

click node_home "https://github.com/hackerd-825/playverse/blob/main/index.html"
click node_visuals "https://github.com/hackerd-825/playverse/blob/main/index.html"
click node_gamepages "https://github.com/hackerd-825/playverse/tree/main/game"
click node_scrapboy "https://github.com/hackerd-825/playverse/blob/main/game/scrap_boy.html"
click node_scraplogic "https://github.com/hackerd-825/playverse/blob/main/game/scrap_boy.js"
click node_assets "https://github.com/hackerd-825/playverse/tree/main/image"
click node_express "https://github.com/hackerd-825/playverse/blob/main/server.js"
click node_static "https://github.com/hackerd-825/playverse/blob/main/server.js"
click node_expresscatalog "https://github.com/hackerd-825/playverse/blob/main/server.js"
click node_vercelapi "https://github.com/hackerd-825/playverse/blob/main/api/games.js"
click node_gamefiles "https://github.com/hackerd-825/playverse/tree/main/game"

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_home,node_visuals,node_pico,node_gamepages,node_scrapboy,node_scraplogic,node_assets toneBlue
class node_expresscatalog,node_vercelapi,node_gamefiles,node_catalogdata toneAmber
class node_express,node_static toneMint
class node_player toneIndigo
```

## Components

### Expérience de jeu

- [Accueil interactif](https://github.com/hackerd-825/playverse/blob/main/index.html): `index.html`
- [Ambiance animée](https://github.com/hackerd-825/playverse/blob/main/index.html): `index.html`
- **PICO-8 EDU**
- [Pages de jeux](https://github.com/hackerd-825/playverse/tree/main/game): `game`
- [Scrap Boy](https://github.com/hackerd-825/playverse/blob/main/game/scrap_boy.html): `game/scrap_boy.html`
- [Logique Scrap Boy](https://github.com/hackerd-825/playverse/blob/main/game/scrap_boy.js): `game/scrap_boy.js`
- [Images de jeux](https://github.com/hackerd-825/playverse/tree/main/image): `image`

### Catalogue des jeux

- [Catalogue Express](https://github.com/hackerd-825/playverse/blob/main/server.js): `server.js`
- [API catalogue](https://github.com/hackerd-825/playverse/blob/main/api/games.js): `api/games.js`
- [Pages HTML détectées](https://github.com/hackerd-825/playverse/tree/main/game): `game`
- **Liste des jeux**

### Serveur web

- [Serveur Express](https://github.com/hackerd-825/playverse/blob/main/server.js): `server.js`
- [Fichiers statiques](https://github.com/hackerd-825/playverse/blob/main/server.js): `server.js`

### Other components

- **Joueur**

## Connections

- Joueur → Accueil interactif: ouvre (evidence: `README.md`)
- Accueil interactif → Pages de jeux: sélectionne (evidence: `README.md`)
- Accueil interactif → Ambiance animée: affiche (evidence: `README.md`)
- Accueil interactif → PICO-8 EDU: propose un lien (evidence: `README.md`)
- Joueur → Scrap Boy: joue (evidence: `README.md`)
- Scrap Boy → Logique Scrap Boy: utilise
- Serveur Express → Fichiers statiques: sert (evidence: `server.js`)
- Fichiers statiques → Accueil interactif: sert (evidence: `server.js`)
- Fichiers statiques → Pages de jeux: sert (evidence: `server.js`)
- Fichiers statiques → Images de jeux: sert (evidence: `server.js`)
- Serveur Express → Catalogue Express: enregistre (evidence: `server.js`)
- Catalogue Express → Pages HTML détectées: parcourt (evidence: `server.js`)
- Catalogue Express → Liste des jeux: renvoie (evidence: `server.js`)
- API catalogue → Pages HTML détectées: parcourt (evidence: `api/games.js`)
- API catalogue → Liste des jeux: renvoie (evidence: `api/games.js`)
- Accueil interactif → API catalogue: charge le catalogue
