{
  "openapi": "3.0.0",
  "paths": {
    "/": {
      "get": {
        "operationId": "AppController_getHomePage",
        "parameters": [],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "tags": [
          "App"
        ]
      }
    },
    "/swagger.json": {
      "get": {
        "operationId": "AppController_getSwaggerJson",
        "parameters": [],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "tags": [
          "App"
        ]
      }
    },
    "/licences": {
      "post": {
        "operationId": "LicenceController_create",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "example": "Licence Premium"
                  }
                },
                "required": [
                  "name"
                ]
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Licence créée avec succès"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Créer une nouvelle licence",
        "tags": [
          "Licences"
        ]
      },
      "get": {
        "operationId": "LicenceController_findAll",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Liste des licences"
          },
          "403": {
            "description": "Accès interdit - SUPERADMIN requis"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Récupérer toutes les licences (SUPERADMIN uniquement)",
        "tags": [
          "Licences"
        ]
      }
    },
    "/licences/dashboard-summary": {
      "get": {
        "operationId": "LicenceController_dashboardSummary",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Récapitulatif par licence"
          },
          "403": {
            "description": "Accès interdit - SUPERADMIN requis"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Récapitulatif multi-licences pour le dashboard superadmin (saveur, état config persisté, compteurs)",
        "tags": [
          "Licences"
        ]
      }
    },
    "/licences/{id}": {
      "get": {
        "operationId": "LicenceController_findOne",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "description": "ID de la licence",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Licence trouvée"
          },
          "404": {
            "description": "Licence introuvable"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Récupérer une licence par ID",
        "tags": [
          "Licences"
        ]
      },
      "put": {
        "operationId": "LicenceController_update",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "description": "ID de la licence",
            "schema": {
              "type": "number"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "example": "Nouveau nom"
                  },
                  "activeIntegration": {
                    "type": "string",
                    "enum": [
                      "EASYDOCT",
                      "LIBRE",
                      "TEST_SERVEUR",
                      "NONE"
                    ],
                    "example": "EASYDOCT",
                    "description": "Intégration active (LIBRE = éditeur générique du Kiosk Integration Contract)"
                  },
                  "assignedFlavor": {
                    "type": "string",
                    "enum": [
                      "EASYDOCT",
                      "LIBRE"
                    ],
                    "nullable": true,
                    "example": "EASYDOCT",
                    "description": "Saveur imposée aux administrateurs (superadmin uniquement ; null = non assignée)"
                  },
                  "scanVaultEnabled": {
                    "type": "boolean",
                    "example": false,
                    "description": "Coffre documents : dépôt des ordonnances scannées (RDV direct) dans le bucket S3 privé du coffre (superadmin uniquement ; suppose une convention d'hébergement signée)"
                  },
                  "documentAnalysisEnabled": {
                    "type": "boolean",
                    "example": false,
                    "description": "Service d'analyse documentaire ApiBorne (analysis/, chiffré de bout en bout) : la borne y envoie les documents scannés au lieu du service local (superadmin uniquement ; données de santé, hébergement HDS)"
                  },
                  "timeZone": {
                    "type": "string",
                    "nullable": true,
                    "example": "Indian/Reunion",
                    "description": "Fuseau horaire du centre (identifiant IANA). Les heures de RDV transmises par l'éditeur en heure murale sont relues dans ce fuseau par la borne et le Cockpit (centres hors métropole). null = non défini. 400 si l'identifiant n'est pas un fuseau IANA valide"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Licence mise à jour"
          },
          "404": {
            "description": "Licence introuvable"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Mettre à jour une licence",
        "tags": [
          "Licences"
        ]
      },
      "delete": {
        "operationId": "LicenceController_remove",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "description": "ID de la licence",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Licence supprimée"
          },
          "404": {
            "description": "Licence introuvable"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Supprimer une licence",
        "tags": [
          "Licences"
        ]
      }
    },
    "/auth/login": {
      "post": {
        "operationId": "AuthController_login",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "email": {
                    "type": "string",
                    "example": "user@example.com"
                  },
                  "password": {
                    "type": "string",
                    "example": "password123"
                  },
                  "rememberMe": {
                    "type": "boolean",
                    "example": true,
                    "description": "Pose le cookie httpOnly `apiborne_admin_refresh` (session persistante, AUTH_REMEMBER_DAYS jours)"
                  }
                },
                "required": [
                  "email",
                  "password"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Connexion réussie, token JWT retourné",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "access_token": {
                      "type": "string"
                    },
                    "user": {
                      "type": "object"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Email ou mot de passe invalide"
          },
          "429": {
            "description": "Trop de tentatives (par IP ou par identifiant)"
          }
        },
        "summary": "Se connecter et obtenir un token JWT",
        "tags": [
          "Authentication"
        ]
      }
    },
    "/auth/refresh": {
      "post": {
        "operationId": "AuthController_refresh",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Même forme que /auth/login (access_token, user, licence)"
          },
          "401": {
            "description": "Cookie absent, inconnu ou périmé"
          },
          "429": {
            "description": "Trop de tentatives (par IP)"
          }
        },
        "summary": "Restaurer la session depuis le cookie « Se souvenir de moi » (nouveau JWT, rotation du cookie)",
        "tags": [
          "Authentication"
        ]
      }
    },
    "/auth/logout": {
      "post": {
        "operationId": "AuthController_logout",
        "parameters": [],
        "responses": {
          "200": {
            "description": "{ success: true }"
          }
        },
        "summary": "Se déconnecter : révoque le cookie de session persistante",
        "tags": [
          "Authentication"
        ]
      }
    },
    "/auth/profile": {
      "get": {
        "operationId": "AuthController_getProfile",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Profil récupéré avec succès"
          },
          "401": {
            "description": "Token manquant ou invalide"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Récupérer le profil de l'utilisateur connecté",
        "tags": [
          "Authentication"
        ]
      }
    },
    "/auth/accessibleLicences": {
      "get": {
        "operationId": "AuthController_accessibleLicences",
        "parameters": [],
        "responses": {
          "200": {
            "description": "{ licences: [{ id, name }] }"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Licences accessibles à l'utilisateur courant (superadmin : toutes ; login externe : celles accordées par l'éditeur)",
        "tags": [
          "Authentication"
        ]
      }
    },
    "/auth/switchLicence": {
      "post": {
        "description": "Génère un nouveau JWT avec la licence spécifiée. Superadmin : n'importe quelle licence ; admin : uniquement les licences accordées (login externe éditeur ou licence par défaut).",
        "operationId": "AuthController_switchLicence",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "licenceId": {
                    "type": "number",
                    "example": 1,
                    "description": "ID de la licence à utiliser"
                  }
                },
                "required": [
                  "licenceId"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Nouveau token JWT généré avec la licence spécifiée",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "access_token": {
                      "type": "string",
                      "description": "Nouveau JWT avec la licence switchée"
                    },
                    "currentLicenceId": {
                      "type": "number",
                      "description": "ID de la licence active"
                    },
                    "user": {
                      "type": "object"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Accès interdit - SUPERADMIN requis"
          },
          "404": {
            "description": "Licence introuvable"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Changer de licence temporairement (superadmin : tout ; admin : son périmètre)",
        "tags": [
          "Authentication"
        ]
      }
    },
    "/users": {
      "post": {
        "operationId": "UserController_create",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "email": {
                    "type": "string",
                    "example": "user@example.com"
                  },
                  "password": {
                    "type": "string",
                    "example": "password123"
                  },
                  "firstName": {
                    "type": "string",
                    "example": "John"
                  },
                  "lastName": {
                    "type": "string",
                    "example": "Doe"
                  },
                  "phone": {
                    "type": "string",
                    "example": "+33 6 12 34 56 78"
                  },
                  "role": {
                    "type": "string",
                    "enum": [
                      "user",
                      "observateur",
                      "superviseur",
                      "admin",
                      "superadmin"
                    ],
                    "example": "user"
                  },
                  "defaultLicenceId": {
                    "type": "number",
                    "example": 1
                  },
                  "canAccessCockpit": {
                    "type": "boolean",
                    "example": true
                  }
                },
                "required": [
                  "email",
                  "password",
                  "role"
                ]
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Utilisateur créé avec succès"
          },
          "409": {
            "description": "Email déjà utilisé"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Créer un nouvel utilisateur",
        "tags": [
          "Users"
        ]
      },
      "get": {
        "operationId": "UserController_findAll",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Liste des utilisateurs"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Récupérer les utilisateurs (admin/observateur : ceux de sa licence)",
        "tags": [
          "Users"
        ]
      }
    },
    "/users/invite": {
      "post": {
        "operationId": "UserController_invite",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "email": {
                    "type": "string",
                    "example": "user@example.com"
                  },
                  "firstName": {
                    "type": "string",
                    "example": "John"
                  },
                  "lastName": {
                    "type": "string",
                    "example": "Doe"
                  },
                  "role": {
                    "type": "string",
                    "enum": [
                      "user",
                      "observateur",
                      "superviseur",
                      "admin",
                      "superadmin"
                    ],
                    "example": "user"
                  },
                  "defaultLicenceId": {
                    "type": "number",
                    "example": 1
                  }
                },
                "required": [
                  "email"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Invitation envoyée"
          },
          "409": {
            "description": "Email déjà utilisé"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Inviter un utilisateur par email (admin : sur sa licence uniquement)",
        "tags": [
          "Users"
        ]
      }
    },
    "/users/{id}/resend-invitation": {
      "post": {
        "operationId": "UserController_resendInvitation",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Invitation renvoyée"
          },
          "400": {
            "description": "Compte déjà activé ou email injoignable"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Renvoyer l'invitation d'un compte jamais activé (nouveau token, admin : sa licence uniquement)",
        "tags": [
          "Users"
        ]
      }
    },
    "/users/forgot-password": {
      "post": {
        "operationId": "UserController_forgotPassword",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "email": {
                    "type": "string"
                  }
                },
                "required": [
                  "email"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Toujours success (ne révèle pas si le compte existe)"
          }
        },
        "summary": "Demander un email de réinitialisation de mot de passe",
        "tags": [
          "Users"
        ]
      }
    },
    "/users/set-password": {
      "post": {
        "operationId": "UserController_setPassword",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "email": {
                    "type": "string"
                  },
                  "token": {
                    "type": "string"
                  },
                  "password": {
                    "type": "string"
                  }
                },
                "required": [
                  "email",
                  "token",
                  "password"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Mot de passe défini"
          },
          "400": {
            "description": "Invitation invalide ou expirée"
          },
          "429": {
            "description": "Trop de tentatives (par IP)"
          }
        },
        "summary": "Définir le mot de passe depuis un lien d'invitation",
        "tags": [
          "Users"
        ]
      }
    },
    "/users/{id}": {
      "get": {
        "operationId": "UserController_findOne",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "description": "ID de l'utilisateur",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Utilisateur trouvé"
          },
          "404": {
            "description": "Utilisateur introuvable"
          }
        },
        "summary": "Récupérer un utilisateur par ID",
        "tags": [
          "Users"
        ]
      },
      "put": {
        "operationId": "UserController_update",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "description": "ID de l'utilisateur",
            "schema": {
              "type": "number"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "email": {
                    "type": "string"
                  },
                  "password": {
                    "type": "string"
                  },
                  "firstName": {
                    "type": "string"
                  },
                  "lastName": {
                    "type": "string"
                  },
                  "phone": {
                    "type": "string"
                  },
                  "role": {
                    "type": "string",
                    "enum": [
                      "user",
                      "observateur",
                      "superviseur",
                      "admin",
                      "superadmin"
                    ]
                  },
                  "defaultLicenceId": {
                    "type": "number"
                  },
                  "canAccessCockpit": {
                    "type": "boolean"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Utilisateur mis à jour"
          },
          "404": {
            "description": "Utilisateur introuvable"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Mettre à jour un utilisateur",
        "tags": [
          "Users"
        ]
      },
      "delete": {
        "operationId": "UserController_remove",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "description": "ID de l'utilisateur",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Utilisateur supprimé"
          },
          "404": {
            "description": "Utilisateur introuvable"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Supprimer un utilisateur",
        "tags": [
          "Users"
        ]
      }
    },
    "/users/bulk-role": {
      "post": {
        "operationId": "UserController_updateRolesBulk",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "ids": {
                    "type": "array",
                    "items": {
                      "type": "number"
                    },
                    "example": [
                      9,
                      10,
                      11
                    ]
                  },
                  "role": {
                    "type": "string",
                    "enum": [
                      "user",
                      "observateur",
                      "superviseur",
                      "admin",
                      "superadmin"
                    ]
                  }
                },
                "required": [
                  "ids",
                  "role"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Rapport : ids modifies et, pour chaque echec, sa raison"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Changer le role de plusieurs utilisateurs (admin : sa licence uniquement)",
        "tags": [
          "Users"
        ]
      }
    },
    "/users/validate": {
      "post": {
        "operationId": "UserController_validate",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "email": {
                    "type": "string",
                    "example": "user@example.com"
                  },
                  "password": {
                    "type": "string",
                    "example": "password123"
                  }
                },
                "required": [
                  "email",
                  "password"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Credentials validés"
          }
        },
        "summary": "Valider les credentials d'un utilisateur",
        "tags": [
          "Users"
        ]
      }
    },
    "/licences/{licenceId}/integration/easydoct": {
      "post": {
        "operationId": "setIntegrationEasyDoct",
        "parameters": [
          {
            "name": "licenceId",
            "required": true,
            "in": "path",
            "description": "ID de la licence",
            "schema": {
              "type": "number"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "officeId": {
                    "type": "string",
                    "example": "office-123"
                  },
                  "officeVisibleId": {
                    "type": "string",
                    "example": "office-visible-456"
                  },
                  "targetUrl": {
                    "type": "string",
                    "example": "http://localhost/easydoct.com",
                    "description": "Fallback historique des deux base URLs (compat)"
                  },
                  "contractBaseUrl": {
                    "type": "string",
                    "nullable": true,
                    "description": "Base URL du contrat (apiborneIntegrationService/v1)"
                  },
                  "configServiceBaseUrl": {
                    "type": "string",
                    "nullable": true,
                    "description": "Base URL du config service EasyDoct legacy (apiborneConfigService) — vide = pas de forwards référentiels"
                  },
                  "supportedRoutes": {
                    "type": "object",
                    "nullable": true,
                    "description": "HISTORIQUE, ignoré — toutes les routes du contrat sont obligatoires (implémentation minimale acceptée). Toléré pour compat."
                  }
                },
                "required": []
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Intégration EasyDoct créée/mise à jour"
          },
          "404": {
            "description": "Licence introuvable"
          },
          "409": {
            "description": "La licence a déjà une autre intégration"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Créer ou mettre à jour l'intégration éditeur (contrat) d'une licence — EasyDoct ou tout éditeur implémentant le Kiosk Integration Contract",
        "tags": [
          "Integrations"
        ]
      },
      "delete": {
        "operationId": "removeIntegrationEasyDoct",
        "parameters": [
          {
            "name": "licenceId",
            "required": true,
            "in": "path",
            "description": "ID de la licence",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Intégration EasyDoct supprimée"
          },
          "404": {
            "description": "Licence ou intégration introuvable"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Supprimer l'intégration EasyDoct d'une licence",
        "tags": [
          "Integrations"
        ]
      }
    },
    "/licences/{licenceId}/integration/test-serveur": {
      "post": {
        "operationId": "setIntegrationTestServeur",
        "parameters": [
          {
            "name": "licenceId",
            "required": true,
            "in": "path",
            "description": "ID de la licence",
            "schema": {
              "type": "number"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "serverUrl": {
                    "type": "string",
                    "example": "https://test.example.com",
                    "nullable": true
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Intégration TestServeur créée/mise à jour"
          },
          "404": {
            "description": "Licence introuvable"
          },
          "409": {
            "description": "La licence a déjà une autre intégration"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Créer ou mettre à jour l'intégration TestServeur pour une licence",
        "tags": [
          "Integrations"
        ]
      },
      "delete": {
        "operationId": "removeIntegrationTestServeur",
        "parameters": [
          {
            "name": "licenceId",
            "required": true,
            "in": "path",
            "description": "ID de la licence",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Intégration TestServeur supprimée"
          },
          "404": {
            "description": "Licence ou intégration introuvable"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Supprimer l'intégration TestServeur d'une licence",
        "tags": [
          "Integrations"
        ]
      }
    },
    "/licences/{licenceId}/config-check": {
      "get": {
        "operationId": "getConfigCheck",
        "parameters": [
          {
            "name": "licenceId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "force",
            "required": false,
            "in": "query",
            "description": "true = re-sonder même si une validation est persistée (bouton Relancer)",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "{ connectivity: {...}, integration: {...} }"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "État de la configuration de la licence : connectivité KioskReactor (définie + sondée) et intégration éditeur (endpoint contrat sondé) — pilote le verrouillage de l'admin",
        "tags": [
          "Integrations"
        ]
      }
    },
    "/licences/{licenceId}/contract-test": {
      "post": {
        "operationId": "runContractTest",
        "parameters": [
          {
            "name": "licenceId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "route"
                ],
                "properties": {
                  "route": {
                    "type": "string",
                    "description": "identifyPatients | getAppointmentByCode | getAppointmentById | listAppointmentDocuments | getNotificationReadiness | staffSignIn | getOfficePlaces | getExamTypes | getPractitioners | getRooms | getExams | getDocumentTypes"
                  },
                  "params": {
                    "type": "object",
                    "description": "Entrées utilisateur selon la route : criteria identify (lastName, firstName, birthDate, socialSecurityId), code, appointmentId, login/password, deviceId (optionnel)"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Rapport { ok, status, durationMs, request, response, checks }"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Banc de test du contrat : exécute UN appel réel (lecture) vers l'éditeur avec les entrées fournies et rend un rapport détaillé (requête, statut, durée, réponse, checks de conformité)",
        "tags": [
          "Integrations"
        ]
      }
    },
    "/licences/{licenceId}/config-referentials": {
      "get": {
        "operationId": "getConfigReferentials",
        "parameters": [
          {
            "name": "licenceId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "{ flavor, officePlaces, examTypes, practitioners, rooms, exams }"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Contenu des référentiels de l'éditeur (lieux, types d'examen, praticiens, salles, examens) tels que vus par le serveur ApiBorne — page « Référentiels éditeur » de l'admin",
        "tags": [
          "Integrations"
        ]
      }
    },
    "/api/contractRelay/{splat}": {
      "get": {
        "operationId": "ContractRelay_Relay",
        "parameters": [],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Relais générique des appels contrat de la borne vers l'éditeur (passthrough chiffré E2E)",
        "tags": [
          "ContractRelay"
        ]
      },
      "post": {
        "operationId": "ContractRelay_Relay",
        "parameters": [],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Relais générique des appels contrat de la borne vers l'éditeur (passthrough chiffré E2E)",
        "tags": [
          "ContractRelay"
        ]
      },
      "put": {
        "operationId": "ContractRelay_Relay",
        "parameters": [],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Relais générique des appels contrat de la borne vers l'éditeur (passthrough chiffré E2E)",
        "tags": [
          "ContractRelay"
        ]
      },
      "delete": {
        "operationId": "ContractRelay_Relay",
        "parameters": [],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Relais générique des appels contrat de la borne vers l'éditeur (passthrough chiffré E2E)",
        "tags": [
          "ContractRelay"
        ]
      },
      "patch": {
        "operationId": "ContractRelay_Relay",
        "parameters": [],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Relais générique des appels contrat de la borne vers l'éditeur (passthrough chiffré E2E)",
        "tags": [
          "ContractRelay"
        ]
      },
      "options": {
        "operationId": "ContractRelay_Relay",
        "parameters": [],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Relais générique des appels contrat de la borne vers l'éditeur (passthrough chiffré E2E)",
        "tags": [
          "ContractRelay"
        ]
      },
      "head": {
        "operationId": "ContractRelay_Relay",
        "parameters": [],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Relais générique des appels contrat de la borne vers l'éditeur (passthrough chiffré E2E)",
        "tags": [
          "ContractRelay"
        ]
      },
      "search": {
        "operationId": "ContractRelay_Relay",
        "parameters": [],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Relais générique des appels contrat de la borne vers l'éditeur (passthrough chiffré E2E)",
        "tags": [
          "ContractRelay"
        ]
      }
    },
    "/api/analysisRelay/{splat}": {
      "get": {
        "operationId": "AnalysisRelay_Relay",
        "parameters": [],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Relais des appels d'analyse documentaire de la borne vers le service HDS (passthrough chiffré, zero knowledge)",
        "tags": [
          "AnalysisRelay"
        ]
      },
      "post": {
        "operationId": "AnalysisRelay_Relay",
        "parameters": [],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Relais des appels d'analyse documentaire de la borne vers le service HDS (passthrough chiffré, zero knowledge)",
        "tags": [
          "AnalysisRelay"
        ]
      },
      "put": {
        "operationId": "AnalysisRelay_Relay",
        "parameters": [],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Relais des appels d'analyse documentaire de la borne vers le service HDS (passthrough chiffré, zero knowledge)",
        "tags": [
          "AnalysisRelay"
        ]
      },
      "delete": {
        "operationId": "AnalysisRelay_Relay",
        "parameters": [],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Relais des appels d'analyse documentaire de la borne vers le service HDS (passthrough chiffré, zero knowledge)",
        "tags": [
          "AnalysisRelay"
        ]
      },
      "patch": {
        "operationId": "AnalysisRelay_Relay",
        "parameters": [],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Relais des appels d'analyse documentaire de la borne vers le service HDS (passthrough chiffré, zero knowledge)",
        "tags": [
          "AnalysisRelay"
        ]
      },
      "options": {
        "operationId": "AnalysisRelay_Relay",
        "parameters": [],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Relais des appels d'analyse documentaire de la borne vers le service HDS (passthrough chiffré, zero knowledge)",
        "tags": [
          "AnalysisRelay"
        ]
      },
      "head": {
        "operationId": "AnalysisRelay_Relay",
        "parameters": [],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Relais des appels d'analyse documentaire de la borne vers le service HDS (passthrough chiffré, zero knowledge)",
        "tags": [
          "AnalysisRelay"
        ]
      },
      "search": {
        "operationId": "AnalysisRelay_Relay",
        "parameters": [],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Relais des appels d'analyse documentaire de la borne vers le service HDS (passthrough chiffré, zero knowledge)",
        "tags": [
          "AnalysisRelay"
        ]
      }
    },
    "/api/examReferential/{userSessionKey}": {
      "get": {
        "operationId": "getExamReferential",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "description": "JWT token utilisateur — mettre '-' pour s'authentifier par X-Licence-Uuid",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "x-licence-uuid",
            "required": true,
            "in": "header",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Licence-Uuid",
            "in": "header",
            "description": "UUID de la licence — alternative au JWT (service d'analyse documentaire)",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "{ licenceUuid, flavor, examTypes, exams }"
          },
          "401": {
            "description": "Authentification manquante ou invalide"
          }
        },
        "summary": "Examens et types d'examen de la licence (référentiel éditeur), pour le service d'analyse documentaire",
        "tags": [
          "Integrations"
        ]
      }
    },
    "/api/kioskIdentification/status": {
      "get": {
        "operationId": "KioskIdentification_Status",
        "parameters": [],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "État du chemin rapide d'identification pour la borne appelante",
        "tags": [
          "kiosk-identification"
        ]
      }
    },
    "/api/kioskIdentification/invalidateCache": {
      "post": {
        "operationId": "KioskIdentification_InvalidateCache",
        "parameters": [],
        "responses": {
          "201": {
            "description": ""
          }
        },
        "summary": "Vide le cache des RDV du jour de la licence (outil de test)",
        "tags": [
          "kiosk-identification"
        ]
      }
    },
    "/api/kioskIdentification/reloadCache": {
      "post": {
        "operationId": "KioskIdentification_ReloadCache",
        "parameters": [],
        "responses": {
          "201": {
            "description": ""
          }
        },
        "summary": "Vide puis relit immédiatement les RDV du jour de la licence (outil de test)",
        "tags": [
          "kiosk-identification"
        ]
      }
    },
    "/api/kioskIdentification/identify": {
      "post": {
        "operationId": "KioskIdentification_Identify",
        "parameters": [],
        "responses": {
          "201": {
            "description": ""
          }
        },
        "summary": "Identifie un patient parmi les RDV du jour mis en cache (chemin rapide, repli borne si indisponible)",
        "tags": [
          "kiosk-identification"
        ]
      }
    },
    "/api/kioskReactorSetting/saveUpdateKioskReactorSetting": {
      "post": {
        "operationId": "saveUpdateKioskReactorSetting",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "userSessionKey": {
                    "type": "string",
                    "description": "JWT token"
                  },
                  "projectAuthorizationKey": {
                    "type": "string"
                  },
                  "brandId": {
                    "type": "string"
                  },
                  "brandAuthorizationKey": {
                    "type": "string"
                  },
                  "enableFeature": {
                    "type": "boolean"
                  },
                  "sesamReaderBaseHostUrl": {
                    "type": "string"
                  },
                  "useRetryOnApiFailure": {
                    "type": "boolean"
                  },
                  "retryOnApiFailureCount": {
                    "type": "integer"
                  },
                  "retryOnApiFailureStartHour": {
                    "type": "string"
                  },
                  "retryOnApiFailureEndHour": {
                    "type": "string"
                  },
                  "contractEncryptionPublicKey": {
                    "type": "string",
                    "nullable": true,
                    "description": "Clé publique RSA (PEM SPKI, >= 2048 bits) du chiffrement de bout en bout du contrat — vide/null = désactivé"
                  }
                },
                "required": [
                  "userSessionKey"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Configuration sauvegardÃ©e avec succÃ¨s",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "KioskReactorSetting": {
                      "type": "object"
                    },
                    "SessionKey": {
                      "type": "string"
                    },
                    "HasError": {
                      "type": "boolean",
                      "default": false
                    }
                  }
                }
              }
            }
          }
        },
        "summary": "Sauvegarder ou mettre Ã  jour la configuration KioskReactorSetting",
        "tags": [
          "KioskReactorSetting"
        ]
      }
    },
    "/api/kioskReactorSetting/getKioskReactorSetting/{userSessionKey}": {
      "get": {
        "operationId": "getKioskReactorSetting",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Configuration rÃ©cupÃ©rÃ©e avec succÃ¨s",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "KioskReactorSetting": {
                      "type": "object"
                    },
                    "SessionKey": {
                      "type": "string"
                    },
                    "HasError": {
                      "type": "boolean",
                      "default": false
                    }
                  }
                }
              }
            }
          }
        },
        "summary": "RÃ©cupÃ©rer la configuration KioskReactorSetting",
        "tags": [
          "KioskReactorSetting"
        ]
      }
    },
    "/api/kioskReactorSetting/kioskReactorSettingFeatures/getKioskReactorSettingFeatures/{userSessionKey}": {
      "get": {
        "operationId": "KioskReactorSetting_GetKioskReactorSettingFeatures",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Configuration récupérée"
          }
        },
        "summary": "Récupérer la configuration globale KioskReactorSettingFeatures",
        "tags": [
          "KioskReactorSetting"
        ]
      }
    },
    "/api/kioskReactorSetting/kioskReactorSettingFeatures/getKioskReactorSettingFeaturesByOfficePlaceId/{officePlaceId}/{userSessionKey}": {
      "get": {
        "operationId": "KioskReactorSetting_GetKioskReactorSettingFeaturesByOfficePlaceId",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "officePlaceId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Configuration par office place récupérée"
          }
        },
        "summary": "Récupérer la configuration KioskReactorSettingFeatures par office place",
        "tags": [
          "KioskReactorSetting"
        ]
      }
    },
    "/api/kioskReactorSetting/kioskReactorSettingFeatures/saveUpdateKioskReactorSettingFeatures": {
      "post": {
        "operationId": "KioskReactorSetting_SaveUpdateKioskReactorSettingFeatures",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Configuration sauvegardée"
          }
        },
        "summary": "Sauvegarder ou mettre à jour la config globale KioskReactorSettingFeatures",
        "tags": [
          "KioskReactorSetting"
        ]
      }
    },
    "/api/kioskReactorSetting/kioskReactorSettingFeatures/saveUpdateKioskReactorSettingFeaturesByOfficePlaceId": {
      "post": {
        "operationId": "KioskReactorSetting_SaveUpdateKioskReactorSettingFeaturesByOfficePlaceId",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Configuration par office place sauvegardée"
          }
        },
        "summary": "Sauvegarder ou mettre à jour la config par office place",
        "tags": [
          "KioskReactorSetting"
        ]
      }
    },
    "/api/kioskReactorSetting/kioskReactorSettingLanguages/getKioskReactorSettingLanguages/{userSessionKey}": {
      "get": {
        "operationId": "KioskReactorSetting_GetKioskReactorSettingLanguages",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Configuration récupérée"
          }
        },
        "summary": "Récupérer la configuration globale des langues de la borne",
        "tags": [
          "KioskReactorSetting"
        ]
      }
    },
    "/api/kioskReactorSetting/kioskReactorSettingLanguages/getKioskReactorSettingLanguagesByOfficePlaceId/{officePlaceId}/{userSessionKey}": {
      "get": {
        "operationId": "KioskReactorSetting_GetKioskReactorSettingLanguagesByOfficePlaceId",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "officePlaceId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Configuration par office place récupérée"
          }
        },
        "summary": "Récupérer la configuration des langues par office place",
        "tags": [
          "KioskReactorSetting"
        ]
      }
    },
    "/api/kioskReactorSetting/kioskReactorSettingLanguages/saveUpdateKioskReactorSettingLanguages": {
      "post": {
        "operationId": "KioskReactorSetting_SaveUpdateKioskReactorSettingLanguages",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Configuration sauvegardée"
          }
        },
        "summary": "Sauvegarder ou mettre à jour la config globale des langues",
        "tags": [
          "KioskReactorSetting"
        ]
      }
    },
    "/api/kioskReactorSetting/kioskReactorSettingLanguages/saveUpdateKioskReactorSettingLanguagesByOfficePlaceId": {
      "post": {
        "operationId": "KioskReactorSetting_SaveUpdateKioskReactorSettingLanguagesByOfficePlaceId",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Configuration par office place sauvegardée"
          }
        },
        "summary": "Sauvegarder ou mettre à jour la config des langues par office place",
        "tags": [
          "KioskReactorSetting"
        ]
      }
    },
    "/api/kioskReactorSetting/kioskReactorSettingMessages/getKioskReactorSettingMessages/{userSessionKey}": {
      "get": {
        "operationId": "KioskReactorSetting_GetKioskReactorSettingMessages",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Configuration rÃ©cupÃ©rÃ©e"
          }
        },
        "summary": "RÃ©cupÃ©rer la configuration KioskReactorSettingMessages",
        "tags": [
          "KioskReactorSetting"
        ]
      }
    },
    "/api/kioskReactorSetting/kioskReactorSettingMessages/getKioskReactorSettingMessagesPerPlace/{userSessionKey}": {
      "get": {
        "operationId": "KioskReactorSetting_GetKioskReactorSettingMessagesPerPlace",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Déclinaisons récupérées"
          }
        },
        "summary": "Lister les déclinaisons par lieu des messages (overrides du bloc global)",
        "tags": [
          "KioskReactorSetting"
        ]
      }
    },
    "/api/kioskReactorSetting/kioskReactorSettingMessages/saveUpdateKioskReactorSettingMessagesPerPlace": {
      "post": {
        "operationId": "KioskReactorSetting_SaveUpdateKioskReactorSettingMessagesPerPlace",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Déclinaison sauvegardée"
          }
        },
        "summary": "Sauvegarder la déclinaison par lieu des messages (upsert par officePlaceId)",
        "tags": [
          "KioskReactorSetting"
        ]
      }
    },
    "/api/kioskReactorSetting/kioskReactorSettingMessages/saveUpdateKioskReactorSettingMessages": {
      "post": {
        "operationId": "KioskReactorSetting_SaveUpdateKioskReactorSettingMessages",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Configuration sauvegardÃ©e"
          }
        },
        "summary": "Sauvegarder ou mettre Ã  jour KioskReactorSettingMessages",
        "tags": [
          "KioskReactorSetting"
        ]
      }
    },
    "/api/kioskReactorSetting/kioskReactorSettingPrinterCodes/getKioskReactorSettingPrinterCodes/{userSessionKey}": {
      "get": {
        "operationId": "KioskReactorSetting_GetKioskReactorSettingPrinterCodes",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Configuration rÃ©cupÃ©rÃ©e"
          }
        },
        "summary": "RÃ©cupÃ©rer la configuration KioskReactorSettingPrinterCodes",
        "tags": [
          "KioskReactorSetting"
        ]
      }
    },
    "/api/kioskReactorSetting/kioskReactorSettingPrinterCodes/saveUpdateKioskReactorSettingPrinterCodes": {
      "post": {
        "operationId": "KioskReactorSetting_SaveUpdateKioskReactorSettingPrinterCodes",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Configuration sauvegardÃ©e"
          }
        },
        "summary": "Sauvegarder ou mettre Ã  jour KioskReactorSettingPrinterCodes",
        "tags": [
          "KioskReactorSetting"
        ]
      }
    },
    "/api/kioskReactorSetting/kioskReactorSettingCheckinAppointmentDetail/getKioskReactorSettingCheckinAppointmentDetail/{userSessionKey}": {
      "get": {
        "operationId": "KioskReactorSetting_GetKioskReactorSettingCheckinAppointmentDetail",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Configuration récupérée"
          }
        },
        "summary": "Récupérer la configuration globale CheckinAppointmentDetail",
        "tags": [
          "KioskReactorSetting"
        ]
      }
    },
    "/api/kioskReactorSetting/kioskReactorSettingCheckinAppointmentDetail/getKioskReactorSettingCheckinAppointmentDetailByOfficePlaceId/{officePlaceId}/{userSessionKey}": {
      "get": {
        "operationId": "KioskReactorSetting_GetKioskReactorSettingCheckinAppointmentDetailByOfficePlaceId",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "officePlaceId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Configuration par office place récupérée"
          }
        },
        "summary": "Récupérer la configuration CheckinAppointmentDetail par office place",
        "tags": [
          "KioskReactorSetting"
        ]
      }
    },
    "/api/kioskReactorSetting/kioskReactorSettingCheckinAppointmentDetail/saveUpdateKioskReactorSettingCheckinAppointmentDetail": {
      "post": {
        "operationId": "KioskReactorSetting_SaveUpdateKioskReactorSettingCheckinAppointmentDetail",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Configuration sauvegardée"
          }
        },
        "summary": "Sauvegarder ou mettre à jour la config globale CheckinAppointmentDetail",
        "tags": [
          "KioskReactorSetting"
        ]
      }
    },
    "/api/kioskReactorSetting/kioskReactorSettingCheckinAppointmentDetail/saveUpdateKioskReactorSettingCheckinAppointmentDetailByOfficePlaceId": {
      "post": {
        "operationId": "KioskReactorSetting_SaveUpdateKioskReactorSettingCheckinAppointmentDetailByOfficePlaceId",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Configuration par office place sauvegardée"
          }
        },
        "summary": "Sauvegarder ou mettre à jour la config par office place",
        "tags": [
          "KioskReactorSetting"
        ]
      }
    },
    "/api/kioskReactorSetting/kioskReactorCheckInSystemNotifySetting/getKioskReactorCheckInSystemNotifySetting/{userSessionKey}": {
      "get": {
        "operationId": "KioskReactorSetting_GetKioskReactorCheckInSystemNotifySetting",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Configuration récupérée"
          }
        },
        "summary": "Récupérer la configuration globale KioskReactorCheckInSystemNotifySetting",
        "tags": [
          "KioskReactorSetting"
        ]
      }
    },
    "/api/kioskReactorSetting/kioskReactorCheckInSystemNotifySetting/getKioskReactorCheckInSystemNotifySettingByOfficePlaceId/{officePlaceId}/{userSessionKey}": {
      "get": {
        "operationId": "KioskReactorSetting_GetKioskReactorCheckInSystemNotifySettingByOfficePlaceId",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "officePlaceId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Configuration par office place récupérée"
          }
        },
        "summary": "Récupérer la configuration KioskReactorCheckInSystemNotifySetting par office place",
        "tags": [
          "KioskReactorSetting"
        ]
      }
    },
    "/api/kioskReactorSetting/kioskReactorCheckInSystemNotifySetting/saveUpdateKioskReactorCheckInSystemNotifySetting": {
      "post": {
        "operationId": "KioskReactorSetting_SaveUpdateKioskReactorCheckInSystemNotifySetting",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Configuration sauvegardée"
          }
        },
        "summary": "Sauvegarder ou mettre à jour la config globale KioskReactorCheckInSystemNotifySetting",
        "tags": [
          "KioskReactorSetting"
        ]
      }
    },
    "/api/kioskReactorSetting/kioskReactorCheckInSystemNotifySetting/saveUpdateKioskReactorCheckInSystemNotifySettingByOfficePlaceId": {
      "post": {
        "operationId": "KioskReactorSetting_SaveUpdateKioskReactorCheckInSystemNotifySettingByOfficePlaceId",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Configuration par office place sauvegardée"
          }
        },
        "summary": "Sauvegarder ou mettre à jour la config par office place",
        "tags": [
          "KioskReactorSetting"
        ]
      }
    },
    "/api/kioskReactorSetting/kioskReactorDirectAdmissionSetting/getKioskReactorDirectAdmissionSetting/{userSessionKey}": {
      "get": {
        "operationId": "KioskReactorSetting_GetKioskReactorDirectAdmissionSetting",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Configuration rÃ©cupÃ©rÃ©e"
          }
        },
        "summary": "RÃ©cupÃ©rer la configuration KioskReactorDirectAdmissionSetting",
        "tags": [
          "KioskReactorSetting"
        ]
      }
    },
    "/api/kioskReactorSetting/kioskReactorDirectAdmissionSetting/saveUpdateKioskReactorDirectAdmissionSetting": {
      "post": {
        "operationId": "KioskReactorSetting_SaveUpdateKioskReactorDirectAdmissionSetting",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Configuration sauvegardÃ©e"
          }
        },
        "summary": "Sauvegarder ou mettre Ã  jour KioskReactorDirectAdmissionSetting",
        "tags": [
          "KioskReactorSetting"
        ]
      }
    },
    "/api/kioskReactorSetting/kioskReactorSettingDisplay/getKioskReactorSettingDisplay/{userSessionKey}": {
      "get": {
        "operationId": "KioskReactorSetting_GetKioskReactorDisplaySetting",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Configuration rÃ©cupÃ©rÃ©e"
          }
        },
        "summary": "RÃ©cupÃ©rer la configuration KioskReactorSettingDisplay",
        "tags": [
          "KioskReactorSetting"
        ]
      }
    },
    "/api/kioskReactorSetting/kioskReactorSettingDisplay/saveUpdateKioskReactorSettingDisplay": {
      "post": {
        "operationId": "KioskReactorSetting_SaveUpdateKioskReactorDisplaySetting",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Configuration sauvegardÃ©e"
          }
        },
        "summary": "Sauvegarder ou mettre Ã  jour KioskReactorSettingDisplay",
        "tags": [
          "KioskReactorSetting"
        ]
      }
    },
    "/api/kioskReactorSetting/getKioskReactorSettingPatientLateAnomalies": {
      "post": {
        "operationId": "KioskReactorSetting_GetKioskReactorSettingPatientLateAnomalies",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Liste des anomalies récupérée"
          }
        },
        "summary": "Récupérer toutes les anomalies patient late",
        "tags": [
          "KioskReactorSetting"
        ]
      }
    },
    "/api/kioskReactorSetting/saveUpdateKioskReactorSettingPatientLateAnomaly": {
      "post": {
        "operationId": "KioskReactorSetting_SaveUpdateKioskReactorSettingPatientLateAnomaly",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Anomalie sauvegardée"
          }
        },
        "summary": "Sauvegarder ou mettre à jour une anomalie patient late",
        "tags": [
          "KioskReactorSetting"
        ]
      }
    },
    "/api/kioskReactorSetting/deleteKioskReactorSettingPatientLateAnomaly": {
      "post": {
        "operationId": "KioskReactorSetting_DeleteKioskReactorSettingPatientLateAnomaly",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Anomalie supprimée"
          }
        },
        "summary": "Supprimer une anomalie patient late",
        "tags": [
          "KioskReactorSetting"
        ]
      }
    },
    "/api/kioskReactorSetting/getKioskReactorSettingPatientAgeAnomalies": {
      "post": {
        "operationId": "KioskReactorSetting_GetKioskReactorSettingPatientAgeAnomalies",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Liste des anomalies récupérée"
          }
        },
        "summary": "Récupérer toutes les anomalies patient age",
        "tags": [
          "KioskReactorSetting"
        ]
      }
    },
    "/api/kioskReactorSetting/saveUpdateKioskReactorSettingPatientAgeAnomaly": {
      "post": {
        "operationId": "KioskReactorSetting_SaveUpdateKioskReactorSettingPatientAgeAnomaly",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Anomalie sauvegardée"
          }
        },
        "summary": "Sauvegarder ou mettre à jour une anomalie patient age",
        "tags": [
          "KioskReactorSetting"
        ]
      }
    },
    "/api/kioskReactorSetting/deleteKioskReactorSettingPatientAgeAnomaly": {
      "post": {
        "operationId": "KioskReactorSetting_DeleteKioskReactorSettingPatientAgeAnomaly",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Anomalie supprimée"
          }
        },
        "summary": "Supprimer une anomalie patient age",
        "tags": [
          "KioskReactorSetting"
        ]
      }
    },
    "/api/kioskReactorSettingPatientInfoBookingOptions/getKioskReactorSettingPatientInfoBookingOptions/{userSessionKey}": {
      "get": {
        "operationId": "KioskReactorSettingPatientInfoBookingOptions_Get",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Configuration récupérée"
          }
        },
        "summary": "Récupérer la configuration PatientInfoBookingOptions",
        "tags": [
          "KioskReactorSettingPatientInfoBookingOptions"
        ]
      }
    },
    "/api/kioskReactorSettingPatientInfoBookingOptions/saveUpdateKioskReactorSettingPatientInfoBookingOptions": {
      "post": {
        "operationId": "KioskReactorSettingPatientInfoBookingOptions_SaveUpdate",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Configuration sauvegardée"
          }
        },
        "summary": "Sauvegarder ou mettre à jour PatientInfoBookingOptions",
        "tags": [
          "KioskReactorSettingPatientInfoBookingOptions"
        ]
      }
    },
    "/api/kioskReactorSetting/kioskReactorSettingRequiredDocumentSetting/getKioskReactorSettingRequiredDocumentSettings/{userSessionKey}": {
      "get": {
        "operationId": "KioskReactorSetting_GetKioskReactorSettingRequiredDocumentSettings",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Liste des paramètres de documents requis"
          }
        },
        "summary": "Récupérer les paramètres des documents requis (tous les types, avec overrides)",
        "tags": [
          "KioskReactorSetting"
        ]
      }
    },
    "/api/kioskReactorSetting/kioskReactorSettingRequiredDocumentSetting/getKioskReactorSettingRequiredDocumentSettingsByOfficePlaceId/{officePlaceId}/{userSessionKey}": {
      "get": {
        "operationId": "KioskReactorSetting_GetKioskReactorSettingRequiredDocumentSettingsByOfficePlaceId",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "officePlaceId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Liste des paramètres de documents requis du lieu"
          }
        },
        "summary": "Récupérer les paramètres des documents requis pour un lieu",
        "tags": [
          "KioskReactorSetting"
        ]
      }
    },
    "/api/kioskReactorSetting/kioskReactorSettingRequiredDocumentSetting/saveUpdateKioskReactorSettingRequiredDocumentSetting": {
      "post": {
        "operationId": "KioskReactorSetting_SaveUpdateKioskReactorSettingRequiredDocumentSetting",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Paramètre sauvegardé"
          }
        },
        "summary": "Sauvegarder ou réinitialiser l'override d'un document requis",
        "tags": [
          "KioskReactorSetting"
        ]
      }
    },
    "/api/kioskReactorSetting/kioskReactorSettingRequiredDocumentSetting/saveUpdateKioskReactorSettingRequiredDocumentSettingByOfficePlaceId": {
      "post": {
        "operationId": "KioskReactorSetting_SaveUpdateKioskReactorSettingRequiredDocumentSettingByOfficePlaceId",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Paramètre du lieu sauvegardé"
          }
        },
        "summary": "Sauvegarder ou réinitialiser l'override d'un document requis pour un lieu",
        "tags": [
          "KioskReactorSetting"
        ]
      }
    },
    "/api/kioskReactorSetting/kioskReactorSettingRequiredDocumentSetting/saveUpdateKioskReactorSettingRequiredDocumentOverrideGlobalConfig": {
      "post": {
        "operationId": "KioskReactorSetting_SaveUpdateKioskReactorSettingRequiredDocumentOverrideGlobalConfig",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Flag sauvegardé"
          }
        },
        "summary": "Activer/désactiver le remplacement de la config globale pour un lieu",
        "tags": [
          "KioskReactorSetting"
        ]
      }
    },
    "/api/kioskReactorSetting/kioskReactorSettingRequestMessage/getKioskReactorSettingRequestMessages/{userSessionKey}": {
      "get": {
        "operationId": "KioskReactorSetting_GetKioskReactorSettingRequestMessages",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "{ KioskReactorSettingRequestMessages: [...] }"
          }
        },
        "summary": "Lister les messages de demande guichet (une entrée par lieu)",
        "tags": [
          "KioskReactorSetting"
        ]
      }
    },
    "/api/kioskReactorSetting/kioskReactorSettingRequestMessage/saveUpdateKioskReactorSettingRequestMessage": {
      "post": {
        "operationId": "KioskReactorSetting_SaveUpdateKioskReactorSettingRequestMessage",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Message sauvegardé"
          }
        },
        "summary": "Sauvegarder le message de demande guichet d'un lieu (upsert par officePlaceId)",
        "tags": [
          "KioskReactorSetting"
        ]
      }
    },
    "/api/kioskReactorSetting/kioskReactorSettingRequestMessage/getKioskReactorSettingWrongPlaceMessageDetails/{userSessionKey}": {
      "get": {
        "operationId": "KioskReactorSetting_GetKioskReactorSettingWrongPlaceMessageDetails",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "{ KioskReactorSettingWrongPlaceMessageDetails: [...] }"
          }
        },
        "summary": "Lister les messages « mauvais lieu » (une entrée par lieu)",
        "tags": [
          "KioskReactorSetting"
        ]
      }
    },
    "/api/kioskReactorSetting/kioskReactorSettingRequestMessage/saveUpdateKioskReactorSettingWrongPlaceMessageDetail": {
      "post": {
        "operationId": "KioskReactorSetting_SaveUpdateKioskReactorSettingWrongPlaceMessageDetail",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Message sauvegardé"
          }
        },
        "summary": "Sauvegarder le message « mauvais lieu » d'un lieu (upsert par officePlaceId)",
        "tags": [
          "KioskReactorSetting"
        ]
      }
    },
    "/api/kioskReactorSetting/configImport/importLegacyConfig": {
      "post": {
        "operationId": "KioskReactorSetting_ImportLegacyConfig",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Rapport d'import par groupe de configuration"
          }
        },
        "summary": "Importer l'ancienne configuration kiosk depuis un serveur EasyDoct (legacy)",
        "tags": [
          "KioskReactorSetting"
        ]
      }
    },
    "/licences/{licenceId}/config-history": {
      "get": {
        "operationId": "listConfigHistory",
        "parameters": [
          {
            "name": "licenceId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Entrées d'historique (snapshots before/after inclus)"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Les 20 derniers changements de configuration de la licence (tous blocs confondus, plus récents d’abord)",
        "tags": [
          "ConfigHistory"
        ]
      }
    },
    "/licences/{licenceId}/config-history/{changeId}/revert": {
      "post": {
        "operationId": "revertConfigChange",
        "parameters": [
          {
            "name": "licenceId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "changeId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Changement annulé (entrée revert tracée)"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Annule un changement de configuration : réapplique le snapshot antérieur (bloc singleton) ou l'opération inverse (critère d'accueil)",
        "tags": [
          "ConfigHistory"
        ]
      }
    },
    "/api/kioskCheckInCriteria/getKioskCheckInCriterias/{userSessionKey}": {
      "get": {
        "operationId": "KioskCheckInCriteria_GetKioskCheckInCriterias",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "description": "JWT token utilisateur",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Liste des critères"
          },
          "401": {
            "description": "Token invalide"
          }
        },
        "summary": "Récupérer tous les critères de check-in kiosk",
        "tags": [
          "KioskCheckInCriteria"
        ]
      }
    },
    "/api/kioskCheckInCriteria/saveKioskCheckInCriteria": {
      "post": {
        "operationId": "KioskCheckInCriteria_SaveKioskCheckInCriteria",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "userSessionKey": {
                    "type": "string"
                  },
                  "question": {
                    "type": "string"
                  },
                  "imageUrl": {
                    "type": "string"
                  },
                  "enabled": {
                    "type": "boolean"
                  },
                  "blockingOnYes": {
                    "type": "boolean"
                  },
                  "examTypeIds": {
                    "type": "string"
                  },
                  "examIds": {
                    "type": "string"
                  },
                  "deviceIds": {
                    "type": "string"
                  },
                  "commonKioskAnomalyIds": {
                    "type": "string"
                  },
                  "matchAnomalyConditionsType": {
                    "type": "number"
                  },
                  "kioskAnomalyId": {
                    "type": "number"
                  }
                },
                "required": [
                  "userSessionKey",
                  "question"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Critère créé avec succès"
          },
          "401": {
            "description": "Token invalide"
          }
        },
        "summary": "Créer un nouveau critère de check-in kiosk",
        "tags": [
          "KioskCheckInCriteria"
        ]
      }
    },
    "/api/kioskCheckInCriteria/updateKioskCheckInCriteria": {
      "post": {
        "operationId": "KioskCheckInCriteria_UpdateKioskCheckInCriteria",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "userSessionKey": {
                    "type": "string"
                  },
                  "kioskCheckInCriteriaId": {
                    "type": "number"
                  },
                  "question": {
                    "type": "string"
                  },
                  "imageUrl": {
                    "type": "string"
                  },
                  "enabled": {
                    "type": "boolean"
                  },
                  "blockingOnYes": {
                    "type": "boolean"
                  },
                  "examTypeIds": {
                    "type": "string"
                  },
                  "examIds": {
                    "type": "string"
                  },
                  "deviceIds": {
                    "type": "string"
                  },
                  "commonKioskAnomalyIds": {
                    "type": "string"
                  },
                  "kioskAnomalyMatchCondition": {
                    "type": "number"
                  },
                  "kioskAnomalyId": {
                    "type": "number"
                  }
                },
                "required": [
                  "userSessionKey",
                  "kioskCheckInCriteriaId"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Critère mis à jour avec succès"
          },
          "401": {
            "description": "Token invalide"
          }
        },
        "summary": "Mettre à jour un critère de check-in kiosk",
        "tags": [
          "KioskCheckInCriteria"
        ]
      }
    },
    "/api/kioskCheckInCriteria/moveKioskCheckInCriteria/{userSessionKey}/{kioskCheckInCriteriaId}/{moveUp}": {
      "post": {
        "operationId": "KioskCheckInCriteria_MoveKioskCheckInCriteria",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "kioskCheckInCriteriaId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "moveUp",
            "required": true,
            "in": "path",
            "description": "true = monter, false = descendre",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Critère déplacé, liste réordonnée renvoyée"
          },
          "401": {
            "description": "Token invalide"
          }
        },
        "summary": "Déplacer un critère dans l'ordre d'affichage des questions",
        "tags": [
          "KioskCheckInCriteria"
        ]
      }
    },
    "/api/kioskCheckInCriteria/deleteKioskCheckInCriteria/{userSessionKey}/{kioskCheckInCriteriaId}": {
      "post": {
        "operationId": "KioskCheckInCriteria_DeleteKioskCheckInCriteria",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "kioskCheckInCriteriaId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Critère supprimé avec succès"
          },
          "401": {
            "description": "Token invalide"
          }
        },
        "summary": "Supprimer un critère de check-in kiosk",
        "tags": [
          "KioskCheckInCriteria"
        ]
      }
    },
    "/api/kioskAnomaly/saveUpdateKioskAnomaly": {
      "post": {
        "operationId": "KioskAnomalyController_saveUpdateKioskAnomaly",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "number",
                    "example": 1,
                    "description": "ID de l'anomalie (omis pour création, requis pour mise à jour)"
                  },
                  "name": {
                    "type": "string",
                    "example": "Anomalie test"
                  },
                  "description": {
                    "type": "string",
                    "example": "Description de l'anomalie"
                  },
                  "color": {
                    "type": "string",
                    "example": "#FF0000"
                  },
                  "code": {
                    "type": "string",
                    "example": "ANO001"
                  },
                  "keepForAppointment": {
                    "type": "boolean",
                    "example": false
                  },
                  "userSessionKey": {
                    "type": "string",
                    "description": "JWT token utilisateur (requis) - l'anomalie sera créée pour la licence de cet utilisateur"
                  }
                },
                "required": [
                  "name",
                  "userSessionKey"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Anomalie créée/mise à jour avec succès"
          },
          "401": {
            "description": "Token invalide"
          }
        },
        "summary": "Créer ou mettre à jour une anomalie kiosk",
        "tags": [
          "KioskAnomaly"
        ]
      }
    },
    "/api/kioskAnomaly/getKioskAnomalies/{userSessionKey}": {
      "get": {
        "operationId": "KioskAnomalyController_getKioskAnomalies",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "description": "JWT token utilisateur",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Liste des anomalies"
          },
          "401": {
            "description": "Token invalide"
          }
        },
        "summary": "Récupérer toutes les anomalies kiosk",
        "tags": [
          "KioskAnomaly"
        ]
      }
    },
    "/api/kioskAnomaly/deleteKioskAnomaly/{kioskAnomalyId}/{userSessionKey}": {
      "post": {
        "operationId": "KioskAnomalyController_deleteKioskAnomaly",
        "parameters": [
          {
            "name": "kioskAnomalyId",
            "required": true,
            "in": "path",
            "description": "ID de l'anomalie à supprimer",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "description": "JWT token utilisateur",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Anomalie supprimée avec succès"
          },
          "401": {
            "description": "Token invalide"
          },
          "404": {
            "description": "Anomalie introuvable"
          }
        },
        "summary": "Supprimer une anomalie kiosk",
        "tags": [
          "KioskAnomaly"
        ]
      }
    },
    "/global-anomalies": {
      "get": {
        "operationId": "listGlobalAnomalies",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Liste des anomalies globales (OfficeId 0)"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Lister les anomalies globales (superadmin)",
        "tags": [
          "KioskAnomaly"
        ]
      },
      "post": {
        "operationId": "saveGlobalAnomaly",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "Id": {
                    "type": "number",
                    "description": "Omis pour création"
                  },
                  "Name": {
                    "type": "string",
                    "example": "Accueil RIS non confirmé"
                  },
                  "Description": {
                    "type": "string"
                  },
                  "Color": {
                    "type": "string",
                    "example": "#e07a5f",
                    "nullable": true
                  },
                  "Code": {
                    "type": "string",
                    "example": "ER"
                  },
                  "KeepForAppointment": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "Name",
                  "Code"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "L'anomalie globale enregistrée"
          },
          "400": {
            "description": "Name/Code manquant ou code déjà utilisé"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Créer ou mettre à jour une anomalie globale (superadmin)",
        "tags": [
          "KioskAnomaly"
        ]
      }
    },
    "/global-anomalies/{id}": {
      "delete": {
        "operationId": "deleteGlobalAnomaly",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Supprimée"
          },
          "404": {
            "description": "Anomalie globale introuvable"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Supprimer une anomalie globale (superadmin)",
        "tags": [
          "KioskAnomaly"
        ]
      }
    },
    "/api/kioskInformation/saveKioskInformation": {
      "post": {
        "operationId": "KioskInformation_SaveKioskInformation",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "userSessionKey": {
                    "type": "string",
                    "description": "JWT token utilisateur"
                  },
                  "name": {
                    "type": "string"
                  },
                  "information": {
                    "type": "string"
                  },
                  "imageUrl": {
                    "type": "string"
                  },
                  "enabled": {
                    "type": "boolean"
                  },
                  "examTypeIds": {
                    "type": "string"
                  },
                  "kioskInformationDisplayStep": {
                    "type": "number"
                  }
                },
                "required": [
                  "userSessionKey"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Information créée avec succès"
          },
          "401": {
            "description": "Token invalide"
          }
        },
        "summary": "Créer une nouvelle information kiosk",
        "tags": [
          "KioskInformation"
        ]
      }
    },
    "/api/kioskInformation/updateKioskInformation": {
      "post": {
        "operationId": "KioskInformation_UpdateKioskInformation",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "userSessionKey": {
                    "type": "string",
                    "description": "JWT token utilisateur"
                  },
                  "id": {
                    "type": "number",
                    "description": "ID de l'information à modifier"
                  },
                  "name": {
                    "type": "string"
                  },
                  "information": {
                    "type": "string"
                  },
                  "imageUrl": {
                    "type": "string"
                  },
                  "enabled": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "userSessionKey",
                  "id"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Information mise à jour avec succès"
          },
          "401": {
            "description": "Token invalide"
          },
          "404": {
            "description": "Information introuvable"
          }
        },
        "summary": "Mettre à jour une information kiosk existante",
        "tags": [
          "KioskInformation"
        ]
      }
    },
    "/api/kioskInformation/updateKioskInformationForReorder": {
      "post": {
        "operationId": "KioskInformation_UpdateKioskInformationForReorder",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "userSessionKey": {
                    "type": "string",
                    "description": "JWT token utilisateur"
                  },
                  "kioskInformationId": {
                    "type": "number",
                    "description": "ID de l'information à réordonner"
                  },
                  "targetKioskInformationGroupId": {
                    "type": "number",
                    "description": "ID du groupe cible (null = sans groupe)",
                    "nullable": true
                  },
                  "targetIndex": {
                    "type": "number",
                    "description": "Index cible dans la liste"
                  }
                },
                "required": [
                  "userSessionKey",
                  "kioskInformationId"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Ordre mis à jour avec succès"
          },
          "401": {
            "description": "Token invalide"
          },
          "404": {
            "description": "Information introuvable"
          }
        },
        "summary": "Mettre à jour l'ordre d'une information kiosk",
        "tags": [
          "KioskInformation"
        ]
      }
    },
    "/api/kioskInformation/getKioskInformations/{userSessionKey}": {
      "get": {
        "operationId": "KioskInformation_GetKioskInformations",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "description": "JWT token utilisateur",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Liste des informations"
          },
          "401": {
            "description": "Token invalide"
          }
        },
        "summary": "Récupérer toutes les informations kiosk",
        "tags": [
          "KioskInformation"
        ]
      }
    },
    "/api/kioskInformation/deleteKioskInformation/{userSessionKey}/{kioskInformationId}": {
      "post": {
        "operationId": "KioskInformation_DeleteKioskInformation",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "description": "JWT token utilisateur",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "kioskInformationId",
            "required": true,
            "in": "path",
            "description": "ID de l'information à supprimer",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Information supprimée avec succès"
          },
          "401": {
            "description": "Token invalide"
          },
          "404": {
            "description": "Information introuvable"
          }
        },
        "summary": "Supprimer une information kiosk",
        "tags": [
          "KioskInformation"
        ]
      }
    },
    "/api/kioskInformationGroup/saveUpdateKioskInformationGroup": {
      "post": {
        "operationId": "KioskInformationGroup_SaveUpdateKioskInformationGroup",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "userSessionKey": {
                    "type": "string",
                    "description": "JWT token utilisateur"
                  },
                  "Id": {
                    "type": "number",
                    "description": "ID du groupe (0 pour création)"
                  },
                  "name": {
                    "type": "string",
                    "description": "Nom du groupe (max 100 caractères)"
                  }
                },
                "required": [
                  "userSessionKey"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Groupe créé/mis à jour avec succès"
          },
          "401": {
            "description": "Token invalide"
          }
        },
        "summary": "Créer ou mettre à jour un groupe d'informations kiosk",
        "tags": [
          "KioskInformationGroup"
        ]
      }
    },
    "/api/kioskInformationGroup/getKioskInformationGroups/{userSessionKey}": {
      "get": {
        "operationId": "KioskInformationGroup_GetKioskInformationGroups",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "description": "JWT token utilisateur",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Liste des groupes d'informations"
          },
          "401": {
            "description": "Token invalide"
          }
        },
        "summary": "Récupérer tous les groupes d'informations kiosk",
        "tags": [
          "KioskInformationGroup"
        ]
      }
    },
    "/api/kioskInformationGroup/deleteKioskInformationGroup/{kioskInformationGroupId}/{userSessionKey}": {
      "post": {
        "operationId": "KioskInformationGroup_DeleteKioskInformationGroup",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "description": "JWT token utilisateur",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "kioskInformationGroupId",
            "required": true,
            "in": "path",
            "description": "ID du groupe à supprimer",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Groupe supprimé avec succès"
          },
          "401": {
            "description": "Token invalide"
          }
        },
        "summary": "Supprimer un groupe d'informations kiosk",
        "tags": [
          "KioskInformationGroup"
        ]
      }
    },
    "/api/kioskInformationGroup/moveKioskInformationGroup/{kioskInformationGroupId}/{moveLeft}": {
      "post": {
        "operationId": "KioskInformationGroup_MoveKioskInformationGroup",
        "parameters": [
          {
            "name": "kioskInformationGroupId",
            "required": true,
            "in": "path",
            "description": "ID du groupe à déplacer",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "moveLeft",
            "required": true,
            "in": "path",
            "description": "true pour déplacer vers la gauche, false vers la droite",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "userSessionKey",
            "required": true,
            "in": "query",
            "description": "JWT token utilisateur",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Groupe déplacé avec succès"
          },
          "401": {
            "description": "Token invalide"
          }
        },
        "summary": "Déplacer un groupe d'informations kiosk",
        "tags": [
          "KioskInformationGroup"
        ]
      }
    },
    "/api/kioskDeskRequestReason/getKioskDeskRequestReasons/{userSessionKey}": {
      "get": {
        "operationId": "KioskDeskRequestReasonController_getKioskDeskRequestReasons",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Liste des motifs"
          }
        },
        "summary": "Récupérer les motifs de demande guichet",
        "tags": [
          "KioskDeskRequestReason"
        ]
      }
    },
    "/api/kioskDeskRequestReason/saveKioskDeskRequestReason": {
      "post": {
        "operationId": "KioskDeskRequestReasonController_saveKioskDeskRequestReason",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Motif créé"
          }
        },
        "summary": "Créer un motif de demande guichet",
        "tags": [
          "KioskDeskRequestReason"
        ]
      }
    },
    "/api/kioskDeskRequestReason/updateKioskDeskRequestReason": {
      "post": {
        "operationId": "KioskDeskRequestReasonController_updateKioskDeskRequestReason",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Motif mis à jour"
          }
        },
        "summary": "Mettre à jour un motif de demande guichet",
        "tags": [
          "KioskDeskRequestReason"
        ]
      }
    },
    "/api/kioskDeskRequestReason/moveKioskDeskRequestReason/{kioskDeskRequestReasonId}/{moveLeft}": {
      "post": {
        "operationId": "KioskDeskRequestReasonController_moveKioskDeskRequestReason",
        "parameters": [
          {
            "name": "kioskDeskRequestReasonId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "moveLeft",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Motif déplacé"
          }
        },
        "summary": "Déplacer un motif de demande guichet dans l'ordre d'affichage",
        "tags": [
          "KioskDeskRequestReason"
        ]
      }
    },
    "/api/kioskDeskRequestReason/deleteKioskDeskRequestReason": {
      "post": {
        "operationId": "KioskDeskRequestReasonController_deleteKioskDeskRequestReason",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Motif supprimé"
          }
        },
        "summary": "Supprimer un motif de demande guichet",
        "tags": [
          "KioskDeskRequestReason"
        ]
      }
    },
    "/api/examType/getExamTypes/{userSessionKey}": {
      "get": {
        "operationId": "ExamTypeController_getExamTypes",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "description": "JWT token utilisateur",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Liste des types d'examens"
          }
        },
        "summary": "Récupérer les types d'examens depuis EasyDoct (préfixes de tickets locaux fusionnés)",
        "tags": [
          "ExamTypes"
        ]
      }
    },
    "/api/examType/updateKioskTicketPrefix": {
      "post": {
        "operationId": "ExamTypeController_updateKioskTicketPrefix",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "userSessionKey": {
                    "type": "string"
                  },
                  "examTypeId": {
                    "type": "number"
                  },
                  "prefix": {
                    "type": "string"
                  }
                },
                "required": [
                  "userSessionKey",
                  "examTypeId"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Préfixe mis à jour"
          }
        },
        "summary": "Mettre à jour le préfixe de ticket d'un type d'examen (stockage local)",
        "tags": [
          "ExamTypes"
        ]
      }
    },
    "/api/kioskBoard/getKioskBoards/{userSessionKey}": {
      "get": {
        "operationId": "KioskBoardController_getKioskBoards",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Liste des tableaux d'affichage"
          }
        },
        "summary": "Récupérer les tableaux d'affichage",
        "tags": [
          "KioskBoard"
        ]
      }
    },
    "/api/kioskBoard/getKioskBoardsInAllOffices/{userSessionKey}": {
      "get": {
        "operationId": "KioskBoardController_getKioskBoardsInAllOffices",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Liste des tableaux d'affichage"
          }
        },
        "summary": "Récupérer les tableaux d'affichage de tous les cabinets",
        "tags": [
          "KioskBoard"
        ]
      }
    },
    "/api/kioskBoard/saveKioskBoard": {
      "post": {
        "operationId": "KioskBoardController_saveKioskBoard",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Tableau d'affichage créé"
          }
        },
        "summary": "Créer un tableau d'affichage",
        "tags": [
          "KioskBoard"
        ]
      }
    },
    "/api/kioskBoard/updateKioskBoard": {
      "post": {
        "operationId": "KioskBoardController_updateKioskBoard",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Tableau d'affichage mis à jour"
          }
        },
        "summary": "Mettre à jour un tableau d'affichage",
        "tags": [
          "KioskBoard"
        ]
      }
    },
    "/api/kioskBoard/deleteKioskBoard": {
      "post": {
        "operationId": "KioskBoardController_deleteKioskBoard",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Tableau d'affichage supprimé"
          }
        },
        "summary": "Supprimer un tableau d'affichage",
        "tags": [
          "KioskBoard"
        ]
      }
    },
    "/api/kioskBoard/cleanKioskBoardEvents": {
      "post": {
        "operationId": "KioskBoardController_cleanKioskBoardEvents",
        "parameters": [],
        "responses": {
          "200": {
            "description": "{ Deleted, Detached }"
          }
        },
        "summary": "Nettoyer un tableau d'affichage : supprime ses events d'affichage KioskReactor (iso « Clean board » de totemSystemWeb)",
        "tags": [
          "KioskBoard"
        ]
      }
    },
    "/api/kioskBoard/getCallToKioskDeskKioskBoards/{userSessionKey}": {
      "get": {
        "operationId": "KioskBoardController_getCallToKioskDeskKioskBoards",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Liste des tableaux d'appel"
          }
        },
        "summary": "Récupérer les tableaux d'appel au bureau",
        "tags": [
          "KioskBoard"
        ]
      }
    },
    "/api/kioskBoard/getCallToKioskDeskKioskBoardsInAllOffices/{userSessionKey}": {
      "get": {
        "operationId": "KioskBoardController_getCallToKioskDeskKioskBoardsInAllOffices",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Liste des tableaux d'appel"
          }
        },
        "summary": "Récupérer les tableaux d'appel de tous les cabinets",
        "tags": [
          "KioskBoard"
        ]
      }
    },
    "/api/kioskBoard/getCallToKioskDeskKioskBoardCurrentUser/{userSessionKey}": {
      "get": {
        "operationId": "KioskBoardController_getCallToKioskDeskKioskBoardCurrentUser",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Tableau d'appel de l'utilisateur"
          }
        },
        "summary": "Récupérer le tableau d'appel de l'utilisateur courant",
        "tags": [
          "KioskBoard"
        ]
      }
    },
    "/api/kioskBoard/createCallToKioskDeskKioskBoard": {
      "post": {
        "operationId": "KioskBoardController_createCallToKioskDeskKioskBoard",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Tableau d'appel créé"
          }
        },
        "summary": "Créer un tableau d'appel au bureau",
        "tags": [
          "KioskBoard"
        ]
      }
    },
    "/api/kioskBoard/updateCallToKioskDeskKioskBoard": {
      "post": {
        "operationId": "KioskBoardController_updateCallToKioskDeskKioskBoard",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Tableau d'appel mis à jour"
          }
        },
        "summary": "Mettre à jour un tableau d'appel au bureau",
        "tags": [
          "KioskBoard"
        ]
      }
    },
    "/api/kioskBoard/deleteCallToKioskDeskKioskBoard": {
      "post": {
        "operationId": "KioskBoardController_deleteCallToKioskDeskKioskBoard",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Tableau d'appel supprimé"
          }
        },
        "summary": "Supprimer un tableau d'appel au bureau",
        "tags": [
          "KioskBoard"
        ]
      }
    },
    "/kiosk-reactor/brands": {
      "get": {
        "operationId": "listKioskReactorBrands",
        "parameters": [],
        "responses": {
          "200": {
            "description": "[{ brandId, brandName, contactEmail }]"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Lister les companies (brands) KioskReactor par nom — sans les clés",
        "tags": [
          "KioskReactor"
        ]
      },
      "post": {
        "operationId": "createKioskReactorBrand",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "brandName"
                ],
                "properties": {
                  "brandName": {
                    "type": "string",
                    "description": "Nom de la company"
                  },
                  "contactEmail": {
                    "type": "string",
                    "nullable": true
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Credentials de la company créée"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Créer une NOUVELLE company KioskReactor (brand + projet « ApiBorne » par défaut, clés UUID) — n'affecte aucun document existant",
        "tags": [
          "KioskReactor"
        ]
      }
    },
    "/kiosk-reactor/brands/{brandId}": {
      "get": {
        "operationId": "getKioskReactorBrand",
        "parameters": [
          {
            "name": "brandId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "{ brandId, brandName, brandAuthorizationKey, projects: [{ id, name, authKey }] }"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Credentials d'une company (clé de marque + projets)",
        "tags": [
          "KioskReactor"
        ]
      }
    },
    "/kiosk-reactor/brands/{brandId}/devices": {
      "post": {
        "operationId": "createKioskReactorDevice",
        "parameters": [
          {
            "name": "brandId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "name"
                ],
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "Nom de la borne (unique dans la company)"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "{ deviceId, name, brandId, projectId, projectName, projectCreated }"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Créer une NOUVELLE borne (device) dans la company — id généré, défauts usbDevice/lite + imprimante EPSON, nom unique dans la company ; le projet « ApiBorne » est créé au besoin",
        "tags": [
          "KioskReactor"
        ]
      }
    },
    "/kiosk-reactor/brands/{brandId}/boards": {
      "post": {
        "operationId": "createKioskReactorBoard",
        "parameters": [
          {
            "name": "brandId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "name",
                  "kind"
                ],
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "Nom du tableau (unique dans la company)"
                  },
                  "kind": {
                    "type": "string",
                    "enum": [
                      "kioskDesk",
                      "callToDesk"
                    ],
                    "description": "kioskDesk = tableau d'affichage salle d'attente ; callToDesk = tableau d'appel guichet"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "{ boardId, name, brandId, kind }"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Créer un NOUVEAU tableau (board) dans la company en clonant le modèle du type demandé — configuration complète reprise, nom unique dans la company",
        "tags": [
          "KioskReactor"
        ]
      }
    },
    "/kiosk-reactor/brands/{brandId}/devices/{deviceId}": {
      "get": {
        "operationId": "getKioskReactorDevice",
        "parameters": [
          {
            "name": "brandId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "deviceId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Détail éditable d'une borne de la company (champs whitelistés)",
        "tags": [
          "KioskReactor"
        ]
      },
      "patch": {
        "operationId": "updateKioskReactorDevice",
        "parameters": [
          {
            "name": "brandId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "deviceId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Champs éditables à modifier"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Mise à jour WHITELISTÉE d'une borne de la company (nom, toggles, imprimante, écran…) — brandId/projectId/Stripe intouchables",
        "tags": [
          "KioskReactor"
        ]
      }
    },
    "/kiosk-reactor/brands/{brandId}/boards/{boardId}": {
      "get": {
        "operationId": "getKioskReactorBoard",
        "parameters": [
          {
            "name": "brandId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "boardId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Détail éditable d'un tableau de la company (champs whitelistés)",
        "tags": [
          "KioskReactor"
        ]
      },
      "patch": {
        "operationId": "updateKioskReactorBoard",
        "parameters": [
          {
            "name": "brandId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "boardId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Champs éditables à modifier"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Mise à jour WHITELISTÉE d'un tableau de la company (nom, logo, header, colonnes, css, delays…)",
        "tags": [
          "KioskReactor"
        ]
      }
    },
    "/kiosk-reactor/fleet": {
      "get": {
        "operationId": "listKioskReactorFleet",
        "parameters": [],
        "responses": {
          "200": {
            "description": "[{ brandId, brandName, contactEmail, deviceCount, licences: [{ id, name }] }]"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Parc KioskReactor : companies triées par nom, avec leur nombre de bornes et les licences ApiBorne rattachées (plusieurs possibles)",
        "tags": [
          "KioskReactor"
        ]
      }
    },
    "/kiosk-reactor/fleet/{brandId}": {
      "get": {
        "operationId": "getKioskReactorFleetBrand",
        "parameters": [
          {
            "name": "brandId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "{ brandId, brandName, brandAuthorizationKey, projects: [{ id, name, authKey }], devices: [{ deviceId, name, …, apiborne }] }"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Détail parc d'une company : clés, projets et bornes (champs whitelistés — aucune config Stripe) avec leur rattachement ApiBorne",
        "tags": [
          "KioskReactor"
        ]
      }
    },
    "/api/kioskDesk/getKioskDesks/{userSessionKey}": {
      "get": {
        "operationId": "KioskDeskController_getKioskDesks",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Liste des guichets"
          }
        },
        "summary": "Récupérer les guichets",
        "tags": [
          "KioskDesk"
        ]
      }
    },
    "/api/kioskDesk/getRemainingKioskDesks/{userSessionKey}": {
      "get": {
        "operationId": "KioskDeskController_getRemainingKioskDesks",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Liste des guichets restants"
          }
        },
        "summary": "Récupérer les guichets restants",
        "tags": [
          "KioskDesk"
        ]
      }
    },
    "/api/kioskDesk/getKioskDesksWithAssociatedUsers/{userSessionKey}": {
      "get": {
        "operationId": "KioskDeskController_getKioskDesksWithAssociatedUsers",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Liste des guichets avec utilisateurs"
          }
        },
        "summary": "Récupérer les guichets avec utilisateurs associés",
        "tags": [
          "KioskDesk"
        ]
      }
    },
    "/api/kioskDesk/saveKioskDesk": {
      "post": {
        "operationId": "KioskDeskController_saveKioskDesk",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Guichet créé"
          }
        },
        "summary": "Créer un guichet",
        "tags": [
          "KioskDesk"
        ]
      }
    },
    "/api/kioskDesk/updateKioskDesk": {
      "post": {
        "operationId": "KioskDeskController_updateKioskDesk",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Guichet mis à jour"
          }
        },
        "summary": "Mettre à jour un guichet",
        "tags": [
          "KioskDesk"
        ]
      }
    },
    "/api/kioskDesk/deleteKioskDesk": {
      "post": {
        "operationId": "KioskDeskController_deleteKioskDesk",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Guichet supprimé"
          }
        },
        "summary": "Supprimer un guichet",
        "tags": [
          "KioskDesk"
        ]
      }
    },
    "/api/user/getUsersDetail/{token}": {
      "get": {
        "operationId": "KioskDeskUserForwardController_getUsersDetail",
        "parameters": [
          {
            "name": "token",
            "required": true,
            "in": "path",
            "description": "JWT token utilisateur",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "{ officeUsersDetail: [...] }"
          },
          "401": {
            "description": "Token invalide ou expiré"
          }
        },
        "summary": "Utilisateurs du cabinet (EasyDoct forwardé ; liste vide en saveur libre)",
        "tags": [
          "User"
        ]
      }
    },
    "/api/exam/getExams/{token}": {
      "get": {
        "operationId": "ExamController_getExamsByToken",
        "parameters": [
          {
            "name": "token",
            "required": true,
            "in": "path",
            "description": "JWT token utilisateur",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Liste des examens"
          },
          "401": {
            "description": "Token invalide ou expiré"
          }
        },
        "summary": "Examens (EasyDoct forwardé ; route config du contrat en saveur libre)",
        "tags": [
          "Exams"
        ]
      }
    },
    "/api/officePlace/getOfficePlaces/{token}/{examTypeId}/{examId}/{filterNoRooms}": {
      "get": {
        "operationId": "OfficePlaceController_getOfficePlaces",
        "parameters": [
          {
            "name": "token",
            "required": true,
            "in": "path",
            "description": "JWT token utilisateur",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "examTypeId",
            "required": true,
            "in": "path",
            "description": "ID du type d'examen (0 si non applicable)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "examId",
            "required": true,
            "in": "path",
            "description": "ID de l'examen (0 si non applicable)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "filterNoRooms",
            "required": true,
            "in": "path",
            "description": "Filtre pour exclure les salles (true/false)",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "{ xOfficePlaces: [{ id, name }] }"
          },
          "401": {
            "description": "Token invalide ou expiré"
          }
        },
        "summary": "Lieux de consultation (EasyDoct forwardé, ou route config du contrat en saveur libre)",
        "tags": [
          "OfficePlaces"
        ]
      }
    },
    "/api/kioskDevice/hasDeviceForOfficePlace": {
      "post": {
        "operationId": "KioskDeviceController_hasDeviceForOfficePlace",
        "parameters": [
          {
            "name": "authorization",
            "required": true,
            "in": "header",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Authorization",
            "in": "header",
            "description": "brandAuthorizationKey de la licence (KioskReactorSetting)",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "officePlaceId"
                ],
                "properties": {
                  "officePlaceId": {
                    "type": "number",
                    "description": "Id du lieu de la SALLE du RDV (pas celui de la borne)"
                  },
                  "officeVisibleId": {
                    "type": "string",
                    "nullable": true,
                    "description": "Uuid de l'office éditeur appelant — identifiant de référence"
                  },
                  "licenceUuid": {
                    "type": "string",
                    "nullable": true,
                    "description": "Prime sur les autres"
                  },
                  "brandId": {
                    "type": "string",
                    "nullable": true,
                    "description": "Requis sans officeVisibleId/licenceUuid"
                  },
                  "officeId": {
                    "type": "string",
                    "nullable": true,
                    "description": "Repli legacy"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "{ exists: boolean } — `false` = licence résolue mais AUCUNE borne sur ce lieu (réponse concluante)"
          },
          "401": {
            "description": "Clé de marque invalide (contrôle indisponible)"
          }
        },
        "summary": "Existe-t-il une borne de la licence couvrant ce lieu ? (lu par EasyDoct quand UseExternalConfiguration est actif — son garde d'émission de ticket ne voit pas les bornes déclarées uniquement côté ApiBorne)",
        "tags": [
          "KioskDevice"
        ]
      }
    },
    "/api/kioskDevice/saveKioskDevice": {
      "post": {
        "operationId": "KioskDeviceController_saveKioskDevice",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "externalId": {
                    "type": "string",
                    "example": "KIOSK-001",
                    "description": "Identifiant externe unique du device"
                  },
                  "deviceName": {
                    "type": "string",
                    "example": "Kiosk Reception",
                    "description": "Nom du device"
                  },
                  "officePlaceIds": {
                    "type": "array",
                    "items": {
                      "type": "number"
                    },
                    "example": [
                      1,
                      2,
                      3
                    ],
                    "description": "IDs des lieux de consultation"
                  },
                  "defaultTicketPrinter": {
                    "type": "boolean",
                    "example": false
                  },
                  "officePrinterIp": {
                    "type": "string",
                    "example": "192.168.1.100"
                  },
                  "userSessionKey": {
                    "type": "string",
                    "description": "JWT token utilisateur (requis) - le device sera créé pour la licence de cet utilisateur"
                  }
                },
                "required": [
                  "externalId",
                  "userSessionKey"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Device créé avec succès"
          },
          "401": {
            "description": "Token invalide"
          },
          "409": {
            "description": "ExternalId déjà existant"
          }
        },
        "summary": "Créer un nouveau device kiosk",
        "tags": [
          "KioskDevice"
        ]
      }
    },
    "/api/kioskDevice/updateKioskDevice": {
      "post": {
        "operationId": "KioskDeviceController_updateKioskDevice",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "number",
                    "example": 1,
                    "description": "ID du device à mettre à jour"
                  },
                  "externalId": {
                    "type": "string",
                    "example": "KIOSK-001"
                  },
                  "deviceName": {
                    "type": "string",
                    "example": "Kiosk Reception Updated"
                  },
                  "officePlaceIds": {
                    "type": "array",
                    "items": {
                      "type": "number"
                    },
                    "example": [
                      1,
                      2,
                      3
                    ]
                  },
                  "defaultTicketPrinter": {
                    "type": "boolean",
                    "example": true
                  },
                  "userSessionKey": {
                    "type": "string",
                    "description": "JWT token utilisateur (requis)"
                  }
                },
                "required": [
                  "id",
                  "userSessionKey"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Device mis à jour avec succès"
          },
          "401": {
            "description": "Token invalide"
          },
          "404": {
            "description": "Device introuvable"
          }
        },
        "summary": "Mettre à jour un device kiosk",
        "tags": [
          "KioskDevice"
        ]
      }
    },
    "/api/kioskDevice/deleteKioskDevice": {
      "post": {
        "operationId": "KioskDeviceController_deleteKioskDevice",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "number",
                    "example": 1,
                    "description": "ID du device à supprimer"
                  },
                  "userSessionKey": {
                    "type": "string",
                    "description": "JWT token utilisateur (requis)"
                  }
                },
                "required": [
                  "id",
                  "userSessionKey"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Device supprimé avec succès"
          },
          "401": {
            "description": "Token invalide"
          },
          "404": {
            "description": "Device introuvable"
          }
        },
        "summary": "Supprimer un device kiosk",
        "tags": [
          "KioskDevice"
        ]
      }
    },
    "/api/kioskDevice/kioskDeviceCommand/{command}": {
      "post": {
        "description": "Relaie la commande au cloud KioskReactor avec la clé de la licence (jamais exposée au client). Un 200 signifie que la commande a été DÉPOSÉE dans la file du device : la borne la dépile ensuite, donc l’exécution effective n’est pas garantie par cette réponse.",
        "operationId": "KioskDeviceController_kioskDeviceCommand",
        "parameters": [
          {
            "name": "command",
            "required": true,
            "in": "path",
            "description": "Commande à envoyer",
            "schema": {
              "enum": [
                "reboot",
                "reloadHomePage",
                "startRdp",
                "stopRdp"
              ],
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "deviceId": {
                    "type": "number",
                    "example": 1,
                    "description": "Id APIBORNE de la borne"
                  },
                  "userSessionKey": {
                    "type": "string",
                    "description": "JWT token utilisateur (requis)"
                  },
                  "source": {
                    "type": "string",
                    "enum": [
                      "cockpit",
                      "cockpit-extension",
                      "admin",
                      "mcp",
                      "api"
                    ],
                    "description": "Canal déclencheur, tracé dans l’événement Elastic « action distante » avec l’auteur (lu dans le JWT). Optionnel : absent = « unknown »"
                  }
                },
                "required": [
                  "deviceId",
                  "userSessionKey"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Commande déposée auprès de KioskReactor"
          },
          "400": {
            "description": "Commande inconnue, borne sans ExternalId, clé absente ou refusée"
          },
          "401": {
            "description": "Token invalide"
          },
          "404": {
            "description": "Device introuvable"
          }
        },
        "summary": "Envoyer une commande à une borne (reboot, reloadHomePage, startRdp, stopRdp)",
        "tags": [
          "KioskDevice"
        ]
      }
    },
    "/api/kioskDevice/getKioskDevices/{userSessionKey}": {
      "get": {
        "operationId": "KioskDeviceController_getKioskDevices",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "description": "JWT token utilisateur",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Liste des devices"
          },
          "401": {
            "description": "Token invalide"
          }
        },
        "summary": "Récupérer tous les devices kiosk pour la licence de l'utilisateur",
        "tags": [
          "KioskDevice"
        ]
      }
    },
    "/api/kioskDevice/getKioskDevicesInAllOffices/{userSessionKey}": {
      "get": {
        "operationId": "KioskDeviceController_getKioskDevicesInAllOffices",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "description": "JWT token utilisateur",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Liste de tous les devices"
          },
          "401": {
            "description": "Token invalide"
          }
        },
        "summary": "Récupérer tous les devices kiosk de toutes les licences",
        "tags": [
          "KioskDevice"
        ]
      }
    },
    "/api/kioskDevice/getKioskDeviceByExternalId/{externalId}": {
      "get": {
        "operationId": "KioskDeviceController_getKioskDeviceByExternalId",
        "parameters": [
          {
            "name": "externalId",
            "required": true,
            "in": "path",
            "description": "ExternalId du device",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Device trouvé (kioskDeviceInfo = device + kioskConfig format EasyDoct + kioskAnomalies)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetKioskDeviceByExternalIdResultDto"
                }
              }
            }
          },
          "404": {
            "description": "Device introuvable"
          }
        },
        "summary": "Récupérer un device kiosk par son ExternalId",
        "tags": [
          "KioskDevice"
        ]
      }
    },
    "/api/kioskDevice/keepAlive/{externalId}": {
      "post": {
        "operationId": "kioskDeviceKeepAlive",
        "parameters": [
          {
            "name": "externalId",
            "required": true,
            "in": "path",
            "description": "ExternalId de la borne",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "{ ok: true }"
          },
          "404": {
            "description": "Device introuvable"
          }
        },
        "summary": "Signe de vie de la page de la borne (statut admin)",
        "tags": [
          "KioskDevice"
        ]
      }
    },
    "/api/kioskTheme/saveUpdateKioskTheme": {
      "post": {
        "operationId": "KioskThemeController_saveUpdateKioskTheme",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "number",
                    "example": 1,
                    "description": "ID du thème (omis pour création, requis pour mise à jour)"
                  },
                  "name": {
                    "type": "string",
                    "example": "Theme Modern",
                    "description": "Nom du thème"
                  },
                  "base64JsonStyle": {
                    "type": "string",
                    "example": "eyJjb2xvcnMiOnsicHJpbWFyeSI6IiMwMDdiZmYifX0=",
                    "description": "Style JSON encodé en base64"
                  },
                  "externalId": {
                    "type": "string",
                    "example": "THEME-001"
                  },
                  "visibleId": {
                    "type": "string",
                    "example": "T001"
                  },
                  "creationUser": {
                    "type": "string",
                    "example": "admin@example.com"
                  },
                  "lastModificationUser": {
                    "type": "string",
                    "example": "admin@example.com"
                  },
                  "userSessionKey": {
                    "type": "string",
                    "description": "JWT token utilisateur (requis)"
                  }
                },
                "required": [
                  "name",
                  "userSessionKey"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Thème créé/mis à jour avec succès"
          },
          "401": {
            "description": "Token invalide"
          }
        },
        "summary": "Créer ou mettre à jour un thème kiosk",
        "tags": [
          "KioskTheme"
        ]
      }
    },
    "/api/kioskTheme/getKioskThemes/{userSessionKey}": {
      "get": {
        "operationId": "KioskThemeController_getKioskThemes",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "description": "JWT token utilisateur",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Liste des thèmes complets"
          },
          "401": {
            "description": "Token invalide"
          }
        },
        "summary": "Récupérer tous les thèmes kiosk complets",
        "tags": [
          "KioskTheme"
        ]
      }
    },
    "/api/kioskTheme/getLightKioskThemes/{userSessionKey}": {
      "get": {
        "operationId": "KioskThemeController_getLightKioskThemes",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "description": "JWT token utilisateur",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Liste des thèmes légers"
          },
          "401": {
            "description": "Token invalide"
          }
        },
        "summary": "Récupérer tous les thèmes kiosk légers (sans Base64JsonStyle)",
        "tags": [
          "KioskTheme"
        ]
      }
    },
    "/api/kioskTheme/convertKioskThemeToTokens": {
      "post": {
        "operationId": "KioskThemeController_convertKioskThemeToTokens",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "number",
                    "example": 1,
                    "description": "ID du thème legacy à convertir"
                  },
                  "apply": {
                    "type": "boolean",
                    "example": false,
                    "description": "false/omis = aperçu (tokens proposés + unmappedKeys + droppedValues) ; true = écrit les tokens, supprime le blob et propage aux bornes"
                  },
                  "userSessionKey": {
                    "type": "string",
                    "description": "JWT token utilisateur (requis)"
                  }
                },
                "required": [
                  "id",
                  "userSessionKey"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Rapport de conversion (et thème converti si apply)"
          },
          "400": {
            "description": "Thème déjà en tokens ou sans style"
          },
          "401": {
            "description": "Token invalide"
          },
          "404": {
            "description": "Thème introuvable"
          }
        },
        "summary": "Convertir un thème legacy (blob MUI base64) vers le format tokens v2 — apply: false = rapport seul",
        "tags": [
          "KioskTheme"
        ]
      }
    },
    "/api/kioskTheme/deleteKioskTheme": {
      "post": {
        "operationId": "KioskThemeController_deleteKioskTheme",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "number",
                    "example": 1,
                    "description": "ID du thème à supprimer"
                  },
                  "userSessionKey": {
                    "type": "string",
                    "description": "JWT token utilisateur (requis)"
                  }
                },
                "required": [
                  "id",
                  "userSessionKey"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Thème supprimé avec succès"
          },
          "401": {
            "description": "Token invalide"
          },
          "404": {
            "description": "Thème introuvable"
          }
        },
        "summary": "Supprimer un thème kiosk",
        "tags": [
          "KioskTheme"
        ]
      }
    },
    "/api/practitioner/getPractitionerResources/{token}": {
      "get": {
        "operationId": "PractitionerController_getPractitionerResources",
        "parameters": [
          {
            "name": "token",
            "required": true,
            "in": "path",
            "description": "JWT token utilisateur",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Liste des ressources praticiens"
          },
          "401": {
            "description": "Token invalide ou expiré"
          }
        },
        "summary": "Praticiens (EasyDoct forwardé ; route config du contrat en saveur libre)",
        "tags": [
          "Practitioner"
        ]
      }
    },
    "/api/room/getRoomResourcesWithExamTypes/{token}": {
      "get": {
        "operationId": "RoomController_getRoomResourcesWithExamTypes",
        "parameters": [
          {
            "name": "token",
            "required": true,
            "in": "path",
            "description": "JWT token utilisateur",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Liste des salles avec types d'examens"
          },
          "401": {
            "description": "Token invalide ou expiré"
          }
        },
        "summary": "Salles (EasyDoct forwardé ; route config du contrat en saveur libre)",
        "tags": [
          "Room"
        ]
      }
    },
    "/api/kioskDeskGroup/saveUpdateKioskDeskGroup": {
      "post": {
        "operationId": "KioskDeskGroup_SaveUpdateKioskDeskGroup",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "userSessionKey": {
                    "type": "string",
                    "description": "JWT token utilisateur"
                  },
                  "Id": {
                    "type": "number",
                    "description": "ID du groupe (0 pour création)"
                  },
                  "name": {
                    "type": "string",
                    "description": "Nom du groupe (max 100 caractères)"
                  }
                },
                "required": [
                  "userSessionKey"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Groupe créé/mis à jour avec succès"
          },
          "401": {
            "description": "Token invalide"
          }
        },
        "summary": "Créer ou mettre à jour un groupe de guichets",
        "tags": [
          "KioskDeskGroup"
        ]
      }
    },
    "/api/kioskDeskGroup/getKioskDeskGroups/{userSessionKey}": {
      "get": {
        "operationId": "KioskDeskGroup_GetKioskDeskGroups",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "description": "JWT token utilisateur",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Liste des groupes de guichets"
          },
          "401": {
            "description": "Token invalide"
          }
        },
        "summary": "Récupérer tous les groupes de guichets",
        "tags": [
          "KioskDeskGroup"
        ]
      }
    },
    "/api/kioskDeskGroup/deleteKioskDeskGroup/{kioskDeskGroupId}/{userSessionKey}": {
      "post": {
        "operationId": "KioskDeskGroup_DeleteKioskDeskGroup",
        "parameters": [
          {
            "name": "kioskDeskGroupId",
            "required": true,
            "in": "path",
            "description": "ID du groupe",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "description": "JWT token utilisateur",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Groupe supprimé"
          },
          "401": {
            "description": "Token invalide"
          }
        },
        "summary": "Supprimer un groupe de guichets (ses guichets sont détachés)",
        "tags": [
          "KioskDeskGroup"
        ]
      }
    },
    "/api/kioskTicket/reserve": {
      "post": {
        "operationId": "KioskTicketController_reserve",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "kioskDeviceExternalId",
                  "officePlaceId",
                  "reservationUid"
                ],
                "properties": {
                  "kioskDeviceExternalId": {
                    "type": "string"
                  },
                  "officePlaceId": {
                    "type": "number"
                  },
                  "reservationUid": {
                    "type": "string",
                    "description": "Uid unique par tentative logique — même uid ⇒ même numéro"
                  },
                  "prefix": {
                    "type": "string",
                    "nullable": true,
                    "description": "Préfixe RDV calculé côté borne"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Réservation (number, formattedNumber, status)"
          }
        },
        "summary": "Réserver un numéro de ticket avant le check-in contrat (idempotent par reservationUid)",
        "tags": [
          "KioskTicket"
        ]
      }
    },
    "/api/kioskTicket/confirm": {
      "post": {
        "operationId": "KioskTicketController_confirm",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "reservationUid"
                ],
                "properties": {
                  "reservationUid": {
                    "type": "string"
                  },
                  "contractAppointmentId": {
                    "type": "string",
                    "nullable": true
                  },
                  "patientDisplayName": {
                    "type": "string",
                    "nullable": true,
                    "deprecated": true,
                    "description": "IGNORÉ — le nom du patient n'est jamais persisté (donnée sensible)"
                  },
                  "examLabel": {
                    "type": "string",
                    "nullable": true
                  },
                  "kioskCheckinAnomalyIds": {
                    "type": "array",
                    "items": {
                      "type": "integer"
                    },
                    "nullable": true
                  },
                  "nonEligibilityReason": {
                    "type": "integer",
                    "nullable": true,
                    "description": "Motif du refus d'accueil (référentiel éditeur) — affiché au Cockpit avec l'anomalie « Dossier Incomplet »"
                  },
                  "paramedicCheckIn": {
                    "type": "boolean",
                    "description": "Check-in effectué par un accompagnant/brancardier (mode paramédical)"
                  },
                  "pendingExternalCheckIn": {
                    "type": "boolean",
                    "description": "Accueil RIS différé : la borne n'a pas appelé le check-in du contrat (licence en enablePostKioskCheckInSystemNotify). Le ticket ressort dans l'onglet « À vérifier » du Cockpit, où l'accueil réel est déclenché."
                  },
                  "kioskReactorCheckinConditionMatch": {
                    "type": "boolean",
                    "description": "Onglet « Accueilli borne » du Cockpit : vrai sauf refus d'accueil traçable (absent sur une borne antérieure ⇒ levé dès qu'un RDV du contrat est rattaché)"
                  },
                  "checkinDiagnostic": {
                    "type": "object",
                    "nullable": true,
                    "description": "Ce que la borne savait au moment du check-in (specs/admin-assistant-chat/) — sanitisé par liste blanche, JAMAIS de donnée patient. Lu par les tools de diagnostic diagnose_ticket_checkin / get_ticket_timeline.",
                    "properties": {
                      "version": {
                        "type": "integer",
                        "description": "Version du sous-document (1)"
                      },
                      "flavour": {
                        "type": "string",
                        "enum": [
                          "classic",
                          "mini"
                        ]
                      },
                      "readyForNotification": {
                        "type": "boolean",
                        "nullable": true,
                        "description": "Verdict d'éligibilité à l'accueil RIS (null = non évalué)"
                      },
                      "nonEligibilityReason": {
                        "type": "integer",
                        "nullable": true,
                        "description": "Motif du refus reçu par la borne (référentiel éditeur 0..18)"
                      },
                      "documentsManaged": {
                        "type": "boolean"
                      },
                      "documentsComplete": {
                        "type": "boolean",
                        "nullable": true
                      },
                      "missingDocumentTypes": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        },
                        "description": "Types (codes) de documents manquants, 10 max"
                      },
                      "anomalyCodes": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        },
                        "description": "Codes des anomalies du parcours, 20 max"
                      },
                      "identification": {
                        "type": "string",
                        "enum": [
                          "vitale",
                          "manual",
                          "qr_pass",
                          "fast_lane",
                          "simulated",
                          "unknown"
                        ]
                      },
                      "paramedic": {
                        "type": "boolean"
                      },
                      "appointmentCount": {
                        "type": "integer"
                      },
                      "criteriaCount": {
                        "type": "integer",
                        "nullable": true
                      },
                      "preparatorySurveyStep": {
                        "type": "boolean",
                        "nullable": true
                      },
                      "deferExternalNotification": {
                        "type": "boolean",
                        "description": "Accueil RIS différé demandé à l'éditeur"
                      },
                      "contractCheckInOk": {
                        "type": "boolean",
                        "nullable": true
                      },
                      "capturedAt": {
                        "type": "string",
                        "format": "date-time",
                        "nullable": true
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Réservation confirmée"
          }
        },
        "summary": "Confirmer une réservation après succès du check-in (détails Suivi)",
        "tags": [
          "KioskTicket"
        ]
      }
    },
    "/api/kioskTicket/issueForAppointment": {
      "post": {
        "operationId": "KioskTicketController_issueForAppointment",
        "parameters": [
          {
            "name": "authorization",
            "required": true,
            "in": "header",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Authorization",
            "in": "header",
            "description": "brandAuthorizationKey de la licence (KioskReactorSetting)",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "officePlaceId",
                  "requestUid"
                ],
                "properties": {
                  "licenceUuid": {
                    "type": "string",
                    "nullable": true,
                    "description": "UUID de la licence ApiBorne — identification de RÉFÉRENCE (admin, page Connectivité), prime sur tout autre identifiant"
                  },
                  "officeVisibleId": {
                    "type": "string",
                    "nullable": true,
                    "description": "Uuid de l'office éditeur (EasyDoct : Office.VisibleId) — repli des intégrations historiques qui n'envoient pas le licenceUuid"
                  },
                  "brandId": {
                    "type": "string",
                    "nullable": true,
                    "description": "BrandId KioskReactor de la licence (requis sans officeVisibleId/licenceUuid ; sinon vérifié)"
                  },
                  "officeId": {
                    "type": "string",
                    "nullable": true,
                    "description": "Id office éditeur — repli legacy via integrationEasyDocts"
                  },
                  "officePlaceId": {
                    "type": "number",
                    "description": "Id du lieu de soins du RDV — sert à la séquence par lieu ET au décalage de numérotation configuré par lieu (Numéros de ticket)"
                  },
                  "requestUid": {
                    "type": "string",
                    "description": "Uid d'idempotence, UNIQUE PAR GÉNÉRATION (rejeu réseau seulement — une re-génération legacy consomme un nouveau numéro)"
                  },
                  "prefix": {
                    "type": "string",
                    "nullable": true,
                    "description": "Préfixe explicite (démo/compat). Absent → calculé ICI depuis la conf Mongo (enableTicketExamTypePrefix + examTypeTicketPrefixes, repli 2 lettres du type)"
                  },
                  "examTypeId": {
                    "type": "number",
                    "nullable": true,
                    "description": "Id du type d'examen (référentiel éditeur) — pour le préfixe calculé"
                  },
                  "examTypeLabel": {
                    "type": "string",
                    "nullable": true,
                    "description": "Libellé du type d'examen — repli du préfixe calculé"
                  },
                  "contractAppointmentId": {
                    "type": "string",
                    "nullable": true,
                    "description": "Id contrat du RDV ({id}~{visibleId})"
                  },
                  "patientDisplayName": {
                    "type": "string",
                    "nullable": true,
                    "deprecated": true,
                    "description": "IGNORÉ — le nom du patient n'est jamais persisté (donnée sensible)"
                  },
                  "examLabel": {
                    "type": "string",
                    "nullable": true
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "{ number, formattedNumber, day }"
          }
        },
        "summary": "Émettre un ticket pour une arrivée pointée dans EasyDoct (flag UseExternalConfiguration) — même séquence que la borne, ticket confirmé visible au Cockpit, idempotent par requestUid",
        "tags": [
          "KioskTicket"
        ]
      }
    },
    "/api/kioskTicket/appointmentStatusChanged": {
      "post": {
        "operationId": "KioskTicketController_appointmentStatusChanged",
        "parameters": [
          {
            "name": "authorization",
            "required": true,
            "in": "header",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Authorization",
            "in": "header",
            "description": "brandAuthorizationKey de la licence (KioskReactorSetting)",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "contractAppointmentId",
                  "status"
                ],
                "properties": {
                  "officeVisibleId": {
                    "type": "string",
                    "nullable": true,
                    "description": "Uuid de l'office éditeur — repli des intégrations historiques (licenceUuid prime)"
                  },
                  "licenceUuid": {
                    "type": "string",
                    "nullable": true,
                    "description": "UUID de la licence ApiBorne — identification de référence (admin, page Connectivité)"
                  },
                  "brandId": {
                    "type": "string",
                    "nullable": true,
                    "description": "Requis sans officeVisibleId/licenceUuid"
                  },
                  "officeId": {
                    "type": "string",
                    "nullable": true,
                    "description": "Repli legacy (integrationEasyDocts)"
                  },
                  "contractAppointmentId": {
                    "type": "string",
                    "description": "Id contrat du RDV ({id}~{visibleId})"
                  },
                  "status": {
                    "type": "string",
                    "enum": [
                      "scheduled",
                      "checkedIn",
                      "inCare",
                      "done",
                      "cancelled"
                    ],
                    "description": "État courant du RDV (référentiel contrat)"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "{ updated: nombre de tickets mis à jour }"
          }
        },
        "summary": "Notification push d'EasyDoct (UseExternalConfiguration) à chaque changement d'état d'un RDV — met à jour externalStatus des tickets du jour, invalide le cache Cockpit et émet l'event Firestore",
        "tags": [
          "KioskTicket"
        ]
      }
    },
    "/api/kioskTicket/cancelForAppointment": {
      "post": {
        "operationId": "KioskTicketController_cancelForAppointment",
        "parameters": [
          {
            "name": "authorization",
            "required": true,
            "in": "header",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Authorization",
            "in": "header",
            "description": "brandAuthorizationKey de la licence (KioskReactorSetting)",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "contractAppointmentId"
                ],
                "properties": {
                  "officeVisibleId": {
                    "type": "string",
                    "nullable": true,
                    "description": "Uuid de l'office éditeur — repli des intégrations historiques (licenceUuid prime)"
                  },
                  "licenceUuid": {
                    "type": "string",
                    "nullable": true,
                    "description": "UUID de la licence ApiBorne — identification de référence (admin, page Connectivité)"
                  },
                  "brandId": {
                    "type": "string",
                    "nullable": true,
                    "description": "Requis sans officeVisibleId/licenceUuid"
                  },
                  "officeId": {
                    "type": "string",
                    "nullable": true,
                    "description": "Repli legacy (integrationEasyDocts)"
                  },
                  "contractAppointmentId": {
                    "type": "string",
                    "description": "Id contrat du RDV ({id}~{visibleId})"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "{ cancelled: nombre de tickets annulés }"
          }
        },
        "summary": "Annulation par l'éditeur des tickets du jour d'un RDV (refaire l'accueil) : tickets passés `cancelled`, retirés du Cockpit ; le prochain passage borne réserve un nouveau numéro",
        "tags": [
          "KioskTicket"
        ]
      }
    },
    "/api/kioskTicket/getCheckinNotifySettings": {
      "post": {
        "operationId": "KioskTicketController_getCheckinNotifySettings",
        "parameters": [
          {
            "name": "authorization",
            "required": true,
            "in": "header",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Authorization",
            "in": "header",
            "description": "brandAuthorizationKey de la licence (KioskReactorSetting)",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "officeVisibleId": {
                    "type": "string",
                    "nullable": true,
                    "description": "Uuid de l'office éditeur — repli des intégrations historiques (licenceUuid prime)"
                  },
                  "licenceUuid": {
                    "type": "string",
                    "nullable": true
                  },
                  "brandId": {
                    "type": "string",
                    "nullable": true,
                    "description": "Requis sans officeVisibleId/licenceUuid"
                  },
                  "officeId": {
                    "type": "string",
                    "nullable": true,
                    "description": "Repli legacy"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "{ settings: [entrée globale (officePlaceId null) + entrées par lieu], anomalies: référentiel ApiBorne (propres + globales) pour traduire excludedAnomalyCodes sans le référentiel EasyDoct }"
          }
        },
        "summary": "Réglages « Accueil RIS » (checkInSystemNotifySettings) de la licence, lus par EasyDoct quand UseExternalConfiguration est actif — la conf Mongo (admin ApiBorne) est la source de vérité des conditions de notification",
        "tags": [
          "KioskTicket"
        ]
      }
    },
    "/api/kioskTicket/printTicket": {
      "post": {
        "operationId": "KioskTicketController_printTicket",
        "parameters": [
          {
            "name": "authorization",
            "required": true,
            "in": "header",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Authorization",
            "in": "header",
            "description": "brandAuthorizationKey de la licence (KioskReactorSetting)",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "officePlaceId"
                ],
                "properties": {
                  "officeVisibleId": {
                    "type": "string",
                    "nullable": true,
                    "description": "Uuid de l'office éditeur (résolution prioritaire)"
                  },
                  "licenceUuid": {
                    "type": "string",
                    "nullable": true
                  },
                  "brandId": {
                    "type": "string",
                    "nullable": true
                  },
                  "officeId": {
                    "type": "string",
                    "nullable": true
                  },
                  "officePlaceId": {
                    "type": "number",
                    "description": "Lieu du RDV — sélectionne la borne cible"
                  },
                  "kioskDeskId": {
                    "type": "number",
                    "nullable": true,
                    "description": "Guichet du demandeur (id ApiBorne) — son imprimante bureau est prioritaire si configurée"
                  },
                  "userEmail": {
                    "type": "string",
                    "nullable": true,
                    "description": "Email du demandeur. Utilisé quand l'appelant est l'éditeur, dont les ids de guichet ne valent que dans son propre SQL : le guichet ApiBorne est alors retrouvé par l'utilisateur qui l'occupe (page Guichets de l'admin). Ignoré si kioskDeskId est fourni."
                  },
                  "language": {
                    "type": "string",
                    "nullable": true,
                    "description": "Variante de template (fr par défaut)"
                  },
                  "data": {
                    "type": "object",
                    "nullable": true,
                    "description": "Données Mustache du ticket (contexte minimal : numéro, patient, examen…) — clés dupliquées Pascal/camel au rendu"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "{ printed, deviceExternalId }"
          }
        },
        "summary": "Réimpression d'un ticket demandée par l'éditeur (UseExternalConfiguration) — template Mustache, borne cible et IP résolus depuis la conf Mongo, commande envoyée au cloud KioskReactor",
        "tags": [
          "KioskTicket"
        ]
      }
    },
    "/api/kioskTicket/reprintFromCockpit": {
      "post": {
        "operationId": "KioskTicketController_reprintFromCockpit",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "userSessionKey",
                  "kioskTicketId"
                ],
                "properties": {
                  "userSessionKey": {
                    "type": "string",
                    "description": "JWT de session Cockpit"
                  },
                  "kioskTicketId": {
                    "type": "number",
                    "description": "Id ApiBorne du ticket à réimprimer"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "{ printed, deviceExternalId }"
          }
        },
        "summary": "Réimpression d'un ticket depuis le Cockpit (saveur ApiBorne) — authentifiée par la session utilisateur, la clé de marque ne transite jamais par le navigateur",
        "tags": [
          "KioskTicket"
        ]
      }
    },
    "/api/kioskTicket/release": {
      "post": {
        "operationId": "KioskTicketController_release",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "reservationUid"
                ],
                "properties": {
                  "reservationUid": {
                    "type": "string"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Réservation relâchée"
          }
        },
        "summary": "Relâcher une réservation après échec du check-in (statut failed)",
        "tags": [
          "KioskTicket"
        ]
      }
    },
    "/api/kioskTicket/createKioskDeskRequest": {
      "post": {
        "operationId": "KioskTicketController_createKioskDeskRequest",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "kioskDeviceExternalId",
                  "officePlaceId",
                  "requestUid"
                ],
                "properties": {
                  "kioskDeviceExternalId": {
                    "type": "string"
                  },
                  "officePlaceId": {
                    "type": "number"
                  },
                  "requestUid": {
                    "type": "string"
                  },
                  "kioskDeskRequestReasonId": {
                    "type": "number",
                    "nullable": true
                  },
                  "cause": {
                    "type": "string"
                  },
                  "firstName": {
                    "type": "string"
                  },
                  "lastName": {
                    "type": "string"
                  },
                  "kioskRequestType": {
                    "type": "number",
                    "nullable": true,
                    "description": "1 = ticket de sortie (SOR), sinon REQ"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Forme legacy { appointmentTicketNumber, appointmentTicketNumberWithPrefix }"
          }
        },
        "summary": "Créer une demande guichet (numéro + persistance, forme legacy en retour, idempotent par requestUid)",
        "tags": [
          "KioskTicket"
        ]
      }
    },
    "/api/kioskTicket/getKioskTickets/{userSessionKey}": {
      "get": {
        "operationId": "KioskTicketController_getKioskTickets",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "day",
            "required": false,
            "in": "query",
            "description": "Jour YYYY-MM-DD (Europe/Paris)",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Liste des tickets, tri heure desc"
          }
        },
        "summary": "Suivi admin : tickets RDV du jour (défaut jour courant, borné aux 7 derniers)",
        "tags": [
          "KioskTicket"
        ]
      }
    },
    "/api/kioskTicket/getKioskDeskRequests/{userSessionKey}": {
      "get": {
        "operationId": "KioskTicketController_getKioskDeskRequests",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "day",
            "required": false,
            "in": "query",
            "description": "Jour YYYY-MM-DD (Europe/Paris)",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Liste des demandes, tri heure desc"
          }
        },
        "summary": "Suivi admin : demandes guichet du jour (défaut jour courant, borné aux 7 derniers)",
        "tags": [
          "KioskTicket"
        ]
      }
    },
    "/api/cockpit/signIn": {
      "post": {
        "operationId": "CockpitController_signIn",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "login",
                  "password"
                ],
                "properties": {
                  "login": {
                    "type": "string"
                  },
                  "password": {
                    "type": "string"
                  },
                  "sources": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "enum": [
                        "local",
                        "external"
                      ]
                    },
                    "description": "Sources à tenter (défaut : toutes)"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "{ pendingSessionKey, offices: [{licenceId, name, officeId, officeVisibleId, useExternalConfiguration}] }"
          },
          "429": {
            "description": "Trop de tentatives (par IP ou par identifiant)"
          }
        },
        "summary": "Login Cockpit étape 1 : valide les identifiants et renvoie les licences accessibles. Le serveur gère toujours les deux sources ('local' = comptes ApiBorne, 'external' = éditeur via le contrat staff/sign-in) ; le client choisit celles à tenter via `sources`",
        "tags": [
          "Cockpit"
        ]
      }
    },
    "/api/cockpit/signInLicence": {
      "post": {
        "operationId": "CockpitController_signInLicence",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "pendingSessionKey",
                  "licenceId"
                ],
                "properties": {
                  "pendingSessionKey": {
                    "type": "string"
                  },
                  "licenceId": {
                    "type": "number"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "{ userSessionKey, userFirstNameLastName, email }"
          }
        },
        "summary": "Login Cockpit étape 2 : établit la session sur une licence (JWT userSessionKey)",
        "tags": [
          "Cockpit"
        ]
      }
    },
    "/api/cockpit/getOfficeConfig/{userSessionKey}": {
      "get": {
        "operationId": "CockpitController_getOfficeConfig",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "userConfig + kioskConfig.features + userAgendaSettings"
          }
        },
        "summary": "Équivalent minimal du officeConfig EasyDoct consommé par le Cockpit",
        "tags": [
          "Cockpit"
        ]
      }
    },
    "/api/cockpit/getKioskDeskId/{userSessionKey}": {
      "get": {
        "operationId": "CockpitController_getKioskDeskId",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Guichet occupé par l'utilisateur + email",
        "tags": [
          "Cockpit"
        ]
      }
    },
    "/api/cockpit/getCallToKioskDeskKioskBoards/{userSessionKey}": {
      "get": {
        "operationId": "CockpitController_getBoards",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Boards de la licence (AppointmentStatesList en tableau)",
        "tags": [
          "Cockpit"
        ]
      }
    },
    "/api/cockpit/getCallToKioskDeskKioskBoardCurrentUser/{userSessionKey}": {
      "get": {
        "operationId": "CockpitController_getCurrentUserBoard",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Board lié au guichet occupé par l'utilisateur",
        "tags": [
          "Cockpit"
        ]
      }
    },
    "/api/cockpit/getKioskDesksWithAssociatedUsers/{userSessionKey}": {
      "get": {
        "operationId": "CockpitController_getKioskDesksWithAssociatedUsers",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Guichets + utilisateur occupant (jointure cockpitUserSettings)",
        "tags": [
          "Cockpit"
        ]
      }
    },
    "/api/cockpit/updateTicketStatus": {
      "post": {
        "operationId": "CockpitController_updateTicketStatus",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "userSessionKey",
                  "kioskTicketId"
                ],
                "properties": {
                  "userSessionKey": {
                    "type": "string"
                  },
                  "kioskTicketId": {
                    "type": "number"
                  },
                  "status": {
                    "type": "string",
                    "description": "Défaut : 'next' (avance d'un cran)"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "{ externalStatus }"
          }
        },
        "summary": "Change le statut du RDV lié à un ticket chez l'éditeur externe (contrat PUT /appointments/{id}/status) — status: 'next' | 'checkedIn' | 'inCare' | 'done'",
        "tags": [
          "Cockpit"
        ]
      }
    },
    "/api/cockpit/getKioskAppointments/{userSessionKey}": {
      "get": {
        "operationId": "CockpitController_getKioskAppointments",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "freshIds",
            "required": false,
            "in": "query",
            "description": "Ids (CSV) dont l'état vient de changer (signal Firestore) : ids tickets apiborne ou ids RDV éditeur — le cache de réconciliation est bypassé pour ces RDV",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "forceRefresh",
            "required": false,
            "in": "query",
            "description": "Rafraîchissement MANUEL demandé par l'utilisateur (bouton « Rafraîchir » du Cockpit) : le cache de réconciliation est ignoré pour TOUS les RDV du board. Réservé à ce geste — un poll automatique ne doit jamais le poser.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Tickets RDV du jour réconciliés avec l'agenda de l'éditeur externe (source de vérité) — annulés/supprimés exclus, externalStatus exposé",
        "tags": [
          "Cockpit"
        ]
      }
    },
    "/api/cockpit/updateUserAgendaDisplaySetting": {
      "post": {
        "operationId": "CockpitController_updateUserAgendaDisplaySetting",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "userSessionKey": {
                    "type": "string"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "{ HasError, kioskDeskIdModifed }"
          }
        },
        "summary": "Sauvegarde des réglages board de l'utilisateur (payload legacy)",
        "tags": [
          "Cockpit"
        ]
      }
    },
    "/api/cockpit/getKioskDeskRequests/{userSessionKey}/{officePlaceId}": {
      "get": {
        "operationId": "CockpitController_getKioskDeskRequests",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "officePlaceId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Demandes guichet du jour d'un lieu (forme wire EasyDoct)",
        "tags": [
          "Cockpit"
        ]
      }
    },
    "/api/cockpit/getDeskRequestScanPageUrl/{userSessionKey}/{scanId}/{pageIndex}": {
      "get": {
        "operationId": "CockpitController_getDeskRequestScanPageUrl",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "scanId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "pageIndex",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "{ url, expiresAt }"
          },
          "404": {
            "description": "Scan inconnu pour cette licence, ou page hors du coffre"
          }
        },
        "summary": "Coffre documents : URL présignée (GET, 2 min, inline) d'une page d'ordonnance scannée — scan de la licence de la session uniquement",
        "tags": [
          "Cockpit"
        ]
      }
    },
    "/api/cockpit/callToKioskDeskRequest": {
      "post": {
        "operationId": "CockpitController_callToKioskDeskRequest",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "userSessionKey",
                  "kioskDeskRequestId"
                ],
                "properties": {
                  "userSessionKey": {
                    "type": "string"
                  },
                  "kioskDeskRequestId": {
                    "type": "number"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Appelle une demande au guichet occupé par l'utilisateur",
        "tags": [
          "Cockpit"
        ]
      }
    },
    "/api/cockpit/cancelCallToKioskDeskRequest": {
      "post": {
        "operationId": "CockpitController_cancelCallToKioskDeskRequest",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "userSessionKey",
                  "kioskDeskRequestId"
                ],
                "properties": {
                  "userSessionKey": {
                    "type": "string"
                  },
                  "kioskDeskRequestId": {
                    "type": "number"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Annule l'appel d'une demande (retour en attente)",
        "tags": [
          "Cockpit"
        ]
      }
    },
    "/api/cockpit/callTicketToDesk": {
      "post": {
        "operationId": "CockpitController_callTicketToDesk",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "userSessionKey",
                  "kioskTicketId"
                ],
                "properties": {
                  "userSessionKey": {
                    "type": "string"
                  },
                  "kioskTicketId": {
                    "type": "number"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Appelle un patient accueilli (ticket) au guichet occupé par l'utilisateur",
        "tags": [
          "Cockpit"
        ]
      }
    },
    "/api/cockpit/checkInTicketInExternalSystem": {
      "post": {
        "operationId": "CockpitController_checkInTicketInExternalSystem",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "userSessionKey",
                  "kioskTicketId"
                ],
                "properties": {
                  "userSessionKey": {
                    "type": "string"
                  },
                  "kioskTicketId": {
                    "type": "number"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Ticket mis à jour (pendingExternalCheckIn: false)"
          }
        },
        "summary": "Accueil RIS différé : déclenche le check-in du RDV chez l'éditeur (contrat) pour un ticket en attente",
        "tags": [
          "Cockpit"
        ]
      }
    },
    "/api/cockpit/cancelCallTicket": {
      "post": {
        "operationId": "CockpitController_cancelCallTicket",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "userSessionKey",
                  "kioskTicketId"
                ],
                "properties": {
                  "userSessionKey": {
                    "type": "string"
                  },
                  "kioskTicketId": {
                    "type": "number"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Annule l'appel d'un patient accueilli (retour en attente)",
        "tags": [
          "Cockpit"
        ]
      }
    },
    "/api/cockpit/togglePostCheckin": {
      "post": {
        "operationId": "CockpitController_togglePostCheckin",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "userSessionKey",
                  "kioskTicketId"
                ],
                "properties": {
                  "userSessionKey": {
                    "type": "string"
                  },
                  "kioskTicketId": {
                    "type": "number"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Ticket mis à jour (postCheckinCompleted basculé)"
          }
        },
        "summary": "Onglet « Accueilli borne » : bascule la validation post-accueil d'un ticket (prêt / pas prêt pour l'examen)",
        "tags": [
          "Cockpit"
        ]
      }
    },
    "/api/cockpit/updateKioskDeskRequest": {
      "post": {
        "operationId": "CockpitController_updateKioskDeskRequest",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "userSessionKey",
                  "Id"
                ],
                "properties": {
                  "userSessionKey": {
                    "type": "string"
                  },
                  "Id": {
                    "type": "number"
                  },
                  "Processed": {
                    "type": "boolean"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Met à jour une demande (bascule Processed)",
        "tags": [
          "Cockpit"
        ]
      }
    },
    "/api/cockpit/logOff": {
      "post": {
        "operationId": "CockpitController_logOff",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "userSessionKey": {
                    "type": "string"
                  }
                },
                "required": [
                  "userSessionKey"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Déconnexion explicite d'un agent : libère son guichet et sa présence",
        "tags": [
          "Cockpit"
        ]
      }
    },
    "/api/kioskDeskRequestScan/uploadUrls": {
      "post": {
        "operationId": "KioskDeskRequestScanController_createUploadUrls",
        "parameters": [
          {
            "name": "x-kiosk-device-id",
            "required": true,
            "in": "header",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "x-kiosk-auth-key",
            "required": true,
            "in": "header",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Kiosk-Auth-Key",
            "in": "header",
            "description": "Clé de marque de la licence",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Kiosk-Device-Id",
            "in": "header",
            "description": "externalId de la borne",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "kioskDeviceExternalId",
                  "requestUid",
                  "scanUid",
                  "pages"
                ],
                "properties": {
                  "kioskDeviceExternalId": {
                    "type": "string"
                  },
                  "requestUid": {
                    "type": "string",
                    "description": "Uid de la demande guichet"
                  },
                  "scanUid": {
                    "type": "string",
                    "description": "Uid d'idempotence du scan (le même qu'à attach)"
                  },
                  "pages": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "required": [
                        "index",
                        "contentType",
                        "size"
                      ],
                      "properties": {
                        "index": {
                          "type": "number",
                          "example": 0
                        },
                        "contentType": {
                          "type": "string",
                          "enum": [
                            "image/jpeg",
                            "image/png"
                          ]
                        },
                        "size": {
                          "type": "number",
                          "description": "Octets (≤ SCAN_VAULT_MAX_PAGE_BYTES)"
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "{ enabled, pages: [{ index, storageKey, uploadUrl, expiresAt }] } — seul Content-Type est un en-tête signé"
          },
          "401": {
            "description": "En-têtes borne absents ou clé de marque invalide"
          }
        },
        "summary": "Coffre documents : URLs présignées de dépôt (PUT direct S3) pour les pages d'un scan — { enabled: false } si le coffre n'est pas actif pour la licence",
        "tags": [
          "KioskDeskRequestScan"
        ]
      }
    },
    "/api/kioskDeskRequestScan/vaultIdentity": {
      "get": {
        "operationId": "KioskDeskRequestScanController_verifyVaultIdentity",
        "parameters": [
          {
            "name": "x-kiosk-device-id",
            "required": true,
            "in": "header",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "x-kiosk-auth-key",
            "required": true,
            "in": "header",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Kiosk-Auth-Key",
            "in": "header",
            "description": "Clé de marque de la licence",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Kiosk-Device-Id",
            "in": "header",
            "description": "externalId de la borne",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "{ licenceId }"
          },
          "401": {
            "description": "En-têtes absents ou clé de marque invalide"
          },
          "404": {
            "description": "Borne inconnue"
          }
        },
        "summary": "Coffre documents : validation d'une identité de borne pour la passerelle (serveur → serveur) — renvoie { licenceId }",
        "tags": [
          "KioskDeskRequestScan"
        ]
      }
    },
    "/api/kioskDeskRequestScan/attach": {
      "post": {
        "operationId": "KioskDeskRequestScanController_attach",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "kioskDeviceExternalId",
                  "requestUid",
                  "scanUid",
                  "pages"
                ],
                "properties": {
                  "kioskDeviceExternalId": {
                    "type": "string"
                  },
                  "requestUid": {
                    "type": "string",
                    "description": "Uid de la demande guichet (KioskDeskRequest.requestUid)"
                  },
                  "scanUid": {
                    "type": "string",
                    "description": "Uid d'idempotence du scan"
                  },
                  "pages": {
                    "type": "array",
                    "description": "Pages scannées. Le fichier reste sur le disque de la borne : seul son nom est transmis.",
                    "items": {
                      "type": "object",
                      "properties": {
                        "filename": {
                          "type": "string",
                          "nullable": true,
                          "example": "capture_20260423_113027.jpg",
                          "description": "Nom du fichier sur la borne. Peut être absent pour une capture webcam déposée au coffre (storageKey obligatoire alors)"
                        },
                        "capturedAt": {
                          "type": "string",
                          "nullable": true
                        },
                        "documentDetected": {
                          "type": "boolean",
                          "nullable": true
                        },
                        "isBlurry": {
                          "type": "boolean",
                          "nullable": true
                        },
                        "captureQuality": {
                          "type": "number",
                          "nullable": true
                        },
                        "rotation": {
                          "type": "number",
                          "nullable": true
                        },
                        "cropped": {
                          "type": "boolean",
                          "nullable": true
                        },
                        "storageKey": {
                          "type": "string",
                          "nullable": true,
                          "description": "Coffre documents : clé renvoyée par uploadUrls, après PUT réussi. Vérifiée (préfixe + HEAD) ; absente du coffre ⇒ page conservée sans clé"
                        },
                        "contentType": {
                          "type": "string",
                          "nullable": true
                        },
                        "size": {
                          "type": "number",
                          "nullable": true
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Scan rattaché (ou scan existant si rejeu du scanUid) — pages avec `stored` (jamais de clé ni d’URL)"
          }
        },
        "summary": "Rattacher des pages scannées à une demande guichet (noms de fichiers, plus clé du coffre documents si la licence l'a activé ; idempotent par scanUid)",
        "tags": [
          "KioskDeskRequestScan"
        ]
      }
    },
    "/api/kioskDeskRequestScan/analysis": {
      "post": {
        "operationId": "KioskDeskRequestScanController_recordAnalysis",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "kioskDeviceExternalId",
                  "requestUid",
                  "status"
                ],
                "properties": {
                  "kioskDeviceExternalId": {
                    "type": "string"
                  },
                  "requestUid": {
                    "type": "string",
                    "description": "Uid de la demande guichet (KioskDeskRequest.requestUid)"
                  },
                  "status": {
                    "type": "string",
                    "enum": [
                      "analyzed",
                      "failed"
                    ]
                  },
                  "result": {
                    "type": "object",
                    "description": "Réponse STRUCTURÉE du service d'analyse : status métier, structuredAnswer, prescriberResolution, processDelayMs, errorMessage. Jamais le document.",
                    "properties": {
                      "status": {
                        "type": "string",
                        "nullable": true
                      },
                      "structuredAnswer": {
                        "type": "object",
                        "nullable": true
                      },
                      "prescriberResolution": {
                        "type": "object",
                        "nullable": true
                      },
                      "processDelayMs": {
                        "type": "number",
                        "nullable": true
                      },
                      "errorMessage": {
                        "type": "string",
                        "nullable": true
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Scan mis à jour avec son analyse"
          },
          "404": {
            "description": "Demande ou scan introuvable pour cette borne"
          }
        },
        "summary": "Déposer le résultat de l'analyse IA faite par la borne sur le scan d'une demande guichet (jamais d'image)",
        "tags": [
          "KioskDeskRequestScan"
        ]
      }
    },
    "/api/kioskDeskRequestScan/getScans/{userSessionKey}": {
      "get": {
        "operationId": "KioskDeskRequestScanController_getScans",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "day",
            "required": false,
            "in": "query",
            "description": "Jour YYYY-MM-DD (Europe/Paris)",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Liste des scans, tri date desc"
          }
        },
        "summary": "Suivi admin : scans du jour (défaut jour courant, borné aux 7 derniers)",
        "tags": [
          "KioskDeskRequestScan"
        ]
      }
    },
    "/api/kioskDeskRequestScan/byRequest/{deskRequestId}/{userSessionKey}": {
      "get": {
        "operationId": "KioskDeskRequestScanController_getScanByRequest",
        "parameters": [
          {
            "name": "deskRequestId",
            "required": true,
            "in": "path",
            "description": "KioskDeskRequest.id",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "description": "JWT token utilisateur — mettre '-' pour s'authentifier par X-Licence-Uuid",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "x-licence-uuid",
            "required": true,
            "in": "header",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Licence-Uuid",
            "in": "header",
            "description": "UUID de la licence — alternative au JWT (outil de test local)",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Le scan de la demande"
          },
          "404": {
            "description": "Aucun scan rattaché à cette demande"
          }
        },
        "summary": "Scan rattaché à UNE demande guichet (le plus récent). Outil de test d'analyse IA.",
        "tags": [
          "KioskDeskRequestScan"
        ]
      }
    },
    "/api/scanVaultRelay/upload/{token}": {
      "put": {
        "operationId": "ScanVaultRelayController_upload",
        "parameters": [
          {
            "name": "token",
            "required": true,
            "in": "path",
            "description": "Jeton de dépôt délivré par uploadUrls (5 min)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "content-type",
            "required": true,
            "in": "header",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "x-kiosk-device-id",
            "required": true,
            "in": "header",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "x-kiosk-auth-key",
            "required": true,
            "in": "header",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Kiosk-Auth-Key",
            "in": "header",
            "description": "Clé de marque de la licence",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Kiosk-Device-Id",
            "in": "header",
            "description": "externalId de la borne liée au jeton",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Page déposée"
          },
          "400": {
            "description": "Content-Type ou taille différents de ceux annoncés"
          },
          "401": {
            "description": "Jeton invalide/expiré, ou identité de borne refusée"
          },
          "404": {
            "description": "Relais inactif"
          }
        },
        "summary": "Coffre documents (mode relais) : dépôt d'une page par la borne — jeton de uploadUrls + en-têtes borne + Content-Type/taille annoncés",
        "tags": [
          "ScanVaultRelay"
        ]
      }
    },
    "/api/scanVaultRelay/page/{token}": {
      "get": {
        "operationId": "ScanVaultRelayController_page",
        "parameters": [
          {
            "name": "token",
            "required": true,
            "in": "path",
            "description": "Jeton de lecture délivré à la session Cockpit (2 min)",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "L'image (Content-Disposition inline)"
          },
          "401": {
            "description": "Jeton invalide ou expiré"
          },
          "404": {
            "description": "Relais inactif, ou objet absent du coffre (expiré ou purgé)"
          }
        },
        "summary": "Coffre documents (mode relais) : lecture d'une page par le Cockpit — jeton de getDeskRequestScanPageUrl (2 min), rendu en flux, no-store",
        "tags": [
          "ScanVaultRelay"
        ]
      }
    },
    "/api/apiCallLog/logBatch": {
      "post": {
        "operationId": "ApiCallLogController_logBatch",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "kioskDeviceExternalId",
                  "entries"
                ],
                "properties": {
                  "kioskDeviceExternalId": {
                    "type": "string"
                  },
                  "entries": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "channel": {
                          "type": "string",
                          "enum": [
                            "contract",
                            "apiborne-ticket"
                          ]
                        },
                        "httpMethod": {
                          "type": "string"
                        },
                        "path": {
                          "type": "string"
                        },
                        "httpStatus": {
                          "type": "number",
                          "nullable": true
                        },
                        "durationMs": {
                          "type": "number"
                        },
                        "ok": {
                          "type": "boolean"
                        },
                        "errorCode": {
                          "type": "string",
                          "nullable": true
                        },
                        "encrypted": {
                          "type": "boolean"
                        },
                        "clientTs": {
                          "type": "number",
                          "description": "Epoch ms côté borne"
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Lot persisté (HasError:false)"
          }
        },
        "summary": "Réception par lots des métadonnées d'appel de la borne (jamais de contenu)",
        "tags": [
          "ApiCallLog"
        ]
      }
    },
    "/api/apiCallLog/getApiCallLogs/{userSessionKey}": {
      "get": {
        "operationId": "ApiCallLogController_getApiCallLogs",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "channel",
            "required": false,
            "in": "query",
            "schema": {
              "enum": [
                "contract",
                "apiborne-ticket"
              ],
              "type": "string"
            }
          },
          {
            "name": "httpMethod",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "ok",
            "required": false,
            "in": "query",
            "description": "true | false",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "deviceExternalId",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Liste des logs, tri clientTs desc"
          }
        },
        "summary": "Consultation admin : métadonnées d'appel de la licence courante (7 derniers jours)",
        "tags": [
          "ApiCallLog"
        ]
      }
    },
    "/elastic-admin/stats": {
      "get": {
        "description": "Par index : nb total de documents et nb de documents plus vieux que olderThanMonths. Sans licenceId : vision globale ; avec licenceId : cloisonné aux officeIds de la licence.",
        "operationId": "getElasticRetentionStats",
        "parameters": [
          {
            "name": "olderThanMonths",
            "required": false,
            "in": "query",
            "schema": {
              "example": 6,
              "type": "number"
            }
          },
          {
            "name": "licenceId",
            "required": false,
            "in": "query",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Stats par index (cutoff, total, olderThanCutoff)"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Statistiques de rétention Elastic (superadmin)",
        "tags": [
          "ElasticAdmin"
        ]
      }
    },
    "/elastic-admin/cleanup": {
      "post": {
        "description": "Supprime (deleteByQuery) les documents plus vieux que olderThanMonths (>= 1 obligatoire). Sans licenceId : clean GLOBAL ; avec licenceId : cloisonné aux officeIds de la licence.",
        "operationId": "runElasticRetentionCleanup",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "olderThanMonths": {
                    "type": "number",
                    "example": 6,
                    "minimum": 1
                  },
                  "licenceId": {
                    "type": "number",
                    "nullable": true,
                    "description": "Omis = clean global"
                  }
                },
                "required": [
                  "olderThanMonths"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Résultat par index (deleted)"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Ménage manuel des données Elastic anciennes (superadmin)",
        "tags": [
          "ElasticAdmin"
        ]
      }
    },
    "/licences/{licenceId}/kiosk-stats": {
      "get": {
        "operationId": "getKioskStats",
        "parameters": [
          {
            "name": "licenceId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "from",
            "required": true,
            "in": "query",
            "description": "Début de période (ISO 8601)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "to",
            "required": true,
            "in": "query",
            "description": "Fin de période (ISO 8601)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "granularity",
            "required": true,
            "in": "query",
            "schema": {
              "enum": [
                "hour",
                "day",
                "week",
                "month"
              ],
              "type": "string"
            }
          },
          {
            "name": "officePlaceId",
            "required": false,
            "in": "query",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "deviceId",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "includeSimulated",
            "required": false,
            "in": "query",
            "description": "Inclure les sessions de test (?simulate) — exclues par défaut",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Stats agrégées (voir KioskStatsResponse)"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Statistiques d'activité des bornes de la licence (KPI, séries temporelles Europe/Paris, par borne, langues)",
        "tags": [
          "KioskStats"
        ]
      }
    },
    "/licences/{licenceId}/kiosk-stats/desk-calls": {
      "get": {
        "operationId": "getDeskCallStats",
        "parameters": [
          {
            "name": "licenceId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "from",
            "required": true,
            "in": "query",
            "description": "Début de période (ISO 8601)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "to",
            "required": true,
            "in": "query",
            "description": "Fin de période (ISO 8601)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "granularity",
            "required": true,
            "in": "query",
            "schema": {
              "enum": [
                "hour",
                "day",
                "week",
                "month"
              ],
              "type": "string"
            }
          },
          {
            "name": "officePlaceId",
            "required": false,
            "in": "query",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Stats agrégées (voir DeskCallStatsResponse)"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Statistiques des appels guichet de la licence (KPI, séries temporelles Europe/Paris, motifs, guichets, agents)",
        "tags": [
          "KioskStats"
        ]
      }
    },
    "/licences/{licenceId}/kiosk-stats/center-flow": {
      "get": {
        "description": "Détection des engorgements par créneau horaire. La présence est ESTIMÉE par différence de flux cumulés (remise à zéro chaque jour) : le ticket de sortie étant anonyme, aucun appariement arrivée ↔ sortie n'est possible — d'où l'absence de durée individuelle et de découpage par type d'examen. Les drapeaux `hasArrivals`/`hasExits` disent si les deux bouts de la mesure existent sur la période ; sans les deux, `estimatedStayMs` est null et l'UI masque la présence.",
        "operationId": "getCenterFlowStats",
        "parameters": [
          {
            "name": "licenceId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "from",
            "required": true,
            "in": "query",
            "description": "Début de période (ISO 8601)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "to",
            "required": true,
            "in": "query",
            "description": "Fin de période (ISO 8601)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "granularity",
            "required": true,
            "in": "query",
            "schema": {
              "enum": [
                "hour",
                "day",
                "week",
                "month"
              ],
              "type": "string"
            }
          },
          {
            "name": "officePlaceId",
            "required": false,
            "in": "query",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Stats agrégées (voir CenterFlowStatsResponse)"
          },
          "403": {
            "description": "Réservé au superadmin tant que CENTER_FLOW_STATS_ENABLED est vide sur le serveur"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Statistiques de flux du centre (arrivées/sorties par créneau, présence estimée, attente avant appel guichet, charge documentaire)",
        "tags": [
          "KioskStats"
        ]
      }
    },
    "/licences/{licenceId}/kiosk-stats/pass": {
      "get": {
        "operationId": "getPassUsageStats",
        "parameters": [
          {
            "name": "licenceId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "from",
            "required": true,
            "in": "query",
            "description": "Début de période (ISO 8601)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "to",
            "required": true,
            "in": "query",
            "description": "Fin de période (ISO 8601)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "granularity",
            "required": true,
            "in": "query",
            "schema": {
              "enum": [
                "hour",
                "day",
                "week",
                "month"
              ],
              "type": "string"
            }
          },
          {
            "name": "officePlaceVisibleId",
            "required": false,
            "in": "query",
            "description": "VisibleId du lieu (une CHAÎNE : le Pass ne connaît pas les ids numériques)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "includeSimulated",
            "required": false,
            "in": "query",
            "description": "Inclure les sessions de test (?simulate) — exclues par défaut",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Stats agrégées (voir PassUsageStatsResponse)"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Statistiques d'usage de l'app patient Pass (KPI, entonnoir d'adoption, séries, répartitions) — métadonnées seulement, aucune donnée patient",
        "tags": [
          "KioskStats"
        ]
      }
    },
    "/licences/{licenceId}/kiosk-stats/fast-lane": {
      "get": {
        "description": "Deux sources, deux rôles : l'entonnoir et TOUS les taux viennent de Mongo (`fastLaneInvites`, un document par RDV, chaque étape datée) ; le détail (issues de résolution à la borne, avance avant le RDV) vient d'Elastic. ⚠️ L'entonnoir n'est calculable que sur la fenêtre de purge TTL (`funnelWindowDays`, 30 jours après le RDV) : `funnelTruncated` dit si la période demandée la dépasse. `mode` (`identification` ou `qr`) permet à l'UI d'adapter son discours sur l'étape « présentés à la borne ».",
        "operationId": "getFastLaneStats",
        "parameters": [
          {
            "name": "licenceId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "from",
            "required": true,
            "in": "query",
            "description": "Début de période (ISO 8601)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "to",
            "required": true,
            "in": "query",
            "description": "Fin de période (ISO 8601)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "granularity",
            "required": true,
            "in": "query",
            "schema": {
              "enum": [
                "hour",
                "day",
                "week",
                "month"
              ],
              "type": "string"
            }
          },
          {
            "name": "locationId",
            "required": false,
            "in": "query",
            "description": "Lieu du RDV (`appointment.locationId` du contrat) — SEUL champ de lieu de la collection, et une CHAÎNE : ce n'est pas l'`officePlaceId` numérique des autres pages de stats",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Stats agrégées (voir FastLaneStatsResponse)"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Statistiques de la file rapide « Prêt avant d'arriver » (entonnoir invitation → accueil, KPI, séries, documents manquants) — métadonnées seulement, aucune donnée patient",
        "tags": [
          "KioskStats"
        ]
      }
    },
    "/prescription-ai-stats": {
      "get": {
        "operationId": "getPrescriptionAiStats",
        "parameters": [
          {
            "name": "from",
            "required": true,
            "in": "query",
            "description": "Début de période (ISO 8601)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "to",
            "required": true,
            "in": "query",
            "description": "Fin de période (ISO 8601)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "granularity",
            "required": true,
            "in": "query",
            "schema": {
              "enum": [
                "hour",
                "day",
                "week",
                "month"
              ],
              "type": "string"
            }
          },
          {
            "name": "licenceId",
            "required": false,
            "in": "query",
            "description": "Filtre de diagnostic ; absent = toutes licences",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Stats agrégées (voir PrescriptionAiStatsResponse)"
          },
          "403": {
            "description": "Réservé au superadmin"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Statistiques des analyses IA d'ordonnance (coût en tokens, taux de résolution du prescripteur, examens reconnus) — toutes licences, filtrable",
        "tags": [
          "KioskStats"
        ]
      }
    },
    "/elastic-events": {
      "get": {
        "operationId": "getElasticEvents",
        "parameters": [
          {
            "name": "from",
            "required": true,
            "in": "query",
            "description": "Début de période (ISO 8601)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "to",
            "required": true,
            "in": "query",
            "description": "Fin de période (ISO 8601)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "licenceId",
            "required": false,
            "in": "query",
            "description": "Filtre ; absent = tout le parc",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "deviceId",
            "required": false,
            "in": "query",
            "description": "ExternalId KioskReactor de la borne",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "officePlaceId",
            "required": false,
            "in": "query",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "eventTypes",
            "required": false,
            "in": "query",
            "description": "Types séparés par des virgules ; prime sur minSeverity",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "minSeverity",
            "required": false,
            "in": "query",
            "description": "Gravité minimale 1→5 du catalogue (défaut 4)",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "search",
            "required": false,
            "in": "query",
            "description": "Recherche plein texte (detail, borne, lieu, acteur)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "includeSimulated",
            "required": false,
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "page",
            "required": false,
            "in": "query",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "pageSize",
            "required": false,
            "in": "query",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Événements paginés (voir ElasticEventsResponse)"
          },
          "403": {
            "description": "Réservé au superadmin"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Événements Elastic bruts du parc (erreurs par défaut), paginés et filtrables par licence, borne, lieu, type, gravité et texte libre",
        "tags": [
          "KioskStats"
        ]
      }
    },
    "/support/contact": {
      "post": {
        "operationId": "SupportController_contact",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "example": "John Doe"
                  },
                  "email": {
                    "type": "string",
                    "example": "user@example.com"
                  },
                  "phone": {
                    "type": "string",
                    "example": "+33 6 12 34 56 78"
                  },
                  "message": {
                    "type": "string",
                    "example": "Bonjour, j’ai une question…"
                  }
                },
                "required": [
                  "email",
                  "message"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Message envoyé au support"
          },
          "400": {
            "description": "Email ou message manquant"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Envoyer un message au support",
        "tags": [
          "Support"
        ]
      }
    },
    "/support/public-contact": {
      "post": {
        "operationId": "PublicContactController_publicContact",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "example": "Marie Dupont"
                  },
                  "email": {
                    "type": "string",
                    "example": "marie.dupont@cabinet.fr"
                  },
                  "phone": {
                    "type": "string",
                    "example": "06 12 34 56 78"
                  },
                  "sector": {
                    "type": "string",
                    "example": "Cabinet de radiologie"
                  },
                  "message": {
                    "type": "string",
                    "example": "Je souhaite une démonstration."
                  },
                  "company": {
                    "type": "string",
                    "description": "Honeypot anti-spam : doit rester vide"
                  }
                },
                "required": [
                  "name",
                  "email",
                  "phone",
                  "sector",
                  "message"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Demande transmise"
          },
          "400": {
            "description": "Champs manquants ou invalides"
          },
          "429": {
            "description": "Trop de demandes depuis cette IP"
          }
        },
        "summary": "Envoyer une demande depuis le formulaire de contact public du site",
        "tags": [
          "Support"
        ]
      }
    },
    "/api/patient/officePlaceContext/{officeVisibleId}/{officePlaceVisibleId}": {
      "get": {
        "operationId": "PatientController_getOfficePlaceContext",
        "parameters": [
          {
            "name": "X-Licence-Uuid",
            "in": "header",
            "description": "UUID de la licence ApiBorne (saveur libre) — injecté par le Pass depuis ?licence=",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "officeVisibleId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "officePlaceVisibleId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "title",
            "required": true,
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "{ officeVisibleId, officePlaceVisibleId, title? }"
          }
        },
        "summary": "Contexte lieu (echo du couple office/officePlace + titre optionnel)",
        "tags": [
          "Patient"
        ]
      }
    },
    "/api/patient/identify": {
      "post": {
        "operationId": "PatientController_identify",
        "parameters": [
          {
            "name": "X-Licence-Uuid",
            "in": "header",
            "description": "UUID de la licence ApiBorne (saveur libre) — injecté par le Pass depuis ?licence=",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "x-licence-uuid",
            "required": true,
            "in": "header",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "ticketNumber",
                  "birthDate",
                  "officePlaceVisibleId"
                ],
                "properties": {
                  "ticketNumber": {
                    "type": "string",
                    "description": "Numéro de ticket / code du RDV"
                  },
                  "birthDate": {
                    "type": "string",
                    "description": "DD/MM/YYYY ou YYYY-MM-DD"
                  },
                  "officePlaceVisibleId": {
                    "type": "string",
                    "description": "VisibleId du lieu où le ticket a été émis"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Une entrée par RDV du patient (vide si non trouvé/naissance KO)"
          },
          "429": {
            "description": "Trop de tentatives (par IP ou par ticket+lieu)"
          }
        },
        "summary": "Identifier par numéro de ticket + date de naissance (le ticket est un code getAppointmentByCode ; la naissance garde l’accès)",
        "tags": [
          "Patient"
        ]
      }
    },
    "/api/patient/appointmentByCode/{code}": {
      "get": {
        "operationId": "PatientController_getAppointmentByCode",
        "parameters": [
          {
            "name": "X-Licence-Uuid",
            "in": "header",
            "description": "UUID de la licence ApiBorne (saveur libre) — injecté par le Pass depuis ?licence=",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "x-licence-uuid",
            "required": true,
            "in": "header",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "code",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "RDV (forme UI Pass)"
          },
          "404": {
            "description": "RDV introuvable"
          }
        },
        "summary": "RDV par code (QR / visibleId)",
        "tags": [
          "Patient"
        ]
      }
    },
    "/api/patient/appointment/{appointmentId}": {
      "get": {
        "operationId": "PatientController_getAppointmentById",
        "parameters": [
          {
            "name": "X-Licence-Uuid",
            "in": "header",
            "description": "UUID de la licence ApiBorne (saveur libre) — injecté par le Pass depuis ?licence=",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "x-licence-uuid",
            "required": true,
            "in": "header",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "appointmentId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "RDV (forme UI Pass)"
          },
          "404": {
            "description": "RDV introuvable"
          }
        },
        "summary": "RDV par id",
        "tags": [
          "Patient"
        ]
      }
    },
    "/api/patient/checkBirthDate": {
      "post": {
        "operationId": "PatientController_checkBirthDate",
        "parameters": [
          {
            "name": "X-Licence-Uuid",
            "in": "header",
            "description": "UUID de la licence ApiBorne (saveur libre) — injecté par le Pass depuis ?licence=",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "x-licence-uuid",
            "required": true,
            "in": "header",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "appointmentId",
                  "dateOfBirth"
                ],
                "properties": {
                  "appointmentId": {
                    "type": "string"
                  },
                  "dateOfBirth": {
                    "type": "string",
                    "description": "DD/MM/YYYY"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "{ valid: boolean }"
          },
          "429": {
            "description": "Trop de tentatives (par IP ou par RDV)"
          }
        },
        "summary": "Vérifier la date de naissance d’un RDV → { valid }",
        "tags": [
          "Patient"
        ]
      }
    },
    "/api/patient/appointment/{appointmentId}/patient": {
      "patch": {
        "operationId": "PatientController_updatePatient",
        "parameters": [
          {
            "name": "X-Licence-Uuid",
            "in": "header",
            "description": "UUID de la licence ApiBorne (saveur libre) — injecté par le Pass depuis ?licence=",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "x-licence-uuid",
            "required": true,
            "in": "header",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "appointmentId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "dateOfBirth",
                  "patient"
                ],
                "properties": {
                  "dateOfBirth": {
                    "type": "string",
                    "description": "DD/MM/YYYY — preuve d’identité, revérifiée"
                  },
                  "patient": {
                    "type": "object",
                    "description": "Champs à modifier (liste fermée : firstName, lastName, birthDate, email, mobilePhone, addressLine1, addressLine2, zipCode, city, heightCm, weightKg)",
                    "properties": {
                      "firstName": {
                        "type": "string"
                      },
                      "lastName": {
                        "type": "string"
                      },
                      "birthDate": {
                        "type": "string",
                        "description": "YYYY-MM-DD ou DD/MM/YYYY"
                      },
                      "email": {
                        "type": "string"
                      },
                      "mobilePhone": {
                        "type": "string"
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "RDV relu après mise à jour (forme UI Pass)"
          },
          "400": {
            "description": "Clé inconnue dans patient, ou refus éditeur"
          },
          "404": {
            "description": "RDV introuvable ou date de naissance fausse"
          },
          "429": {
            "description": "Trop de tentatives (par IP ou par RDV)"
          }
        },
        "summary": "Corriger l’identité du patient d’un RDV (nom, prénom, naissance, e-mail, mobile) — naissance revérifiée",
        "tags": [
          "Patient"
        ]
      }
    },
    "/api/patient/appointment/{appointmentId}/documents": {
      "get": {
        "operationId": "PatientController_listDocuments",
        "parameters": [
          {
            "name": "X-Licence-Uuid",
            "in": "header",
            "description": "UUID de la licence ApiBorne (saveur libre) — injecté par le Pass depuis ?licence=",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "x-licence-uuid",
            "required": true,
            "in": "header",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "appointmentId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Documents + types requis (forme UI Pass)"
          }
        },
        "summary": "Documents du RDV + types requis",
        "tags": [
          "Patient"
        ]
      },
      "post": {
        "operationId": "PatientController_uploadDocument",
        "parameters": [
          {
            "name": "X-Licence-Uuid",
            "in": "header",
            "description": "UUID de la licence ApiBorne (saveur libre) — injecté par le Pass depuis ?licence=",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "x-licence-uuid",
            "required": true,
            "in": "header",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "appointmentId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "documentType",
                  "pagesContentBase64"
                ],
                "properties": {
                  "documentType": {
                    "type": "string",
                    "description": "Code contrat (vendor-neutral)"
                  },
                  "pagesContentBase64": {
                    "type": "string",
                    "description": "Pages base64 (sans préfixe data:) séparées par !#!"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "{ documentId }"
          }
        },
        "summary": "Téléverser un document (pages base64 séparées par !#!)",
        "tags": [
          "Patient"
        ]
      }
    },
    "/api/patient/appointment/{appointmentId}/documents/{documentId}": {
      "delete": {
        "operationId": "PatientController_deleteDocument",
        "parameters": [
          {
            "name": "X-Licence-Uuid",
            "in": "header",
            "description": "UUID de la licence ApiBorne (saveur libre) — injecté par le Pass depuis ?licence=",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "x-licence-uuid",
            "required": true,
            "in": "header",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "appointmentId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "documentId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Document supprimé"
          }
        },
        "summary": "Supprimer un document du RDV",
        "tags": [
          "Patient"
        ]
      }
    },
    "/api/patient/appointment/{appointmentId}/notificationContext": {
      "get": {
        "operationId": "PatientController_getNotificationContext",
        "parameters": [
          {
            "name": "X-Licence-Uuid",
            "in": "header",
            "description": "UUID de la licence ApiBorne (saveur libre) — injecté par le Pass depuis ?licence=",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "x-licence-uuid",
            "required": true,
            "in": "header",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "appointmentId",
            "required": true,
            "in": "path",
            "description": "Id contrat du RDV",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "{ brandId, callToDeskBoardExternalId, stateBoardExternalId, appointmentId, ticketNumber, kioskTicketId, ticketFormatted }"
          },
          "404": {
            "description": "Aucun ticket borne pour ce RDV"
          }
        },
        "summary": "Contexte de notification d’appel guichet (brandId + boards + clés d’appariement du ticket)",
        "tags": [
          "Patient"
        ]
      }
    },
    "/api/patient/appointment/{appointmentId}/preparatorySurvey": {
      "get": {
        "operationId": "PatientController_ensurePreparatorySurvey",
        "parameters": [
          {
            "name": "X-Licence-Uuid",
            "in": "header",
            "description": "UUID de la licence ApiBorne (saveur libre) — injecté par le Pass depuis ?licence=",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "x-licence-uuid",
            "required": true,
            "in": "header",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "appointmentId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "{ xId, name?, done }"
          }
        },
        "summary": "Résoudre/créer le questionnaire préparatoire du RDV (xId null si aucun)",
        "tags": [
          "Patient"
        ]
      }
    },
    "/api/patient/preparatorySurvey/{surveyResultId}": {
      "get": {
        "operationId": "PatientController_getPreparatorySurvey",
        "parameters": [
          {
            "name": "X-Licence-Uuid",
            "in": "header",
            "description": "UUID de la licence ApiBorne (saveur libre) — injecté par le Pass depuis ?licence=",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "x-licence-uuid",
            "required": true,
            "in": "header",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "surveyResultId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "jsonDef + prefilledInfos + existingData + alreadyDone"
          }
        },
        "summary": "Charger la définition + données du questionnaire",
        "tags": [
          "Patient"
        ]
      },
      "post": {
        "operationId": "PatientController_sendPreparatorySurvey",
        "parameters": [
          {
            "name": "X-Licence-Uuid",
            "in": "header",
            "description": "UUID de la licence ApiBorne (saveur libre) — injecté par le Pass depuis ?licence=",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "x-licence-uuid",
            "required": true,
            "in": "header",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "surveyResultId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "data"
                ],
                "properties": {
                  "data": {
                    "type": "object",
                    "description": "Résultat SurveyJS (nom → valeur)"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Résultat enregistré (éléments pour le PDF)"
          }
        },
        "summary": "Soumettre les réponses du questionnaire",
        "tags": [
          "Patient"
        ]
      }
    },
    "/api/patient/preparatorySurvey/{surveyResultId}/pdf": {
      "post": {
        "operationId": "PatientController_uploadPreparatorySurveyPdf",
        "parameters": [
          {
            "name": "X-Licence-Uuid",
            "in": "header",
            "description": "UUID de la licence ApiBorne (saveur libre) — injecté par le Pass depuis ?licence=",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "x-licence-uuid",
            "required": true,
            "in": "header",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "surveyResultId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "pdfBase64"
                ],
                "properties": {
                  "pdfBase64": {
                    "type": "string",
                    "description": "PDF encodé base64"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "PDF enregistré"
          }
        },
        "summary": "Téléverser le PDF du questionnaire rempli (base64)",
        "tags": [
          "Patient"
        ]
      }
    },
    "/api/patient/usage-events": {
      "post": {
        "operationId": "postPassUsageEvents",
        "parameters": [
          {
            "name": "X-Licence-Uuid",
            "in": "header",
            "description": "UUID de la licence ApiBorne — REPLI d'attribution quand le contexte ne porte pas d'officeVisibleId exploitable. Un licenceId présent dans le corps est toujours ignoré.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "x-licence-uuid",
            "required": true,
            "in": "header",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PassUsageEventsDto"
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "Lot accepté (ou jeté en silence : type inconnu, quota dépassé, Elastic non configuré)"
          },
          "401": {
            "description": "Licence non résolue : ni l'officeVisibleId du contexte ni X-Licence-Uuid ne désignent une licence connue"
          }
        },
        "summary": "Télémétrie d'usage de l'app patient Pass (métadonnées seulement) — 202 systématique, jamais bloquant",
        "tags": [
          "Patient"
        ]
      }
    },
    "/mcp-tokens/openapi.json": {
      "get": {
        "description": "Admin : portée `licence` seulement (403 sur `global`). Superadmin : `licence` ou `global`. Le document est généré depuis le registre des tools (jamais un fichier à maintenir) ; c’est le même que `GET /api/v1/openapi.json` appelé avec une clé de la portée.",
        "operationId": "downloadToolsOpenApi",
        "parameters": [
          {
            "name": "scope",
            "required": false,
            "in": "query",
            "description": "Défaut : licence",
            "schema": {
              "enum": [
                "licence",
                "global"
              ],
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Document OpenAPI 3.0.3 (attachment apiborne-api-<scope>.json)"
          },
          "403": {
            "description": "Portée globale demandée par un admin de licence"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Télécharge le document OpenAPI 3 de l’API REST des tools (portée licence ou globale)",
        "tags": [
          "McpTokens"
        ]
      }
    },
    "/mcp-tokens": {
      "get": {
        "operationId": "listMcpTokens",
        "parameters": [
          {
            "name": "licenceId",
            "required": false,
            "in": "query",
            "description": "Filtre superadmin uniquement",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Tokens sans keyHash (keyPrefix seulement)"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Liste des tokens MCP (admin : sa licence ; superadmin : tous)",
        "tags": [
          "McpTokens"
        ]
      },
      "post": {
        "description": "Admin : token figé sur sa licence (licenceId refusé). Superadmin : licenceId pour un token figé sur une licence, omis pour un token global multi-licences. Quota : 5 tokens actifs par licence, 5 tokens globaux.",
        "operationId": "createMcpToken",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "label": {
                    "type": "string",
                    "example": "Claude Code — poste dev"
                  },
                  "expiresInDays": {
                    "type": "number",
                    "nullable": true,
                    "description": "Omis = sans expiration"
                  },
                  "licenceId": {
                    "type": "number",
                    "nullable": true,
                    "description": "Superadmin uniquement"
                  }
                },
                "required": [
                  "label"
                ]
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "{ token, fullKey } — fullKey affichée une seule fois"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Crée un token MCP — la clé complète n’est retournée qu’ici, une seule fois",
        "tags": [
          "McpTokens"
        ]
      }
    },
    "/mcp-tokens/{id}/revoke": {
      "post": {
        "operationId": "revokeMcpToken",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Token révoqué"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Révoque un token MCP (soft-revoke ; global : superadmin uniquement)",
        "tags": [
          "McpTokens"
        ]
      }
    },
    "/api/v1/tools": {
      "get": {
        "description": "Chaque entrée est appelable par `POST /api/v1/tools/{name}`. `write: true` = écriture à double appel (aperçu sans `confirm`, application avec `confirm: true`).",
        "operationId": "listApiTools",
        "parameters": [],
        "responses": {
          "200": {
            "description": "{ scope, count, tools: [{ name, tag, description, write, method, path }] }"
          },
          "401": {
            "description": "Clé absente, invalide, expirée ou révoquée"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Catalogue des tools visibles pour la clé (portée licence ou globale)",
        "tags": [
          "ToolsApi"
        ]
      }
    },
    "/api/v1/openapi.json": {
      "get": {
        "operationId": "getApiToolsOpenApi",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Document OpenAPI 3.0.3 (JSON)"
          },
          "401": {
            "description": "Clé absente, invalide, expirée ou révoquée"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Document OpenAPI 3 de l’API des tools, pour la portée de la clé",
        "tags": [
          "ToolsApi"
        ]
      }
    },
    "/api/v1/tools/{name}": {
      "post": {
        "operationId": "ToolsApiController_callTool",
        "parameters": [
          {
            "name": "name",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "tags": [
          "ToolsApi"
        ]
      }
    },
    "/api/media/status": {
      "get": {
        "operationId": "getMediaStatus",
        "parameters": [],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Le stockage S3 est-il configuré ?",
        "tags": [
          "Media"
        ]
      }
    },
    "/api/media/list": {
      "get": {
        "operationId": "listMedia",
        "parameters": [
          {
            "name": "licenceId",
            "required": true,
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Bibliothèque de la licence : dossiers + médias (URL publiques)",
        "tags": [
          "Media"
        ]
      }
    },
    "/api/media/fonts/catalog": {
      "get": {
        "operationId": "listGoogleFonts",
        "parameters": [],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Polices Google Fonts proposées dans la page Thèmes",
        "tags": [
          "Media"
        ]
      }
    },
    "/api/media/fonts/install": {
      "post": {
        "operationId": "installGoogleFont",
        "parameters": [],
        "responses": {
          "201": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Installe une police Google Fonts dans la médiathèque (auto-hébergement) et renvoie les entrées fonts[] du thème",
        "tags": [
          "Media"
        ]
      }
    },
    "/api/media/upload": {
      "post": {
        "operationId": "uploadMedia",
        "parameters": [
          {
            "name": "licenceId",
            "required": true,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "folder",
            "required": true,
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "201": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Charge un média (multipart, champ « file » ; ?folder= optionnel)",
        "tags": [
          "Media"
        ]
      }
    },
    "/api/media/folder": {
      "post": {
        "operationId": "createMediaFolder",
        "parameters": [
          {
            "name": "licenceId",
            "required": true,
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "201": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Crée un dossier (un niveau)",
        "tags": [
          "Media"
        ]
      },
      "delete": {
        "operationId": "deleteMediaFolder",
        "parameters": [
          {
            "name": "name",
            "required": true,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "licenceId",
            "required": true,
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Supprime un dossier VIDE (400 sinon)",
        "tags": [
          "Media"
        ]
      }
    },
    "/api/media/move": {
      "post": {
        "operationId": "moveMedia",
        "parameters": [
          {
            "name": "licenceId",
            "required": true,
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "201": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Déplace un média vers un dossier (folder null/vide = racine)",
        "tags": [
          "Media"
        ]
      }
    },
    "/api/media": {
      "delete": {
        "operationId": "deleteMedia",
        "parameters": [
          {
            "name": "key",
            "required": true,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "licenceId",
            "required": true,
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Supprime un média (par clé S3)",
        "tags": [
          "Media"
        ]
      }
    },
    "/update-announcements/contacts": {
      "get": {
        "operationId": "listUpdateContacts",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Contacts, triés par email"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Lister les contacts de la liste d'annonce (superadmin)",
        "tags": [
          "UpdateAnnouncement"
        ]
      },
      "post": {
        "operationId": "saveUpdateContact",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "Id": {
                    "type": "number",
                    "description": "Omis pour création"
                  },
                  "Email": {
                    "type": "string",
                    "example": "jean.dupont@centre.fr"
                  },
                  "FirstName": {
                    "type": "string",
                    "description": "Optionnel"
                  },
                  "LastName": {
                    "type": "string",
                    "description": "Optionnel"
                  },
                  "Company": {
                    "type": "string",
                    "description": "Optionnel"
                  },
                  "Notes": {
                    "type": "string",
                    "description": "Optionnel"
                  },
                  "Active": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "Email"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Le contact enregistré"
          },
          "400": {
            "description": "Email manquant, invalide ou déjà présent"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Créer ou mettre à jour un contact (superadmin)",
        "tags": [
          "UpdateAnnouncement"
        ]
      }
    },
    "/update-announcements/contacts/{id}": {
      "delete": {
        "operationId": "deleteUpdateContact",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Supprimé"
          },
          "404": {
            "description": "Contact introuvable"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Supprimer un contact (superadmin)",
        "tags": [
          "UpdateAnnouncement"
        ]
      }
    },
    "/update-announcements/contacts/bulk": {
      "post": {
        "description": "Une ligne par contact. Formes acceptées : « email », « Prénom Nom <email> », « email ; Prénom Nom ». Le prénom/nom est déduit de la partie locale quand elle contient un séparateur (prenom.nom). Un email invalide part dans rejected[] sans faire échouer les autres lignes.",
        "operationId": "addUpdateContactsBulk",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "Text": {
                    "type": "string",
                    "example": "Jean Dupont <jean.dupont@centre.fr>"
                  }
                },
                "required": [
                  "Text"
                ]
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Rapport created / updated / rejected"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Ajouter plusieurs contacts depuis un bloc de texte collé (superadmin)",
        "tags": [
          "UpdateAnnouncement"
        ]
      }
    },
    "/update-announcements/contacts/active-count": {
      "get": {
        "operationId": "countActiveUpdateContacts",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Compteur"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Nombre de contacts actifs (confirmation avant envoi)",
        "tags": [
          "UpdateAnnouncement"
        ]
      }
    },
    "/update-announcements": {
      "get": {
        "operationId": "listUpdateAnnouncements",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Annonces, la plus récente en premier"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Lister les annonces de mise à jour (superadmin)",
        "tags": [
          "UpdateAnnouncement"
        ]
      },
      "post": {
        "description": "⚠️ Toute modification du corps repasse le statut à draft : le test doit être refait avant un envoi à tous.",
        "operationId": "saveUpdateAnnouncement",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "Id": {
                    "type": "number",
                    "description": "Omis pour création"
                  },
                  "Title": {
                    "type": "string",
                    "description": "Titre = sujet du mail"
                  },
                  "BodyMarkdown": {
                    "type": "string",
                    "description": "Corps en markdown"
                  }
                },
                "required": [
                  "Title"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "L'annonce enregistrée"
          },
          "400": {
            "description": "Titre manquant"
          },
          "404": {
            "description": "Annonce introuvable"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Créer ou mettre à jour une annonce (superadmin)",
        "tags": [
          "UpdateAnnouncement"
        ]
      }
    },
    "/update-announcements/{id}": {
      "get": {
        "operationId": "getUpdateAnnouncement",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "L'annonce"
          },
          "404": {
            "description": "Annonce introuvable"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Lire une annonce (superadmin)",
        "tags": [
          "UpdateAnnouncement"
        ]
      },
      "delete": {
        "operationId": "deleteUpdateAnnouncement",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Supprimée"
          },
          "404": {
            "description": "Annonce introuvable"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Supprimer une annonce (superadmin)",
        "tags": [
          "UpdateAnnouncement"
        ]
      }
    },
    "/update-announcements/{id}/preview": {
      "get": {
        "operationId": "previewUpdateAnnouncement",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "firstName",
            "required": false,
            "in": "query",
            "description": "Prénom d'exemple pour la salutation (défaut : un prénom fictif)",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Sujet + HTML rendu"
          },
          "404": {
            "description": "Annonce introuvable"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Aperçu du HTML final de l'annonce, sans rien envoyer (superadmin)",
        "tags": [
          "UpdateAnnouncement"
        ]
      }
    },
    "/update-announcements/{id}/send-test": {
      "post": {
        "description": "Pré-requis de l'envoi à tous : passe le statut à tested.",
        "operationId": "sendUpdateAnnouncementTest",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "TestEmail": {
                    "type": "string",
                    "example": "moi@apiborne.com"
                  }
                },
                "required": [
                  "TestEmail"
                ]
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "L'annonce, statut tested"
          },
          "400": {
            "description": "Adresse de test manquante ou invalide"
          },
          "404": {
            "description": "Annonce introuvable"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Envoyer l'annonce à une adresse de test (superadmin)",
        "tags": [
          "UpdateAnnouncement"
        ]
      }
    },
    "/update-announcements/{id}/send": {
      "post": {
        "description": "Refusé si l'annonce n'a pas été testée, ou si elle a déjà été envoyée sans Force. Envoi séquentiel étalé : un échec est compté sans interrompre la boucle.",
        "operationId": "sendUpdateAnnouncementToAll",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "Force": {
                    "type": "boolean",
                    "description": "Renvoyer une annonce déjà envoyée"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "L'annonce, statut sent + compteurs"
          },
          "400": {
            "description": "Non testée, déjà envoyée, ou aucun contact actif"
          },
          "404": {
            "description": "Annonce introuvable"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Envoyer l'annonce à tous les contacts actifs (superadmin)",
        "tags": [
          "UpdateAnnouncement"
        ]
      }
    },
    "/update-announcements/{id}/send-selection": {
      "post": {
        "description": "Rattrapage : échec d’envoi, défi MailInBlack validé après coup, contact ajouté tard. L’annonce doit avoir été testée ; un contact désinscrit est ignoré même s’il est sélectionné. Les compteurs sont CUMULÉS et les destinataires repris sortent de la liste des échecs.",
        "operationId": "sendUpdateAnnouncementToSelection",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "ContactIds"
                ],
                "properties": {
                  "ContactIds": {
                    "type": "array",
                    "items": {
                      "type": "number"
                    },
                    "description": "Ids des contacts à qui renvoyer l’annonce"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "L'annonce, compteurs cumulés"
          },
          "400": {
            "description": "Non testée, sélection vide ou sans contact actif"
          },
          "404": {
            "description": "Annonce introuvable"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Renvoyer une annonce à une sélection de contacts",
        "tags": [
          "UpdateAnnouncement"
        ]
      }
    },
    "/feature-requests": {
      "get": {
        "operationId": "FeatureRequestController_list",
        "parameters": [
          {
            "name": "status",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "mine",
            "required": false,
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Demandes visibles : celles de la licence (superviseur/admin) ou tout le parc (superadmin) ; `mine=true` réduit aux siennes",
        "tags": [
          "FeatureRequest"
        ]
      },
      "post": {
        "operationId": "FeatureRequestController_create",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "title"
                ],
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 160
                  },
                  "bodyMarkdown": {
                    "type": "string",
                    "maxLength": 20000
                  },
                  "priority": {
                    "type": "string",
                    "enum": [
                      "low",
                      "normal",
                      "high"
                    ]
                  },
                  "status": {
                    "type": "string",
                    "enum": [
                      "draft",
                      "submitted"
                    ],
                    "default": "submitted"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "429": {
            "description": "Plus de 5 créations aujourd’hui"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Créer une demande (demandeur rempli côté serveur, PII masquée, 5 par jour)",
        "tags": [
          "FeatureRequest"
        ]
      }
    },
    "/feature-requests/{id}": {
      "get": {
        "operationId": "FeatureRequestController_get",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Détail d'une demande (404 si elle n'est pas visible)",
        "tags": [
          "FeatureRequest"
        ]
      },
      "put": {
        "operationId": "FeatureRequestController_update",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Modifier titre / corps / priorité (demandeur tant que non triée ; superadmin toujours) ; `submit: true` soumet un brouillon",
        "tags": [
          "FeatureRequest"
        ]
      },
      "delete": {
        "operationId": "FeatureRequestController_remove",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Supprimer (superadmin ; le demandeur peut supprimer son brouillon)",
        "tags": [
          "FeatureRequest"
        ]
      }
    },
    "/feature-requests/{id}/status": {
      "patch": {
        "operationId": "FeatureRequestController_updateStatus",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "status"
                ],
                "properties": {
                  "status": {
                    "type": "string",
                    "enum": [
                      "draft",
                      "submitted",
                      "accepted",
                      "in_progress",
                      "done",
                      "rejected"
                    ]
                  },
                  "statusNote": {
                    "type": "string",
                    "maxLength": 2000
                  },
                  "specFolder": {
                    "type": "string"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Changer le statut (superadmin) avec note et dossier de spec",
        "tags": [
          "FeatureRequest"
        ]
      }
    },
    "/api/kioskTranslate/batch": {
      "post": {
        "operationId": "KioskTranslate_Batch",
        "parameters": [],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Traduire un lot de textes fr vers une langue du pool produit (cache Mongo)",
        "tags": [
          "KioskTranslate"
        ]
      }
    },
    "/api/prescriber/search/{userSessionKey}": {
      "get": {
        "operationId": "PrescriberController_search",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "description": "JWT token utilisateur — mettre '-' pour s'authentifier par X-Licence-Uuid",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "x-licence-uuid",
            "required": true,
            "in": "header",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "rppsId",
            "required": false,
            "in": "query",
            "description": "RPPS lu sur l'ordonnance",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lastName",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "firstName",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "town",
            "required": false,
            "in": "query",
            "description": "Commune lue sur l'ordonnance — DISCRIMINANT de dernier recours, jamais un critère (32,9 % du référentiel n'a aucune commune)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "required": false,
            "in": "query",
            "description": "Défaut et plafond : 20",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Licence-Uuid",
            "in": "header",
            "description": "UUID de la licence — alternative au JWT (service local de la borne)",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Propriétés `matches` (PractitionerRef + lieu), `strategy`, `reason`"
          },
          "400": {
            "description": "Aucun critère exploitable (rppsId ou lastName requis)"
          },
          "401": {
            "description": "Authentification manquante ou invalide"
          }
        },
        "summary": "Recherche un prescripteur dans le référentiel RPPS public (RPPS prioritaire, nom en repli, commune en discriminant seulement)",
        "tags": [
          "Prescriber"
        ]
      }
    },
    "/api/prescriber/browse/{userSessionKey}": {
      "get": {
        "operationId": "PrescriberController_browse",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "description": "JWT token utilisateur",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "rppsId",
            "required": false,
            "in": "query",
            "description": "RPPS, même partiel (début de numéro)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lastName",
            "required": false,
            "in": "query",
            "description": "Début du nom (casse/accents indifférents)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "firstName",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "town",
            "required": false,
            "in": "query",
            "description": "Début de la commune",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "professionCode",
            "required": false,
            "in": "query",
            "description": "10 · 40 · 50",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "required": false,
            "in": "query",
            "description": "À partir de 1",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "pageSize",
            "required": false,
            "in": "query",
            "description": "Défaut 25, plafond 100",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "`rows`, `total`, `totalIsCapped`, `page`, `pageSize`, `referentialReady`"
          },
          "401": {
            "description": "Token invalide ou expiré"
          },
          "403": {
            "description": "Réservé au superadmin"
          }
        },
        "summary": "CONSULTATION paginée du référentiel RPPS — page Prescripteurs de l'admin. SUPERADMIN uniquement (référentiel GLOBAL, partagé par toutes les licences).",
        "tags": [
          "Prescriber"
        ]
      }
    },
    "/api/prescriber/status/{userSessionKey}": {
      "get": {
        "operationId": "PrescriberController_status",
        "parameters": [
          {
            "name": "userSessionKey",
            "required": true,
            "in": "path",
            "description": "JWT token utilisateur — mettre '-' pour s'authentifier par X-Licence-Uuid",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "x-licence-uuid",
            "required": true,
            "in": "header",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Licence-Uuid",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Propriétés `ready` (false = import jamais passé, distinct de « aucun résultat »), `count`, `extractionDate`, `attribution`"
          }
        },
        "summary": "État du référentiel RPPS : peuplé ou non, date de l'extraction ANS, dernier import",
        "tags": [
          "Prescriber"
        ]
      }
    },
    "/api/prescription-ai/health": {
      "get": {
        "operationId": "PrescriptionAiController_health",
        "parameters": [],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "État de l'analyse IA (sans appel Azure, donc sans coût)",
        "tags": [
          "PrescriptionAi"
        ]
      }
    },
    "/api/prescription-ai/analyzeDocument": {
      "post": {
        "operationId": "PrescriptionAiController_analyzeDocument",
        "parameters": [
          {
            "name": "refresh",
            "required": true,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "documentId",
            "required": true,
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Analyse (status ok) — forme du service local"
          },
          "401": {
            "description": "Borne non authentifiée"
          },
          "404": {
            "description": "Document absent ou inexploitable (file-not-found)"
          },
          "500": {
            "description": "not-configured · ai-failed · ai-unreadable"
          }
        },
        "summary": "Analyse IA d'une ordonnance fournie en base64 (mini-borne) — même contrat que POST /analyzeDocument du service local tools/prescription-ai",
        "tags": [
          "PrescriptionAi"
        ]
      }
    },
    "/api/patient/invite/{token}": {
      "get": {
        "operationId": "FastLanePatientController_getState",
        "parameters": [
          {
            "name": "X-Invite-Session",
            "in": "header",
            "description": "JWT de session rendu par open (identité, complétion)",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "token",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "{ status, appointmentStartDate, appointmentLabel, center }"
          },
          "404": {
            "description": "Invitation inconnue"
          }
        },
        "summary": "État public d’une invitation (statut, date du RDV, centre) — aucune donnée patient",
        "tags": [
          "Patient"
        ]
      }
    },
    "/api/patient/invite/{token}/open": {
      "post": {
        "operationId": "FastLanePatientController_open",
        "parameters": [
          {
            "name": "X-Invite-Session",
            "in": "header",
            "description": "JWT de session rendu par open (identité, complétion)",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "token",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "dateOfBirth"
                ],
                "properties": {
                  "dateOfBirth": {
                    "type": "string",
                    "description": "DD/MM/YYYY ou YYYY-MM-DD"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "InviteOpenResult"
          },
          "404": {
            "description": "Invitation inconnue, RDV disparu ou naissance fausse (indifférencié)"
          },
          "429": {
            "description": "Trop de tentatives (par IP ou par invitation)"
          }
        },
        "summary": "Ouvrir l’invitation par date de naissance → session + RDV + étapes",
        "tags": [
          "Patient"
        ]
      }
    },
    "/api/patient/invite/{token}/identity": {
      "get": {
        "operationId": "FastLanePatientController_identityForm",
        "parameters": [
          {
            "name": "X-Invite-Session",
            "in": "header",
            "description": "JWT de session rendu par open (identité, complétion)",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "token",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "x-invite-session",
            "required": true,
            "in": "header",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "{ fields: [{ key, required, value }] }"
          },
          "401": {
            "description": "Session absente ou invalide"
          }
        },
        "summary": "Formulaire d’identité : champs affichés / obligatoires selon la conf « Détails du rendez-vous », valeurs courantes",
        "tags": [
          "Patient"
        ]
      },
      "post": {
        "operationId": "FastLanePatientController_identity",
        "parameters": [
          {
            "name": "X-Invite-Session",
            "in": "header",
            "description": "JWT de session rendu par open (identité, complétion)",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "token",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "x-invite-session",
            "required": true,
            "in": "header",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "patient": {
                    "type": "object",
                    "description": "Champs du formulaire (liste fermée : firstName, lastName, email, mobilePhone, addressLine1, addressLine2, zipCode, city, heightCm, weightKg) ; null = effacer",
                    "additionalProperties": {
                      "type": "string",
                      "nullable": true
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "{ appointment, steps }"
          },
          "401": {
            "description": "Session absente ou invalide"
          }
        },
        "summary": "Étape identité : confirmer (corps vide) ou corriger les champs du formulaire",
        "tags": [
          "Patient"
        ]
      }
    },
    "/api/patient/invite/{token}/complete": {
      "post": {
        "operationId": "FastLanePatientController_complete",
        "parameters": [
          {
            "name": "X-Invite-Session",
            "in": "header",
            "description": "JWT de session rendu par open (identité, complétion)",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "token",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "x-invite-session",
            "required": true,
            "in": "header",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "{ complete: true, qr: { payload }, wallet }"
          },
          "401": {
            "description": "Session absente ou invalide"
          },
          "409": {
            "description": "{ complete: false, steps } — dossier encore incomplet"
          }
        },
        "summary": "Compléter : revérification en direct, QR généré une fois, email du QR",
        "tags": [
          "Patient"
        ]
      }
    },
    "/api/patient/invite/{token}/resend-qr": {
      "post": {
        "operationId": "FastLanePatientController_resendQr",
        "parameters": [
          {
            "name": "X-Invite-Session",
            "in": "header",
            "description": "JWT de session rendu par open (identité, complétion)",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "token",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "x-invite-session",
            "required": true,
            "in": "header",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "{ sent } — false si aucune adresse connue chez l’éditeur"
          },
          "401": {
            "description": "Session absente ou invalide"
          },
          "409": {
            "description": "Dossier non complété"
          },
          "429": {
            "description": "Trop tôt depuis le dernier envoi ({ retryAfterSeconds })"
          }
        },
        "summary": "Renvoyer le QR par email (dossier déjà complet, lien rouvert)",
        "tags": [
          "Patient"
        ]
      }
    },
    "/api/kioskFastLane/status/{appointmentId}": {
      "get": {
        "operationId": "FastLaneKioskController_status",
        "parameters": [
          {
            "name": "X-Kiosk-Auth-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Kiosk-Device-Id",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "appointmentId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "{ complete }"
          }
        },
        "summary": "Le dossier de ce RDV est-il préparé (file rapide complétée, valable aujourd’hui) ?",
        "tags": [
          "KioskFastLane"
        ]
      }
    },
    "/api/kioskFastLane/resolve/{code}": {
      "get": {
        "operationId": "FastLaneKioskController_resolve",
        "parameters": [
          {
            "name": "X-Kiosk-Auth-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Kiosk-Device-Id",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "code",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "{ contractAppointmentId, startDate, completedAt }"
          },
          "404": {
            "description": "QR inconnu (ou d’une autre licence)"
          },
          "409": {
            "description": "{ reason: not_completed | expired | not_today }"
          }
        },
        "summary": "Résoudre un QR file rapide (code sans le préfixe APB1:, ou payload complet)",
        "tags": [
          "KioskFastLane"
        ]
      }
    },
    "/fast-lane/licences/{licenceId}/run-now": {
      "post": {
        "operationId": "runFastLaneNow",
        "parameters": [
          {
            "name": "licenceId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "force": {
                    "type": "boolean",
                    "description": "Renvoyer même aux patients déjà invités pour cet offset"
                  },
                  "today": {
                    "type": "boolean",
                    "description": "Inviter les RDV DU JOUR (offset 0) au lieu des jours de rappel — test de bout en bout"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Bilan de la passe (compteurs, raison d’ignorance éventuelle)"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Lancer maintenant la passe d’invitation file rapide d’une licence (test superadmin)",
        "tags": [
          "FastLane"
        ]
      }
    },
    "/assistant/status": {
      "get": {
        "description": "`enabled: false` quand ASSISTANT_ENABLED est vide ou que la clé du fournisseur manque : la page admin affiche alors l'écran « désactivé », aucun appel LLM n'est fait.",
        "operationId": "AssistantController_status",
        "parameters": [],
        "responses": {
          "200": {
            "description": "{ enabled, provider, model, quota, limits }"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "État de l'assistant (activé, fournisseur, modèle, quota du jour)",
        "tags": [
          "Assistant"
        ]
      }
    },
    "/assistant/sessions": {
      "get": {
        "operationId": "AssistantController_listSessions",
        "parameters": [],
        "responses": {
          "400": {
            "description": "Superadmin sans licence active"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Conversations de l'utilisateur sur la licence active (100 max, plus récentes d'abord)",
        "tags": [
          "Assistant"
        ]
      },
      "post": {
        "operationId": "AssistantController_createSession",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "mode": {
                    "type": "string",
                    "enum": [
                      "diagnostic",
                      "feature_request"
                    ],
                    "default": "diagnostic"
                  },
                  "title": {
                    "type": "string",
                    "nullable": true
                  },
                  "language": {
                    "type": "string",
                    "enum": [
                      "fr",
                      "en",
                      "es",
                      "it"
                    ],
                    "default": "fr"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Session créée"
          },
          "409": {
            "description": "Limite de conversations atteinte"
          },
          "503": {
            "description": "Assistant désactivé"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Nouvelle conversation (30 actives max par utilisateur et licence ⇒ 409)",
        "tags": [
          "Assistant"
        ]
      }
    },
    "/assistant/sessions/{id}/messages": {
      "get": {
        "operationId": "AssistantController_getMessages",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "limit",
            "required": false,
            "in": "query",
            "description": "Défaut 50, max 200",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "before",
            "required": false,
            "in": "query",
            "description": "Id de message : ne renvoie que les plus anciens",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "{ messages, hasMore }"
          },
          "404": {
            "description": "Conversation introuvable (ou pas la vôtre)"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Messages d'une conversation (ordre chronologique, pagination vers le passé par `before`)",
        "tags": [
          "Assistant"
        ]
      },
      "post": {
        "description": "Réponse `text/event-stream` : `meta` {sessionId, userMessageId, provider, model} · `token` {text} · `tool_start` {name} · `tool_end` {name, ok} · `confirm_required` {confirmId, toolName, preview, expiresAt} (écriture en attente de la décision de l’utilisateur : POST sessions/:id/confirm) · `done` {message, session, usage, aborted} · `error` {message}. Statuts avant le flux : 400 (message vide ou > 5000 caractères, superadmin sans licence), 404 (conversation), 429 (20 messages / 5 min ou plafond quotidien), 503 (assistant désactivé). Fermer la connexion interrompt le tour ; la réponse partielle est conservée (`aborted: true`).",
        "operationId": "AssistantController_sendMessage",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "content"
                ],
                "properties": {
                  "content": {
                    "type": "string",
                    "maxLength": 5000
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Flux SSE"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Envoyer un message et recevoir la réponse en flux SSE",
        "tags": [
          "Assistant"
        ]
      }
    },
    "/assistant/sessions/{id}": {
      "patch": {
        "operationId": "AssistantController_renameSession",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "title"
                ],
                "properties": {
                  "title": {
                    "type": "string"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Renommer une conversation",
        "tags": [
          "Assistant"
        ]
      },
      "delete": {
        "operationId": "AssistantController_deleteSession",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Supprimer une conversation et ses messages",
        "tags": [
          "Assistant"
        ]
      }
    },
    "/assistant/sessions/{id}/files": {
      "post": {
        "description": "Le contenu est stocké EN BASE, cloisonné par licence et par utilisateur, et purgé avec la conversation — jamais dans la médiathèque S3, qui est publique. Il n'est relisible que par `GET sessions/:id/files/:fileId`, authentifié.",
        "operationId": "AssistantController_saveFile",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "fileName",
                  "contentType",
                  "base64Data"
                ],
                "properties": {
                  "fileName": {
                    "type": "string",
                    "example": "checkins-semaine.pdf"
                  },
                  "contentType": {
                    "type": "string",
                    "example": "application/pdf"
                  },
                  "base64Data": {
                    "type": "string",
                    "description": "Contenu encodé base64 (≤ 5 Mo décodés)"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Déposer un fichier produit pour cette conversation (export, rapport)",
        "tags": [
          "Assistant"
        ]
      }
    },
    "/assistant/sessions/{id}/files/{fileId}": {
      "get": {
        "description": "Réservé à l'auteur de la conversation, dans sa licence. Aucun accès anonyme, aucune URL publique : le client admin appelle cette route en Bearer et enregistre le blob reçu.",
        "operationId": "AssistantController_downloadFile",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "fileId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Contenu binaire du fichier"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Télécharger un fichier produit par Vigie",
        "tags": [
          "Assistant"
        ]
      }
    },
    "/assistant/sessions/{id}/confirm": {
      "post": {
        "description": "`accept: true` ⇒ le serveur rejoue le tool avec `confirm: true` sous l’identité de l’admin (mode « demande de fonctionnalité » : save_feature_request) ; `accept: false` ⇒ rien n’est écrit. Un message assistant trace le résultat dans la conversation. 404 si la confirmation est inconnue, expirée (15 min) ou déjà traitée.",
        "operationId": "AssistantController_confirm",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "confirmId",
                  "accept"
                ],
                "properties": {
                  "confirmId": {
                    "type": "string"
                  },
                  "accept": {
                    "type": "boolean"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Décision de l'utilisateur sur une écriture en attente (event SSE confirm_required)",
        "tags": [
          "Assistant"
        ]
      }
    }
  },
  "info": {
    "title": "API ApiBorne",
    "description": "API de gestion des utilisateurs, licences et authentification",
    "version": "1.0",
    "contact": {}
  },
  "tags": [],
  "servers": [],
  "components": {
    "securitySchemes": {
      "bearer": {
        "scheme": "bearer",
        "bearerFormat": "JWT",
        "type": "http"
      }
    },
    "schemas": {
      "XKioskDeviceDto": {
        "type": "object",
        "properties": {}
      },
      "XKioskConfigDto": {
        "type": "object",
        "properties": {
          "KioskReactorSetting": {
            "type": "object",
            "description": "Bloc KioskReactorSetting (feuilles camelCase)"
          },
          "KioskReactorSettingFeatures": {
            "type": "object"
          },
          "KioskReactorSettingMessages": {
            "type": "object"
          },
          "KioskReactorSettingPrinterCodes": {
            "type": "object"
          },
          "KioskReactorSettingCheckinAppointmentDetail": {
            "type": "object",
            "description": "Détail check-in global (officePlaceId null)"
          },
          "KioskReactorSettingCheckinAppointmentDetails": {
            "description": "Détails check-in par lieu du device",
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "KioskReactorDirectAdmissionSetting": {
            "type": "object"
          },
          "KioskReactorSettingDisplay": {
            "type": "object"
          },
          "KioskReactorSettingPatientInfoBookingOptions": {
            "type": "object"
          },
          "KioskReactorSettingRequestMessages": {
            "description": "Messages de demande guichet par lieu (requestMessageModel)",
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "KioskReactorSettingWrongPlaceMessageDetails": {
            "description": "Messages « mauvais lieu » par lieu (wrongPlaceMessageModel)",
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "KioskReactorSettingPatientLateAnomalies": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "KioskReactorSettingPatientAgeAnomalies": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "KioskReactorSettingRequiredDocumentLabels": {
            "description": "XKioskRequiredDocumentLabel[] (PascalCase : AppointmentFileType, CustomLabel, AvailableOnPhone, CameraProfile — clé ApiBorne : profil caméra du scan, null = défaut de la borne — et QuestionEnabled, QuestionHtml, QuestionYesBehavior, QuestionNoBehavior, QuestionYesAnomalyId, QuestionNoAnomalyId, QuestionConfirmRequired — clés ApiBorne : question oui/non posée avant le scan, dont la réponse peut valoir fourniture du document ; comportements `validate` ou `scan`, null = `scan`)",
            "type": "array",
            "items": {
              "type": "object"
            }
          }
        },
        "required": [
          "KioskReactorSetting",
          "KioskReactorSettingFeatures",
          "KioskReactorSettingMessages",
          "KioskReactorSettingPrinterCodes",
          "KioskReactorSettingCheckinAppointmentDetail",
          "KioskReactorSettingCheckinAppointmentDetails",
          "KioskReactorDirectAdmissionSetting",
          "KioskReactorSettingDisplay",
          "KioskReactorSettingPatientInfoBookingOptions",
          "KioskReactorSettingRequestMessages",
          "KioskReactorSettingWrongPlaceMessageDetails",
          "KioskReactorSettingPatientLateAnomalies",
          "KioskReactorSettingPatientAgeAnomalies",
          "KioskReactorSettingRequiredDocumentLabels"
        ]
      },
      "XKioskAnomalyByExternalIdDto": {
        "type": "object",
        "properties": {
          "Global": {
            "type": "boolean",
            "description": "Anomalie commune (non liée à une licence)"
          },
          "Description": {
            "type": "string",
            "nullable": true
          },
          "Name": {
            "type": "string"
          },
          "Color": {
            "type": "string",
            "nullable": true
          },
          "Code": {
            "type": "string",
            "nullable": true,
            "description": "Code métier vendor-neutral (ex 'DI', 'PR')"
          },
          "Id": {
            "type": "number"
          },
          "KeepForAppointment": {
            "type": "boolean"
          }
        },
        "required": [
          "Global",
          "Name",
          "Id",
          "KeepForAppointment"
        ]
      },
      "XKioskDeviceInfoDto": {
        "type": "object",
        "properties": {
          "kioskDevice": {
            "$ref": "#/components/schemas/XKioskDeviceDto"
          },
          "kioskConfig": {
            "nullable": true,
            "description": "null si la licence du device n’a pas de KioskReactorSetting",
            "allOf": [
              {
                "$ref": "#/components/schemas/XKioskConfigDto"
              }
            ]
          },
          "kioskAnomalies": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/XKioskAnomalyByExternalIdDto"
            }
          },
          "kioskDeskRequestReasons": {
            "description": "Motifs de requête guichet (clé ApiBorne, absente de la réponse EasyDoct) — champs PascalCase legacy (Id, Name, Description, PrintTicket, OfficePlaceIds…), ordonnés par la chaîne Previous/Next",
            "type": "array",
            "items": {
              "type": "object"
            }
          }
        },
        "required": [
          "kioskDevice",
          "kioskAnomalies"
        ]
      },
      "GetKioskDeviceByExternalIdResultDto": {
        "type": "object",
        "properties": {
          "kioskDeviceInfo": {
            "$ref": "#/components/schemas/XKioskDeviceInfoDto"
          }
        }
      },
      "PassUsageContextDto": {
        "type": "object",
        "properties": {
          "officeVisibleId": {
            "type": "string",
            "description": "VisibleId du centre (le ?office= du QR, = « ID Cabinet Visible » de la page Intégration). CLÉ D'ATTRIBUTION : le serveur en dérive la licence, ce qui permet à un build unique du Pass de servir tout le parc."
          },
          "officePlaceVisibleId": {
            "type": "string",
            "description": "VisibleId du lieu déclaré par le Pass"
          },
          "officePlaceName": {
            "type": "string",
            "description": "Nom lisible du lieu (le &title= du QR) — DÉCLARATIF, pour l'affichage seulement : il n'identifie ni ne cloisonne rien."
          },
          "lang": {
            "type": "string",
            "description": "Langue de l'interface (ex. fr)"
          },
          "sessionKey": {
            "type": "string",
            "description": "Uuid aléatoire tronqué à 8 caractères — compte des sessions distinctes, ne chaîne pas un parcours"
          },
          "simulated": {
            "type": "boolean",
            "description": "Session de test (?simulate) — exclue des stats par défaut"
          }
        }
      },
      "PassUsageEventDto": {
        "type": "object",
        "properties": {
          "eventType": {
            "type": "string",
            "description": "Type d'événement ; hors registre serveur, l'événement est ignoré SILENCIEUSEMENT",
            "example": "pass_app_open"
          },
          "occurredAt": {
            "type": "string",
            "description": "Horodatage ISO de l'émission ; hors de [now − 2 h, now + 5 min] il est remplacé par now (horloges mobiles déréglées)"
          },
          "detail": {
            "type": "object",
            "description": "Métadonnées de l'événement — reprojetées sur la liste blanche du serveur. Jamais de donnée patient.",
            "additionalProperties": true
          },
          "timespanMs": {
            "type": "number",
            "description": "Durée en millisecondes (champ `timespan`)"
          }
        },
        "required": [
          "eventType"
        ]
      },
      "PassUsageEventsDto": {
        "type": "object",
        "properties": {
          "context": {
            "$ref": "#/components/schemas/PassUsageContextDto"
          },
          "events": {
            "description": "Lot d'événements — tronqué à 20 au-delà",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PassUsageEventDto"
            }
          }
        },
        "required": [
          "events"
        ]
      }
    }
  }
}