Aller au contenu
My Amana · ReportingDirection, manager technique, tickets

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, 27 POST, 3 PUT, 2 PATCH, 2 DELETE)
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 AAAAMMJJ propre à 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.

Problèmes relevés, par groupe de workflows et par sévéritécliquer une cellule filtre le tableau ci-dessous
Nombre de problèmes par groupe et par sévérité
GroupeBloquantMajeurMoyenMineurTotal
Authentification
Accueil
Dashboard
Compte
Menu
Souscription
Paiement
Contrats
Sinistres
Remboursements
Santé Individuelle · Santé Famille · Santé Groupe
Total (+ 7 transverses)122031568
68 problèmes
Analyse des problèmes techniques identifiés, par workflow
SévéritéEndpointProblème observéRéf.
Authentification
BloquantPOST /auth/otpLe 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 clientsN13#82(ticket dans l’outil de ticketing, nouvelle fenêtre)
BloquantPOST /auth/otp/validateSeul 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 404P0-D#2(ticket dans l’outil de ticketing, nouvelle fenêtre)
MajeurPOST /users puis POST /auth/loginLa 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 connexionA18#65(ticket dans l’outil de ticketing, nouvelle fenêtre)
MajeurPOST /auth/otpRé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-mailA20#67(ticket dans l’outil de ticketing, nouvelle fenêtre)
MajeurPOST /auth/otp/validateUn code vide expose une SQLGrammarException Hibernate dans le messageA21#68(ticket dans l’outil de ticketing, nouvelle fenêtre)
MajeurPOST /auth/loginCodes 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)
MajeurJWT clientLe 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ègeA12#60(ticket dans l’outil de ticketing, nouvelle fenêtre)
MoyenPOST /auth/attachContrat 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)
MoyenPATCH /auth/password · GET /auth/password-policyL'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éeDocumentation à compléter
MineurPOST /auth/mfa/verifyCode 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)
MineurPOST /auth/otp/validateLe jeton est renvoyé avec le préfixe Bearer dans la valeur ; e-mail émis par notification_sinistre@amana.dz avec une coquille dans le sujetA24#70(ticket dans l’outil de ticketing, nouvelle fenêtre)
Accueil
MajeurGET /notifications/unread-count404 : une page de 50 notifications est chargée dans 4 écrans uniquement pour compter les non-lusP3.2#43(ticket dans l’outil de ticketing, nouvelle fenêtre)
MoyenGET /notificationsAucune catégorie exposée et icon ne suit pas le sujet : la famille (contrats, remboursements, sinistres) est déduite du préfixe de l'identifiantN6#77(ticket dans l’outil de ticketing, nouvelle fenêtre)
MoyenGET /produits · GET /tarifsAucun 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 400P3.9#44(ticket dans l’outil de ticketing, nouvelle fenêtre)
MoyenGET /produits/{id}/detailCharge 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é serveurP2.7#40(ticket dans l’outil de ticketing, nouvelle fenêtre)
MoyenEnvironnementPurge 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 productionN2#74(ticket dans l’outil de ticketing, nouvelle fenêtre)
Dashboard
MoyenGET /contrats · /refunds · /claimsDeux 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éeP2.4#33(ticket dans l’outil de ticketing, nouvelle fenêtre)
MoyenGET /contratsAucun numéro de police ; ordre de tri et politique d'exclusion non confirmés ; limitation à 1 000 élémentsP3.15#46(ticket dans l’outil de ticketing, nouvelle fenêtre)
MoyenGET /refundsAucun 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)
MoyenGET /refunds/{id}Renvoie le même objet plat que la liste, sans enrichissement—
Compte
BloquantDELETE /ayantDroits/{id}/demandeSuppression500 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)
BloquantPUT /membersRemplacement 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 partP0-F#18(ticket dans l’outil de ticketing, nouvelle fenêtre)
MajeurPUT /beneficiaries/updateTauxTotal des parts imposé à 100 %, non documenté ; le compte de test porte 10 % + 19 %, donc aucune répartition ne peut y être enregistréeP1-F#26(ticket dans l’outil de ticketing, nouvelle fenêtre)
MajeurPOST /beneficiariesSeule 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 à nullN10#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)
MajeurPOST /ayantDroitsFonctionne 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 admisesN36#85(ticket dans l’outil de ticketing, nouvelle fenêtre)
MajeurGET …/members/dependents/{id}/photo · PUT /ayantDroits/{id}/demandeChangementPhotoLa partie photo de POST /ayantDroits est acceptée puis jetée ; le GET répond 404 ou 500, le PUT 500N37#86(ticket dans l’outil de ticketing, nouvelle fenêtre)
MoyenGET /auth/meDTO 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 renvoieP2.1#31(ticket dans l’outil de ticketing, nouvelle fenêtre)P1-J#25(ticket dans l’outil de ticketing, nouvelle fenêtre)
MoyenGET /users/photoBinaire image/png exigeant l'en-tête Authorization : impossible à donner à un composant image, converti en data: URI côté application—
MoyenDELETE /ayantDroits/{id}/demandeSuppressionCorps multipart déclaré sans aucun champ ; aucun état de demande exposé ensuiteP3.19#47(ticket dans l’outil de ticketing, nouvelle fenêtre)
Menu
MoyenGET /a-propos-amana/sos · /documents · /actes/groups · /garanties/{code} · /contratsaccept-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érosP3.16#49(ticket dans l’outil de ticketing, nouvelle fenêtre)
MoyenPOST /nousContacter500 « Required part 'nom' is not present » sur champ manquant (attendu 400) ; champs multipart non déclarés ; enveloppe de réponse propre à cet endpointP2.6#37(ticket dans l’outil de ticketing, nouvelle fenêtre)P2.10#42(ticket dans l’outil de ticketing, nouvelle fenêtre)
MoyenGET /garanties/{codeProduit}Valeurs par formule là où le modèle attend une valeur unique ; la fiche produit Santé renvoie guarantees: [] et force le repliP3.6#48(ticket dans l’outil de ticketing, nouvelle fenêtre)
MoyenGET /a-propos-amana/actualitesPas d'endpoint de détail : le détail réutilise la charge de la liste—
MineurGET /documents/downloadLivré et vérifié sur les 23 documents ; aucun id par document, 500 au lieu de 400 quand path est absent—
Souscription
BloquantPOST /souscriptions/voyageA 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 serveurP1-A#20(ticket dans l’outil de ticketing, nouvelle fenêtre)P1-B#21(ticket dans l’outil de ticketing, nouvelle fenêtre)
MajeurPOST /simulation-voyageChamps 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)
MajeurPOST /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 · quittanceSur 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 ScolaireN29#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)
MajeurAucune idempotenceUn 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)
MoyenPOST /personnes/assure · GET /professionsprofession en texte libre ; 354 professions non triéesP2.11#34(ticket dans l’outil de ticketing, nouvelle fenêtre)
MoyenMontantsPrimes en flottants à 13 décimales (16164.146341463415), reduction: false alors que les variantes avec et sans réduction diffèrentA13#61(ticket dans l’outil de ticketing, nouvelle fenêtre)
Paiement
BloquantPOST /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)
BloquantGET /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élaiP0-N#6(ticket dans l’outil de ticketing, nouvelle fenêtre)
BloquantGET /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'étatP0-B#7(ticket dans l’outil de ticketing, nouvelle fenêtre)
MajeurPOST /modePaiement/DAHABIAFonctionne jusqu'à la page de paiement, sur l'hôte confirmé par le client ; jamais réglé faute de cartes de testCL-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)
MoyenPOST /modePaiement/livraisonUne demande avec adresse et téléphone vides est acceptéeN31#84(ticket dans l’outil de ticketing, nouvelle fenêtre)
MineurconfirmPayment/livraison/{quittanceId}Livré et vérifié—
Contrats
BloquantPOST /avenant/resiliation500 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)
MajeurPOST /voyages/{contratId}/report500 « 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)
MoyenGET /contrats/{id}Ni personnes assurées, ni libellé du moyen de paiement, ni valeur par garantie : second appel GET /coverages/{produitId} à chaque ouvertureP3.5#53(ticket dans l’outil de ticketing, nouvelle fenêtre)
MoyenGET /contrats/{id}/documents404 même avec un identifiant réelP3.4#52(ticket dans l’outil de ticketing, nouvelle fenêtre)
MoyenPOST /carteFlash/checkTicketValidationstatut vaut la chaîne "false" : booléen déguisé sous un nom d'énumération ; cartes Flash de test demandées—
Sinistres
BloquantPOST /claims500 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/AAAAN38#87(ticket dans l’outil de ticketing, nouvelle fenêtre)
BloquantGET /chat/history · POST /chat/sendAucun 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 uniqueP3.12#11(ticket dans l’outil de ticketing, nouvelle fenêtre)
MoyenGET /claimsRépond encore 500 sans page ; enveloppe migrée sans mise à jour de la spécificationP2.4#33(ticket dans l’outil de ticketing, nouvelle fenêtre)
Remboursements
MajeurPOST /refundsPlafond 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ésP2.6#37(ticket dans l’outil de ticketing, nouvelle fenêtre)
MoyenGET /actes/groupsNi catégorie, ni illustration ; codeActe non unique (8 prestations sociales partagent Evenement) : la classification est déduite côté mobileP3.1#56(ticket dans l’outil de ticketing, nouvelle fenêtre)
MoyenGET /refundsAucune 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)
MoyenGET /refunds/{id}/documentsRé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
BloquantPOST /members/addPieceJointeContrat 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 pasP0-J#13(ticket dans l’outil de ticketing, nouvelle fenêtre)
MajeurPOST /avenants/{id}/renouvellements/sante/devis409 « 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)
MajeurPOST /avenants/{id}/adjonctions/sante/devisChamp 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 500P1-I#29(ticket dans l’outil de ticketing, nouvelle fenêtre)
MoyenPOST /members/validationLe 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)
MoyenPOST /souscriptions/devis-souscription-santeNe prend pas en compte destination, durée ou âge (n'est pas un devis Voyage) ; montants en flottants non arrondisA13#61(ticket dans l’outil de ticketing, nouvelle fenêtre)
MoyenGET /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)
MoyenTypes de contratSeuls 530 (Individuel) et 531 (Famille) existent : aucun niveau Groupe pour la Santé—
MineurGET /members/bulletinAdhesionLivré 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

