Broulala
Broulala transcrit de l'audio et, à partir du texte obtenu, produit un document selon un template. Elle est appelée par des systèmes clients — une clé d'API par intégration — et ne connaît jamais les utilisateurs finaux de ces systèmes.
Les documents ci-dessous sont autonomes : ils s'ouvrent hors ligne, ne chargent rien, et disent pourquoi autant que comment.
Les deux portes et le mur entre elles, les six frontières, le parcours complet d'un cours de sa réception à sa suppression, le tunnel vers la machine louée, la capacité et le bail qui expire — et ce qui n'arrive jamais.
pour qui veut comprendre la plateformeCe qu'un système client doit respecter pour se connecter : l'authentification, l'envoi d'un média en tus, la création d'un job, ce qu'une réponse porte, la capacité et le mode dégradé, les codes d'erreur et les limites. C'est la source de vérité de l'implémentation — la page est engendrée depuis le contrat lui-même, jamais recopiée.
pour qui implémente contre l'APIUne intégration réelle, de bout en bout, avec les charges utiles telles qu'elles circulent : la frontière entre les deux systèmes, les identifiants de chaque côté, le webhook qui ne porte rien, et ce que le client garde de chaque échange.
pour qui écrit une intégrationUne revue complète du back, du front, des conteneurs et des dépendances : ce qui tient et pourquoi, ce qui reste à reprendre et ce que ça coûte, classé par criticité et suivi d'un plan d'action priorisé. Chaque constat est vérifié dans le code ou mesuré ; ce qui n'a pas pu être établi est une question, pas une supposition.
pour qui décide de ce qu'on répare d'abord