Set-OPS-Public/docs/meta-classe.md

# La méta-classe — une définition, tout l'écosystème

> **Pour qui :** le **mainteneur** — le concept qui explique pourquoi on écrit *un* plan et non onze serveurs.

Set-OPS se comporte comme une **méta-classe** : on n'écrit pas onze serveurs, on
écrit *une* **définition d'écosystème** (le plan déclaratif) ; l'instanciation
engendre la flotte entière, cohérente. Le réseau, la taille des VM, les groupes, les
liens de bases (DSN) et l'exposition DNS sont **dérivés** — jamais saisis deux fois.

> Concept acté dans [`positionnement.md`](positionnement.md) : « la définition
> instancie toute la flotte ». La dérivation des ressources est décrite dans
> [`dimensionnement-ressources.md`](dimensionnement-ressources.md).

## Schéma

```mermaid
flowchart TB
  subgraph DEF["① DÉFINITION — la méta-classe (le plan déclaratif)"]
    direction LR
    NOM["nomenclature.yml<br/>catégories · VLAN · fonctions"]
    SRV["serveurs.yml<br/>VM = fonction + état + overrides"]
    APP["applications.yml<br/>app → rôle · hôte · expose"]
    BD["bases-donnees.yml<br/>serveurs_bd · DSN · portée"]
    DOM["domaines.yml<br/>domaines publics · edge"]
    EMP["roles/*/meta/empreinte.yml<br/>empreinte ressources"]
    TPL[("golden template<br/>Debian 13 durci")]
  end

  subgraph GEN["② DÉRIVATION — make instancier (le constructeur)"]
    direction LR
    R1["réseau<br/>VMID · VLAN · IP · gw"]
    R2["ressources<br/>cœurs · RAM · disque"]
    R3["groupes<br/>socle + services + état"]
    R4["liens<br/>DSN + exposition DNS"]
  end

  subgraph INST["③ INSTANCES — la flotte (inventory hosts.yml)"]
    direction LR
    INV[["hosts.yml"]]
    VMS(("14 VM<br/>infra-pki · infra-dns · infra-mail · infra-edge · edge-mta<br/>idm · data-sql · obs · mon · forge · collab<br/>web-frontal · web-dorsal · ops"))
  end

  ECO["④ ÉCOSYSTÈME souverain en service<br/>PKI · DNS · IdM/SSO · Données · Observabilité · Forge · Web"]

  DEF --> GEN --> INST
  TPL -. "clone + cloud-init" .-> VMS
  INV --> VMS
  INST -- "make deployer · rôles par groupe" --> ECO
```

## Le même schéma en texte

```
①  DÉFINITION — la « méta-classe »  (instance/plan/ + roles/*/meta/empreinte.yml)
      nomenclature · serveurs · applications · bases-données · domaines
      ⟦ golden template Debian 13 durci ⟧
                    │  make instancier
                    ▼
②  DÉRIVATION — le constructeur  (instancier.py · inventory_rules · filter_plugins)
      réseau (VMID·VLAN·IP·gw) · ressources (cœurs·RAM·disque) · groupes · DSN+DNS
                    │  = instanciation
                    ▼
③  INSTANCES — la flotte  (inventory hosts.yml : 14 VM cohérentes)
      infra-pki · infra-dns · infra-mail · infra-edge · edge-mta · idm · data-sql
      obs · mon · forge · collab · web-frontal · web-dorsal · ops
      ▲ clone du golden template + identité cloud-init
                    │  make deployer (rôles Ansible par groupe)
                    ▼
④  ÉCOSYSTÈME souverain en service
      PKI · DNS interne · IdM+SSO · Bases · Observabilité · Forge · Web

   1 définition  ───────────────▶  N VM : réseau, taille, groupes, DSN, DNS
   (édite le plan)                 tout dérivé, rien saisi deux fois.
```

## Pourquoi c'est une *méta*-classe

Une classe ordinaire instancie **un** objet. Ici, **une** définition instancie un
**ensemble cohérent** d'objets (VM + services + liens), avec leurs invariants garantis
par dérivation plutôt que par discipline humaine. Éditer le plan, c'est faire évoluer
la classe ; régénérer, c'est ré-instancier — de façon idempotente.