# Architecture

Où vivent les règles, comment une donnée circule, comment les sociétés restent séparées.


:::caution[Architecture en évolution]
Ironlane devient une application Next.js sur PostgreSQL seul : connexion dans l'application, fichiers sur disque, une base par société dans un même serveur PostgreSQL. Le produit en ligne est déjà ainsi : une base ne porte qu'une société, sans Supabase ni Vercel. Cette page sera complétée avec la construction.
:::

## 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é.

<figure class="schema"><svg viewBox="0 0 520 484" role="img" aria-label="Architecture : navigateur, application, base de données" xmlns="http://www.w3.org/2000/svg"><defs><marker id="f" viewBox="0 0 10 10" refX="8" refY="5" markerWidth="8" markerHeight="8" orient="auto-start-reverse"><path d="M1 1.5L8.5 5L1 8.5z" class="mk"/></marker><filter id="o" x="-5%" y="-5%" width="110%" height="120%"><feDropShadow dx="0" dy="1.5" stdDeviation="2" flood-opacity=".14"/></filter></defs><g class="cc c-gris"><rect x="160" y="8" width="200" height="46" rx="12" class="card" filter="url(#o)"/><text x="260.0" y="28.0" class="tt" text-anchor="middle">Navigateur</text><text x="260.0" y="47.0" class="ts" text-anchor="middle">écran ou téléphone</text></g><path d="M260 57 V80" class="ln" fill="none" marker-end="url(#f)"/><g class="cc c-bleu"><rect x="10" y="82" width="500" height="98" rx="16" class="zone"/><text x="26" y="104" class="tz" text-anchor="start">APPLICATION</text></g><g class="cc c-bleu"><rect x="28" y="120" width="150" height="30" rx="15.0" class="chip"/><text x="103.0" y="139.5" class="tc" text-anchor="middle">Écrans</text></g><g class="cc c-bleu"><rect x="188" y="120" width="150" height="30" rx="15.0" class="chip"/><text x="263.0" y="139.5" class="tc" text-anchor="middle">Actions serveur</text></g><g class="cc c-bleu"><rect x="348" y="120" width="150" height="30" rx="15.0" class="chip"/><text x="423.0" y="139.5" class="tc" text-anchor="middle">Routes</text></g><path d="M260 182 V208" class="ln" fill="none" marker-end="url(#f)"/><rect x="268.0" y="184.0" width="112.0" height="20" rx="10" class="pill"/><text x="324.0" y="199.0" class="tl" text-anchor="middle">un aller-retour</text><g class="cc c-vert"><rect x="10" y="210" width="500" height="150" rx="16" class="zone"/><text x="26" y="232" class="tz" text-anchor="start">BASE DE DONNÉES</text></g><g class="cc c-ambre"><rect x="28" y="244" width="464" height="50" rx="12" class="card" filter="url(#o)"/><path d="M40 244 H33 a5 5 0 0 0 -5 5 V289 a5 5 0 0 0 5 5 H40z" class="bar" transform="translate(0 0)"/><text x="52" y="266.0" class="tt" text-anchor="start">Fonctions SQL gardées</text><text x="52" y="285.0" class="ts" text-anchor="start">droit · périmètre · société</text></g><g class="cc c-vert"><rect x="28" y="300" width="464" height="50" rx="12" class="card" filter="url(#o)"/><path d="M40 300 H33 a5 5 0 0 0 -5 5 V345 a5 5 0 0 0 5 5 H40z" class="bar" transform="translate(0 0)"/><text x="52" y="322.0" class="tt" text-anchor="start">Tables</text><text x="52" y="341.0" class="ts" text-anchor="start">règle d&#x27;accès sur chaque ligne</text></g><g class="cc c-gris"><rect x="10" y="384" width="164" height="56" rx="12" class="card" filter="url(#o)"/><text x="92.0" y="409.0" class="tt" text-anchor="middle">Tâches planifiées</text><text x="92.0" y="428.0" class="ts" text-anchor="middle">nuit, relances</text></g><path d="M92 384 V364" class="ln" fill="none" marker-end="url(#f)"/><g class="cc c-gris"><rect x="182" y="384" width="164" height="56" rx="12" class="card" filter="url(#o)"/><text x="264.0" y="409.0" class="tt" text-anchor="middle">Robot (IA)</text><text x="264.0" y="428.0" class="ts" text-anchor="middle">lit le filtré</text></g><path d="M264 384 V364" class="ln" fill="none" marker-end="url(#f)"/><g class="cc c-gris"><rect x="354" y="384" width="164" height="56" rx="12" class="card" filter="url(#o)"/><text x="436.0" y="409.0" class="tt" text-anchor="middle">Stockage</text><text x="436.0" y="428.0" class="ts" text-anchor="middle">fichiers, photos</text></g><path d="M436 384 V364" class="ln" fill="none" marker-end="url(#f)"/><text x="260" y="466" class="ts" text-anchor="middle">Un import passe par les mêmes gardes que l&#x27;écran.</text></svg></figure>

