# Wakastart en 5 minutes

> Ce que fait la plateforme, pour qui, ses trois piliers et le parcours à suivre selon votre rôle.

Wakastart est une plateforme pour éditeurs de logiciels. Elle fournit à vos applications, les [wakapps](/v1.0/glossaire#wakapp), tout ce qui n'est pas votre métier : l'identité de vos utilisateurs, l'organisation de vos clients, les droits, l'hébergement et des modules réglementaires prêts à l'emploi.

Vous écrivez votre application. Wakastart la connecte à ses utilisateurs, la range chez chacun de vos clients et la fait tourner.

## Pour qui

| Vous êtes | Vous utilisez Wakastart pour | Votre porte d'entrée |
|---|---|---|
| **Éditeur ou partenaire** | publier une application, la distribuer à plusieurs clients et suivre ses projets | la console |
| **Développeur d'une wakapp** | brancher la connexion, lire les droits de l'utilisateur, héberger le code | l'API publique et la console |
| **Administrateur d'une organisation cliente** | suivre les applications de votre organisation, son activité et sa sécurité | la console |

## Les trois piliers

::::cards{cols=3}
:::card{title="Identité" href="/v1.0/authentification" icon="KeyRound"}
Keycloak, une instance par environnement, des réseaux et des clients isolés, des profils et des droits lus par votre code.
:::
:::card{title="Hébergement" href="/v1.0/applications" icon="Container"}
Vos services construits depuis Git, avec leurs bases, buckets et URLs, déployés en dev, staging et prod.
:::
:::card{title="Modules" href="/v1.0/antivirus" icon="Blocks"}
Antivirus, données de santé, paiements, crédits, documents légaux : des briques métier appelées par API.
:::
::::

## Comment ça marche

Votre application ne connaît jamais le serveur d'identité qui authentifie ses utilisateurs. Elle envoie l'adresse de son front à [Discovery](/v1.0/glossaire#discovery), qui lui renvoie l'adresse de connexion de la bonne instance [Keycloak](/v1.0/glossaire#keycloak). Une fois l'utilisateur connecté, elle interroge l'API publique pour savoir qui il est, à quelle organisation il appartient et ce qu'il a le droit de faire. Pendant ce temps, la console décrit l'architecture de l'application et Wakastart la fait tourner dans chaque environnement.

```mermaid
flowchart LR
  U([Utilisateur]) --> F

  subgraph H["Hébergement Wakastart"]
    F["Front de la wakapp"]
    B["Back de la wakapp"]
    D[("Base de données")]
    F --> B --> D
  end

  F -->|"1. host du front"| DI["Discovery<br/>discovery.wakastart.app"]
  DI -->|"2. keycloakUrl"| F
  F -->|"3. connexion"| K["Keycloak de l'environnement<br/>auth · auth-staging · auth-dev"]
  K -->|"4. jetons"| F
  B -->|"5. qui est l'utilisateur ?"| API["API publique<br/>api.wakastart.app/api"]
  C["Console<br/>app.wakastart.app"] -.->|"décrit et déploie"| H
```

1. Le front envoie son propre nom d'hôte à Discovery, sans jeton.
2. Discovery répond par une URL de connexion complète : instance, realm et client y sont déjà.
3. L'utilisateur s'authentifie sur l'instance Keycloak de cet environnement.
4. L'application reçoit ses jetons.
5. Le back appelle `GET /api/me` : identité, organisation, profil et droits.

Pour le détail de chaque étape, lisez [Discovery](/v1.0/concepts/discovery) et [Jeton enrichi et /me](/v1.0/concepts/jeton-enrichi-et-me).

## Ce que Wakastart organise pour vous

Chaque application appartient à un [propriétaire](/v1.0/glossaire#propriétaire). Elle est distribuée par un ou plusieurs [réseaux](/v1.0/glossaire#réseau), qui regroupent des [clients](/v1.0/glossaire#client), qui regroupent des utilisateurs. Côté hébergement, la même application déclare une fois son architecture, puis chaque [environnement](/v1.0/glossaire#environnement) en reçoit ses propres instances.

Le [schéma central des concepts](/v1.0/concepts) présente ces deux arbres côte à côte.

## Choisissez votre parcours

::::cards{cols=3}
:::card{title="Connecter vos utilisateurs" href="/v1.0/demarrer/connecter-vos-utilisateurs" icon="LogIn"}
Intégrer la connexion Wakastart dans votre application, en TypeScript, de Discovery à la déconnexion.
:::
:::card{title="Déployer votre premier service" href="/v1.0/demarrer/deployer-votre-premier-service" icon="Rocket"}
Passer d'un dépôt Git à un service en ligne sur son URL, depuis la console.
:::
:::card{title="Administrer votre organisation" href="/v1.0/demarrer/administrer-votre-organisation" icon="UserCog"}
Prendre vos repères dans la console, ajouter un utilisateur avec son profil, lire le journal d'audit.
:::
::::

:::note
Votre application est créée par Wakastart ; contactez-nous pour en ouvrir une. Elle apparaît ensuite dans le menu de votre console, avec votre organisation déjà en place.
:::

## Ressources

- [Visite de la console](/v1.0/demarrer/visite-de-la-console) : ce que contient chaque menu, selon votre rôle.
- [Concepts](/v1.0/concepts) : le modèle de la plateforme, en dix pages courtes.
- [Référence API](/v1.0/reference-api) : URL de base, authentification et endpoints.
- [Limites et quotas](/v1.0/limites) : valeurs par défaut et plafonds.
- [Glossaire](/v1.0/glossaire) : tous les termes de la documentation et de la console.
- [waka-ui](/v1.0/interface-waka-ui) : la bibliothèque de composants pour construire le front de votre wakapp.
- [Outils pour assistants IA](/v1.0/outils-ia) : interroger cette documentation depuis votre assistant, par le serveur MCP `https://docs.wakastart.app/api/mcp`.
