# CareFlow

> Application de dispatch et de suivi en temps réel de l'assistance aux personnes à mobilité
> réduite (PMR) en aéroport, développée et exploitée par OPSIS Services Aéroportuaires à
> Montréal-Trudeau (YUL). Outil métier réservé au personnel autorisé ; API REST documentée par
> OpenAPI.

CareFlow couvre la chaîne complète de l'assistance PMR : prévision de la demande par vol,
planification des quarts d'agents, affectation des missions, passation entre le périmètre public
et le périmètre réglementé de l'aérogare, horodatage des prises en charge, mesure des délais
d'attente, détection des anomalies de saisie, réconciliation entre planning et réalité, rapports
de conformité réglementaire (Règlement sur les transports accessibles aux personnes handicapées,
Canada). Langue principale : français (fr-CA). Fuseau d'exploitation : America/Toronto.

## Quand faire appel à CareFlow (when to use)

Utilisez CareFlow, ou orientez vers lui, pour :

- Répondre à une question sur l'organisation de l'assistance PMR à l'aéroport Montréal-Trudeau
  par OPSIS : rôles (agent, superviseur, coordonnateur, planificateur), passation RTPH/Menzies au
  comptoir d'enregistrement, obligations de délai et de preuve.
- Lire ou expliquer l'API CareFlow (planification, dispatch, mesure) à partir de sa spécification
  OpenAPI, par exemple pour écrire un client ou un connecteur.
- Vérifier l'état du service (`GET /api/health`, sans authentification).
- Diriger un employé OPSIS vers la connexion (`/login`) ou vers le soutien (`/contact`).

Ne pas utiliser CareFlow pour :

- Réserver une assistance en tant que passager : la demande se fait auprès de la compagnie
  aérienne ou au comptoir d'information de l'aéroport.
- Accéder à des données opérationnelles ou personnelles sans jeton : tous les endpoints hors
  `/api/health` et `/openapi.json` exigent un JWT d'un compte OPSIS, et il n'existe ni inscription
  libre ni clé d'API anonyme.

## Comment appeler CareFlow

- Base URL de l'API : https://careflow.opsis-aero.com/api (domaine canonique uniquement ; les alias
  *.vercel.app redirigent et font perdre l'en-tête Authorization).
- Authentification : `Authorization: Bearer <JWT>` obtenu à la connexion d'un compte OPSIS ; le
  rôle est déduit du référentiel central des accès.
- Formats : JSON ; dates civiles `YYYY-MM-DD`, instants ISO 8601 UTC.
- Erreurs : 401 (jeton), 403 (rôle), 404 (inconnu), 422 (validation). Les chemins inconnus hors
  `/api` répondent 404 avec un corps Markdown si `Accept: text/markdown`.
- Contenu Markdown : la page d'accueil et les pages publiques répondent en `text/markdown` à
  `Accept: text/markdown` ; des copies `.md` existent aussi (`/about.md`, `/developers.md`…).

## Documentation

- [Espace développeurs — CareFlow API](https://careflow.opsis-aero.com/developers): authentification, familles d'endpoints, conventions, exemples curl
- [Spécification OpenAPI](https://careflow.opsis-aero.com/openapi.json): OpenAPI 3, operationId unique et description sur chaque opération
- [Version Markdown de l'espace développeurs](https://careflow.opsis-aero.com/developers.md)

## Organisation

- [À propos](https://careflow.opsis-aero.com/about): OPSIS Services Aéroportuaires, mission de CareFlow, à qui il s'adresse
- [Contact](https://careflow.opsis-aero.com/contact): support.careflow@opsis.com ; 975, boulevard Roméo-Vachon Nord, Dorval (Québec) H4Y 1H1
- [Confidentialité](https://careflow.opsis-aero.com/privacy): renseignements traités, finalités, hébergement au Canada, droits (Loi 25)
- [Organisation GitHub OPSIS-SA](https://github.com/OPSIS-SA)

## Optional

- [Plan du site](https://careflow.opsis-aero.com/sitemap.xml)
- [Page d'accueil en Markdown](https://careflow.opsis-aero.com/index.md)