Tutoriels¶

Les tutoriels sont des parcours d'apprentissage guidés. Vous suivez une série d'étapes précises pour construire quelque chose de concret. L'objectif n'est pas de comprendre en profondeur chaque décision — c'est d'acquérir la confiance de faire fonctionner gitrust entre vos mains.

Diátaxis — mode apprentissage : chaque tutoriel est orienté vers l'expérience pratique. Vous apprendrez en faisant, pas en lisant.

Parcours recommandé¶

flowchart LR
    T01["01 — Installer
l'environnement
~45 min"]
    T02["02 — Première
contribution
~90 min"]
    T03["03 — Worker
async
~120 min"]

    T01 --> T02
    T02 --> T03

    style T01 fill:#4ade80,color:#000
    style T02 fill:#60a5fa,color:#000
    style T03 fill:#f472b6,color:#000

Chaque tutoriel indique ses prérequis au début. Ne sautez pas un niveau sans avoir vérifié les prérequis — les étapes suivantes supposent que vous avez les outils installés et un dépôt fonctionnel en local.

Les tutoriels¶

01 — Démarrer avec le code gitrust¶

Durée estimée : 45 minutes | Niveau : débutant

Vous installez Rust, PostgreSQL, et les outils gitrust. À la fin, vous lancez l'application en local et vous voyez la page d'accueil.

Prérequis : Linux ou macOS, accès sudo.

02 — Première contribution : corriger un bug¶

Durée estimée : 90 minutes | Niveau : intermédiaire

Vous identifiez un bug réel, créez une branche, écrivez un test qui échoue (TDD), corrigez le code, passez la QA, et ouvrez une Pull Request.

Prérequis : tutoriel 01 terminé, fork du dépôt gitrust.

03 — Créer un worker async de bout en bout¶

Durée estimée : 120 minutes | Niveau : avancé

Tutoriel capstone. Vous construisez un worker complet : migration DB, struct d'état, canal mpsc, Semaphore, handler SSE, et tests d'intégration.

Prérequis : tutoriels 01 et 02 terminés, connaissance de base de Rust async.

Ce que les tutoriels ne font pas¶

Les tutoriels ne vous expliquent pas pourquoi les choses fonctionnent ainsi. Pour comprendre les décisions d'architecture, consultez la section Explication. Pour accomplir une tâche spécifique sans apprentissage guidé, consultez les Guides pratiques.