Ce projet est un framework pédagogique, suivant une architecture Express-React connectée à une base de données :

sequenceDiagram
    box Web Client
    participant React as React
    participant Fetcher as Fetcher
    end
    box Web Server
    participant Express as Express
    participant Module as Module
    end
    box DB Server
    participant DB as MySQL Server
    end

    React-)Fetcher: event
    activate Fetcher
    Fetcher-)Express: request (HTTP)
    activate Express
    Express-)Module: route
    activate Module
    Module-)DB: request (SQL)
    activate DB
    DB--)Module: data
    deactivate DB
    Module--)Express: json
    deactivate Module
    Express--)Fetcher: response (HTTP)
    deactivate Express
    Fetcher--)React: render
    deactivate Fetcher

Le framework est pré-configuré avec un ensemble d'outils pour aider des juniors à produire du code de qualité industrielle, tout en restant un outil pédagogique :

• Express : Framework minimaliste pour créer des serveurs web et des API avec Node.js.
• React : Bibliothèque JavaScript pour construire des interfaces utilisateur interactives et modulaires.

Sous le capot (dans l'ordre alphabétique, liste non exhaustive) :

• Biome : Outil tout-en-un pour le linting, le formatage et l'analyse statique de code, conçu pour assurer la qualité et la lisibilité du code de manière performante et moderne.
• Docker : Plateforme de conteneurisation permettant de standardiser et d'automatiser les environnements de développement et de déploiement, garantissant des configurations reproductibles.
• MySQL : Système de gestion de bases de données relationnelles, utilisé pour stocker et interroger les données.
• Pico CSS : Kit CSS minimaliste et léger qui donne la priorité à la syntaxe sémantique.
• React Router (Mode Data) : Gestionnaire de routage pour les applications React, permettant la création de chemins et de composants dynamiques.
• TypeScript : Superset de JavaScript ajoutant des types statiques, facilitant la maintenance et réduisant les erreurs.
• Vite : Outil de construction rapide et léger pour les applications front-end, avec un serveur de développement ultra-rapide et une optimisation des bundles pour la production.
• Vitest : Framework de test JavaScript.
• Zod : Bibliothèque de déclaration et de validation de schéma axée sur TypeScript.

Une documentation complète est disponible dans notre wiki.

Pour démarrer, référez-vous aux pages :

• Installation
• Database
• Express
• React

.
├── .env
├── .env.sample
├── compose.yaml
├── compose.prod.yaml
├── Dockerfile
├── index.html
├── server.ts
└── src
    ├── database
    │   └── schema.sql
    ├── express
    │   ├── modules
    │   │   └── ...
    │   └── routes.ts
    ├── react
    │   ├── components
    │   │   └── ...
    │   ├── pages
    │   │   └── ...
    │   └── routes.tsx
    └── types
        └── index.d.ts