Aller au contenu principal

Parcours de lecture

Repères utiles
remarque

Cette note sert à orienter le lecteur selon son niveau et selon son objectif. Le wiki contient maintenant plusieurs gros chapitres : ce parcours aide à ne pas les lire comme une simple pile de notes.

Pourquoi cette note existe​

Maintenant que le wiki contient :

  • le socle backend,
  • plusieurs chapitres avancés,
  • un bonus frontend,

il devient utile d’avoir une route de lecture claire.

Le bon ordre dépend en réalité de ce que tu veux faire :

  • apprendre FastAPI sérieusement,
  • construire une API produit réaliste,
  • brancher une interface React,
  • comprendre l’auth et les notifications,
  • préparer un déploiement plus propre.

Parcours canonique de la v1​

Si tu veux suivre le wiki presque de bout en bout sans te demander quoi lire ensuite, suis cet ordre :

  1. Plan directeur
  2. API de base
  3. Advanced FastAPI
  4. Authentification avec FastAPI
  5. Relations SQL avec FastAPI
  6. Gestion d’erreurs avec FastAPI
  7. Middleware avec FastAPI
  8. Tests avec FastAPI
  9. Docker avec FastAPI
  10. Réponses personnalisées avec FastAPI
  11. Notifications et communication utilisateur avec FastAPI
  12. Tâches asynchrones avec Celery et FastAPI
  13. Frontend React consommant l’API FastAPI
  14. FAQ, erreurs fréquentes et conseils pratiques

Pourquoi cet ordre ?​

Parce qu’il correspond maintenant à la forme stabilisée de la v1 :

  • un socle d’architecture
  • une montée en puissance backend
  • des couches de robustesse
  • des flux utilisateur réalistes
  • une ouverture vers l’async puis le bonus frontend

[SCHEMA](/docs/schema) et [Template de tutoriel](/docs/fastapi-llm-wiki-template-de-tutoriel) restent des notes utiles si tu veux comprendre la fabrique du wiki, mais elles ne sont pas nécessaires pour suivre l’apprentissage FastAPI lui-même.

Parcours recommandé si ton but est "API produit réaliste"​

Lis dans cet ordre :

  1. API de base
  2. Authentification avec FastAPI
  3. Relations SQL avec FastAPI
  4. Gestion d’erreurs avec FastAPI
  5. Middleware avec FastAPI
  6. Réponses personnalisées avec FastAPI
  7. Notifications et communication utilisateur avec FastAPI
  8. Tâches asynchrones avec Celery et FastAPI
  9. Tests avec FastAPI
  10. Docker avec FastAPI

Pourquoi cet ordre ?​

Parce qu’il se rapproche d’un backend applicatif crédible :

  • utilisateurs,
  • ownership,
  • erreurs propres,
  • instrumentation,
  • UX backend,
  • emails / reset / SMS,
  • tâches async,
  • tests,
  • environnement reproductible.

Parcours recommandé si ton but est "authentification et cycle utilisateur"​

Concentre-toi surtout sur :

  1. API de base
  2. Authentification avec FastAPI
  3. Notifications et communication utilisateur avec FastAPI
  4. Réponses personnalisées avec FastAPI
  5. Tâches asynchrones avec Celery et FastAPI

Pourquoi ?​

Parce que ce chemin couvre :

  • création de compte,
  • JWT,
  • utilisateur courant,
  • email de vérification,
  • reset password,
  • SMS,
  • délégation asynchrone via Celery.

Parcours recommandé si ton but est "qualité et robustesse"​

Lis dans cet ordre :

  1. API de base
  2. Relations SQL avec FastAPI
  3. Gestion d’erreurs avec FastAPI
  4. Middleware avec FastAPI
  5. Tests avec FastAPI
  6. Docker avec FastAPI
  7. Tâches asynchrones avec Celery et FastAPI

Pourquoi ?​

Parce que ce parcours répond surtout à :

  • comment garder une API cohérente,
  • comment mieux voir ce qu’elle fait,
  • comment la tester,
  • comment l’exécuter proprement,
  • comment sortir les jobs longs du thread HTTP.

Parcours recommandé si ton but est "full-stack simple avec React"​

Lis dans cet ordre :

  1. API de base
  2. Authentification avec FastAPI
  3. Notifications et communication utilisateur avec FastAPI
  4. Réponses personnalisées avec FastAPI
  5. Tâches asynchrones avec Celery et FastAPI
  6. Frontend React consommant l’API FastAPI

Pourquoi ?​

Parce que le frontend React ne prend son sens que si tu comprends déjà :

  • le login backend,
  • le reset password,
  • les routes protégées,
  • les appels métier réellement disponibles,
  • le rôle du token côté client.

Parcours recommandé si tu veux seulement aller vite vers le déploiement​

Lis dans cet ordre :

  1. API de base
  2. Tests avec FastAPI
  3. Docker avec FastAPI
  4. Tâches asynchrones avec Celery et FastAPI

Pourquoi ?​

Parce que ce chemin cible surtout :

  • exécution reproductible,
  • validation minimale,
  • services annexes,
  • worker + Redis.

Parcours court minimal​

Si tu veux juste voir le fil principal sans tout lire :

  1. API de base
  2. Authentification avec FastAPI
  3. Relations SQL avec FastAPI
  4. Tests avec FastAPI
  5. Docker avec FastAPI

C’est la version la plus courte qui garde une vraie logique produit.

Conseil pratique​

Si un chapitre te semble trop avancé :

  • ne force pas,
  • reviens à API de base,
  • puis reprends le parcours adapté à ton objectif.

Le wiki est fait pour être progressif, pas pour être lu de manière punitive ou rigide.

Résumé rapide​

Le plus important à retenir est simple :

  • API de base reste le socle,
  • Advanced FastAPI organise la montée en puissance,
  • le frontend React est un bonus utile,
  • cette note sert à choisir le bon ordre, pas juste l’ordre chronologique d’écriture.