> ## Documentation Index
> Fetch the complete documentation index at: https://api-documentation.kare-app.fr/llms.txt
> Use this file to discover all available pages before exploring further.

# KARE

> Documentation technique de la plateforme KARE

KARE est une plateforme de gestion de la conformité réglementaire : suivi des installations
techniques (SSI, DTA amiante), maintenance des équipements, stockage documentaire et rapports d'audit.

## L'API

Un unique code Fastify (`apps/api`) servant **quatre audiences**, chacune dans son propre container.
L'audience est choisie au démarrage par `APP_AUDIENCE`.

| Audience | Préfixe | Front             | Pour qui                            |
| -------- | ------- | ----------------- | ----------------------------------- |
| **RS**   | `/rs`   | `apps/kare`       | le registre, utilisé sur le terrain |
| **BO**   | `/bo`   | `apps/backoffice` | l'administration                    |
| **AD**   | `/ad`   | `apps/audit`      | les auditeurs                       |
| **PR**   | `/pr`   | `apps/provider`   | les prestataires                    |

Chaque onglet d'API expose les endpoints d'une audience. Tous les schémas sont générés depuis les
validateurs Zod des routes : un changement de schéma apparaît ici dès que `yarn docs:openapi` a
régénéré la spec. L'audience RS publie en plus une spec AsyncAPI pour ses WebSockets.

## Par où commencer

<CardGroup cols={2}>
  <Card title="Monorepo" href="/onboarding/monorepo">
    Structure du repo, workspaces, circulation des types
  </Card>

  <Card title="API" href="/onboarding/api">
    Audiences, arborescence, erreurs, tests
  </Card>

  <Card title="Dev local" href="/devops/local-dev">
    Démarrer la stack sur sa machine
  </Card>

  <Card title="Seed" href="/onboarding/seed/overview">
    Créer un jeu de données en local ou sur staging
  </Card>

  <Card title="DevOps" href="/devops/overview">
    Environnements, CI, déploiement, infra
  </Card>

  <Card title="Conventions" href="/onboarding/conventions">
    Code, commentaires, commits, migrations
  </Card>
</CardGroup>