Risques techniques associés
RisqueProbabilitéGravitéWorkflow(s)Mitigation
Un client paie par carte, voit un écran d'échec ou reste sur le site vitrine, et paie une seconde foisCertaine sans correctif : l'encaissement suit la passerelle de dix à trente minutesBloquantPaiement CIBRelecture 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 500BloquantPaiement Points vertsRelecture 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 droitCertaineBloquantSinistres, 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 passeCertaine tant que le code OTP n'a pas une longueur fixeBloquantAuthentificationSaisie 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)PossibleMajeurSouscriptionCré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 gratuitementCertaine tant que non tranchéMajeurSouscription VoyageDécision métier A2
Un montant affiché différent du montant encaisséCertaine sur l'AccidentMajeurSouscription AccidentQuestion 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éeMajeurTousyarn 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 actionMajeurTransverseEndpoint 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)CertaineMoyenTousDé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 compositeMoyenneMoyenAccueil, Espace santé, Mon espaceDé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éponseMoyenAuthentification – Connexion9 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.

Cette section est écrite pour être lue avec l'équipe backend. Elle ne met pas en cause sa réactivité : la plupart des correctifs demandés ont été livrés en un à deux jours, et plusieurs points ont été résolus le jour même. Elle établit des faits datés sur ce qui a été livré, quand, et dans quel état, parce que c'est le seul moyen de reconstruire un planning que les deux équipes peuvent tenir.

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 :

