doc pages

Author: tacxou

docs/pages/audits/table.md

@@ -6,5 +6,31 @@ description: Documentation de la page /audits/table dans Sesame-Orchestrator
 
 # Table audits
 
-Cette page documente l’écran `table` des audits (route `/audits/table`).
+Cette page affiche l’historique global des changements (route `/audits/table`) avec recherche, filtres, et visualisation de diff.
+
+## Contenu de l’interface
+
+- **Barre d’outils** :
+  - titre “Historique global des changements”
+  - bouton refresh
+- **Filtres** :
+  - `sesame-core-pan-filters` (recherche simple : collection, auteur, opération, …)
+  - sélection “Collection” (chargée dynamiquement, clearable)
+- **Table** : pagination serveur (page/limit tri), chips pour :
+  - opération (couleur + label)
+  - collection
+  - document (cliquable pour certaines collections)
+  - aperçu des changements (jusqu’à 4 chips + compteur)
+- **Diff** : bouton loupe ouvre un dialog maximisé avec `LazyMonacoDiffEditor` (JSON).
+
+## Données / API
+
+- **Collections** : `GET /core/audits/collections`
+- **Liste** : `GET /core/audits` (avec query `page`, `limit`, `search`, `coll`, tri)
+- **Détail** : `GET /core/audits/<id>` (via `fetchAuditDetails`)
+
+## Raccourcis
+
+- Si `coll === "Identities"` : lien vers `/identities/table/<documentId>`
+- Si `coll === "Agents"` : lien vers `/settings/agents/<documentId>`
 

docs/pages/identities/export.md

@@ -6,5 +6,22 @@ description: Documentation de la page /identities/export dans Sesame-Orchestrato
 
 # Export
 
-Cette page documente la section `export` des identités de Sesame-Orchestrator (route `/identities/export`).
+Cette page permet d’exporter des identités (route `/identities/export`).
+
+## Contenu de l’interface
+
+- **Bouton** “Exporter” : lance le téléchargement.
+- **Sélecteur** de format : `CSV` ou `JSON`.
+- **Filtres** : `sesame-core-pan-filters` (mode “complex”).
+- **Table** : `q-table` affichant les lignes exportables selon les colonnes calculées.
+
+## Données / API
+
+- **Colonnes disponibles** : `GET /management/identities/validation` (liste des champs schemas → transformée en colonnes de table).
+- **Données** : `GET /management/identities?sort[inetOrgPerson.cn]=asc` avec `limit: 9999` + query courante (hors `read`).
+
+## Export
+
+- **CSV** : génération côté client (séparateur `;`, séparateur tableau `,`, fin de ligne `\\r\\n`), téléchargement `sesame-export.csv`.
+- **JSON** : téléchargement brut du payload API (avec `total`, `data`, …) en `sesame-export.json`.
 

docs/pages/identities/fusion.md

@@ -6,5 +6,32 @@ description: Documentation de la page /identities/fusion dans Sesame-Orchestrato
 
 # Fusion
 
-Cette page documente la section `fusion` des identités de Sesame-Orchestrator (route `/identities/fusion`).
+Cette page aide à **détecter et fusionner des identités en double** (route `/identities/fusion`).
+
+## Contenu de l’interface
+
+- **Table** “Détection des identités en double” listant des paires d’identités.
+- **Filtre** “Filtrer les fusions ignorées” (`includeIgnored`).
+- **Actions sur une paire** :
+  - éditer identité 1 / identité 2 (ouvre un formulaire)
+  - fusionner (dans un sens ou dans l’autre)
+  - supprimer une identité
+  - ignorer / réactiver l’alerte de fusion (toggle)
+
+## Edition
+
+L’édition se fait dans un **dialog plein écran** avec :
+
+- un rendu `sesame-core-jsonforms-renderer` (schema `inetOrgPerson` + onglets `additionalFields.attributes[...]`)
+- un bouton **Enregistrer**.
+
+## Données / API
+
+- **Liste des doublons** : `GET /management/identities/duplicates` (query = `route.query`).
+- **Ignorer** : `POST /management/identities/ignore-fusion` (body `{ ids }`).
+- **Réactiver** : `POST /management/identities/unignore-fusion` (body `{ ids }`).
+- **Fusion** : `POST /management/identities/fusion` (body `{ id1, id2 }`), puis ouverture de l’identité résultante.
+- **Chargement identité** (édition) : `GET /management/identities/<id>`.
+- **Sauvegarde identité** (édition) : `PATCH /management/identities/<id>`.
+- **Suppression** : `POST /core/backends/delete` (payload `[id]`).
 

