Documentation utilisateur — WakaStart

Version documentée : ws-front-wakastart (Next.js 16, React 19) Langue : Français Date de rédaction : Mai 2026

---

Table des matières

1. Connexion et authentification
2. Tableau de bord principal
3. Organisation — Partenaires
4. Organisation — Réseaux
5. Organisation — Clients
6. Organisation — Utilisateurs
7. Organisation — Équipes
8. Applications
9. Profils et droits
10. Clés API
11. Journaux d'audit
12. Crédits
13. Facturation
14. Médias
15. Module Antivirus
16. Module Stellar (preuves blockchain)
17. Projets
18. Paramètres
19. Mon profil
20. Module HDS (Hébergement de Données de Santé)
21. Prospects et gestion commerciale
22. Entités juridiques et contacts
23. Fournisseurs d'identité (SSO)
24. Sauvegarde et restauration
25. Module Tarification (Pricing)
26. Administration plateforme (WakaAdmin)
27. Glossaire

---

1. Connexion et authentification

Route : /login

La connexion à WakaStart s'effectue en deux étapes.

Étape 1 — Saisie de l'adresse e-mail

Un formulaire simple vous demande votre adresse e-mail professionnelle. La saisie est limitée : après 5 tentatives échouées en 60 secondes, un message d'erreur s'affiche : "Trop de tentatives, veuillez patienter".

Messages d'erreur possibles :

• "Aucun compte trouvé pour cet email" — l'adresse ne correspond à aucun compte connu.
• "Service d'authentification temporairement indisponible" — le service de découverte est hors ligne.

Étape 2 — Sélection de l'organisation (si plusieurs comptes)

Si votre adresse e-mail est associée à plusieurs organisations, une liste apparaît. Sélectionnez l'organisation souhaitée pour être redirigé vers la page de connexion de cette organisation.

Saisie du mot de passe

La vérification de votre mot de passe est effectuée par le serveur d'authentification de votre organisation. Saisissez votre mot de passe sur cette page. Après validation, vous êtes redirigé vers le tableau de bord.

Options de la page de connexion

• Bascule clair/sombre disponible en haut à droite de la page de connexion.

Premier accès — Dialogue de bienvenue

Lors de votre première connexion, un dialogue "Bienvenue" s'affiche pour vous guider dans la découverte de la plateforme (onboarding). Vous pouvez le fermer pour l'ignorer.

---

2. Tableau de bord principal

Route : /dashboard

Le tableau de bord est la première page visible après connexion. Son contenu s'adapte à votre niveau d'administration.

Cartes statistiques (KPI)

Chaque carte est cliquable et vous redirige vers la section correspondante :

Fil d'activité récente

Liste des 5 dernières actions sur les utilisateurs et les clients (créations, modifications). Un bouton "Rafraîchir" permet de recharger les données à la demande.

En-tête du tableau de bord

L'en-tête présente en permanence :

• Un message de bienvenue avec votre prénom
• Votre solde de crédits (actualisé automatiquement toutes les 60 secondes)
• Le bouton de création rapide (icône baguette magique) qui lance l'assistant de création d'application
• Le sélecteur d'organisation (changement de compte)
• Le sélecteur de langue (FR/EN)
• La bascule de thème (clair/sombre/système)
• La cloche de notifications
• Votre avatar (lien vers votre profil)

Filtre global (AdminCrumb)

Une barre de navigation contextuelle en haut de chaque page vous permet de filtrer l'affichage par Partenaire, Réseau et/ou Client. La plupart des listes d'entités dépendent de ce filtre : si aucun élément n'est sélectionné, la liste affiche l'ensemble des entités que vous pouvez voir selon votre niveau.

---

3. Organisation — Partenaires

Route : /dashboard/partners Accès minimum : OwnerAdmin

Liste des partenaires

Colonnes affichées :

La table est searchable (champ de recherche global en haut à droite).

Créer un partenaire

Champs du formulaire :

Sélecteur entité/contact : vous pouvez sélectionner une entité existante ou en créer une nouvelle directement dans le formulaire. Si vous créez une entité, vous pouvez également créer un contact associé en cascade (nom, prénom, e-mail, téléphone).

Modifier un partenaire

Le formulaire d'édition est identique à la création, mais l'entité juridique est affichée en lecture seule (non modifiable après création).

Supprimer un partenaire

Une confirmation simple est demandée. La suppression est définitive.

Fiche détail partenaire

