# Administrer votre organisation

> Premiers pas d'un administrateur client : se connecter, lire la console, inviter un utilisateur avec son profil, consulter le journal d'audit.

Ce démarrage rapide s'adresse à l'administrateur d'une organisation cliente. En dix minutes, vous prenez vos repères dans la console, vérifiez ce que votre compte vous permet, ajoutez un collègue avec le bon profil et retrouvez la trace de vos actions.

## Ce que vous allez faire

1. Vous connecter à la console Wakastart.
2. Lire votre tableau de bord et repérer vos applications.
3. Vérifier votre niveau d'administration et vos droits.
4. Inviter un utilisateur dans votre organisation, avec son profil.
5. Consulter le journal d'audit.

## Avant de commencer

- [ ] Un compte sur la console, avec le niveau Administrateur client. Wakastart crée le premier administrateur de chaque organisation.
- [ ] Pour l'étape 4 : un profil qui porte le droit `invitations.create` dans l'application, et un terminal avec `curl`.
- [ ] Pour l'étape 5 : le profil **Auditeur**.

::::steps
### Se connecter à la console

1. Ouvrez `https://app.wakastart.app`.
2. Sur l'écran **Bienvenue**, saisissez votre **Adresse email**, puis cliquez sur **Continuer**.
3. Sur la page de connexion qui s'ouvre, saisissez votre mot de passe.

Résultat : la console s'ouvre sur le **Tableau de bord**, avec une salutation suivie de votre prénom, par exemple « Bonjour, Claire ». Lors de votre première connexion, une fenêtre « Bienvenue sur Wakastart ! » vous accueille ; vous pouvez la fermer.

### Repérer vos applications

Le **Tableau de bord** d'un administrateur client contient deux cartes :

- **Accès rapide** (« Vos applications ») : une tuile par application de votre organisation. Cliquez sur une tuile pour l'ouvrir.
- **Dernière activité** : les derniers builds de vos applications, toutes confondues.

Dans le menu latéral, chaque application forme un groupe à son nom. Il contient **Paramétrage**, accessible aux profils Développeur et Infra, puis, pour ces mêmes profils, **Architecture**, **Builds**, **Environnements** et **Backups**.

Résultat : vous savez quelles applications votre organisation utilise. Si la carte affiche « Aucune application ne vous est encore assignée », contactez Wakastart : aucune application n'est encore rattachée à votre organisation.

### Vérifier votre niveau d'accès

1. En bas du menu latéral, cliquez sur votre nom, puis sur **Mon profil**.
2. Lisez la carte **Niveaux d'accès** :
   - **Niveau d'administration** : « Administrateur Client » ;
   - **Droits applicatifs (AppRights)** : les codes de droits que vous détenez, par exemple `audit.read` ;
   - **Profils assignés** : vos profils, par exemple Infra ou Auditeur.

Résultat : vous savez ce que la console vous montrera. Le tableau de la [visite de la console](/v1.0/demarrer/visite-de-la-console) indique quel profil ouvre quel menu.

### Inviter un utilisateur avec son profil

L'invitation passe par l'API publique, avec un jeton que Keycloak vous a délivré en vous connectant à votre application (voir [Connecter vos utilisateurs](/v1.0/demarrer/connecter-vos-utilisateurs)). Le profil est attribué dans la même requête : l'invité le reçoit dès qu'il accepte.

```bash
curl -s https://api.wakastart.app/api/invitations \
  -H "Authorization: Bearer $JETON" \
  -H 'Content-Type: application/json' \
  -d '{
    "customerId": "EXCLI1",
    "invitedEmail": "paul.durand@exemple.fr",
    "invitedFirstName": "Paul",
    "invitedLastName": "Durand",
    "profileWid": "EXPRF1",
    "language": "fr"
  }'
```

```ts
const response = await fetch("https://api.wakastart.app/api/invitations", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.JETON}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    customerId: "EXCLI1", // WID de votre organisation
    invitedEmail: "paul.durand@exemple.fr",
    invitedFirstName: "Paul",
    invitedLastName: "Durand",
    profileWid: "EXPRF1", // identifiant du profil à attribuer
    language: "fr",
  }),
});
console.log(response.status, await response.json());
```

Réponse attendue, `201` (extrait) :

```json
{
  "id": "6f1c2b9e-3d47-4a8e-9c1f-2b7d5e8a4c10",
  "invitedEmail": "paul.durand@exemple.fr",
  "invitedFirstName": "Paul",
  "invitedLastName": "Durand",
  "status": "PENDING",
  "envType": "prod",
  "language": "fr",
  "expiresAt": "2026-11-02T09:30:00.000Z",
  "customer": { "wid": "EXCLI1", "name": "Clinique Exemple" },
  "profile": { "wid": "EXPRF1", "name": "Soignant" }
}
```

`customerId` reçoit le WID de votre organisation, que `GET /api/me` renvoie dans `customer.wid` : un administrateur client ne peut inviter que dans la sienne. L'invitation vise toujours l'environnement de votre jeton, ici la production : n'envoyez pas `envType`, il est refusé en `400`. Pour inviter la même personne en staging, utilisez un jeton obtenu en vous connectant à l'application de staging.

Résultat : Paul reçoit un e-mail d'invitation. Le lien ouvre la page d'acceptation de votre application, ou à défaut la page **Rejoindre la plateforme** de Wakastart, où il saisit son **Prénom**, son **Nom** et son **Mot de passe** (8 à 128 caractères), coche **J'accepte les Conditions d'utilisation**, puis clique sur **Créer mon compte**. Le lien reste valable 10 jours, sauf réglage différent de l'application.

### Consulter le journal d'audit

1. Dans le menu latéral, ouvrez **Sécurité**, puis **Audit Logs**.
2. Cliquez sur **Filtres** pour restreindre la période, la sévérité ou l'action.
3. Ouvrez une entrée pour lire son détail, puis cliquez sur **Vérifier l'intégrité** pour contrôler qu'elle n'a pas été modifiée.

Résultat : vous voyez les actions enregistrées sous votre compte, horodatées et vérifiables. **Exporter** produit un fichier JSON ou CSV chiffré, après saisie d'une raison d'export.
::::

## Vérifier le résultat

- **Mon profil** affiche votre niveau et vos profils.
- L'invitation renvoyée par l'API a le statut `PENDING`. Elle passe à `ACCEPTED` quand Paul a créé son compte ; il se connecte ensuite à votre application avec le profil choisi.
- Le journal d'audit liste vos actions des derniers jours.

:::note
Si l'API répond `403` avec le message « Droit applicatif requis : invitations.create », votre profil ne porte pas ce droit dans l'application. Demandez à l'éditeur de l'application de l'ajouter à votre profil. Une réponse `409` signale qu'une invitation est déjà en cours pour cette adresse.
:::

## Étapes suivantes

::::cards{cols=3}
:::card{title="Visite de la console" href="/v1.0/demarrer/visite-de-la-console" icon="Map"}
Chaque menu, ce qu'il contient et le profil qui l'affiche.
:::
:::card{title="Droits, profils et équipes" href="/v1.0/concepts/droits-profils-et-equipes" icon="ShieldCheck"}
Comment un profil regroupe des droits, environnement par environnement.
:::
:::card{title="Utilisateurs et équipes" href="/v1.0/utilisateurs" icon="Users"}
Suivre, relancer et annuler les invitations, désactiver un compte.
:::
::::
