FastAPI LLM Wiki

Repères utiles

• SCHEMA
• Plan directeur
• Template de tutoriel
• Journal d’itération

Catalogue principal du wiki FastAPI. Cette note sert de point d'entrée pour comprendre la structure et naviguer dans les grands chapitres.

Pilotage

• Plan directeur — vision globale du wiki, blocs principaux, stratégie pédagogique et logique d'itération.
• Template de tutoriel — modèle standard pour écrire des tutoriels complets, progressifs et concrets.
• SCHEMA — règles éditoriales, exigences de qualité et principes de construction du wiki.
• Journal d’itération — journal des itérations, décisions et ajouts importants.

Fondations

Pour cette v1, le choix assumé a été de ne pas créer de notes de fondation séparées. Le wiki privilégie ici un socle pratique immédiatement ancré dans du code, puis une montée en puissance par use cases.

Si un futur enrichissement devient utile, des fondations dédiées pourront être ajoutées plus tard. Elles ne sont pas nécessaires pour suivre correctement la version actuelle.

Cas d’usage

• API de base — premier grand tutoriel pratique du wiki. Il montre comment construire une API FastAPI de base en s'appuyant sur l'architecture du repo task-organizer-API, avec plus de guidage, plus de setup et plus de code expliqué.
• Advanced FastAPI — second grand bloc du wiki. Il organise les briques avancées à ajouter sur le socle : auth, relations, notifications, error handling, middleware, tests, Docker et plus.
• Authentification avec FastAPI — premier sous-chapitre concret de Advanced FastAPI. Il montre comment ajouter inscription, login, utilisateur courant, routes protégées et compréhension du logout.
• Relations SQL avec FastAPI — deuxième sous-chapitre concret de Advanced FastAPI. Il montre comment relier vraiment les tâches aux utilisateurs et introduire l'ownership en base.
• Gestion d’erreurs avec FastAPI — troisième sous-chapitre concret de Advanced FastAPI. Il montre comment créer des exceptions métier et centraliser les handlers pour rendre l’API plus propre et robuste.
• Middleware avec FastAPI — quatrième sous-chapitre concret de Advanced FastAPI. Il montre comment ajouter une couche transversale pour le logging, le timing et le request ID.
• Tests avec FastAPI — cinquième sous-chapitre concret de Advanced FastAPI. Il montre comment tester l’API avec pytest, httpx.AsyncClient, une base mémoire et des overrides FastAPI.
• Docker avec FastAPI — sixième sous-chapitre concret de Advanced FastAPI. Il montre comment dockeriser l’application, lancer PostgreSQL avec Compose et préparer l’extension vers Redis / Celery.
• Réponses personnalisées avec FastAPI — septième sous-chapitre concret de Advanced FastAPI. Il montre comment renvoyer du JSON enrichi, des fichiers, des redirections, du HTML et une réponse custom.
• Notifications et communication utilisateur avec FastAPI — huitième sous-chapitre concret de Advanced FastAPI. Il montre comment gérer email de vérification, reset de mot de passe, templates mail et SMS optionnel.
• Tâches asynchrones avec Celery et FastAPI — neuvième sous-chapitre concret de Advanced FastAPI. Il montre comment sortir les notifications du cycle HTTP direct avec Celery et Redis.
• Frontend React consommant l’API FastAPI — dixième sous-chapitre concret de Advanced FastAPI. Il montre comment brancher un client React bonus sur l’API FastAPI, avec auth context, dashboard et appels réseau protégés.

Navigation et lecture

• Parcours de lecture — guide de lecture selon le niveau et l’objectif.
• FAQ, erreurs fréquentes et conseils pratiques — questions fréquentes, pièges classiques et réflexes utiles.

Structure volontairement légère

Pour cette version, le wiki reste simple et utile :

• pas de glossaire séparé
• pas de dossier comparatif
• pas de dossier de sources

Le choix est de concentrer l'effort sur les gros tutoriels pratiques.

État de la v1

Le wiki n'est plus en phase de construction principale. La version 1 est maintenant complète :

• un socle backend complet avec API de base
• un hub de montée en puissance avec Advanced FastAPI
• dix sous-chapitres avancés rédigés
• une couche de navigation avec Parcours de lecture et FAQ, erreurs fréquentes et conseils pratiques

Ordre de lecture recommandé

Si tu hésites sur l’ordre à suivre, commence par Parcours de lecture. C’est la note qui sert de routeur principal.

Si tu veux ensuite suivre la séquence canonique de la v1 de manière linéaire, l’ordre recommandé est :

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

SCHEMA et Template de tutoriel restent utiles si tu veux comprendre ou maintenir la fabrique éditoriale du wiki, mais ils ne font pas partie du chemin d’apprentissage principal.

État actuel

• Statut global : version 1 terminée et stabilisée
• Socle principal : API de base
• Hub avancé : Advanced FastAPI
• Sous-chapitres avancés : 10
• Couche de navigation : Parcours de lecture + FAQ, erreurs fréquentes et conseils pratiques
• Qualité structurelle attendue en clôture : liens internes propres, navigation cohérente, aucun chapitre majeur laissé sans sortie claire
• Positionnement éditorial : wiki pratique, backend-first, en français, avec code obligatoire dans les gros tutoriels
• État du projet : plus aucune tâche éditoriale nécessaire pour la v1