Arthur Ria
0ff44f7b78
Nouveaux documents :
- README.md : porte d'entrée humaine, absente jusqu'ici. Objet du projet,
installation, npm test, branchement Claude Desktop, ajout d'un profil WMS,
compilation de l'exécutable.
- DECISIONS.md : 20 décisions et pièges vérifiés sur un WMS réel (D1..D20),
chacun avec son pourquoi. Extrait ce qui était noyé dans CLAUDE.md :
100 % API, tenant_code OAuth, réponses {entities}, casse des propriétés,
dotenv sur stderr, dates relatives LINQ non traduisibles, absence de
CommandParameterData, etc.
- MONITORING.md : supervision du serveur MCP. Préfixes de logs, séquence
d'un démarrage sain, cycle de vie du token OAuth et ses trois filets,
état des caches, table symptôme -> cause. Une section dit explicitement
ce qui n'est pas instrumenté (ni healthcheck, ni métriques, ni alerte).
- docs/logs.md : accès aux logs du WMS. Chemins, placeholder {host},
blocage volontaire sur les profils SaaS, les trois outils, format des
lignes, limites connues.
Mises à jour :
- CLAUDE.md réécrit et aligné sur le code. Correction de l'écart le plus
gênant : le code utilise QueryType 0 (Reading), la doc annonçait 1, soit
l'inverse de ce qui fonctionne pour les comparaisons de statut par
chaîne. Corrigés également : 6 resources et non 7 (workflows://categories
n'existe pas), section .env mono-profil obsolète, références à des
fichiers de test absents, README annoncé mais inexistant. Le suivi de
projet et les checklists de phases sont retirés.
- docs/README.md : index réel du dossier. L'ancien promettait une resource
docs:// qui n'a jamais existé.
- docs/getting_started.md : avertissement en tête, c'est une capture
partielle du portail Mecalux dont les liens internes ne résolvent pas.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Documentation de référence
Documents de référence sur EasyWMS et ses API, conservés dans le dépôt pour être consultables hors ligne et par un agent qui lit le code.
⚠️ Ce dossier n'est pas exposé comme resource MCP. Une resource
docs://a existé sans jamais être branchée ; elle a été supprimée. Ces fichiers se lisent directement depuis le dépôt. Voir D19 dans DECISIONS.md.
Contenu
| Fichier | Nature |
|---|---|
| logs.md | Rédigé pour ce projet — accès aux logs WMS, outils, limites |
| ad-api-validation.md | Rédigé pour ce projet — campagne de validation curl des 19 types AD testés (17 valides) |
| api/Application Service API Reference.md | Référence de l'API ApplicationService |
| api/POST apiQueryExecute.md | Détail de l'endpoint QueryExecute |
| entities/easywms_reading_entites.md | Catalogue des entités du modèle Reading |
| entities/easywms_reading_entites_outboundorder.md | Détail de l'entité OutboundOrder |
| entities/easywms_reading_entites_outboundorder_OutboundOrderStatus.md | Valeurs de OutboundOrderStatus |
getting_started.md, docs_downloads/ |
Extractions du portail documentaire Mecalux |
reference-queries-api.php |
Client PHP d'origine, source des patterns d'API. ⚠️ utilise QueryType: 1 — ne pas recopier, voir D3 |
Sur les extractions du portail : ce sont des captures partielles. Leurs
liens internes pointent vers des pages non téléchargées (ReleaseNotes.md,
video_tutorials/, …) et ne fonctionnent pas. Le seul document réellement
exploitable de cet ensemble est
docs_downloads/communications/EasyWMS_WebApi_en.html.md (référence complète de
la Web API, ~320 Ko).
Où trouver le reste
| Question | Document |
|---|---|
| À quoi sert ce projet, comment l'installer | ../README.md |
| Architecture, outils, resources, conventions de code | ../CLAUDE.md |
| Pourquoi le code est écrit ainsi, pièges vérifiés | ../DECISIONS.md |
| Le serveur ne répond pas / comment le superviser | ../MONITORING.md |
Ajouter un document
Déposez le .md dans le sous-dossier qui convient et ajoutez sa ligne au
tableau ci-dessus. Un document non listé ici est un document que personne ne
retrouvera.