Aller au contenu principal

schema

title: SCHEMA tags:

  • django
  • drf
  • llm-wiki
  • schema
  • pedagogy aliases:
  • Django DRF LLM Wiki Schema created: 2026-04-18 updated: 2026-04-24 type: schema status: active

SCHEMA

Repères utiles :

Domain​

Ce wiki couvre Django et Django REST Framework sous la forme d'un guide pédagogique en français, organisé autour de fondations, de grands cas d'usage et d'une couche de navigation pratique.

L'objectif n'est pas seulement d'expliquer des concepts isolés. L'objectif est de permettre à une personne de comprendre quand utiliser Django DRF, pourquoi, comment structurer un projet, et comment avancer pas à pas.

Core Promise​

Chaque contenu du wiki doit respecter cette promesse :

  • être compréhensible par un débutant motivé ;
  • rester utile à un lecteur intermédiaire ;
  • relier raisonnement produit, architecture backend et mise en œuvre DRF ;
  • rester révisable sans casser la structure globale.

Editorial Principles​

1. Pédagogie avant densité brute​

On ne cherche pas à impressionner le lecteur. On cherche à l'aider à comprendre.

Donc :

  • définir les termes avant de les utiliser intensivement ;
  • expliquer le pourquoi avant le comment ;
  • éviter les sauts implicites ;
  • reformuler quand un concept risque d'être flou.

2. Pratique guidée obligatoire pour les grands use cases​

Un grand chapitre use case ne doit pas rester purement conceptuel. Il doit montrer :

  • un mini-projet ou scénario réaliste ;
  • une structure de fichiers ;
  • les fichiers Django/DRF importants ;
  • du code expliqué ;
  • une méthode de vérification.

3. Progressivité obligatoire​

Chaque tutoriel doit aller du plus simple au plus structurant :

  1. le problème réel ;
  2. le contexte ;
  3. le vocabulaire ;
  4. la vision d'ensemble ;
  5. l'architecture type ;
  6. la mise en œuvre ;
  7. la vérification ;
  8. les pièges et évolutions possibles.

4. Navigation explicite​

Le wiki doit éviter l'effet “pile de notes”. Chaque lecteur doit pouvoir se repérer via :

Folder Structure​

Structure réelle de la version stable actuelle :

Django DRF LLM Wiki/
├── SCHEMA.md
├── index.md
├── log.md
├── Django DRF LLM Wiki - Plan directeur.md
├── Django DRF LLM Wiki - Template de tutoriel.md
├── Django DRF LLM Wiki - Parcours de lecture.md
├── Checklist pratique de projet Django DRF.md
├── Django DRF - FAQ, erreurs fréquentes et conseils pratiques.md
├── Foundations/
└── Use Cases/

Les dossiers Glossaire, Comparisons et Sources ne sont pas obligatoires pour cette version. Ils pourront être ajoutés plus tard si un besoin réel apparaît.

Page Types​

1. Schema​

Définit les règles du wiki.

2. Meta / Pilotage​

Pages de cadrage, feuille de route, décisions éditoriales et journal d'itération.

3. Navigation / Raffinement transversal​

Pages qui aident à utiliser le wiki : parcours de lecture, checklist projet, FAQ et conseils pratiques.

4. Foundation​

Pages de socle : Django, DRF, logique d'API, modèles, serializers, viewsets, routers, permissions et architecture générale.

5. Use Case​

Tutoriels longs et complets orientés cas d'usage. Exemples :

  • backend pour app web/mobile ;
  • API avec rôles et permissions ;
  • application métier / SaaS ;
  • back-office et admin Django ;
  • application data-centric ;
  • API B2B / interne ;
  • backend produit autour d'un système IA.

Required Frontmatter​

Chaque nouvelle note doit au minimum contenir :

---
title: Nom de la note
tags:
  - django
  - drf
created: YYYY-MM-DD
updated: YYYY-MM-DD
type: meta | foundation | use-case | schema
status: draft | active | revised
---

Naming Conventions​

  • Les notes doivent avoir des noms lisibles, humains et explicites.
  • On privilégie les titres longs mais clairs plutôt que des abréviations cryptiques.
  • Si un titre pédagogique contient /, utiliser un nom de fichier avec - et un alias wikilink lisible.

Exemples :

  • Django DRF LLM Wiki - Plan directeur
  • Backend pour application web ou mobile avec Django DRF
  • Application métier - SaaS - outil interne avec Django DRF

Pedagogical Checklist​

Chaque grand tutoriel doit, si pertinent, couvrir :

  • pour qui est le tutoriel ;
  • le problème concret à résoudre ;
  • quand utiliser Django DRF pour ce cas ;
  • quand ne pas l'utiliser ;
  • les prérequis ;
  • le vocabulaire indispensable ;
  • la vision d'ensemble ;
  • l'architecture type ;
  • une structure de mini-projet ;
  • une implémentation guidée avec code ;
  • une vérification guidée ;
  • les erreurs fréquentes ;
  • les bonnes pratiques ;
  • les limites ;
  • les pistes d'amélioration ;
  • un résumé final et des liens de suite.

Minimum Quality Bar​

Une note n'est pas considérée comme suffisante si elle :

  • fait seulement une introduction générale ;
  • ne donne pas de contexte métier ;
  • ne clarifie pas le vocabulaire clé ;
  • liste du code sans explication ;
  • liste des étapes sans vérification ;
  • laisse trop de zones implicites.

Chaque note importante doit essayer de pointer vers :

  • une note de fondation ;
  • un ou plusieurs use cases liés ;
  • le parcours de lecture ;
  • la checklist pratique ;
  • la FAQ si elle peut débloquer le lecteur.

Tag Taxonomy​

Tags principaux autorisés pour ce wiki :

  • django
  • drf
  • llm-wiki
  • pedagogy
  • tutorial
  • foundation
  • use-case
  • backend
  • api
  • orm
  • serializer
  • viewset
  • router
  • auth
  • permissions
  • admin
  • saas
  • b2b
  • mobile
  • web
  • database
  • architecture
  • ia
  • product
  • checklist

Revision Policy​

Le wiki est pensé pour l'itération. Donc :

  • on peut enrichir une note existante ;
  • on peut réécrire une note si sa pédagogie est insuffisante ;
  • on peut déplacer une section si sa place est meilleure ailleurs ;
  • on documente les grandes évolutions dans Journal d’itération.

Current Version Definition​

La version actuelle est considérée comme stable quand :

  • les fondations sont présentes ;
  • les 7 grands use cases sont présents ;
  • les use cases contiennent une mise en œuvre guidée ;
  • le parcours de lecture existe ;
  • la checklist pratique existe ;
  • la FAQ transversale existe ;
  • les wikilinks ne sont pas cassés.