# Les portes entre le cœur et un module

La forme que prend chaque module, et les quatre points de contact avec le cœur.


Un **module** est un dossier `modules/<nom>/`. Il contient son code (écrans, composants, fonctions) et une **fiche d'identité**, `module.ts`.

Le cœur ne nomme jamais un module. Il lit la liste des modules livrés dans un seul fichier, le registre. Un module est **livré** (présent dans le registre) et **allumé** pour une société (une ligne dans la table des modules de la société).

## La fiche d'identité

```ts
export const habilitations: Module = {
  code: "habilitations",
  nom: "Habilitations",
  api: "1",                 // version des portes
  menu: [ /* entrées de menu */ ],
  droits: [ /* droits utilisés */ ],
  blocs: [ /* blocs ajoutés à une fiche du cœur */ ],
  marques: "habilitations_marques_du_planning",
  sql: { tables: [], fonctions: [] },
};
```

## Les quatre portes

1. **Le menu.** Le module fournit ses entrées. Le cœur les fusionne, pour les sociétés qui l'ont allumé.
2. **Les droits.** Le module déclare les droits qu'il utilise, pour que les contrôles sachent ce qui lui appartient.
3. **Un bloc sur une fiche du cœur.** Le cœur réserve des emplacements, par exemple sur la fiche d'un employé. Il y affiche les blocs des modules allumés.
4. **Les marques de personne du planning.** Une marque est une information sur une personne pour un jour. Elle ne refuse jamais une action. Elle dit seulement un fait.

## Ce qu'un contrôle refuse

- Le cœur n'importe rien d'un module, sauf le registre.
- Un module n'importe d'un autre module que sa fiche d'identité.
- Côté base de données, une fonction du cœur ne cite aucune table qu'un module déclare.