## 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

1. **Sans session, rien ne répond.** Le rôle anonyme n'a aucun droit sur les tables, les séquences ni les fonctions.
2. **Le droit.** Toute fonction qu'un écran appelle commence par vérifier que le compte peut faire ce geste.
3. **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

<figure class="schema"><svg viewBox="0 0 520 424" role="img" aria-label="Un écran de bout en bout" xmlns="http://www.w3.org/2000/svg"><defs><marker id="f" viewBox="0 0 10 10" refX="8" refY="5" markerWidth="8" markerHeight="8" orient="auto-start-reverse"><path d="M1 1.5L8.5 5L1 8.5z" class="mk"/></marker><filter id="o" x="-5%" y="-5%" width="110%" height="120%"><feDropShadow dx="0" dy="1.5" stdDeviation="2" flood-opacity=".14"/></filter></defs><g class="cc c-gris"><rect x="40" y="10" width="440" height="58" rx="12" class="card" filter="url(#o)"/><path d="M52 10 H45 a5 5 0 0 0 -5 5 V63 a5 5 0 0 0 5 5 H52z" class="bar" transform="translate(0 0)"/><circle cx="67" cy="39.0" r="12" class="bad"/><text x="67" y="44.0" class="num" text-anchor="middle">1</text><text x="90" y="36.0" class="tt" text-anchor="start">Clic</text><text x="90" y="55.0" class="ts" text-anchor="start">retour visuel en moins de 150 ms</text></g><path d="M260.0 71 V93" class="ln" fill="none" marker-end="url(#f)"/><g class="cc c-bleu"><rect x="40" y="96" width="440" height="58" rx="12" class="card" filter="url(#o)"/><path d="M52 96 H45 a5 5 0 0 0 -5 5 V149 a5 5 0 0 0 5 5 H52z" class="bar" transform="translate(0 0)"/><circle cx="67" cy="125.0" r="12" class="bad"/><text x="67" y="130.0" class="num" text-anchor="middle">2</text><text x="90" y="122.0" class="tt" text-anchor="start">Page serveur</text><text x="90" y="141.0" class="ts" text-anchor="start">lectures indépendantes en parallèle</text></g><path d="M260.0 157 V179" class="ln" fill="none" marker-end="url(#f)"/><g class="cc c-ambre"><rect x="40" y="182" width="440" height="58" rx="12" class="card" filter="url(#o)"/><path d="M52 182 H45 a5 5 0 0 0 -5 5 V235 a5 5 0 0 0 5 5 H52z" class="bar" transform="translate(0 0)"/><circle cx="67" cy="211.0" r="12" class="bad"/><text x="67" y="216.0" class="num" text-anchor="middle">3</text><text x="90" y="208.0" class="tt" text-anchor="start">Une fonction SQL</text><text x="90" y="227.0" class="ts" text-anchor="start">droit, périmètre, société, tout l&#x27;écran</text></g><path d="M260.0 243 V265" class="ln" fill="none" marker-end="url(#f)"/><g class="cc c-vert"><rect x="40" y="268" width="440" height="58" rx="12" class="card" filter="url(#o)"/><path d="M52 268 H45 a5 5 0 0 0 -5 5 V321 a5 5 0 0 0 5 5 H52z" class="bar" transform="translate(0 0)"/><circle cx="67" cy="297.0" r="12" class="bad"/><text x="67" y="302.0" class="num" text-anchor="middle">4</text><text x="90" y="294.0" class="tt" text-anchor="start">Rendu</text><text x="90" y="313.0" class="ts" text-anchor="start">l&#x27;écran n&#x27;a rien à recalculer</text></g><path d="M260.0 329 V351" class="ln" fill="none" marker-end="url(#f)"/><g class="cc c-violet plein"><rect x="40" y="354" width="440" height="58" rx="12" class="card" filter="url(#o)"/><path d="M52 354 H45 a5 5 0 0 0 -5 5 V407 a5 5 0 0 0 5 5 H52z" class="bar" transform="translate(0 0)"/><circle cx="67" cy="383.0" r="12" class="bad"/><text x="67" y="388.0" class="num" text-anchor="middle">5</text><text x="90" y="380.0" class="tt" text-anchor="start">Écriture</text><text x="90" y="399.0" class="ts" text-anchor="start">schéma, droit, règle, puis la base</text></g></svg></figure>

