Aller au contenu principal

Plan directeur

title: Django DRF LLM Wiki - Plan directeur tags:

  • django
  • drf
  • llm-wiki
  • tutorial
  • pedagogy
  • architecture aliases:
  • Plan directeur Django DRF Wiki
  • Roadmap Django DRF LLM Wiki created: 2026-04-18 updated: 2026-04-24 type: meta status: active

Django DRF LLM Wiki - Plan directeur

Repères utiles :

info

Cette note définit la vision générale du wiki, son périmètre, sa structure éditoriale, les grands cas d'usage couverts et l'état stable de la version actuelle.

1. Pourquoi ce wiki existe​

L'objectif n'est pas de produire une simple collection de notes sur Django et DRF.

L'objectif est de construire un grand wiki pédagogique, en français, qui aide une personne à comprendre :

  • ce qu'est Django ;
  • ce qu'est Django REST Framework ;
  • quand utiliser Django DRF ;
  • quand ne pas l'utiliser ;
  • comment penser un projet backend proprement ;
  • comment aborder différents cas d'usage réels sans se perdre ;
  • comment passer du cadrage au code avec une structure raisonnable.

Autrement dit, le wiki sert à la fois de :

  • guide d'apprentissage ;
  • guide de décision ;
  • référence structurée ;
  • base pratique pour construire des projets Django DRF.

2. Public cible​

Ce wiki doit pouvoir parler à plusieurs profils.

Débutant motivé​

Quelqu'un qui a entendu parler de Django ou DRF, mais ne comprend pas encore clairement à quoi cela sert ni comment l'utiliser.

Développeur junior ou intermédiaire​

Quelqu'un qui a déjà vu des APIs, mais qui veut mieux comprendre comment raisonner en termes de cas d'usage, d'architecture, de permissions, de backend métier et de structure DRF.

Lecteur en phase de cadrage produit​

Quelqu'un qui cherche à répondre à des questions comme :

  • est-ce que Django DRF est adapté à mon besoin ?
  • comment structurer mon backend ?
  • quel use case correspond à mon projet ?
  • quels risques dois-je vérifier avant de livrer ?

3. Ce que ce wiki doit être​

Ce wiki doit être :

  • clair ;
  • pédagogique ;
  • progressif ;
  • pratique ;
  • structuré ;
  • non bâclé ;
  • réutilisable dans le temps.

4. Ce que ce wiki ne doit pas être​

Ce wiki ne doit pas devenir :

  • une suite de mini-notes trop courtes ;
  • un pense-bête réservé à quelqu'un qui connaît déjà tout ;
  • une encyclopédie froide sans fil pédagogique ;
  • un catalogue de snippets sans explication ;
  • un tutoriel purement technique qui oublie le contexte métier.

5. Structure actuelle​

La version stable actuelle est organisée en quatre blocs.

Bloc A — Pilotage​

Notes qui définissent le projet documentaire :

Bloc B — Navigation et raffinement transversal​

Notes qui aident le lecteur à utiliser le wiki :

Bloc C — Fondations​

Le socle indispensable avant les grands cas d'usage :

Bloc D — Use Cases​

Le cœur pratique du wiki :

6. État des grands use cases​

Les 7 grands use cases principaux sont présents. Ils ne sont plus seulement conceptuels : chacun contient une logique de mini-projet, une structure de fichiers, une implémentation guidée avec code et une vérification guidée.

La progression canonique est :

  1. web/mobile ;
  2. utilisateurs, rôles et permissions ;
  3. application métier / SaaS / outil interne ;
  4. back-office et admin Django ;
  5. application centrée base de données ;
  6. API B2B / API interne ;
  7. backend produit autour d'un système IA.

7. Rôle de la checklist pratique​

Checklist pratique sert de passerelle entre le wiki et un vrai projet.

Elle permet de vérifier :

  • le cadrage avant code ;
  • le modèle de données ;
  • les serializers ;
  • les viewsets et routes ;
  • l'authentification et les permissions ;
  • les workflows ;
  • l'admin/back-office ;
  • les filtres, la pagination et la stabilité d'API ;
  • la vérification manuelle avant livraison.

8. Niveau de détail attendu​

Le niveau de détail attendu est volontairement élevé. Cela signifie que :

  • les sections de contexte sont importantes ;
  • les définitions sont importantes ;
  • les exemples sont importants ;
  • les transitions entre sections sont importantes ;
  • les explications intermédiaires sont importantes ;
  • le code doit être accompagné d'une explication et d'une vérification.

On privilégie donc :

  • la compréhension profonde ;
  • la cohérence pédagogique ;
  • la clarté du parcours lecteur ;
  • l'utilité pratique.

9. Critère de réussite du wiki​

Le wiki réussit s'il fait trois choses en même temps :

  1. former quelqu'un qui découvre Django DRF ;
  2. aider à décider si Django DRF est adapté à un projet donné ;
  3. servir de référence pratique pour revenir sur un use case précis.

La version actuelle atteint ce seuil pour une première version publiée. Les évolutions futures pourront ajouter des comparaisons, des chapitres spécialisés ou des exemples issus de vrais repos, mais le socle principal est stabilisé.

success

La version actuelle du Django DRF LLM Wiki est publiable : elle contient le socle, les grands cas d'usage, une navigation guidée, une checklist projet et une FAQ transversale.