Mecalux/mcp-wms-wiki
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
9ce6ae37be08c793547e04e9027dc911e638a911
mcp-wms-wiki/wiki_old_13-05-2026/CLAUDE.md
T
Arthur Ria 23eb3f3c84 màj wiki avec retour MES lot-5 AD
2026-05-20 09:41:27 +02:00

16 KiB
Raw Blame History

CLAUDE.md — Wiki EasyWMS Limagrain (Cowork)

Mission

Tu maintiens un wiki projet Limagrain en Markdown dans le sous-dossier limagrain/, au sein d'un dépôt qui contient aussi le wiki standard EasyWMS (dossiers architecture/, concepts/, modules/, operations/, glossary.md). Le wiki standard est également accessible via le MCP server wms-wiki.

Le wiki Limagrain ne documente que le delta projet : customs, configurations, décisions, flux spécifiques. Chaque page renvoie vers la page standard correspondante quand un concept générique existe.

Règle d'or : ne jamais modifier les fichiers du wiki standard. Le dossier limagrain/ est le seul périmètre d'écriture pour le contenu projet.

Arborescence

wiki-ameliorator-v2_x-Limagrain/        ← racine du dépôt
│
├── CLAUDE.md                            ← CE FICHIER
│
├── ── WIKI STANDARD (lecture seule) ──
├── architecture/                        ← 6 pages standard
├── concepts/                            ← 35 pages standard
├── modules/                             ← 24 pages standard
├── operations/                          ← 19 pages standard
├── glossary.md                          ← glossaire standard
├── _index.md                            ← index global (standard + Limagrain)
├── _lint_report.md
├── _log.md
│
├── ── SOURCES (inbox) ──
├── sources/                             ← déposer ici les ressources à intégrer
│   └── archives/                        ← ressources déjà traitées
│
├── ── JOURNAL ──
├── consume.log                          ← journal de consommation (append-only)
│
└── ── WIKI LIMAGRAIN (écriture) ──
    limagrain/
    ├── README.md                        ← index + table des matières du wiki Limagrain
    ├── glossaire-limagrain.md           ← termes et acronymes spécifiques projet
    │
    ├── 01-inbound/
    │   ├── _index.md
    │   ├── reception-fournisseur.md
    │   ├── reception-retour.md
    │   ├── controle-qualite-reception.md
    │   └── flux-erp-inbound.md
    │
    ├── 02-stockage/
    │   ├── _index.md
    │   ├── asrs-miniload.md
    │   ├── galileo-config.md
    │   ├── putaway-strategies.md
    │   ├── zones-stockage.md
    │   └── defragmentation.md
    │
    ├── 03-picking/
    │   ├── _index.md
    │   ├── picking-combinatoire.md
    │   ├── stations-picking.md
    │   ├── waves-groupes.md
    │   └── replenishment.md
    │
    ├── 04-outbound/
    │   ├── _index.md
    │   ├── flux-expedition.md
    │   ├── shipping-orders.md
    │   ├── consolidation-chargement.md
    │   └── flux-erp-outbound.md
    │
    ├── 05-agv/
    │   ├── _index.md
    │   ├── still-igo-integration.md
    │   ├── agv-stations-routes.md
    │   └── agv-troubleshooting.md
    │
    ├── 06-erp-interface/
    │   ├── _index.md
    │   ├── messages-reference.md
    │   ├── mapping-erp-wms.md
    │   └── interface-monitoring.md
    │
    ├── 07-admin/
    │   ├── _index.md
    │   ├── utilisateurs-groupes.md
    │   ├── parametres-projet.md
    │   └── ad-customs.md
    │
    ├── 08-transverse/
    │   ├── _index.md
    │   ├── jira-tickets-cles.md
    │   ├── decisions-architecture.md
    │   ├── questions-ouvertes.md
    │   └── historique-projet.md
    │
    └── assets/

L'arborescence limagrain/ ci-dessus est le squelette initial. Tu peux créer de nouvelles pages ou sous-dossiers si le contenu le justifie — respecte les conventions ci-dessous et mets à jour limagrain/README.md en conséquence.

Workflow de consommation

Quand Arthur te demande d'intégrer des ressources ou quand tu détectes des fichiers dans sources/ :

Étape 1 — Inventaire

