Journal d’itération
Repères utiles :
Journal des itérations et des grandes décisions du Django DRF LLM Wiki.
[2026-04-18] create | Initialisation du wiki
- Création du dossier
Projects/Django DRF LLM Wiki. - Création des sous-dossiers :
Foundations,Use Cases,Glossaire,Comparisons,Sources. - Création de
SCHEMA.md. - Création de
index.md. - Création de
Django DRF LLM Wiki - Plan directeur.md. - Création de
Django DRF LLM Wiki - Template de tutoriel.md. - Décision éditoriale : construire le wiki par itérations incrémentales, avec un niveau pédagogique élevé et des tutoriels longs, complets et révisables.
- Décision structurelle : rédiger d'abord le cadre, puis les fondations, puis les gros use cases.
[2026-04-18] update | Itération 2 — socle de fondation
- Création de
Foundations/Comprendre Django.md. - Création de
Foundations/Comprendre Django REST Framework.md. - Création de
Foundations/Comment penser une API avec Django DRF.md. - Création de
Foundations/Les briques de base de Django DRF.md. - Mise à jour de
index.mdpour référencer les nouvelles notes de fondation. - Décision éditoriale : poser les bases conceptuelles avant d'ouvrir le premier grand tutoriel orienté use case.
- Décision de progression : le prochain incrément recommandé est
Backend pour application web ou mobile avec Django DRF.
[2026-04-18] update | Itération 3 — premier grand use case
- Création de
Use Cases/Backend pour application web ou mobile avec Django DRF.md. - Le tutoriel a été structuré pour couvrir : problème concret, quand utiliser Django DRF, quand ne pas l'utiliser, prérequis, vocabulaire, vision d'ensemble, architecture type, construction pas à pas, pièges, bonnes pratiques, variantes et résumé final.
- Mise à jour de
index.mdpour référencer ce premier grand tutoriel use case. - Décision pédagogique : après le socle de fondation, commencer par le cas web/mobile était le meilleur choix pour relier naturellement frontend séparé, API JSON, auth, permissions et architecture backend moderne.
- Décision de progression : le prochain incrément recommandé est
API avec utilisateurs, rôles et permissions avec Django DRF.
[2026-04-18] update | Itération 4 — rôles et permissions
- Création de
Use Cases/API avec utilisateurs, rôles et permissions avec Django DRF.md. - Le tutoriel a été structuré pour couvrir : problème concret, auth vs autorisation, rôles, permissions, permissions globales vs permissions objet, architecture type, construction pas à pas, pièges, bonnes pratiques, variantes et résumé final.
- Mise à jour de
index.mdpour référencer ce deuxième grand tutoriel use case. - Décision pédagogique : approfondir très tôt les rôles et permissions permet de consolider la sécurité, la clarté des responsabilités et la qualité architecturale du backend.
- Décision de progression : le prochain incrément recommandé est
Application métier / SaaS / outil interne avec Django DRF.
[2026-04-18] update | Itération 5 — application métier / SaaS / outil interne
- Création de
Use Cases/Application métier - SaaS - outil interne avec Django DRF.md. - Le tutoriel a été structuré pour couvrir : définition du problème métier, spécificités des SaaS et outils internes, logique métier, workflows, validations métier, traçabilité, exploitation interne, architecture type, construction pas à pas, pièges, bonnes pratiques, variantes et résumé final.
- Mise à jour de
index.mdpour référencer ce troisième grand tutoriel use case. - Décision pédagogique : consolider tôt la compréhension des applications métier permet d'éviter une vision trop simpliste de Django DRF comme simple générateur de CRUD.
- Décision de progression : le prochain incrément recommandé est
Produit avec back-office et admin Django.
[2026-04-18] update | Itération 6 — back-office et admin Django
- Création de
Use Cases/Produit avec back-office et admin Django.md. - Le tutoriel a été structuré pour couvrir : différence entre produit utilisateur, back-office et admin Django, besoins d'exploitation, quand l'admin intégré suffit, quand un back-office dédié devient nécessaire, architecture type, construction pas à pas, pièges, bonnes pratiques, variantes et résumé final.
- Mise à jour de
index.mdpour référencer ce quatrième grand tutoriel use case. - Décision pédagogique : mettre tôt l'accent sur l'exploitation interne et l'admin Django permet de mieux faire comprendre l'un des avantages distinctifs majeurs de Django.
- Décision de progression : le prochain incrément recommandé est
Application centrée base de données avec Django DRF.
[2026-04-18] update | Itération 7 — application centrée base de données
- Création de
Use Cases/Application centrée base de données avec Django DRF.md. - Le tutoriel a été structuré pour couvrir : définition d'une application data-centric, rôle du modèle de données, relations, intégrité, usages de lecture, filtres, pagination, administration interne, architecture type, construction pas à pas, pièges, bonnes pratiques, variantes et résumé final.
- Mise à jour de
index.mdpour référencer ce cinquième grand tutoriel use case. - Décision pédagogique : traiter ce chapitre après le back-office et les applications métier aide à mieux montrer que la donnée n'est pas un simple détail technique mais une partie centrale de l'architecture produit.
- Décision de progression : le prochain incrément recommandé est
API B2B / API interne avec Django DRF.
[2026-04-18] update | Itération 8 — API B2B / API interne
- Création de
Use Cases/API B2B - API interne avec Django DRF.md. - Le tutoriel a été structuré pour couvrir : définition des APIs B2B et internes, notion de contrat API, périmètre d'accès, stabilité, intégration système-à-système, permissions, architecture type, construction pas à pas, pièges, bonnes pratiques, variantes et résumé final.
- Mise à jour de
index.mdpour référencer ce sixième grand tutoriel use case. - Décision pédagogique : traiter ce chapitre après les cas data-centric, métier et permissions aide à faire comprendre qu'une API n'est pas seulement une interface frontend, mais aussi une surface contractuelle entre systèmes.
- Décision de progression : le prochain incrément recommandé est
Backend produit autour d'un système IA avec Django DRF.
[2026-04-18] update | Itération 9 — backend produit autour d'un système IA
- Création de
Use Cases/Backend produit autour d'un système IA avec Django DRF.md. - Le tutoriel a été structuré pour couvrir : différence entre modèle IA et couche produit, gestion des utilisateurs, projets, jobs, résultats, artefacts, permissions, traçabilité, exploitation, architecture type, construction pas à pas, pièges, bonnes pratiques, variantes et résumé final.
- Mise à jour de
index.mdpour référencer ce septième grand tutoriel use case. - Décision pédagogique : terminer par ce chapitre permet de réutiliser toutes les briques déjà posées — API, permissions, métier, back-office, donnée, intégrations — pour montrer qu'un produit IA sérieux est un système complet et non un simple endpoint d'inférence.
- Décision de progression : le plan principal des grands use cases est maintenant terminé ; la prochaine phase recommandée est un raffinage transversal du wiki.
[2026-04-18] update | Itération 10 — raffinement transversal
- Création de
Django DRF LLM Wiki - Parcours de lecture.mdpour guider la lecture selon le niveau, le type de projet et le besoin réel. - Création de
Django DRF - FAQ, erreurs fréquentes et conseils pratiques.mdpour répondre aux blocages fréquents, renforcer la pédagogie transversale et réduire les contresens. - Ajout de liens transversaux vers le parcours de lecture et la FAQ dans les notes de fondation, les principaux use cases, le plan directeur et le template.
- Correction du lien humain
Application métier / SaaS / outil interne avec Django DRFvia un alias compatible Obsidian. - Mise à jour de
index.mdpour faire apparaître une sectionRaffinement transversalet refléter la dépriorisation deGlossaire,ComparisonsetSourcespour cette version. - Décision pédagogique : privilégier un parcours de lecture guidé et une FAQ transversale améliore immédiatement l'utilisabilité du wiki sans alourdir la structure par des annexes non prioritaires.
- Décision finale : la structure principale du wiki et son polish utile sont terminés ; ce qui reste désormais relève uniquement d'améliorations optionnelles futures.
[2026-04-18] update | Ajustement après relecture utilisateur
- Retour utilisateur : les use cases sont jugés trop conceptuels ; l'attente explicite est d'avoir aussi du code DRF et des étapes guidées d'implémentation.
- Mise à jour de
Django DRF LLM Wiki - Template de tutoriel.mdpour rendre explicites les sections : structure du mini-projet, implémentation guidée avec code, et vérification guidée. - Mise à jour de
SCHEMA.mdpour exiger davantage de code guidé dans les chapitres use case pratiques. - Enrichissement de
Use Cases/Backend pour application web ou mobile avec Django DRF.mdavec un mini-projet concret : modèles, serializers, permission, viewsets, router, admin, commandes et vérifications. - Mise à jour de
index.mdpour indiquer que le wiki entre dans une phase de réécriture progressive des use cases vers un format plus guidé et plus concret.
[2026-04-18] update | Réécriture guidée des 6 use cases restants
- Enrichissement de
Use Cases/API avec utilisateurs, rôles et permissions avec Django DRF.mdavec un mini-projet guidé d'équipe, rôles, permissions, viewset DRF et vérification des droits. - Enrichissement de
Use Cases/Application métier - SaaS - outil interne avec Django DRF.mdavec un mini-projet de demandes d'achat, workflow métier, actions DRF et vérification guidée. - Enrichissement de
Use Cases/Produit avec back-office et admin Django.mdavec un mini-projet de commandes, API back-office staff, admin Django configuré et vérification guidée. - Enrichissement de
Use Cases/Application centrée base de données avec Django DRF.mdavec un mini-projet d'inventaire, relations de données, filtres, recherche, pagination et vérification guidée. - Enrichissement de
Use Cases/API B2B - API interne avec Django DRF.mdavec un mini-projet versionné par token, périmètre partenaire, contrat API stable et vérification guidée. - Enrichissement de
Use Cases/Backend produit autour d'un système IA avec Django DRF.mdavec un mini-projet projets/jobs/résultats, orchestration de jobs et vérification guidée. - Mise à jour de
index.mdpour refléter que tous les grands use cases disposent désormais d'une structure de mini-projet, d'une implémentation guidée avec code et d'une vérification guidée. - Décision pédagogique : fermer la phase de transition conceptuel -> concret sur les grands use cases, afin que le wiki montre désormais non seulement quand utiliser Django DRF, mais aussi comment le mettre en œuvre pas à pas.
[2026-04-18] update | Audit itératif et passe de polish
- Audit batch 1 des trois premiers use cases : structure, présence des sections pédagogiques, cohérence des liens et qualité des sections de clôture.
- Audit batch 2 des quatre use cases suivants : structure, cohérence pédagogique, densité des sections pratiques et progression entre chapitres.
- Vérification transversale : tous les grands use cases possèdent désormais mini-projet, structure, implémentation guidée et vérification guidée.
- Passe de polish sur les sections
Structure du mini-projetpour ajouter des repères de lecture expliquant le rôle de chaque fichier avant la lecture du code. - Harmonisation des liens de progression dans les sections
Pour aller plus loinafin d'utiliser des wikilinks explicites au lieu de simples mentions en gras. - Ajustement de la structure du mini-projet du chapitre
Backend pour application web ou mobile avec Django DRFpour faire apparaîtreadmin.pyet mieux aligner l'arborescence avec l'implémentation montrée plus bas. - Mise à jour de
index.mdpour indiquer que l'audit itératif et la passe de polish sont terminés pour cette version.