Verdicts de la phase 3 portés au planning client
Lot de la phase 3Envoi des endpoints planifiéValidation planifiéeVerdict porté au planning
Onboarding, authentification, navigation, accueil, dashboard15/03/202618/03/2026✅ Validé
Sinistres hors santé, profil, paramètres, menu23/03/202629–30/03/2026✅ Validé
Paiement, Souscriptions voyage30/03/202601/04/2026🔴 « Paiement : Validé — Voyage : 3 rounds – toujours pas validé ! »
Compte, Sinistres santé (remboursements)06/04/202613/04/2026🔴 « Compte : 3 rounds – toujours pas validé ! — Voyage : 3 rounds – toujours pas validé ! »
Souscriptions scolaire et accident, contrats hors santé, carte Flash13/04/202619–20/04/2026aucun verdict porté
Santé individuelle, famille, groupe20/04/2026 et 26/04/202626/04/2026 et 29–30/04/2026aucun 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. 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épendanceDate planifiéeDate réelleÉcart
    Validation des endpoints Voyage01/04/2026jamais 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/202603/08/2026+ 124 jours
    Devis Voyage branché en réelfin du Sprint 2 API, 20/07/202617/08/2026+ 28 jours
    Création de contrat Voyage (POST /souscriptions/voyage ne créait aucun contrat jusqu'au correctif)20/07/202618/08/2026+ 29 jours
    Endpoint de contenu produit (/produits/{id}/detail)avant le Sprint 2 APIlivré le 23/07/2026 sur la base d'un fichier de référence rédigé par l'équipe mobile le 13/0710 jours de fiche produit en statique
    Devis Santé (404 « Problème lors de l'appel API Ticket »)Sprint 3 APIréglé le 03/08/2026+ 8 jours
    PUT /members (405 METHOD_NOT_ALLOWED)Sprint 3 APIrésolu le 04/08/2026+ 7 jours
    POST /members/addPieceJointeannoncé prêt le 09/08/2026contrat livré le 26/09/2026 ; renvoi du bulletin signé encore bloqué+ 48 jours
    Confirmation du paiement à la livraisondécrite par le backend le 30/07/2026livré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 APItoujours en 500 au 26/09/2026ouvert
    Résiliation (POST /avenant/resiliation)Sprint 3 API500 pour toute entrée, mesuré le 24/09/2026 et revérifié le 26/09/2026ouvert
  2. 2. La dépendance la plus longue : la passerelle de paiement.

    2. La dépendance la plus longue : la passerelle de paiement.
    JalonDate
    Cartes CIB de test reçues16/07/2026
    Cartes Dahabia demandées16/07/2026 — jamais transmises
    Signalement : l'instance Satim de test est celle d'un tiers, aucune carte ne fonctionne26/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 client09/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ée17/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
  3. 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.

  4. 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 type integer là où l'implémentation attend un tableau ; la spécification documente le champ retiré de POST /refunds et 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é.

  5. 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.

  6. 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 ; nombreMembres désignant les ayants droit ; convention tarifaire obligatoire pour la Famille Voyage ; recalcul silencieux de la prime Santé le 26/08/2026 ; règle du typeContratId par nombre d'assurés communiquée le 20/07/2026 après six questions écrites.

  7. 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

Décalage par sprint
SprintFin planifiée (Planning V2)Fin effective du câblageÉcartBlocage déterminant
S1 — Authentification07/07/202610/09/2026 ; session reconduite depuis le 22/09/2026+ 65 joursPriorisation 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/202623/07/2026 pour le Scolaire ; Accident groupe vérifié le 22/09/2026quelques joursPOST /souscriptions à corps vide (21/07), 409 groupe et « Tarifs invalide » (23/07)
S2 — Moyens de paiement20/07/202617/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 joursSatim 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 — Voyage13/08/202618/08/2026 (souscription), 19/08/2026 (paiement)+ 5 joursV8 (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/2026non closouvertRésiliation en 500 pour toute entrée, mesurée le 24/09/2026 et revérifiée le 26/09/2026
S3 — Sinistres13/08/2026déclaration non déposableouvertRéférentiel produit non exposé, découvert le 16/09/2026 ; endpoint toujours en 500 le 26/09/2026
S4 / S5 — Santé05/08/202626/08/2026+ 21 joursDevis Santé en 404 jusqu'au 03/08, PUT /members en 405 jusqu'au 04/08
S4 / S5 — Compléter profil santé05/08/2026personnes à charge et bulletin rétablis le 26/09/2026 ; renvoi du bulletin signé non closouvertDépôt des pièces sans réponse exploitable du 09/08 au 26/09/2026 ; addPieceJointe exige encore le RIB à chaque appel
Le report global se concentre sur les phases 4 (Intégration API) et 5 (Q&A). L'intégration statique, dont l'équipe mobile est seule maîtresse, a été livrée à 100 % conformément au plan : les cinq lots de la phase 2 sont marqués achevés dans le planning client.

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.

Plan d’action par lot
LotChantierContenuResponsable
Lot 1 — Débloquer la validation1 et 2P0-M#5(ticket dans l’outil de ticketing, nouvelle fenêtre), P0-N#6(ticket dans l’outil de ticketing, nouvelle fenêtre), P0-B#7(ticket dans l’outil de ticketing, nouvelle fenêtre) (paiement), N13#82(ticket dans l’outil de ticketing, nouvelle fenêtre) (code OTP), P1-D#23(ticket dans l’outil de ticketing, nouvelle fenêtre) (décision A2), P0-D#2(ticket dans l’outil de ticketing, nouvelle fenêtre) (décision A1), N29#83(ticket dans l’outil de ticketing, nouvelle fenêtre) et Q2#90(ticket dans l’outil de ticketing, nouvelle fenêtre) (montant Accident)Backend, Amana
Lot 2 — Débloquer les fonctions inopérantes3N38#87(ticket dans l’outil de ticketing, nouvelle fenêtre) (POST /claims), N11#81(ticket dans l’outil de ticketing, nouvelle fenêtre) (résiliation), N9#79(ticket dans l’outil de ticketing, nouvelle fenêtre) (retrait d'ayant droit), P0-J#13(ticket dans l’outil de ticketing, nouvelle fenêtre) (bulletin signé), N37#86(ticket dans l’outil de ticketing, nouvelle fenêtre) (photo), P1-F#26(ticket dans l’outil de ticketing, nouvelle fenêtre), P1-G#27(ticket dans l’outil de ticketing, nouvelle fenêtre), P3.17#54(ticket dans l’outil de ticketing, nouvelle fenêtre), P3.12#11(ticket dans l’outil de ticketing, nouvelle fenêtre) (décision A3)Backend, Produit
Lot 3 — Arbitrages produitTransverseA3 (chat), Q1#89(ticket dans l’outil de ticketing, nouvelle fenêtre) (tiers payant hors Amana), Q4#91(ticket dans l’outil de ticketing, nouvelle fenêtre) (carte tiers-payant), Q7#94(ticket dans l’outil de ticketing, nouvelle fenêtre) (faux succès), Q1-Q9#71(ticket dans l’outil de ticketing, nouvelle fenêtre) (comptes migrés)Amana, Produit
Lot 4 — Fiabiliser le contratTransverseP0-F#18(ticket dans l’outil de ticketing, nouvelle fenêtre), P1-A#20(ticket dans l’outil de ticketing, nouvelle fenêtre) / P1-B#21(ticket dans l’outil de ticketing, nouvelle fenêtre) / P1-C#22(ticket dans l’outil de ticketing, nouvelle fenêtre), P1-J#25(ticket dans l’outil de ticketing, nouvelle fenêtre), N5#76(ticket dans l’outil de ticketing, nouvelle fenêtre), N7#78(ticket dans l’outil de ticketing, nouvelle fenêtre), N10#80(ticket dans l’outil de ticketing, nouvelle fenêtre), N31#84(ticket dans l’outil de ticketing, nouvelle fenêtre), N36#85(ticket dans l’outil de ticketing, nouvelle fenêtre), A18#65(ticket dans l’outil de ticketing, nouvelle fenêtre), A20#67(ticket dans l’outil de ticketing, nouvelle fenêtre), A21#68(ticket dans l’outil de ticketing, nouvelle fenêtre) (chaîne OTP), P2.9#41(ticket dans l’outil de ticketing, nouvelle fenêtre), P2.3#39(ticket dans l’outil de ticketing, nouvelle fenêtre), P2.10#42(ticket dans l’outil de ticketing, nouvelle fenêtre), P2.2#30(ticket dans l’outil de ticketing, nouvelle fenêtre), A16#63(ticket dans l’outil de ticketing, nouvelle fenêtre) (required de la spécification), A11#59(ticket dans l’outil de ticketing, nouvelle fenêtre), A12#60(ticket dans l’outil de ticketing, nouvelle fenêtre), A13#61(ticket dans l’outil de ticketing, nouvelle fenêtre), A15#62(ticket dans l’outil de ticketing, nouvelle fenêtre), Q5#92(ticket dans l’outil de ticketing, nouvelle fenêtre)Backend
Lot 5 — Reliquat applicatif2 et 3Saisie OTP de 4 à 6 chiffres ; adresse et téléphone obligatoires à la livraison ; répartition des bénéficiaires envoyée ; états d'attente sur le profil santé ; téléchargement du bulletin d'adhésion ; suppression de compte dès l'endpoint ; configuration de production (URL, remontée des plantages, versions, permissions, liens juridiques) ; retrait des gardes de relecture dès P1-A#20(ticket dans l’outil de ticketing, nouvelle fenêtre) et P0-N#6(ticket dans l’outil de ticketing, nouvelle fenêtre)SHIFTIN
Lot 6 — Confort et complétudeTransverseP3.1#56(ticket dans l’outil de ticketing, nouvelle fenêtre), P3.2#43(ticket dans l’outil de ticketing, nouvelle fenêtre), P3.4#52(ticket dans l’outil de ticketing, nouvelle fenêtre) à P3.6#48(ticket dans l’outil de ticketing, nouvelle fenêtre), P3.8#45(ticket dans l’outil de ticketing, nouvelle fenêtre), P3.9#44(ticket dans l’outil de ticketing, nouvelle fenêtre), P3.11#57(ticket dans l’outil de ticketing, nouvelle fenêtre), P3.15#46(ticket dans l’outil de ticketing, nouvelle fenêtre), P3.16#49(ticket dans l’outil de ticketing, nouvelle fenêtre), P3.18#55(ticket dans l’outil de ticketing, nouvelle fenêtre), P3.19#47(ticket dans l’outil de ticketing, nouvelle fenêtre), P2.1#31(ticket dans l’outil de ticketing, nouvelle fenêtre), P2.4#33(ticket dans l’outil de ticketing, nouvelle fenêtre) à P2.7#40(ticket dans l’outil de ticketing, nouvelle fenêtre), P2.11#34(ticket dans l’outil de ticketing, nouvelle fenêtre) à P2.13#32(ticket dans l’outil de ticketing, nouvelle fenêtre), N4#75(ticket dans l’outil de ticketing, nouvelle fenêtre), N6#77(ticket dans l’outil de ticketing, nouvelle fenêtre), N41#88(ticket dans l’outil de ticketing, nouvelle fenêtre), Q6#93(ticket dans l’outil de ticketing, nouvelle fenêtre), A24#70(ticket dans l’outil de ticketing, nouvelle fenêtre)Backend
Prérequis client1 et 2Décisions A1 à A3 et réponses Q1#89(ticket dans l’outil de ticketing, nouvelle fenêtre) à Q7#94(ticket dans l’outil de ticketing, nouvelle fenêtre) (01/10/2026) ; cartes Dahabia de test (01/10/2026) ; comptes App Store et Play Store demandés dès maintenant, disponibles avec l'URL de l'API de production, l'instance Satim au nom d'Amana, la politique de confidentialité, les CGU et le compte de test des relecteurs (13/10/2026)Amana
Règle de fonctionnement proposée pour la suite : un correctif n'est considéré livré que lorsqu'il a été vérifié en réel par l'équipe mobile, et tout risque de glissement est signalé au point quotidien, avec sa cause et son impact estimé, avant la date manquée et non après.

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.