Arthur Ria
03f561fdf7
Ajoute docs/supervision.md, référencé depuis CLAUDE.md et docs/README.md. Décrit le rôle de superviseur du projet, distinct des sessions qui codent : vérifier l'état réel du MCP contre le WMS, réviser leurs livraisons sans les croire sur parole, et rédiger la passation suivante. Contient la baseline chiffrée à préserver (23 outils, 6 resources, npm test 4/4) et les mesures de référence du tenant, la boîte à outils de vérification (handshake MCP, appel d'outil via le protocole, sonde directe de l'API), une grille de revue en sept points, les six règles de rédaction d'une passation, et les garde-fous (lecture seule, pas de push, pas de réécriture d'historique). Consigne les quatre modes d'échec déjà observés sur ce dépôt : taxonomie inventée, casse de champ supposée, collision de préfixe de routage, hypothèse présentée comme solution. Ils sont récurrents et se repèrent vite quand on sait quoi chercher. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
48 lines
2.9 KiB
Markdown
48 lines
2.9 KiB
Markdown
# 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](../DECISIONS.md).
|
|
|
|
## Contenu
|
|
|
|
| Fichier | Nature |
|
|
|---|---|
|
|
| [supervision.md](supervision.md) | **Rôle de supervision** — vérifier le MCP, réviser les livraisons des sessions de codage, rédiger les passations |
|
|
| [handoff-lot1.md](handoff-lot1.md) | **Passation** — prompt autoportant pour le lot 1 de la [roadmap](../ROADMAP.md). À supprimer une fois le lot livré |
|
|
| [logs.md](logs.md) | **Rédigé pour ce projet** — accès aux logs WMS, outils, limites |
|
|
| [ad-api-validation.md](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](api/Application%20Service%20API%20Reference.md) | Référence de l'API ApplicationService |
|
|
| [api/POST apiQueryExecute.md](api/POST%20apiQueryExecute.md) | Détail de l'endpoint `QueryExecute` |
|
|
| [entities/easywms_reading_entites.md](entities/easywms_reading_entites.md) | Catalogue des entités du modèle **Reading** |
|
|
| [entities/easywms_reading_entites_outboundorder.md](entities/easywms_reading_entites_outboundorder.md) | Détail de l'entité `OutboundOrder` |
|
|
| [entities/easywms_reading_entites_outboundorder_OutboundOrderStatus.md](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](../README.md) |
|
|
| Architecture, outils, resources, conventions de code | [../CLAUDE.md](../CLAUDE.md) |
|
|
| Pourquoi le code est écrit ainsi, pièges vérifiés | [../DECISIONS.md](../DECISIONS.md) |
|
|
| Le serveur ne répond pas / comment le superviser | [../MONITORING.md](../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.
|