docs/pages/identities/index.md

@@ -6,5 +6,17 @@ description: Documentation de la page /identities dans Sesame-Orchestrator
 
 # Identités
 
-Cette page documente la section des identités de Sesame-Orchestrator (route `/identities`).
+Cette page est une **page de transition** (route `/identities`) qui indique que la section a été déplacée et redirige vers `/identities/table`.
+
+## Contenu de l’interface
+
+- Message : “Page d'identité déplacée”
+- Indication : “Ajoutez `/table` dans l'URL…”
+- Lien vers le nouveau chemin
+- Compte à rebours avant redirection automatique
+
+## Comportement
+
+- **Nouveau chemin** : construit en remplaçant `'/identities'` par `'/identities/table'` sur l’URL courante.
+- **Redirection** : automatique après 10 secondes (`router.replace(newPath)`).
 

docs/pages/identities/outdated.md

@@ -6,5 +6,16 @@ description: Documentation de la page /identities/outdated dans Sesame-Orchestra
 
 # Identités obsolètes
 
-Cette page documente la section `outdated` des identités (route `/identities/outdated`).
+Cette page liste les identités dont **l’invitation n’est plus valide** (route `/identities/outdated`) et permet de **réenvoyer** l’invitation.
+
+## Contenu de l’interface
+
+- **Table** `q-table` (sélection multiple).
+- **Action** “Réenvoyer le mail d'invitation” activée uniquement si au moins une ligne est sélectionnée.
+
+## Données / API
+
+- **Liste** : `GET /management/passwd/ioutdated`
+- **Ré-envoi invitation** (sélection ou tout) : `POST /management/passwd/initmany` (body `{ ids }`)
+- **Colonnes** : construites au `mounted()` via `GET /management/identities/validation` (construction dynamique à partir des schémas).
 

docs/pages/identities/table.md

@@ -1,10 +1,41 @@
 ---
 lang: fr-FR
-title: Détail identité
-description: Documentation de la page /identities/table/:_id dans Sesame-Orchestrator
+title: Table des identités
+description: Documentation de la page /identities/table (et écrans de détail associés) dans Sesame-Orchestrator
 ---
 
-# Détail identité
+# Table des identités
+
+Cette page documente l’écran de liste des identités (route `/identities/table`) et regroupe aussi la documentation des écrans de détail.
+
+## Liste des identités (`/identities/table`)
+
+### Contenu de l’interface
+
+- **Table + panneau** : composant `sesame-core-twopan` (titre “Gestion des identités”).
+- **Filtres** : `sesame-core-pan-filters` (mode “complex”), placeholder “Rechercher par nom, prénom, email, …”.
+- **Actions de masse** (sur sélection multiple) :
+  - “Mettre à synchroniser” (`mdi-sync`)
+  - “Envoyer le mail d'invitation” (`mdi-email-arrow-right`)
+  - “Supprimer en masse” (`mdi-delete`)
+  - “Nettoyer la sélection” (`mdi-cancel`)
+- **Création** : bouton `+` vers `/identities/table/<NewTargetId>?schema=inetOrgPerson` (soumis à permission `create` sur `/management/identities`).
+- **Actions ligne** :
+  - “Voir” → `/identities/table/<id>`
+  - menu (tabs) : Fiche identité, Historique des changements, Journaux des tâches, Historique des cycles de vie, Debug (si mode debug)
+
+### Données / API
+
+- **Liste** : `GET /management/identities` (pagination via `usePagination()`).
+- **Changement d’état** : `PATCH /management/identities/state` (mise à jour par lot).
+- **Initialisation mot de passe (invitation)** : `POST /management/passwd/initmany`.
+- **Suppression (backend)** : `POST /core/backends/delete`.
+
+## Détail d’une identité (`/identities/table/:_id`)
+
+- **En-tête** : retour vers la liste + affichage de l’état + nom (`inetOrgPerson.cn`) + type (`inetOrgPerson.employeeType`).
+- **Onglets** : l’écran de détail reprend les “tabs” (fiche/audits/jobs/lifecycle/debug) quand l’identité n’est pas “nouvelle” et selon permissions.
+- **Chargement** : `GET /management/identities/<id>` (404 si inexistante).
+- **Création** : si `:_id === NewTargetId`, l’écran initialise une identité vide (state `TO_CREATE`) et permet la saisie.
 
-Cette page documente l’écran de détail d’une identité (route `/identities/table/:_id`).
 

docs/pages/identities/trash.md

