# Les plugins

Étendre un module pour une société, sans copier le code du produit.


Un **plugin** étend un module pour un besoin particulier d'une société. Il vit hors du dépôt du produit. Un besoin propre à une entreprise ne se code ni dans le module ni dans le cœur : personne n'a à garder une copie modifiée du produit.

**Ordre d'essai :** d'abord un réglage, sans code. Puis un plugin pour ce que le réglage ne sait pas dire (un calcul, un import, un document).

## Un exemple : la météo d'une opération

Un plugin gère la météo d'une opération. S'il pleut, il marque le jour « on n'y va pas ». Pour cela il lui faut, sur l'opération :

- un **bloc** sur sa fiche ;
- ses **propres données**, dans une table `plugin_meteo_…` qui garde l'identifiant de l'opération ;
- une **tâche planifiée** qui lit la météo ;
- une **marque** d'information sur le planning ;
- un **réglage** par société.

Aucune ligne du cœur ne change. Retirer le plugin laisse le cœur intact.

<figure class="schema"><svg viewBox="0 0 520 486" role="img" aria-label="Un plugin parle au cœur par neuf portes" 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-violet"><rect x="10" y="30" width="150" height="400" rx="12" class="card" filter="url(#o)"/><path d="M22 30 H15 a5 5 0 0 0 -5 5 V425 a5 5 0 0 0 5 5 H22z" class="bar" transform="translate(0 0)"/><text x="34" y="62" class="tt" text-anchor="start">Plugin</text><text x="34" y="81" class="ts" text-anchor="start">météo d&#x27;une opération</text></g><text x="32" y="110" class="ts" text-anchor="start">• Entrée de menu</text><text x="32" y="138" class="ts" text-anchor="start">• Bloc sur la fiche</text><text x="32" y="166" class="ts" text-anchor="start">• Données propres</text><text x="32" y="194" class="ts" text-anchor="start">• Tâche planifiée</text><text x="32" y="222" class="ts" text-anchor="start">• Marque au planning</text><text x="32" y="250" class="ts" text-anchor="start">• Réglage par société</text><line x1="160" y1="57" x2="190" y2="57" class="ln"/><line x1="330" y1="57" x2="360" y2="57" class="ln"/><g class="cc c-ambre plein"><rect x="190" y="44" width="140" height="26" rx="13.0" class="chip"/><text x="260.0" y="61.5" class="tc" text-anchor="middle">Menu</text></g><line x1="160" y1="100" x2="190" y2="100" class="ln"/><line x1="330" y1="100" x2="360" y2="100" class="ln"/><g class="cc c-ambre plein"><rect x="190" y="87" width="140" height="26" rx="13.0" class="chip"/><text x="260.0" y="104.5" class="tc" text-anchor="middle">Bloc de fiche</text></g><line x1="160" y1="143" x2="190" y2="143" class="ln"/><line x1="330" y1="143" x2="360" y2="143" class="ln"/><g class="cc c-ambre plein"><rect x="190" y="130" width="140" height="26" rx="13.0" class="chip"/><text x="260.0" y="147.5" class="tc" text-anchor="middle">Marques du planning</text></g><line x1="160" y1="186" x2="190" y2="186" class="ln"/><line x1="330" y1="186" x2="360" y2="186" class="ln"/><g class="cc c-ambre"><rect x="190" y="173" width="140" height="26" rx="13.0" class="chip"/><text x="260.0" y="190.5" class="tc" text-anchor="middle">Contrôles</text></g><line x1="160" y1="229" x2="190" y2="229" class="ln"/><line x1="330" y1="229" x2="360" y2="229" class="ln"/><g class="cc c-ambre"><rect x="190" y="216" width="140" height="26" rx="13.0" class="chip"/><text x="260.0" y="233.5" class="tc" text-anchor="middle">Sources de données</text></g><line x1="160" y1="272" x2="190" y2="272" class="ln"/><line x1="330" y1="272" x2="360" y2="272" class="ln"/><g class="cc c-ambre plein"><rect x="190" y="259" width="140" height="26" rx="13.0" class="chip"/><text x="260.0" y="276.5" class="tc" text-anchor="middle">Tâches planifiées</text></g><line x1="160" y1="315" x2="190" y2="315" class="ln"/><line x1="330" y1="315" x2="360" y2="315" class="ln"/><g class="cc c-ambre plein"><rect x="190" y="302" width="140" height="26" rx="13.0" class="chip"/><text x="260.0" y="319.5" class="tc" text-anchor="middle">Réglages</text></g><line x1="160" y1="358" x2="190" y2="358" class="ln"/><line x1="330" y1="358" x2="360" y2="358" class="ln"/><g class="cc c-ambre"><rect x="190" y="345" width="140" height="26" rx="13.0" class="chip"/><text x="260.0" y="362.5" class="tc" text-anchor="middle">Événements</text></g><line x1="160" y1="401" x2="190" y2="401" class="ln"/><line x1="330" y1="401" x2="360" y2="401" class="ln"/><g class="cc c-ambre plein"><rect x="190" y="388" width="140" height="26" rx="13.0" class="chip"/><text x="260.0" y="405.5" class="tc" text-anchor="middle">Données</text></g><g class="cc c-vert"><rect x="360" y="30" width="150" height="400" rx="12" class="card" filter="url(#o)"/><path d="M372 30 H365 a5 5 0 0 0 -5 5 V425 a5 5 0 0 0 5 5 H372z" class="bar" transform="translate(0 0)"/><text x="384" y="62" class="tt" text-anchor="start">Cœur</text><text x="384" y="81" class="ts" text-anchor="start">opération, planning</text></g><text x="260" y="20" class="tz" text-anchor="middle">9 portes</text><text x="260" y="452" class="ts" text-anchor="middle">Pleines : utilisées par le plugin météo.</text><text x="260" y="470" class="ts" text-anchor="middle">Aucune ligne du cœur ne change.</text></svg></figure>

## Les portes

Ironlane propose neuf portes aux plugins. Un plugin utilise celles dont il a besoin, et peut mettre plusieurs éléments dans une même porte. Il ne parle au produit que par ces portes.

| Porte | Ce qu'un module ou un plugin y met |
| --- | --- |
| Menu | Une entrée d'écran. |
| Bloc de fiche | Un bloc sur la fiche d'un employé, d'une opération, d'un client ou d'une intervention. |
| Marques du planning | Une information sur une personne ou un jour. |
| Contrôles | Une règle qui lève une alerte. |
| Sources et destinations de données | Un import, un export, un connecteur. |
| Tâches planifiées | Un travail qui tourne à heure fixe : lire une donnée, relancer, synchroniser. |
| Réglages | Une page de réglages par société. |
| Événements | Être prévenu quand quelque chose arrive : une opération posée au planning, une facture émise. |
| Données | Ses propres tables, liées par l'identifiant d'un objet du cœur. |

Seules quatre de ces portes (menu, droits, bloc de fiche, marques) sont posées aujourd'hui. Les autres sont décidées et restent à construire.

## Les portes sont un contrat public

- Chaque module qui peut être étendu publie ses emplacements, typés et documentés. Ce qui n'est pas une porte n'est pas ouvert.
- Chaque fiche d'identité porte une **version des portes** (`api: "1"`). L'application refuse de charger un plugin dont la version n'est pas la sienne, avec un message clair.
- Une porte ne change pas sans que sa version change. L'ancienne reste servie un temps.
- Un plugin n'ira jamais chercher dans les fichiers internes d'un module.

## Un plugin est un paquet à part

Son propre dépôt, sa fiche d'identité, ses écrans, ses tests.

## Ce qu'un plugin peut faire de la base

- Il crée ses propres tables, nommées `plugin_<nom>_<objet>`. Il ne modifie jamais celles du cœur ni d'un module.
- Ses migrations vivent chez lui. Un contrôle refuse une migration de plugin qui fait `ALTER` ou `DROP` sur une table qui n'est pas la sienne.
- Chaque table porte une règle d'accès, comme celles du produit.
- Il lit les données d'un module par des vues et des fonctions publiques et versionnées, jamais dans ses tables internes.
- Retirer un plugin laisse ses tables : les données d'un client ne se jettent pas.

## Deux modes de confiance

| Mode | Règle |
| --- | --- |
| Installation chez un client, ou plugin écrit par l'éditeur | Le code du plugin tourne dans l'application. Celui qui installe en répond. |
| Hébergement partagé de plusieurs sociétés | Le code libre d'un tiers n'est pas chargé. Un plugin y est soit déclaratif (des réglages et des modèles), soit audité et livré par l'éditeur. |

## En quoi ce n'est pas WordPress

Même idée : un cœur qui ne change pas, des plugins à côté qui se retirent sans dégât. Deux différences voulues. WordPress laisse un plugin tout modifier ; ici seules les portes annoncées sont ouvertes. Et WordPress sert un site par client, alors qu'ici plusieurs sociétés partagent une base : la règle d'accès par société est obligatoire dans chaque table de plugin.

## Pas encore

Un registre public de plugins, leur signature et leur vente ne sont pas prévus pour l'instant. Un banc d'essai de compatibilité (des tests qu'un plugin lance contre une version du produit) est à construire.