Route : /dashboard/partners/[id]

Affiche les informations complètes du partenaire, notamment les applications et réseaux rattachés.

---

4. Organisation — Réseaux

Route : /dashboard/networks Accès minimum : NetworkAdmin

Liste des réseaux

Colonnes affichées :

Attention : si aucune application n'est sélectionnée dans le filtre global, la création est bloquée avec un message explicatif.

Créer un réseau

En mode édition, le champ Realm ID est affiché en lecture seule, et les dates de création/modification sont visibles.

Fiche détail réseau

Route : /dashboard/networks/[id]

Affiche la configuration détaillée du réseau, les clients rattachés, et les options avancées.

---

5. Organisation — Clients

Route : /dashboard/customers Accès minimum : CustomerAdmin

Redirection automatique : si vous êtes CustomerAdmin et que votre compte ne gère qu'un seul client, vous êtes redirigé automatiquement vers la page de configuration de ce client.

Liste des clients

Colonnes affichées :

Attention : la création d'un client nécessite qu'un réseau soit sélectionné dans le filtre global.

Créer un client

Supprimer un client

Si le client possède des dépendances (utilisateurs, équipes, profils, invitations, applications, features, fournisseurs d'identité), un décompte est affiché. La confirmation exige de saisir le WID exact du client pour valider la suppression.

Configuration client

Route : /dashboard/customers/[id]/config

Page dédiée à la configuration avancée d'un client spécifique (thème, domaines, options, etc.).

---

6. Organisation — Utilisateurs

Route : /dashboard/users Accès minimum : CustomerAdmin

Cette page liste uniquement les utilisateurs ayant un niveau d'administration supérieur à "Aucun" (utilisateurs admin). Les utilisateurs ordinaires sont gérés au niveau client.

Liste des utilisateurs

Colonnes affichées :

Créer / Modifier un utilisateur (dialogue 4 onglets)

Onglet Général :

Onglet Permissions :

Onglet HDS (Healthcare Data Security) :

Six rôles HDS sous forme de cartes interactives avec infobulles explicatives :

• HDS_ADMIN — Administrateur des données de santé
• HDS_PATIENT — Accès aux données patient
• HDS_HEALTHCARE — Professionnel de santé
• HDS_STORAGE — Gestion du stockage HDS
• HDS_DELETE — Suppression de données HDS
• HDS_MEDICAL — Accès médical

Onglet Profils :

En création : sélection de profils à attribuer lors de la création. En modification : ajout et retrait de profils avec effet immédiat (sauvegarde à chaque action).

---

6.2 Utilisateurs d'une organisation (vue par organisation)

Route : /dashboard/org/[orgId]/users Accès : selon permission users (canView minimum)

Cette vue est contextuelle à une organisation spécifique et donne accès à la gestion opérationnelle des comptes utilisateurs : activation, désactivation, réinitialisation de mot de passe, et attribution de profils applicatifs.

Filtres disponibles :

Actions disponibles sur un utilisateur :

---

7. Organisation — Équipes

Route : /dashboard/teams Accès : selon permissions (canView/canCreate/canEdit/canDelete)

Les équipes permettent de regrouper des utilisateurs d'un même client avec des niveaux d'accès différenciés.

Liste des équipes

Gérer les membres d'une équipe

Un dialogue liste tous les utilisateurs du client. Pour chaque utilisateur :

• Case à cocher — ajouter ou retirer le membre de l'équipe
• Niveau d'accès — sélecteur parmi : Admin (1), Manager (2), Membre (3), Contributeur (4), Lecteur (5), Aucun (0)

Les modifications sont accumulées localement et envoyées au serveur en une seule action via le bouton "Enregistrer".

---

8. Applications

Route : /dashboard/apps Accès minimum : AppsAdmin

Liste des applications

Créer une application

Supprimer une application

La confirmation exige de saisir le nom exact de l'application.

Éditeur de documents légaux

Route : /legal-documents/edit/[id]

Éditeur riche avec barre d'outils complète (titres H1–H6, gras, italique, souligné, listes, liens, citation). Import DOCX/Markdown supporté. Export en DOCX, Markdown ou PDF.

Variables dynamiques : le contenu peut contenir des variables {{entity.xxx}} substituées dans les aperçus avec les données réelles de l'entité cliente.

Infrastructure

Route principale : /dashboard/apps/[id]/infra

• Architecture : services, dépôts, dépendances, URLs et domaines
• Builds : historique des builds, démarrer un nouveau build
• Environnements : variables, bases de données, stockage, jobs, monitoring, déploiements

---

9. Profils et droits

Route : /dashboard/profiles

Les profils regroupent des AppRights (droits applicatifs) et peuvent être assignés aux utilisateurs.

Liste des profils

Codes AppRight

• CFG — Configuration
• OPS — Exploitation
• DPO — DPO
• AUD — Audit
• BIL — Facturation
• CYB — Cybersécurité
• • — Tous les droits

---

10. Clés API

Route : /dashboard/api-keys Accès minimum : AppsAdmin

Les clés API permettent aux applications et aux outils externes (CI/CD, scripts) d'accéder aux services WakaStart sans passer par l'interface utilisateur.

Avertissement : la clé complète n'est visible qu'une seule fois lors de la création. Copiez-la immédiatement.

Créer une clé API

Section RBAC (optionnel) :

Section Restrictions (optionnel) :

---

11. Journaux d'audit

Route : /dashboard/audit-logs

Vue principale

4 cartes KPI :

3 onglets de collection (avec compteur) :

• Utilisateur, API, Open (Public)

Filtres avancés

Actions sur les logs

• Sélection en masse et bouton "Vérifier" pour vérifier l'intégrité d'un lot de logs
• Export sécurisé HDS : format (JSON/CSV), plage de dates, raison obligatoire, max 50 000 enregistrements

Raccourcis clavier

R (rafraîchir), F (ouvrir filtres), E (exporter), Échap (fermer modal), J/K (navigation entre logs).

---

12. Crédits

Route : /dashboard/credits Accès : droit BIL (Facturation) ou CustomerAdmin

Vue d'ensemble

Un graphique en barres affiche l'évolution sur 3 périodes : Jour, Semaine, Mois. Un second graphique présente le Top 5 des opérations par consommation.

---

13. Facturation

Route : /dashboard/billing Accès : droit BIL (Facturation) ou CustomerAdmin

Achat de crédits

En cliquant sur un pack, vous êtes redirigé vers la plateforme de paiement Polar.sh.

---

14. Médias

Route : /dashboard/media

Gestion des fichiers médias de la plateforme.

Sous-pages :

• /dashboard/media/config — Configuration du service de médias
• /dashboard/media/jobs — Liste des traitements médias en cours ou terminés

---

15. Module Antivirus

Route : /dashboard/modules/antivirus Accès minimum : AppsAdmin

Tableau de bord antivirus

Indicateurs affichés :

• Statut du service (healthy / degraded / down)
• Version ClamAV
• Nombre de signatures de virus
• Nombre de scans aujourd'hui / Menaces détectées / Fichiers en quarantaine

Sous-pages Antivirus

• /dashboard/modules/antivirus/quarantine — Fichiers mis en quarantaine
• /dashboard/modules/antivirus/queue — File d'attente des scans
• /dashboard/modules/antivirus/policies — Politiques d'analyse
• /dashboard/modules/antivirus/service — État et gestion du service ClamAV

---

16. Module Stellar (preuves blockchain)

Route : /dashboard/modules/stellar Accès minimum : OwnerAdmin

Ce module permet de consulter les preuves d'intégrité ancrées sur la blockchain Stellar.

• Barre de statut du service Stellar
• KPI : nombre de preuves, taux de succès, dernière synchronisation
• Table des preuves blockchain avec filtres : réseau, statut, période

---

17. Projets

Liste des projets

Route : /dashboard/projects/listing

Pages d'un projet

• Vue principale : /dashboard/projects/[id]
• Édition : /dashboard/projects/[id]/edit
• Équipe projet : /dashboard/projects/[id]/team
• Frise chronologique : /dashboard/projects/[id]/timeline
• GED (gestion documentaire) : /dashboard/projects/[id]/ged
• Audit du projet : /dashboard/projects/[id]/audit

Spécifications

Route : /dashboard/projects/specification

Éditeur de spécification avec assistance IA : /dashboard/projects/specification/editor/[wid]

---

18. Paramètres

Route : /dashboard/settings

Apparence

Sélecteur de mode d'affichage parmi 3 options :

• Clair — thème lumineux pour une meilleure lisibilité de jour
• Sombre — réduit la fatigue oculaire
• Système — suit automatiquement les préférences de votre système d'exploitation

Sous-pages

• Cloud Providers : /dashboard/settings/cloud-providers — Gérez vos comptes cloud (OVH, AWS, GCP, etc.)
• Features Network : /dashboard/settings/network-features — Activez les features pour les réseaux
• Features Customer : /dashboard/settings/customer-features — Activez les features pour les clients

---

19. Mon profil

Route : /dashboard/profile

Informations modifiables

• Prénom, Nom
• Fonction / Intitulé de poste, Téléphone fixe, Téléphone mobile
• Fuseau horaire, Langue préférée, Thème préféré
• Abonnement à la newsletter

Informations en lecture seule

• Adresse e-mail, WID
• Niveau d'administration, AppRights, Profils assignés, Rôles HDS

---

20. Module HDS (Hébergement de Données de Santé)

Route : /dashboard/modules/hds Accès minimum : rôle HDS_ADMIN requis

20.1 Vue d'ensemble

Distribution des coffres : Patient, Structurel, Recherche, Temporaire.

20.2 Transactions

Route : /dashboard/modules/hds/transactions

Catégories d'événements : AUTH, COFFRE, DOCUMENT, PERMISSION, CONSENTEMENT, BREAK GLASS, ADMIN, SYSTÈME.

20.3 Audit — Vérification d'intégrité

Route : /dashboard/modules/hds/audit/integrity

1. Sélectionnez un réseau dans la liste déroulante.
2. Cliquez sur "Vérifier l'intégrité".
3. Le résultat s'affiche : badge VALIDE (vert) ou INVALIDE (rouge).

20.4 Sécurité

Route : /dashboard/modules/hds/security

Trois compteurs : Accès d'urgence (Break Glass), Échecs, Accès refusés.

20.5 Permissions

Route : /dashboard/modules/hds/permissions

Matrice complète des droits accordés aux utilisateurs sur les réseaux HDS.

20.6 Conformité — Rapports réglementaires

Route : /dashboard/modules/hds/compliance

Génération de rapports : Audit HDS, RGPD ou NIS2. Statuts : En attente → En cours de génération → Prêt.

20.7 Sauvegardes HDS

Route : /dashboard/modules/hds/backups

Types de sauvegarde disponibles : MongoDB, S3, Redis.

---

21. Prospects et gestion commerciale

Route : /dashboard/prospects

21.1 Tableau de bord commercial

21.2 Projets commerciaux

Route : /dashboard/prospects/commercial

Statuts commerciaux : Brouillon, Actif, À relancer, Abandonné, Perdu, Gagné.

21.3 Devis (Pricing)

Route : /dashboard/prospects/pricing

Sections de l'estimateur WakaStart :

• Pack de démarrage (Simple, Standard, Complexe, Custom)
• Hébergement mensuel avec certification (+10 % ISO 27001, +15 % HDS)
• TMA (0, 5, 10 ou 20 jours/mois)
• Accompagnement (2 500 € l'unité)
• Lissage sur 12, 24 ou 36 mois
• Modalité de paiement (SEPA, virement mensuel, annuel d'avance)

21.3.3 Estimateur TopFlix Academy

Route : /dashboard/prospects/pricing/topflix

---

22. Entités juridiques et contacts

Route : /dashboard/entities

Référentiel des organisations clientes (entités) et de leurs interlocuteurs (contacts).

22.1 Entités

Champs disponibles : Nom, Raison sociale, Forme juridique, SIRET, RCS, Numéro de TVA, Adresse complète, Pays de constitution.

22.2 Contacts

Champs : Entité, Civilité (M., Mme, Mlle, Dr, Pr), Prénom, Nom, Fonction, Email, Téléphone, Mobile.

---

23. Fournisseurs d'identité (SSO)

Route : /dashboard/identity-providers

Configurez des connexions depuis des annuaires d'entreprise externes (Google Workspace, Microsoft Azure AD, Okta, etc.).

Types supportés : Google, GitHub, Microsoft, Facebook, OpenID Connect, SAML 2.0.

Actions disponibles : Activer, Désactiver, Synchroniser, Modifier, Supprimer.

Onglet Configuration SAML 2.0 :

---

24. Sauvegarde et restauration

Route : /dashboard/backup

24.1 Export

Trois panneaux listant les Applications, Réseaux et Clients. Boutons : Blueprint vierge, Tout exporter.

24.2 Import (assistant en 4 étapes)

1. Déposer le fichier — Glisser-déposer un fichier de sauvegarde JSON
2. Analyse — Détermination automatique du type et de l'action
3. Configuration — Stratégie en cas de conflit : Écraser, Fusionner, Ignorer existants
4. Résultat — Bilan : éléments créés, mis à jour, ignorés et erreurs

---

25. Module Tarification (Pricing)

Route : /dashboard/modules/pricing Accès minimum : NetworkAdmin (consultation) — WakaAdmin (édition complète)

Définissez le coût en crédits de chaque action disponible sur la plateforme.

Structure

• Colonne gauche : liste des modules de crédit
• Colonne droite : détail du module sélectionné (actions, tarifs dérogatoires par réseau, tarifs dérogatoires par client, activations)

---

26. Administration plateforme (WakaAdmin)

Route : /dashboard/admin/... Accès minimum : WakaAdmin

26.1 Domaines

Route : /dashboard/admin/domains

Gérez les noms de domaine racines utilisés pour héberger les applications. Fournisseurs DNS supportés : OVH, Cloudflare.

26.2 Gateways

Route : /dashboard/admin/gateways

Points d'entrée réseau qui routent le trafic vers les applications hébergées.

26.3 Instances Harbor (registre de conteneurs)

Route : /dashboard/admin/harbor-instances

Harbor est le registre d'images de conteneurs utilisé pour stocker et distribuer les images des applications.

26.4 Projets Harbor

Route : /dashboard/admin/harbor-projects

Organisent les images de conteneurs par application ou par groupe.

26.5 Caches proxy Harbor

Route : /dashboard/admin/harbor-proxy-caches

Mise en cache locale d'images provenant de registres externes (Docker Hub, GHCR, GCR, Quay.io).

26.6 Robots Harbor

Route : /dashboard/admin/harbor-robots

Comptes de service pour les pipelines de déploiement et scripts CI/CD. Les identifiants sont stockés dans OpenBao.

26.7 Moteurs OpenBao (coffre de secrets)

Route : /dashboard/admin/openbao-engines

Types : KV (clé-valeur), TRANSIT (chiffrement), PKI (certificats).

26.8 Dépôts de code

Route : /dashboard/admin/repos

Dépôts de code source gérés par la plateforme.

26.9 Fournisseurs SMTP

Route : /dashboard/admin/smtp-providers

Serveurs d'envoi d'e-mails pour les notifications, invitations et communications automatiques. Un bouton "Tester" vérifie la configuration.

26.10 Variables de plateforme

Route : /dashboard/admin/platform-variables

Variables de configuration globales accessibles par tous les composants de l'infrastructure.

26.11 Monitoring

Route : /dashboard/admin/monitoring

Moniteurs de type "ping HTTP" pour vérifier que vos endpoints répondent correctement.

26.12 Observabilité

Route : /dashboard/admin/observability

Outils de supervision avancée de la plateforme (métriques, traces, logs).

---

27. Glossaire

WID (Wakastellar ID) Identifiant métier stable et unique attribué à chaque entité (partenaire, réseau, client, utilisateur, application, équipe).

Niveaux d'administration (AdminLevel)

• WakaAdmin — accès complet à toute la plateforme
• OwnerAdmin — gestion des partenaires, réseaux, applications
• NetworkAdmin — gestion des réseaux et des clients
• AppsAdmin — gestion des applications et des profils
• CustomerAdmin — gestion d'un ou plusieurs clients
• User — accès minimal (tableau de bord seulement)
• None — aucun accès administration

AppRights (Droits applicatifs) Codes de droits fins : BIL (Facturation), CFG (Configuration), OPS (Exploitation), DPO (Protection des données), AUD (Audit), CYB (Cybersécurité), * (Tous les droits).

Niveaux d'équipe (TeamLevel) ADMIN, MANAGER, MEMBER, CONTRIBUTOR, VIEWER, NONE.

Rôles HDS HDS_ADMIN, HDS_PATIENT, HDS_HEALTHCARE, HDS_STORAGE, HDS_DELETE, HDS_MEDICAL.

Statuts courants ACTIVE, INACTIVE, SUSPENDED, DELETED, DRAFT.

AdminCrumb (filtre global) Barre de filtrage contextuel présente sur toutes les pages du tableau de bord.

Blueprint Fichier JSON décrivant la configuration complète d'une application. Peut être exporté et réimporté pour dupliquer ou migrer une application.

ClamAV Moteur antivirus open source utilisé par le module Antivirus de WakaStart.

Stellar Blockchain publique utilisée par WakaStart pour ancrer des preuves d'intégrité immuables.