Technique · Manager technique
Vue du manager technique
L’API est rapide ; c’est sa forme qui coûte. Aucune rupture de contrat sur ce que l’application consomme, mais 12 problèmes bloquants sur 68 relevés, et une documentation qui ne décrit pas le comportement réel.
Chemins de la spécification consommés
61 à 62
sur 94
Opérations sans champ requis déclaré
41 sur 107 (38 %)
alors que l’API valide strictement
Problèmes bloquants relevés
12
sur 68 problèmes, 11 groupes de workflows
Rupture de contrat sur un endpoint consommé
0 rupture
contrôle automatisé à chaque mise à jour
État de l’API
Les faits mesurés, puis les problèmes par workflow : rouge bloquant, orange majeur, jaune moyen.
Mesures
- Spécification en ligne
- OpenAPI 3.0.1, v4 : 94 chemins, 107 opérations, 165 schémas
- Chemins réellement consommés par l'application
- 61 à 62 (67 fonctions HTTP : 33
GET, 27POST, 3PUT, 2PATCH, 2DELETE) - Chemins consommés absents de la spécification
- 0 (la surface est déclarée)
- Opérations dont le corps de requête déclare
required: [] - 41 sur 107 (38 %) alors que l'API valide strictement
- Opérations déclarant un
400 - 13 seulement ; les refus de saisie sortent en
500 - Réponses déclarées
*/* - 9 (dont un devis qui renvoie du JSON et quatre endpoints photo qui renvoient du binaire)
- Enveloppes d'erreur distinctes observées
- 5, avec trois formats d'horodatage
- Formats de dates coexistants
- 5, dont un compact
AAAAMMJJpropre à un seul endpoint - Enveloppes de pagination
- 2 (page Spring complète / page réduite), base d'index non uniforme (0 ou 1 selon l'endpoint)
- Latence mesurée
- Devis 31 à 94 ms, connexion 277 ms : l'API est rapide, c'est sa forme qui coûte
- Contrôle de dérive du contrat sur les endpoints consommés
- 0 rupture (contrôle rejoué à chaque mise à jour backend et en intégration continue)
- Coût côté application de l'écart API ↔ besoins
- Client HTTP écrit à la main (1 968 lignes, le générateur de code n'a jamais pu être exécuté) + couche d'anti-corruption de 4 051 lignes d'adaptateurs et 2 762 lignes de tests, soit environ 66 lignes de traduction par endpoint
Problèmes par workflow
Légende : 🔴 bloquant · 🟠 majeur · 🟡 moyen · ⚪ mineur. Les références renvoient aux tickets de la Partie 3. Les problèmes résolus depuis l'édition précédente (reconduction de session, code MFA, OTP à usage unique, UTF-8, documents utiles, plafond de téléversement, personnes à charge, bulletin d'adhésion, confirmation du paiement à la livraison, création Accident en groupe) ont été rejoués en réel et sont sortis de ces tableaux ; ils figurent en section 3.0.
| Groupe | Bloquant | Majeur | Moyen | Mineur | Total |
|---|---|---|---|---|---|
| Authentification | |||||
| Accueil | |||||
| Dashboard | |||||
| Compte | |||||
| Menu | |||||
| Souscription | |||||
| Paiement | |||||
| Contrats | |||||
| Sinistres | |||||
| Remboursements | |||||
| Santé Individuelle · Santé Famille · Santé Groupe | |||||
| Total (+ 7 transverses) | 12 | 20 | 31 | 5 | 68 |
| Sévérité | Endpoint | Problème observé | Réf. |
|---|---|---|---|
| Authentification | |||
| Bloquant | POST /auth/otp | Le code OTP n'a pas toujours six chiffres : entier rendu sans remplissage à gauche, un code sur dix a cinq chiffres ; l'écran attend six chiffres, donc inscription, mot de passe oublié et défi MFA sont bloqués pour ces clients | N13#82(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Bloquant | POST /auth/otp/validate | Seul l'OTP e-mail est contrôlé ; l'OTP téléphone est envoyé, collecté et jamais vérifié ; POST /auth/otp par numéro de téléphone répond 404 | P0-D#2(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Majeur | POST /users puis POST /auth/login | La politique de mot de passe n'est pas appliquée à la création : un mot de passe accepté par POST /users est refusé en 419 CHANGE_PASSWORD à la première connexion | A18#65(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Majeur | POST /auth/otp | Répond 409 « Code generated déja » pendant les 15 minutes de validité du code précédent : aucun renvoi de code possible pour l'utilisateur qui n'a pas reçu son e-mail | A20#67(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Majeur | POST /auth/otp/validate | Un code vide expose une SQLGrammarException Hibernate dans le message | A21#68(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Majeur | POST /auth/login | Codes 419 (changement de mot de passe imposé) et 420 (MFA) hors RFC ; le jeton porteur du défi arrive sans champ status ; la connexion est rejetée si un JWT périmé est attaché | P2.2#30(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Majeur | JWT client | Le jeton d'un simple assuré porte 19 rôles, dont des périmètres de back-office ; au moins un est inerte sur cette passerelle (affichage-swagger : /api-docs répond 403). Pas d'élévation prouvée, mais un jeton qui n'est pas au moindre privilège | A12#60(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Moyen | POST /auth/attach | Contrat non confirmé, déclencheur inconnu, cas d'échec et idempotence non documentés : 9 questions transmises, sans réponse ; checkuser: true observé sur un compte de test, candidat signal de compte migré | Q1-Q9#71(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Moyen | PATCH /auth/password · GET /auth/password-policy | L'endpoint de politique répond (anonyme, quatre règles en français) mais reste absent de la spécification et non structuré ; le refus 419 ne nomme pas la règle violée | Documentation à compléter |
| Mineur | POST /auth/mfa/verify | Code erroné → 401, comme un jeton absent : un client ne distingue plus « mauvais code » de « défi expiré » | N4#75(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Mineur | POST /auth/otp/validate | Le jeton est renvoyé avec le préfixe Bearer dans la valeur ; e-mail émis par notification_sinistre@amana.dz avec une coquille dans le sujet | A24#70(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Accueil | |||
| Majeur | GET /notifications/unread-count | 404 : une page de 50 notifications est chargée dans 4 écrans uniquement pour compter les non-lus | P3.2#43(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Moyen | GET /notifications | Aucune catégorie exposée et icon ne suit pas le sujet : la famille (contrats, remboursements, sinistres) est déduite du préfixe de l'identifiant | N6#77(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Moyen | GET /produits · GET /tarifs | Aucun prix minimum sur la liste des produits : un appel /tarifs par produit, soit un N+1 imposé à l'accueil ; /tarifs sans codeProduit répond 200 [] au lieu de 400 | P3.9#44(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Moyen | GET /produits/{id}/detail | Charge la plus riche de l'API, sans aucun schéma dans la spécification ; prix pré-formaté en chaîne, décisions de présentation (isBest, recommandee) prises côté serveur | P2.7#40(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Moyen | Environnement | Purge de la pré-production sans préavis : les contrats de recette antérieurs ont disparu en cours de tests ; une purge est annoncée avant la production | N2#74(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Dashboard | |||
| Moyen | GET /contrats · /refunds · /claims | Deux enveloppes de pagination ; base d'index 0 ou 1 selon l'endpoint ; /claims répond encore 500 sans page ; la spécification documente encore l'enveloppe retirée | P2.4#33(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Moyen | GET /contrats | Aucun numéro de police ; ordre de tri et politique d'exclusion non confirmés ; limitation à 1 000 éléments | P3.15#46(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Moyen | GET /refunds | Aucun champ de catégorie d'acte (type porte la ligne de produit) ; état Retour non documenté | N41#88(ticket dans l’outil de ticketing, nouvelle fenêtre), Q6#93(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Moyen | GET /refunds/{id} | Renvoie le même objet plat que la liste, sans enrichissement | — |
| Compte | |||
| Bloquant | DELETE /ayantDroits/{id}/demandeSuppression | 500 page blanche sur le chemin nominal, ayant droit du compte et multipart bien formé ; aucune des parties de la spécification ne change la réponse ; l'ayant droit n'est pas affecté | N9#79(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Bloquant | PUT /members | Remplacement d'enregistrement complet et non mise à jour partielle ; bloc questionnaire nommé questionnaire et non bonneSanteQuestion ; réponses en chaînes « Oui »/« Non » et non en booléens ; validation (téléphone 10 chiffres, code postal 5 chiffres, ville, date d'entrée en service) documentée nulle part | P0-F#18(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Majeur | PUT /beneficiaries/updateTaux | Total des parts imposé à 100 %, non documenté ; le compte de test porte 10 % + 19 %, donc aucune répartition ne peut y être enregistrée | P1-F#26(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Majeur | POST /beneficiaries | Seule la date compacte AAAAMMJJ est acceptée alors que la lecture renvoie JJ/MM/AAAA ; énumérations LienParenteEnum et SexeEnum fermées et non publiées ; sexe et telephone exigés par le validateur puis relus à null | N10#80(ticket dans l’outil de ticketing, nouvelle fenêtre)P2.13#32(ticket dans l’outil de ticketing, nouvelle fenêtre)P1-G#27(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Majeur | POST /ayantDroits | Fonctionne avec la notation indexée ayantsDroits[0].… ; corps à plat → 500 sans message ; format de date différent de POST /beneficiaries ; sexe sensible à l'accent, sans liste des valeurs admises | N36#85(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Majeur | GET …/members/dependents/{id}/photo · PUT /ayantDroits/{id}/demandeChangementPhoto | La partie photo de POST /ayantDroits est acceptée puis jetée ; le GET répond 404 ou 500, le PUT 500 | N37#86(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Moyen | GET /auth/me | DTO plat de 5 champs déclaré, réponse de 18 champs et 4 objets imbriqués ; nom/prenom vides à la racine ; un compte de test n'expose ni personneId ni bloc souscripteur alors que /auth/login les renvoie | P2.1#31(ticket dans l’outil de ticketing, nouvelle fenêtre)P1-J#25(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Moyen | GET /users/photo | Binaire image/png exigeant l'en-tête Authorization : impossible à donner à un composant image, converti en data: URI côté application | — |
| Moyen | DELETE /ayantDroits/{id}/demandeSuppression | Corps multipart déclaré sans aucun champ ; aucun état de demande exposé ensuite | P3.19#47(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Menu | |||
| Moyen | GET /a-propos-amana/sos · /documents · /actes/groups · /garanties/{code} · /contrats | accept-language ignoré : contenu en français dans l'application arabe (SOS, documents, actes, garanties, libellés de contrat) ; /sos mêle une ligne de prose à une liste de numéros | P3.16#49(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Moyen | POST /nousContacter | 500 « Required part 'nom' is not present » sur champ manquant (attendu 400) ; champs multipart non déclarés ; enveloppe de réponse propre à cet endpoint | P2.6#37(ticket dans l’outil de ticketing, nouvelle fenêtre)P2.10#42(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Moyen | GET /garanties/{codeProduit} | Valeurs par formule là où le modèle attend une valeur unique ; la fiche produit Santé renvoie guarantees: [] et force le repli | P3.6#48(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Moyen | GET /a-propos-amana/actualites | Pas d'endpoint de détail : le détail réutilise la charge de la liste | — |
| Mineur | GET /documents/download | Livré et vérifié sur les 23 documents ; aucun id par document, 500 au lieu de 400 quand path est absent | — |
| Souscription | |||
| Bloquant | POST /souscriptions/voyage | A répondu 201 success: true avec un contratId qui répond ensuite 404 (V8b) ; création en trois appels non transactionnels (/personnes/assure → /souscriptions/voyage → /personnes/membre-assure), rattacher un membre à un contrat inexistant → 500 (V8c) ; souscripteurId déclaré requis mais ignoré par le serveur | P1-A#20(ticket dans l’outil de ticketing, nouvelle fenêtre)P1-B#21(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Majeur | POST /simulation-voyage | Champs déclarés obligatoires ignorés : age omis → 200 avec un prix plausible mais faux ; dateEffet/dateFin absents → 500 (V5) ; prime Famille plafonnée au 7ᵉ voyageur (V13) ; effectif Groupe sous le seuil de 10 → 500 nu, indiscernable d'une panne (les primes négatives, elles, ont disparu) | N5#76(ticket dans l’outil de ticketing, nouvelle fenêtre)P1-C#22(ticket dans l’outil de ticketing, nouvelle fenêtre)P1-D#23(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Majeur | POST /souscriptions (Scolaire, Accident, Santé) | Durée de couverture imposée (Scolaire 364–366 j, Accident 30 j, Santé 365–366 j) découverte par un 409 « Tarifs invalide » ; le backend recalcule la prime Santé et ignore le montant transmis ; nombreMembres désigne les ayants droit et non les personnes ; réponse de 6 blocs dont 5 sans lecteur ; coupon inconnu → 404 en Santé mais ignoré en silence hors santé | Codes promotionnels de test demandés |
| Majeur | /tarifs · quittance | Sur l'Accident, totalMontant porte la prime nette quand les trois autres produits portent la prime brute : l'écran de succès annonce 710 quand la quittance encaisse 1 770 ; une prime nette négative compensée par les frais a été observée sur le Scolaire | N29#83(ticket dans l’outil de ticketing, nouvelle fenêtre), Q2#90(ticket dans l’outil de ticketing, nouvelle fenêtre), Q5#92(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Majeur | Aucune idempotence | Un double appui ou un rejeu réseau crée un second contrat ; aucune compensation (DELETE) sur un contrat non payé | A11#59(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Moyen | POST /personnes/assure · GET /professions | profession en texte libre ; 354 professions non triées | P2.11#34(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Moyen | Montants | Primes en flottants à 13 décimales (16164.146341463415), reduction: false alors que les variantes avec et sans réduction diffèrent | A13#61(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Paiement | |||
| Bloquant | POST /modePaiement/CIB (returnUrl) | Après le 3-D Secure, la passerelle redirige vers le site vitrine et non vers le lien profond de l'application ; la page de test est au nom d'un marchand tiers ; formUrl: null avec errorCode: 0 a été observé | P0-M#5(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Bloquant | GET /modePaiement/confirmPayment/{orderId} | valid: false, tous champs nuls, sur un contrat encaissé ; l'encaissement côté serveur suit le retour de Satim de dix à trente minutes (contrat encore NON PAYE dix minutes après le paiement) : aucune attente côté application ne couvre ce délai | P0-N#6(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Bloquant | GET /points-verts/paiement/{quittanceId} | Débite les points et encaisse le contrat en quatre secondes, puis répond 500 « Erreur lors de la construction du DTO » ; un second appel répond 500 sans redébiter ; 404 sur quittance inconnue livré ; toujours un GET pour une opération qui modifie l'état | P0-B#7(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Majeur | POST /modePaiement/DAHABIA | Fonctionne jusqu'à la page de paiement, sur l'hôte confirmé par le client ; jamais réglé faute de cartes de test | CL-DAHABIA |
| Majeur | /modePaiement/* | Aucune idempotence sur des écritures d'argent ; nom de champ dépendant du résultat (code_reference / codeReference) | A11#59(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Moyen | POST /modePaiement/livraison | Une demande avec adresse et téléphone vides est acceptée | N31#84(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Mineur | confirmPayment/livraison/{quittanceId} | Livré et vérifié | — |
| Contrats | |||
| Bloquant | POST /avenant/resiliation | 500 pour toute entrée, corps vide compris : le chemin amont /scolaire-espace-client/resiliation/annuler-contrat/ est appelé sans identifiant, la requête n'est jamais lue ; justificatif en base64 là où tout le reste est multipart ; motifId sans énumération ; chemin de service interne divulgué | N11#81(ticket dans l’outil de ticketing, nouvelle fenêtre)P3.17#54(ticket dans l’outil de ticketing, nouvelle fenêtre)P3.18#55(ticket dans l’outil de ticketing, nouvelle fenêtre)A15#62(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Majeur | POST /voyages/{contratId}/report | 500 « Cannot format given Object as a Date » sur contrat inexistant comme sur dateDebut absente ; seul JJ/MM/AAAA est accepté | N7#78(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Moyen | GET /contrats/{id} | Ni personnes assurées, ni libellé du moyen de paiement, ni valeur par garantie : second appel GET /coverages/{produitId} à chaque ouverture | P3.5#53(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Moyen | GET /contrats/{id}/documents | 404 même avec un identifiant réel | P3.4#52(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Moyen | POST /carteFlash/checkTicketValidation | statut vaut la chaîne "false" : booléen déguisé sous un nom d'énumération ; cartes Flash de test demandées | — |
| Sinistres | |||
| Bloquant | POST /claims | 500 pour toute valeur de produit (Attempt to read property "produit_sinistre_id" on null), y compris la valeur exacte rendue par GET /claims ; parties en camelCase mais erreurs rapportées en snake_case ; dateSinistre en ISO quand les deux autres dates sont en JJ/MM/AAAA | N38#87(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Bloquant | GET /chat/history · POST /chat/send | Aucun paramètre de dossier : un seul fil par client, affiché sous chaque sinistre ; updatedAt déclaré mais absent ; POST /chat/read sans objet sur un fil unique | P3.12#11(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Moyen | GET /claims | Répond encore 500 sans page ; enveloppe migrée sans mise à jour de la spécification | P2.4#33(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Remboursements | |||
| Majeur | POST /refunds | Plafond de téléversement relevé à 4 Mio ; le refus au-delà reste un 500 « Maximum upload size exceeded » sans nom de pièce ni limite ; champs multipart non déclarés | P2.6#37(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Moyen | GET /actes/groups | Ni catégorie, ni illustration ; codeActe non unique (8 prestations sociales partagent Evenement) : la classification est déduite côté mobile | P3.1#56(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Moyen | GET /refunds | Aucune catégorie d'acte : tout sinistre santé inconnu s'affiche « Consultation » ; état Retour non documenté | N41#88(ticket dans l’outil de ticketing, nouvelle fenêtre), Q6#93(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Moyen | GET /refunds/{id}/documents | Régression 200 → 404 relevée par le contrôle automatisé (endpoint non consommé) | P3.11#57(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Santé Individuelle · Santé Famille · Santé Groupe | |||
| Bloquant | POST /members/addPieceJointe | Contrat livré : six parties liées (rib, justificatif_rib, bulletin_adhesion, fiche_familiale, attestation_ouverture_droit, non_affiliation_conjoint) ; rib et justificatif_rib sont exigés à chaque appel, ce qui bloque le renvoi ultérieur du bulletin signé ; le chemin POST /addPieceJointeList/{adherent_id} cité par l'équipe backend n'existe pas | P0-J#13(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Majeur | POST /avenants/{id}/renouvellements/sante/devis | 409 « problem devis Renouvellement Sante » sur tout payload (6 contrats, 2 types, toutes les variantes) | P1-H#28(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Majeur | POST /avenants/{id}/adjonctions/sante/devis | Champ error typé int alors que le service amont renvoie la chaîne "409 :" : la passerelle plante sur sa propre gestion d'erreur et répond 500 | P1-I#29(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Moyen | POST /members/validation | Le drapeau declare n'est pas lu (false produit le même effet que true) | P2.12#38(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Moyen | POST /souscriptions/devis-souscription-sante | Ne prend pas en compte destination, durée ou âge (n'est pas un devis Voyage) ; montants en flottants non arrondis | A13#61(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Moyen | GET /members | /members/bulletinSoins renvoie un PDF en base64 dans du JSON ; aucun champ ne dit qu'un profil santé est finalisé ni qu'un adhérent est « hors Amana » | Q1#89(ticket dans l’outil de ticketing, nouvelle fenêtre) |
| Moyen | Types de contrat | Seuls 530 (Individuel) et 531 (Famille) existent : aucun niveau Groupe pour la Santé | — |
| Mineur | GET /members/bulletinAdhesion | Livré et vérifié ; téléchargement à câbler côté application | — |
Risques
Ce que ces problèmes ont coûté au projet, et ce qui peut encore se produire.
Conséquences
- Sur les délais : aucun sprint d'intégration API n'a pu s'exécuter sur des endpoints validés ; les endpoints manquants ont été livrés après la fin du sprint qui devait les consommer ; la validation du paiement carte a attendu 51 jours une instance de test exploitable. Le détail chiffré est en section 2.3.
- Sur les livrables : les 48 workflows sont livrés, mais 11 ne sont pas validables sans correction serveur, et une quinzaine fonctionnent grâce à un contournement côté application qui devra être retiré.
- Sur les workflows : chaque endpoint a dû être vérifié en conditions réelles avant d'être codé, ce qui est plus lent par construction, et c'est la seule méthode qui a évité de découvrir les défauts en recette ou en production. Codés d'après la documentation, l'enregistrement du profil santé et la déclaration de remboursement auraient échoué à 100 % ; les deux opérations destructrices, jouées pour la première fois sur le compte jetable, échouent toutes deux côté serveur.
- Sur la confiance : l'application a dû cesser de croire les réponses de succès du serveur et relire l'état réel après chaque écriture sensible ; chaque correctif annoncé est rejoué en réel avant d'être considéré livré.
Risques et mitigation
| Risque | Probabilité | Gravité | Workflow(s) | Mitigation |
|---|---|---|---|---|
| Un client paie par carte, voit un écran d'échec ou reste sur le site vitrine, et paie une seconde fois | Certaine sans correctif : l'encaissement suit la passerelle de dix à trente minutes | Bloquant | Paiement CIB | Relecture du contrat pendant 45 s, message d'échec reformulé ; returnUrl et état intermédiaire d'encaissement à traiter côté passerelle |
| Un client paie en Points verts et croit n'avoir rien payé | Certaine tant que l'appel répond 500 | Bloquant | Paiement Points verts | Relecture du contrat après le 500 envisagée côté application ; réponse 200 attendue côté serveur |
| Un assuré ne peut ni déclarer un sinistre, ni résilier un contrat, ni retirer un ayant droit | Certaine | Bloquant | Sinistres, Contrats, Compte – Profil santé | Correction serveur uniquement ; l'application affiche désormais le refus au lieu d'un succès |
| Un nouvel utilisateur sur dix ne peut ni s'inscrire ni récupérer son mot de passe | Certaine tant que le code OTP n'a pas une longueur fixe | Bloquant | Authentification | Saisie de 4 à 6 chiffres côté application en attendant ; longueur fixe côté serveur |
| Contrat créé deux fois (double appui, rejeu réseau) ou contrat partiel (coupure au 3ᵉ appel) | Possible | Majeur | Souscription | Création au consentement (pas au clic de paiement) et garde de relecture ; idempotence et atomicité à traiter côté serveur |
| Trois voyageurs sur dix assurés gratuitement | Certaine tant que non tranché | Majeur | Souscription Voyage | Décision métier A2 |
| Un montant affiché différent du montant encaissé | Certaine sur l'Accident | Majeur | Souscription Accident | Question Q2#90(ticket dans l’outil de ticketing, nouvelle fenêtre) ; le détail de contrat lit désormais la quittance |
| Régression silencieuse à chaque mise à jour backend (renommage et purge sans préavis déjà survenus) | Élevée | Majeur | Tous | yarn api:contract en intégration continue ; préavis exigé |
| Refus des stores : suppression de compte absente, politique de confidentialité et CGU sans URL, permissions inutiles déclarées | Élevée sans action | Majeur | Transverse | Endpoint de suppression de compte ; URLs juridiques ; permissions retirées avant la soumission |
| Chaque correctif après publication passe par la revue des stores (aucune mise à jour à distance) | Certaine | Moyen | Tous | Décision sur les mises à jour à distance avant la version 1.0 ; déploiement progressif et revue accélérée |
| Panne d'un endpoint bloquant un écran composite | Moyenne | Moyen | Accueil, Espace santé, Mon espace | Dégradation ciblée livrée sur l'accueil ; en-tête sécurisé sur 53 écrans ; remontée des plantages en place |
| Comptes migrés jamais branchés | Élevée sans réponse | Moyen | Authentification – Connexion | 9 questions transmises ; branchement de quelques lignes une fois le déclencheur connu |
Causes des décalages
Des faits datés : la porte de qualité non franchie, les causes racines, le glissement sprint par sprint et le plan d’action.
Le fait générateur : l’API devait être validée avant l’intégration
Le planning du client organise le projet en phases successives. La phase 3, « Tests et validation API », prévoit que Amana envoie les endpoints de chaque sprint et que SHIFTIN les teste et les valide, entre le 15/03/2026 et le 30/04/2026. La phase 4, « Intégration API », ne devait commencer qu'ensuite, le 25/05/2026, sur des endpoints validés. C'est une porte de qualité explicite : aucun sprint d'intégration ne devait démarrer sur des endpoints non validés.
Cette porte n'a pas été franchie. Le planning client lui-même porte les verdicts :
| Lot de la phase 3 | Envoi des endpoints planifié | Validation planifiée | Verdict porté au planning |
|---|---|---|---|
| Onboarding, authentification, navigation, accueil, dashboard | 15/03/2026 | 18/03/2026 | ✅ Validé |
| Sinistres hors santé, profil, paramètres, menu | 23/03/2026 | 29–30/03/2026 | ✅ Validé |
| Paiement, Souscriptions voyage | 30/03/2026 | 01/04/2026 | 🔴 « Paiement : Validé — Voyage : 3 rounds – toujours pas validé ! » |
| Compte, Sinistres santé (remboursements) | 06/04/2026 | 13/04/2026 | 🔴 « Compte : 3 rounds – toujours pas validé ! — Voyage : 3 rounds – toujours pas validé ! » |
| Souscriptions scolaire et accident, contrats hors santé, carte Flash | 13/04/2026 | 19–20/04/2026 | aucun verdict porté |
| Santé individuelle, famille, groupe | 20/04/2026 et 26/04/2026 | 26/04/2026 et 29–30/04/2026 | aucun verdict porté |
Aucune de ces mentions n'a été levée avant l'été. L'intégration a donc démarré sur des endpoints non validés, puis sur des endpoints inexistants. Ce n'est pas un choix d'organisation : maintenir l'équipe à l'arrêt jusqu'à validation aurait coûté quatre mois de calendrier. Le coût réel de ce contournement est mesurable : c'est la totalité des reprises et des contournements documentés en section 2.2.
Causes racines, par impact décroissant
1. Des endpoints livrés après la fin du sprint qui devait les consommer.
Ce n'est pas une question de délai de correction (la plupart des correctifs backend ont été livrés en un à deux jours, ce qui est rapide) mais de séquencement : aucune vélocité d'équipe ne compense un composant absent.
1. Des endpoints livrés après la fin du sprint qui devait les consommer. Dépendance Date planifiée Date réelle Écart Validation des endpoints Voyage 01/04/2026 jamais prononcée — Mise en ligne de POST /simulation-voyage(le devis Voyage n'existait pas ; réponse backend du 03/08 : « concernant voyage une api est manquante »)implicite au 30/03/2026 03/08/2026 + 124 jours Devis Voyage branché en réel fin du Sprint 2 API, 20/07/2026 17/08/2026 + 28 jours Création de contrat Voyage ( POST /souscriptions/voyagene créait aucun contrat jusqu'au correctif)20/07/2026 18/08/2026 + 29 jours Endpoint de contenu produit ( /produits/{id}/detail)avant le Sprint 2 API livré le 23/07/2026 sur la base d'un fichier de référence rédigé par l'équipe mobile le 13/07 10 jours de fiche produit en statique Devis Santé ( 404« Problème lors de l'appel API Ticket »)Sprint 3 API réglé le 03/08/2026 + 8 jours PUT /members(405 METHOD_NOT_ALLOWED)Sprint 3 API résolu le 04/08/2026 + 7 jours POST /members/addPieceJointeannoncé prêt le 09/08/2026 contrat livré le 26/09/2026 ; renvoi du bulletin signé encore bloqué + 48 jours Confirmation du paiement à la livraison décrite par le backend le 30/07/2026 livrée et vérifiée le 22/09/2026 + 54 jours Reconduction de session ( POST /auth/refresh)— corrigée et vérifiée le 22/09/2026 — Déclaration de sinistre ( POST /claims)Sprint 3 API toujours en 500au 26/09/2026ouvert Résiliation ( POST /avenant/resiliation)Sprint 3 API 500pour toute entrée, mesuré le 24/09/2026 et revérifié le 26/09/2026ouvert 2. La dépendance la plus longue : la passerelle de paiement.
2. La dépendance la plus longue : la passerelle de paiement. Jalon Date Cartes CIB de test reçues 16/07/2026 Cartes Dahabia demandées 16/07/2026 — jamais transmises Signalement : l'instance Satim de test est celle d'un tiers, aucune carte ne fonctionne 26/07/2026 Proposition d'un simulateur backend à deux scénarios (succès, échec) 26/07/2026 — non retenue Première page de paiement réellement obtenue (Dahabia) 19/08/2026 Nouvelles cartes CIB transmises par le client 09/09/2026 Premier paiement carte encaissé de bout en bout (contrat passé à ENCAISSE, police émise)16/09/2026, soit 51 jours après le signalement Les quatre tunnels règlent un vrai paiement en exécution automatisée 17/09/2026 Encaissement serveur mesuré dix à trente minutes après le retour de Satim (contrat encore « non payé » dix minutes après le paiement) 26/09/2026 Paiement Points verts : débit et encaissement en quatre secondes, réponse 50027/09/2026 Le paiement est la dernière étape de tout parcours d'achat : son indisponibilité a interdit de déclarer un seul produit « validé » pendant toute cette période, alors que les quatre étaient câblés. Depuis, c'est le délai d'encaissement côté serveur qui empêche de présenter un paiement carte comme réussi au moment où il l'est.
3. Une documentation d'API qui ne décrit pas le comportement réel.
38 % des opérations déclarent tous leurs champs optionnels alors que l'API valide strictement ; des champs déclarés obligatoires sont ignorés à l'exécution ; des champs non déclarés provoquent un
500; une réponse décrite comme du texte transporte du JSON ; un typeintegerlà où l'implémentation attend un tableau ; la spécification documente le champ retiré dePOST /refundset omet celui qui fonctionne. La demande transverse du 27/07/2026 (fournir un exemple de requête fonctionnelle par endpoint de création) n'a jamais reçu de réponse. La conséquence est structurelle : chaque endpoint doit être vérifié en conditions réelles avant d'être codé.4. Un succès applicatif qui ne garantit pas que l'opération a eu lieu.
Sur la seule semaine du 17 au 19/08/2026 : un contrat annoncé créé mais inexistant, une page de paiement annoncée disponible mais vide, une prime tarifée sur des paramètres incomplets et renvoyée sans avertissement. Puis, le 16/09/2026, un paiement encaissé que l'endpoint de confirmation déclare non valide ; le 26/09/2026, un paiement carte encore « non payé » dix minutes après le retour de la passerelle ; le 27/09/2026, un paiement Points verts encaissé en quatre secondes que l'appel déclare en erreur interne. Cette classe de défaut impose de ne faire confiance à aucune réponse et d'ajouter une relecture de contrôle après chaque écriture.
5. Des règles métier découvertes par l'essai plutôt que par la spécification.
Durée de couverture imposée (Scolaire 364–366 jours, Accident 30 jours) révélée par un
409 « Tarifs invalide »le 23/07/2026 ;nombreMembresdésignant les ayants droit ; convention tarifaire obligatoire pour la Famille Voyage ; recalcul silencieux de la prime Santé le 26/08/2026 ; règle dutypeContratIdpar nombre d'assurés communiquée le 20/07/2026 après six questions écrites.6. Un environnement de pré-production incomplet.
Passerelle de paiement inexploitable du 16/07 au 16/09/2026, aucun code promo valide, solde de points insuffisant, compte de test avec des données invalides au regard des règles du backend lui-même, incident de 30 minutes le 27/08/2026 sans cause identifiée (22 endpoints en régression), groupe GitLab passé en lecture seule le 19/08/2026, purge des contrats de recette sans préavis le 23/09/2026 en pleine tests. Aucun de ces points n'est bloquant isolément ; ensemble, ils rendent impossible la validation de ce qui est câblé.
Décalage sprint par sprint
| Sprint | Fin planifiée (Planning V2) | Fin effective du câblage | Écart | Blocage déterminant |
|---|---|---|---|---|
| S1 — Authentification | 07/07/2026 | 10/09/2026 ; session reconduite depuis le 22/09/2026 | + 65 jours | Priorisation des produits d'abord ; puis contrat POST /users erroné (500), absence de vérification serveur de l'OTP téléphone, quatre défauts bloquants corrigés le 10/09 ; code OTP à cinq chiffres mesuré le 24/09/2026 |
| S2 — Souscription hors santé | 20/07/2026 | 23/07/2026 pour le Scolaire ; Accident groupe vérifié le 22/09/2026 | quelques jours | POST /souscriptions à corps vide (21/07), 409 groupe et « Tarifs invalide » (23/07) |
| S2 — Moyens de paiement | 20/07/2026 | 17/09/2026 pour le paiement carte ; confirmation livraison vérifiée le 22/09/2026 ; Points verts partiellement corrigé le 27/09/2026 (débit puis 500) ; Dahabia non clos | + 59 jours | Satim indisponible 51 jours ; /points-verts/paiement en 500 depuis le 20/07 ; encaissement carte différé de dix à trente minutes mesuré le 26/09 ; cartes Dahabia jamais reçues |
| S3 — Voyage | 13/08/2026 | 18/08/2026 (souscription), 19/08/2026 (paiement) | + 5 jours | V8 (aucun contrat créé), V8b (succès sur échec), V11 (formules non identifiables, refus puis livraison le 19/08 après argumentation) |
| S3 — Contrats (résiliation) | 13/08/2026 | non clos | ouvert | Résiliation en 500 pour toute entrée, mesurée le 24/09/2026 et revérifiée le 26/09/2026 |
| S3 — Sinistres | 13/08/2026 | déclaration non déposable | ouvert | Référentiel produit non exposé, découvert le 16/09/2026 ; endpoint toujours en 500 le 26/09/2026 |
| S4 / S5 — Santé | 05/08/2026 | 26/08/2026 | + 21 jours | Devis Santé en 404 jusqu'au 03/08, PUT /members en 405 jusqu'au 04/08 |
| S4 / S5 — Compléter profil santé | 05/08/2026 | personnes à charge et bulletin rétablis le 26/09/2026 ; renvoi du bulletin signé non clos | ouvert | Dépôt des pièces sans réponse exploitable du 09/08 au 26/09/2026 ; addPieceJointe exige encore le RIB à chaque appel |
Plan d’action
Le plan est organisé par chantiers de blocage et non plus par sprint (section 1.4). Les lots ci-dessous restent la clé de lecture des tickets de la Partie 3 ; chaque lot est rattaché à son chantier.
API cible
L’API dont l’application a besoin, écrite pour l’équipe backend : les chemins qui fonctionnent sont conservés, ce qui doit changer est dit opération par opération avec les tickets concernés, et ce qui manque est ajouté. Simulable avant d’exister.
Une spécification OpenAPI, opération par opération
Opérations décrites
106
spécification v1.0.0-cible
Identiques à l’API actuelle
14
chemin et forme conservés
À corriger
77
chemin conservé, forme ou comportement à aligner
Manquantes
15
suppression de compte, pièces, statuts, préférences…
Chaque opération porte son état actuel et ses tickets ; chaque description commence par l’écart avec l’API actuelle. Une seule enveloppe d’erreur, des identifiants en camelCase, des dates ISO, une seule forme de pagination. Le guide de lecture explique comment ouvrir la spécification, lancer un serveur de simulation et y brancher l’application.
Rejouer les requêtes de l’application
L’API cible décrit ce qui est attendu ; cette collection rejoue ce que l’application envoie aujourd’hui, sans l’application : ses 83 requêtes, dans leur forme exacte. Le dossier des lectures et devis ne crée, ne paie et n’envoie rien et peut être lancé après chaque déploiement ; le dossier des écritures se lance requête par requête, sur un compte de recette. Elle s’importe dans Postman, Insomnia ou Bruno (Import → Link avec les liens ci-dessous) et s’exécute en ligne de commande avec newman.