- **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

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

<figure class="schema"><svg viewBox="0 0 520 374" role="img" aria-label="Une base par société : les données de deux sociétés ne se croisent jamais" xmlns="http://www.w3.org/2000/svg"><defs><marker id="f" viewBox="0 0 10 10" refX="8" refY="5" markerWidth="8" markerHeight="8" orient="auto-start-reverse"><path d="M1 1.5L8.5 5L1 8.5z" class="mk"/></marker><filter id="o" x="-5%" y="-5%" width="110%" height="120%"><feDropShadow dx="0" dy="1.5" stdDeviation="2" flood-opacity=".14"/></filter></defs><g class="cc c-gris"><rect x="10" y="10" width="130" height="58" rx="12" class="card" filter="url(#o)"/><text x="75.0" y="36.0" class="tt" text-anchor="middle">Écran</text><text x="75.0" y="55.0" class="ts" text-anchor="middle">demande</text></g><path d="M142 39 H178" class="ln" fill="none" marker-end="url(#f)"/><g class="cc c-ambre"><rect x="180" y="10" width="150" height="58" rx="12" class="card" filter="url(#o)"/><text x="255.0" y="36.0" class="tt" text-anchor="middle">Droit</text><text x="255.0" y="55.0" class="ts" text-anchor="middle">ce geste est permis ?</text></g><path d="M332 39 H368" class="ln" fill="none" marker-end="url(#f)"/><g class="cc c-ambre"><rect x="370" y="10" width="140" height="58" rx="12" class="card" filter="url(#o)"/><text x="440.0" y="36.0" class="tt" text-anchor="middle">Règle d&#x27;accès</text><text x="440.0" y="55.0" class="ts" text-anchor="middle">sur chaque table</text></g><g class="cc c-bleu"><rect x="10" y="118" width="500" height="196" rx="16" class="zone"/><text x="26" y="140" class="tz" text-anchor="start">UN MÊME SERVEUR POSTGRESQL · UNE BASE PAR SOCIÉTÉ</text></g><g class="cc c-vert"><rect x="28" y="152" width="220" height="144" rx="16" class="zone"/><text x="44" y="174" class="tz" text-anchor="start">BASE DE LA SOCIÉTÉ A</text></g><g class="cc c-violet"><rect x="272" y="152" width="220" height="144" rx="16" class="zone"/><text x="288" y="174" class="tz" text-anchor="start">BASE DE LA SOCIÉTÉ B</text></g><rect x="44" y="184" width="188" height="20" rx="6" class="row c-vert"/><rect x="288" y="184" width="188" height="20" rx="6" class="row c-violet"/><rect x="44" y="214" width="188" height="20" rx="6" class="row c-vert"/><rect x="288" y="214" width="188" height="20" rx="6" class="row c-violet"/><rect x="44" y="244" width="188" height="20" rx="6" class="row c-vert"/><rect x="288" y="244" width="188" height="20" rx="6" class="row c-violet"/><path d="M440 70 V94 H138 V150" class="ln" fill="none" marker-end="url(#f)"/><rect x="227.6" y="83" width="124.80000000000001" height="20" rx="10" class="pill"/><text x="290" y="98" class="tl" text-anchor="middle">sa base seulement</text><path d="M440 94 V140" class="ln no" fill="none"/><text x="440" y="136" class="no-x" text-anchor="middle">✕</text><text x="260" y="342" class="ts" text-anchor="middle">Une base ne porte qu&#x27;une société : aucune ligne n&#x27;a à dire</text><text x="260" y="360" class="ts" text-anchor="middle">à qui elle est, et aucune requête ne choisit sa société.</text></svg></figure>