Lis le contenu de sources/ (ignore archives/) et liste les fichiers présents. Pour chaque fichier, identifie :

  • Le type (Confluence export, note Obsidian, mail, Excel, PDF, Word, capture d'écran)
  • Le domaine fonctionnel probable (inbound, stockage, picking, outbound, AGV, ERP, admin, transverse)
  • Les infos clés à extraire

Présente ce résumé à Arthur avant de commencer l'intégration.

Étape 2 — Rédaction / Mise à jour

Pour chaque ressource :

  1. Vérifie le standard : consulte d'abord la page correspondante dans le wiki standard local (concepts/, modules/, etc.) ET/OU appelle wms-wiki:search_wiki ou wms-wiki:get_wiki_page via MCP pour compléter
  2. Identifie la page cible dans limagrain/ (existante ou à créer)
  3. Rédige ou mets à jour la page en respectant le template (voir plus bas)
  4. Cross-référence : ajoute des liens vers les autres pages du wiki Limagrain si pertinent
  5. Mets à jour limagrain/glossaire-limagrain.md si de nouveaux termes apparaissent
  6. Mets à jour limagrain/README.md si de nouvelles pages sont créées

Étape 3 — Log et archivage

Après intégration de chaque fichier :

  1. Ajoute une entrée dans consume.log à la racine (format ci-dessous)
  2. Déplace le fichier de sources/ vers sources/archives/

Étape 4 — Compte rendu

Après chaque session d'intégration, résume à Arthur :

  • Fichiers consommés
  • Pages créées ou modifiées
  • Nouvelles cross-références
  • Questions ouvertes identifiées
  • Termes ajoutés au glossaire

Format du consume.log

Fichier append-only à la racine du dépôt. Chaque session est datée, chaque fichier a une entrée.

## [2026-05-05] session-001

- **Fichier** : `CR_reunion_picking_2026-04-15.pdf`
  **Type** : CR réunion
  **Action** : Mis à jour `limagrain/03-picking/picking-combinatoire.md` (ajout section CstAtt handshake)
  **Cross-refs** : Lien ajouté depuis `limagrain/04-outbound/flux-expedition.md`
  **Questions** : "Valeur par défaut CstAtt quand lot inconnu ?" → ajouté dans `limagrain/08-transverse/questions-ouvertes.md`

- **Fichier** : `Mapping_ERP_Limagrain_v2.xlsx`
  **Type** : Excel mapping
  **Action** : Créé `limagrain/06-erp-interface/mapping-erp-wms.md`
  **Cross-refs** : Liens depuis `limagrain/01-inbound/flux-erp-inbound.md` et `limagrain/04-outbound/flux-erp-outbound.md`
  **Questions** : aucune

Template de page wiki

Chaque fichier .md dans limagrain/ doit suivre cette structure :

---
title: "Titre de la page"
tags: [domaine, sous-domaine, concept]
status: draft | review | validated
standard_ref: concepts/reception.md
jira_refs: [LIM-70, LIM-75]
confluence_refs: []
sources: []
last_updated: 2026-05-05
author: Arthur
---

# Titre de la page

> **Résumé** : 1-2 phrases décrivant le sujet et pourquoi c'est spécifique Limagrain.

> **Standard EasyWMS** : → voir [Nom page standard](../../concepts/page.md)
> Ce qui suit documente les **spécificités Limagrain** par rapport au standard.

## Contexte projet

Pourquoi ce sujet est spécifique chez Limagrain. Quel besoin métier.

## Configuration / Implémentation

Détails techniques : paramètres, valeurs, éléments AD customs.

## Flux fonctionnel

Description du flux. Utiliser un diagramme Mermaid si pertinent :

​```mermaid
sequenceDiagram
    participant ERP
    participant WMS
    ERP->>WMS: SOR01
    WMS->>WMS: Stock assignment
    WMS-->>ERP: SOF01
​```

## Points d'attention

⚠️ Particularités, pièges connus, bugs rencontrés, workarounds.

## Questions ouvertes

- [ ] Question 1 (@Théo)
- [ ] Question 2 (@Michael)

## Historique des modifications

| Date | Auteur | Modification |
|------|--------|-------------|
| 2026-05-05 | Arthur | Création initiale |

## Références

| Source | Type | Date |
|--------|------|------|
| Jira LIM-70 | Ticket | 2025-xx-xx |
| "Titre page" Confluence | Page | 2025-xx-xx |
| CR réunion picking | PDF | 2026-04-15 |

Template _index.md (sommaire de section)

---
title: "Inbound — Vue d'ensemble"
tags: [inbound, index]
status: draft
last_updated: 2026-05-05
---

# Inbound — Vue d'ensemble

> **Périmètre** : réception fournisseur, retours, contrôle qualité à réception, messages ERP inbound.

> **Standard EasyWMS** : voir [Reception](../../concepts/reception.md), [Order Inbound](../../concepts/order-inbound.md)

## Pages de cette section

- [Réception fournisseur](reception-fournisseur.md)
- [Réception retour](reception-retour.md)
- [Contrôle qualité réception](controle-qualite-reception.md)
- [Flux ERP inbound](flux-erp-inbound.md)

## Vue synthétique du flux inbound Limagrain

(Diagramme Mermaid du flux global de la section — à compléter)

Liens entre wikis

Depuis une page Limagrain → page standard (même dépôt)

Chemins relatifs remontant au-dessus de limagrain/ :

→ voir [Reception standard](../../concepts/reception.md)
→ voir [Picking standard](../../concepts/picking.md)
→ voir [Galileo Integration](../../architecture/galileo-integration.md)

Depuis une page Limagrain → autre page Limagrain

Chemins relatifs au sein de limagrain/ :

Voir aussi [Flux expédition](../04-outbound/flux-expedition.md)
Voir aussi [Glossaire Limagrain](../glossaire-limagrain.md)

Vers Jira

[LIM-70](https://easywmsfrance.atlassian.net/browse/LIM-70)

Conventions strictes

Nommage

  • Fichiers : kebab-case, pas d'accents, .md → picking-combinatoire.md
  • Dossiers dans limagrain/ : numérotés 01- à 08- + kebab-case
  • Assets : {section}-{description}.{ext} → 03-picking-schema-stations.png

Markdown lint

Règles à respecter (compatible markdownlint) :

  • Headings ATX (#) uniquement, pas de saut de niveau (h1 → h3 interdit)
  • Pas de trailing spaces
  • Pas de lignes vides multiples (max 1)
  • Line length ≤ 120 caractères (souple pour tableaux et liens)
  • Listes entourées de lignes vides
  • Premier élément du fichier = front matter --- puis heading H1
  • Pas de headings dupliqués dans un même fichier
  • Liens relatifs entre pages (pas de chemins absolus)

Langue

  • Français pour la rédaction
  • Termes techniques WMS en anglais acceptés (putaway, picking, stock assignment, etc.)
  • Noms de messages ERP en majuscules : SOR, SOF, ASN, RUT, LOF
  • Noms d'entités AD en anglais PascalCase : OutboundOrder, ContainerStock, etc.

Contexte projet Limagrain

Équipe

Personne Rôle
Arthur Chef de projet technique - Intégrateur WMS / liaison client-dev, auteur du wiki
Nicolas Chabanis Responsable développement
Théo Chef de projet général - pilote tout le projet
Michael Directeur des opérations - Pilote Arthur
Fabien Mogade Développeur
Fares Zaroui Développeur
Justine Beutin Chef de projet fonctionnelle - Pilote le planning et principale interlocutrice avec Limagrain

Périmètre fonctionnel (par priorité)

  1. Réception / Inbound — modes de réception, ASN, SSCC/LPN, mono-référence
  2. Stockage / ASRS / Galileo — miniload, transstockeurs, stations, routes
  3. Picking / Préparation — picking combinatoire (CR V3.0, 4-job, CstAtt), stations
  4. Expédition / Outbound — flux SOR → RUT → SOF → LOF, chargement
  5. Intégration AGV / Still — iGo API, DB protocol, transport lifecycle
  6. Intégration ERP — catalogue messages, mapping champs
  7. Administration — RBAC, groupes, paramètres, éléments AD customs

Glossaire initial (termes spécifiques Limagrain)

Terme Signification
CstAtt Custom Attribute — handshake dans le picking combinatoire
CR V3.0 Change Request version 3.0 — architecture 4 jobs picking combinatoire
SOR Shipping Order Request — message ERP entrant, crée un ordre d'expédition
RUT Route — message ERP entrant, définit une tournée transporteur
SOF Shipping Order Fulfilled — message ERP sortant, ordre expédié
LOF Load Order Fulfilled — message ERP sortant, chargement camion terminé
ASN Advanced Shipping Notice — pré-avis de réception avec contenu connu
PIE Station de pesée automatique
PDL Picking Dedicated Location — emplacement dédié picking
ASRS Automatic Storage and Retrieval System — stockage automatique
TK Transstockeur (miniload)
TMS Transport Management System (Galileo chez Mecalux)
AD Application Dictionary — framework métadonnées EasyWMS

Jira

  • Projet : Limagrain (préfixe LIM-)
  • Cloud ID : d79e5957-a82c-4b8f-bd19-d553ef331c42
  • URL base : https://easywmsfrance.atlassian.net

MCP tools disponibles

Serveur Usage
wms-wiki:* Wiki standard EasyWMS — search, get_page, get_glossary_term, list_sections, get_related_pages
wms:* Données WMS live — queries LINQ, entities, workflows, AD, metadata
Atlassian:* Jira + Confluence — recherche JQL/CQL, lecture tickets/pages

Utilise wms-wiki systématiquement pour vérifier les concepts standard avant de rédiger. Utilise Atlassian avec le cloudId ci-dessus pour rechercher tickets ou pages Confluence référencés. Consulte aussi les pages standard locales (concepts/, modules/, etc.) quand elles sont plus complètes que le MCP.

Règles impératives

  1. Ne jamais modifier le contenu standard — les dossiers architecture/, concepts/, modules/, operations/, glossary.md sont en lecture seule. Exception unique : le fichier _index.md racine peut être modifié pour y ajouter/mettre à jour la section Limagrain (voir règle 10)
  2. Jamais de duplication du standard — si le standard couvre un concept, renvoie vers lui et ne documente que le delta Limagrain
  3. Toujours sourcer — chaque information vient d'une source identifiable. Cite-la dans le front matter sources et le tableau Références
  4. Marquer les incertitudes — > ⚠️ À confirmer ou - [ ] Question (@personne), reporter dans limagrain/08-transverse/questions-ouvertes.md
  5. Log obligatoire — chaque fichier consommé → entrée dans consume.log AVANT archivage
  6. Archivage obligatoire — après intégration, déplacer le fichier de sources/ vers sources/archives/
  7. Cross-référencer — quand une page mentionne un concept couvert ailleurs dans le wiki Limagrain, ajouter un lien
  8. Granularité — un fichier = un sujet. Découper si > 300 lignes
  9. README.md à jour — toute création/suppression de page dans limagrain/ doit y être reflétée
  10. _index.md racine à jour (MCP discovery) — le fichier _index.md à la racine est le registre utilisé par le MCP server wms-wiki pour découvrir les pages. Quand une page est créée ou supprimée dans limagrain/, ajouter/retirer son entrée dans _index.md sous une section dédiée ## Limagrain — Projet. Le format doit suivre exactement le même pattern que les sections existantes (Concepts, Modules, Architecture, Operations) :
## Limagrain — Projet (XX pages)

### Réception fournisseur
- **Path:** limagrain/01-inbound/reception-fournisseur.md
- **Type:** limagrain
- Résumé court de la page (1-2 lignes tirées du front matter ou du bloc Résumé).

### Picking combinatoire
- **Path:** limagrain/03-picking/picking-combinatoire.md
- **Type:** limagrain
- Architecture 4 jobs, CstAtt handshake, CR V3.0.

Ne jamais modifier les sections standard existantes (Concepts, Modules, Architecture, Operations) dans _index.md. Seule la section ## Limagrain — Projet est modifiable.

Démarrage

Si le dossier limagrain/ n'existe pas encore :

  1. Crée limagrain/ et toutes ses sous-sections (01-inbound/ à 08-transverse/, assets/)
  2. Crée consume.log à la racine (vide, avec juste un header # Journal de consommation)
  3. Crée les _index.md pour chaque section (contenu minimal, statut draft)
  4. Crée limagrain/README.md avec la table des matières
  5. Crée limagrain/glossaire-limagrain.md avec le tableau du glossaire initial ci-dessus
  6. Attends qu'Arthur dépose des ressources dans sources/ ou donne des instructions
Reference in New Issue View Git Blame Copy Permalink