Arthur Ria
242b0c0f1c
Les services lisaient `response?.entities || []` sur les reponses de l'API AD
(enveloppe { entities: [...] }, D4). Toute reponse d'une AUTRE forme — corps
vide, objet d'erreur, champ absent — devenait donc un tableau vide,
indistinguable d'une page finale legitime, et etait mise en cache avec un
timestamp valide : un cache vide empoisonne pour tout le TTL, sans le moindre
message. C'est la cause probable du `count: 0` mesure sous rafale, et le mode
d'echec le plus couteux du lot, parce qu'il se lit comme une reponse.
Le contrat est porte par src/services/ad-envelope.js pour les trois sites
(Workflow/GetByApplication, Application/GetAll, <Type>/GetByApplication) :
`{ entities: [...] }`, `[]` reel compris, est rendu tel quel ; toute autre
forme leve. entity-resolver etait deja conforme — il leve deja si
/configuration/applications ou le Metadata ne rendent aucune entite.
Volontairement sans retry ni logique de resilience : le but est de rendre
l'anomalie visible et non persistante. La rattraper la rendrait invisible,
c'est-a-dire exactement le defaut corrige.
--- Verifications (LIMAGRAIN) ---
Vide LEGITIME — search_workflows sur SmartUI (0 workflow, D26) :
search_workflows(SmartUI) : success=true application=SmartUI count=0
isError=false
error : (aucune)
hint : Aucun workflow trouve dans l'application "SmartUI" — c'est la
SEULE interrogee, les autres ne le sont jamais implicitement.
Le specifique client (prefixe CST_) vit dans "CustomApp" : [...]
cache pose ? workflowCachesByApplication =
{"SmartUI":{"cached":true,"count":0,"timestamp":1787665868988,
"age":0,"valid":true}}
stderr : No more workflows to fetch / Successfully cached 0 workflows
Forme SANS `entities` — non declenchable a la demande contre le vrai WMS,
couverte par un test direct (apiService.post substitue, renvoie {}) :
--- workflow-service fetchAllWorkflows("EasyWMS") avec une reponse {} ---
erreur levee : Failed to fetch workflows for application "EasyWMS":
Reponse inattendue de l'API AD sur Workflow/GetByApplication
(application "EasyWMS", offset 0) : un objet vide, au lieu de
l'enveloppe attendue { entities: [...] }. Rien n'a ete mis en cache —
relancez l'appel. Si l'erreur persiste, l'API AD est en defaut [...]
cache : {} (attendu {})
--- workflow-service fetchApplications() avec une reponse {} ---
erreur levee : Reponse inattendue de l'API AD sur Application/GetAll : [...]
cache : {} (attendu {})
--- ad-service getElements("Command") avec une reponse {} ---
erreur levee : Failed to fetch Command for application "EasyWMS": [...]
cache : {} (attendu {})
--- puis une reponse normale : le refetch repart (rien de coince) ---
1 workflow(s), cache : {"EasyWMS":{"cached":true,"count":1,...}}
Cas nominaux du helper (unitaire) : { entities: [] } et { entities: [1,2] }
passent ; {}, null, undefined, [], { error }, "texte" levent tous.
--- Non-regression, rafales rejouees 3 fois ---
L6.1 rafale workflow RUN 1/2/3 : 6/6 a count=44 | fetch=1 joins=5
L6.1 rafale resolver RUN 1/2/3 : 6/6 succes | chargements=1 joins=5 GET=5
L6.1 rafale mixte RUN 1/2/3 : CustomApp@44=3 EasyWMS@50=3 |
fetch=2 joins=4
L6.2 bascule RUN 1/2/3 : caches peuples : 0 (attendu 0)
sequentiel nominal count=50 puis count=50 | fetch=1 cached=1 joins=0
Baseline finale : tools/list 23, resources/list 6 ; npm test 4/4, exit 0.
ROADMAP : lot 6 retire. Le point ouvert « bascule de profil concurrente aux
appels en vol » reste — D27 borne les chargements paresseux, pas le routage
d'une requete deja partie.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
60 lines
2.4 KiB
JavaScript
60 lines
2.4 KiB
JavaScript
/**
|
|
* Enveloppe des API AD — un vide anormal n'est pas un vide (D27)
|
|
*
|
|
* Les API AD renvoient `{ entities: [...] }` (D4). Les services lisaient
|
|
* `response?.entities || []` : toute réponse d'une **autre forme** (pas de
|
|
* champ `entities`, corps vide, objet d'erreur) devenait un tableau vide,
|
|
* indistinguable d'une page finale légitime — donc mise en cache avec un
|
|
* timestamp valide. Un cache vide empoisonné pour tout le TTL, sans le
|
|
* moindre message.
|
|
*
|
|
* Deux cas, deux traitements :
|
|
*
|
|
* | Réponse | Traitement |
|
|
* |---|---|
|
|
* | `{ entities: [...] }`, y compris `[]` réel | rendue telle quelle — une application peut être légitimement vide (`SmartUI` : 0 workflow, D26) |
|
|
* | tout le reste | **lève** — l'appel échoue, rien n'est mis en cache, l'appel suivant refetche |
|
|
*
|
|
* Volontairement sans retry ni résilience : le but est de rendre l'anomalie
|
|
* **visible et non persistante**, pas de la rattraper.
|
|
*/
|
|
|
|
/**
|
|
* Décrit la forme reçue, pour un message d'erreur exploitable (convention 4).
|
|
*/
|
|
function describeShape(response) {
|
|
if (response === null) return 'null';
|
|
if (response === undefined) return 'undefined';
|
|
if (Array.isArray(response)) return `un tableau nu de ${response.length} élément(s)`;
|
|
if (typeof response !== 'object') return `un ${typeof response}`;
|
|
const keys = Object.keys(response);
|
|
if (keys.length === 0) return 'un objet vide';
|
|
return `un objet sans champ "entities" (champs reçus : ${keys.slice(0, 10).join(', ')})`;
|
|
}
|
|
|
|
/**
|
|
* Extrait le tableau `entities` d'une réponse d'API AD, ou lève.
|
|
*
|
|
* @param {any} response - la réponse brute de `apiService.post(..., true)`
|
|
* @param {string} context - l'appel concerné, pour le message d'erreur
|
|
* (ex. `Workflow/GetByApplication (application "EasyWMS", offset 0)`)
|
|
* @returns {Array} le tableau `entities`, éventuellement vide
|
|
* @throws {Error} si la réponse n'a pas la forme `{ entities: [...] }`
|
|
*/
|
|
function requireEntities(response, context) {
|
|
const entities = response ? response.entities : undefined;
|
|
|
|
if (!Array.isArray(entities)) {
|
|
throw new Error(
|
|
`Réponse inattendue de l'API AD sur ${context} : ${describeShape(response)}, ` +
|
|
`au lieu de l'enveloppe attendue { entities: [...] }. ` +
|
|
`Rien n'a été mis en cache — relancez l'appel. ` +
|
|
`Si l'erreur persiste, l'API AD est en défaut (elle échoue notamment sous appels concurrents nombreux).`
|
|
);
|
|
}
|
|
|
|
return entities;
|
|
}
|
|
|
|
module.exports = { requireEntities };
|