@@ -6,5 +6,23 @@ description: Documentation de la page /identities/trash dans Sesame-Orchestrator
 
 # Corbeille
 
-Cette page documente la section `trash` des identités (route `/identities/trash`).
+Cette page liste les identités supprimées (route `/identities/trash`) et permet de **consulter** ou **restaurer** une identité.
+
+## Contenu de l’interface
+
+- **Table + panneau** : `sesame-core-twopan` avec titre “Suivi des identités supprimées”.
+- **Actions ligne** :
+  - voir la fiche supprimée → `/identities/trash/<id>`
+  - restaurer (`mdi-restore`) si permission `update` sur `/management/identities`
+
+## Données / API
+
+- **Liste** : `GET /management/identities/getdeleted`
+- **Restaurer** : `POST /core/backends/undelete` (payload `[id]`)
+
+## Détail d’une identité supprimée (`/identities/trash/:_id`)
+
+- Barre d’actions : retour vers la liste + bouton restaurer.
+- Lecture : chargement via `GET /management/identities/<id>` puis affichage en lecture seule via `sesame-core-jsonforms-renderer`.
+- Sauvegarde (bouton “disquette”) : `PATCH /management/identities/<id>` (utile pour corriger/compléter avant restauration).
 

docs/pages/index.md

@@ -6,5 +6,20 @@ description: Documentation de la page / dans Sesame-Orchestrator
 
 # Accueil
 
-Cette page documente l’écran d’accueil de Sesame-Orchestrator (route `/`).
+Cette page correspond au **dashboard** de Sesame-Orchestrator (route `/`).
+
+## Contenu de l’interface
+
+- **Sections (parts)** : les tuiles sont regroupées par “parties” (titre affiché via une barre `q-bar`).
+- **Tuiles de navigation** : chaque tuile est un `q-btn` qui navigue vers `item.path`.
+- **Badge optionnel** : une tuile peut afficher un `q-badge` (valeur + couleurs).
+- **Menu contextuel** (clic droit) :
+  - “Ouvrir”
+  - “Ouvrir dans un nouvel onglet”
+  - “Debug” (uniquement si le mode debug est actif)
+
+## Comportement / logique
+
+- **Source des entrées** : les menus proviennent de `useMenu(...)` (via le store `useIdentityStateStore()`).
+- **Masquage** : une tuile peut être masquée si `hideInDashboard === true`.
 

docs/pages/jobs/details.md

@@ -6,5 +6,18 @@ description: Documentation de la page /jobs/details dans Sesame-Orchestrator
 
 # Détails job
 
-Cette page documente l’écran `details` des jobs (route `/jobs/details`).
+Cette page affiche les jobs sous forme de **timeline** avec défilement infini (route `/jobs/details`).
+
+## Contenu de l’interface
+
+- **Regroupement** : select “Regrouper par” (Jour / Mois / Année) via `jobsBy`.
+- **Timeline** :
+  - chaque entrée affiche `[jobId]` + nom/prénom (si disponibles)
+  - sous-titre : action + date/heure
+  - onglets : “Paramètres d'appel” (params) et “Résultat” (result), affichés via `LazyMonacoEditor`.
+- **Défilement infini** : charge 10 jobs par page.
+
+## Données / API
+
+- **Chargement incrémental** : `GET /core/jobs/` avec `limit=10`, `skip=(index-1)*10`, tri `sort[metadata.lastUpdatedAt]=desc` + query courante.
 

docs/pages/jobs/table.md

@@ -6,5 +6,23 @@ description: Documentation de la page /jobs/table dans Sesame-Orchestrator
 
 # Table jobs
 
-Cette page documente l’écran `table` des jobs (route `/jobs/table`).
+Cette page affiche le **journal des jobs** (route `/jobs/table`) sous forme de table paginée, avec filtre d’état et aperçu du résultat.
+
+## Contenu de l’interface
+
+- **Filtre d’état** : select “Filtrer par état” (valeurs typiques : Ok / En erreur).
+- **Table** (pagination serveur) :
+  - statut
+  - n° job
+  - identité concernée (chip cliquable si connue)
+  - action
+  - date
+- **Résultat** :
+  - bouton par ligne pour afficher/masquer le résultat (`props.row.result`)
+  - affichage JSON dans `LazyMonacoEditor`
+
+## Données / API
+
+- **Liste** : `GET /core/jobs` (tri `sort[metadata.lastUpdatedAt]=desc`, pagination via `page/limit/skip`).
+- **Filtre d’état** : query `filters[:state]` (ex. `9` = OK, `-1` = erreur).