Architecture
Où vivent les règles, comment une donnée circule, comment les sociétés restent séparées.
Les règles vont dans la base, pas dans l’écran
Section intitulée « Les règles vont dans la base, pas dans l’écran »Un filtre oublié dans un écran laisse sortir des données. Une règle d’accès oubliée dans la base n’en laisse sortir aucune. Une règle qui n’existe que dans le code de l’application est un défaut, parce qu’un import ou une correction à la main passera à côté.
Les couches
Section intitulée « Les couches »| Couche | Rôle | Ce qu’elle ne fait pas |
|---|---|---|
| Application | Affiche, valide une entrée, appelle une fonction. | Ne recalcule jamais une règle métier. |
| Fonctions SQL gardées | Portent les règles. Chacune vérifie le droit, le périmètre et la société. | Ne s’ouvrent pas à un compte sans besoin. |
| Tables | Gardent les données, avec une règle d’accès sur chaque ligne. | Ne se lisent pas en direct pour les montants. |
| Tâches planifiées | Tournent la nuit, parlent au dehors par une route de l’application. | Ne téléchargent rien depuis la base. |
Les droits en trois temps
Section intitulée « Les droits en trois temps »- Sans session, rien ne répond. Le rôle anonyme n’a aucun droit sur les tables, les séquences ni les fonctions.
- Le droit. Toute fonction qu’un écran appelle commence par vérifier que le compte peut faire ce geste.
- Le périmètre. Puis elle vérifie que le compte a la main sur cette ligne-ci, dans sa société.
Les montants, les prix d’achat et les taux de coût ne se lisent pas en direct dans les tables : une lecture directe ouvre les colonnes une à une, sans l’argent. Les écrans lisent l’argent par leurs fonctions, chacune sous son droit.
Un écran de bout en bout
Section intitulée « Un écran de bout en bout »- Un aller-retour par écran. Une fonction rend tout ce que l’écran affiche, y compris le cadre (société, menu, repères de lecture). Ce qui est indépendant part en parallèle.
- Un clic répond tout de suite. Un retour visuel apparaît en moins de 150 ms, sans que l’écran ait à s’en occuper.
- Un tiroir s’ouvre sur ce que le tableau sait déjà, en attendant la fiche complète.
La mémoire des lectures
Section intitulée « La mémoire des lectures »Il n’y a pas de cache de page : chaque écran dépend de qui le regarde. Quelques listes courtes sont gardées en mémoire du serveur, vidées à chaque écriture qui les change. Un repère en base dit quand vider.
Une société par base
Section intitulée « Une société par base »- Une base ne porte qu’une société. Une autre société a sa propre base, dans le même serveur PostgreSQL. Les tables n’ont pas de colonne de société et les fonctions SQL n’ont pas de paramètre de société.
- La société de la base se lit par
ma_societe(). Ni la session, ni le jeton, ni le compte ne la choisissent, et aucun identifiant n’est écrit en dur. - Les données de deux sociétés ne se croisent donc pas : il n’y a rien à filtrer, parce qu’elles ne sont pas au même endroit.
- Les secrets d’une société vont dans un coffre de la base, chiffrés, qu’aucune fonction ouverte à un compte ne rend.
Les migrations
Section intitulée « Les migrations »Une migration passe avant le code qui l’appelle, et l’ancien code doit tenir sur la base nouvelle le temps du déploiement. Elle ne se réécrit jamais une fois jouée. Le texte courant de chaque fonction est gardé dans un fichier par fonction, généré après les migrations : c’est là qu’on lit une fonction, pas dans l’historique.
Les tâches de nuit
Section intitulée « Les tâches de nuit »Une tâche qui doit parler au dehors passe par une route de l’application que la base appelle. Elle note chaque passage, réussi ou non. Une nuit ratée envoie un courriel. Si la planification elle-même s’arrête, la console de santé montre le dernier passage de chaque tâche.
Les modules
Section intitulée « Les modules »Le cœur ne dépend jamais d’un module : voir cœur, modules et plugins.