Skip to content

Écrire un module

This content is not available in your language yet.

Ce parcours construit un module réel, de bout en bout : la gestion d’une bibliothèque. Un catalogue, les exemplaires physiques, les adhérents, les emprunts et leur cycle de vie.

À la fin, il aura des tables, une API, sept écrans de genres différents, des permissions, des traductions, une machine à états, et il s’empaquettera pour être installé ailleurs.

Vous n’écrirez aucune ligne de code frontend.

Ce que nous construisons

La liste des emprunts : exemplaire, adhérent, dates et état, avec ses couleurs sémantiques

Quatre entités qui se répondent :

ModèleCe que c’est
library_titleL’œuvre. « Dune », son auteur, son ISBN, son genre.
library_copyL’objet physique sur l’étagère, avec son code-barres et son rayon.
library_memberQuelqu’un qui a le droit d’emprunter.
library_loanUn exemplaire, sorti par un adhérent, pour une période.

La distinction entre l’œuvre et l’exemplaire n’est pas de la coquetterie de modélisation : une bibliothèque possède trois exemplaires du même livre et les prête indépendamment. Le code-barres appartient à l’objet, l’ISBN à l’œuvre.

Les étapes

1Le moduleLe squelette, le manifeste, le point d’entrée.
2Les donnéesLes modèles, les champs, les relations, les champs calculés.
3Les écransLes huit genres de vue, et ce que chacun sait faire.
4Le rendre visibleL’étape qu’on oublie, et à cause de laquelle le module reste introuvable.
5TraduirePourquoi le fichier de traduction n’est pas optionnel.
6Les droitsQui voit quoi, jusqu’au champ près.
7Les étatsUn cycle de vie, ses transitions, et les boutons qui vont avec.
8L’intelligence artificielleAppeler un modèle depuis votre module, proprement.
9LivrerEmpaqueter, signer, installer ailleurs.

Ce qu’il vous faut

Une installation Kewos qui fonctionne, et un accès en écriture à son répertoire modules/. Pour développer, une installation locale suffit ; les commandes de ce parcours s’y exécutent telles quelles.