- **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

<figure class="schema"><svg viewBox="0 0 520 368" role="img" aria-label="Cycle d&#x27;une migration" xmlns="http://www.w3.org/2000/svg"><defs><marker id="f" viewBox="0 0 10 10" refX="8" refY="5" markerWidth="8" markerHeight="8" orient="auto-start-reverse"><path d="M1 1.5L8.5 5L1 8.5z" class="mk"/></marker><filter id="o" x="-5%" y="-5%" width="110%" height="120%"><feDropShadow dx="0" dy="1.5" stdDeviation="2" flood-opacity=".14"/></filter></defs><g class="cc c-gris"><rect x="40" y="10" width="440" height="58" rx="12" class="card" filter="url(#o)"/><path d="M52 10 H45 a5 5 0 0 0 -5 5 V63 a5 5 0 0 0 5 5 H52z" class="bar" transform="translate(0 0)"/><circle cx="67" cy="39.0" r="12" class="bad"/><text x="67" y="44.0" class="num" text-anchor="middle">1</text><text x="90" y="36.0" class="tt" text-anchor="start">Sauvegarde</text><text x="90" y="55.0" class="ts" text-anchor="start">juste avant la migration</text></g><path d="M260.0 71 V93" class="ln" fill="none" marker-end="url(#f)"/><g class="cc c-ambre"><rect x="40" y="96" width="440" height="58" rx="12" class="card" filter="url(#o)"/><path d="M52 96 H45 a5 5 0 0 0 -5 5 V149 a5 5 0 0 0 5 5 H52z" class="bar" transform="translate(0 0)"/><circle cx="67" cy="125.0" r="12" class="bad"/><text x="67" y="130.0" class="num" text-anchor="middle">2</text><text x="90" y="122.0" class="tt" text-anchor="start">Essai à blanc</text><text x="90" y="141.0" class="ts" text-anchor="start">transaction annulée, mesure avant et après</text></g><path d="M260.0 157 V179" class="ln" fill="none" marker-end="url(#f)"/><g class="cc c-bleu"><rect x="40" y="182" width="440" height="58" rx="12" class="card" filter="url(#o)"/><path d="M52 182 H45 a5 5 0 0 0 -5 5 V235 a5 5 0 0 0 5 5 H52z" class="bar" transform="translate(0 0)"/><circle cx="67" cy="211.0" r="12" class="bad"/><text x="67" y="216.0" class="num" text-anchor="middle">3</text><text x="90" y="208.0" class="tt" text-anchor="start">Migration jouée</text><text x="90" y="227.0" class="ts" text-anchor="start">par l&#x27;outil, avant le code</text></g><path d="M260.0 243 V265" class="ln" fill="none" marker-end="url(#f)"/><g class="cc c-vert plein"><rect x="40" y="268" width="440" height="58" rx="12" class="card" filter="url(#o)"/><path d="M52 268 H45 a5 5 0 0 0 -5 5 V321 a5 5 0 0 0 5 5 H52z" class="bar" transform="translate(0 0)"/><circle cx="67" cy="297.0" r="12" class="bad"/><text x="67" y="302.0" class="num" text-anchor="middle">4</text><text x="90" y="294.0" class="tt" text-anchor="start">Code déployé</text><text x="90" y="313.0" class="ts" text-anchor="start">l&#x27;ancien code tenait déjà</text></g><text x="260" y="356" class="ts" text-anchor="middle">Elle dit comment elle se défait, ou pourquoi elle ne peut pas.</text></svg></figure>

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

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

Le cœur ne dépend jamais d'un module : voir [cœur, modules et plugins](/modules/).
