docs: add Mermaid diagrams for role state flow and CI pipeline

README.md

@@ -14,6 +14,23 @@ Le rôle est piloté par la variable `remote_users_fact_state` :
 
 Le state peut être défini à tout niveau (all, groupe, hôte, extra-vars). `noop` par défaut garantit qu'un hôte ajouté à l'inventaire sans configuration explicite ne sera pas impacté.
 
+```mermaid
+flowchart LR
+    A[assert.yml] --> B{remote_users_fact_state}
+    B -->|noop| C[Aucune action]
+    B -->|present| D[present.yml]
+    B -->|absent| E[absent.yml]
+    D --> F{validate ?}
+    F -->|oui| G[validate.yml]
+    F -->|non| H{summary ?}
+    G --> H
+    H -->|oui| I[summary.yml]
+    H -->|non| J[Fin]
+    I --> J
+    E --> J
+    C --> J
+```
+
 ## Arborescence
 
 ```text
@@ -163,6 +180,19 @@ all:
 
 Le rôle est testé automatiquement sur toutes les distributions déclarées dans `meta/main.yml` via Docker.
 
+```mermaid
+flowchart LR
+    A[meta/main.yml] --> B[build_matrix.py]
+    B --> C[JSON matrix]
+    C --> D{Makefile}
+    D --> E[Dockerfile.el]
+    D --> F[Dockerfile.debian]
+    E --> G[docker build + run]
+    F --> G
+    G --> H[test_playbook.yml]
+    H --> I[role: assert + present + validate + summary]
+```
+
 ### Commandes Make
 
 ```bash