Quatre portes, un seul Intake

Ce qui ne change pas d’une porte à l’autre

Le fichier est lu par le même moteur, les lignes sont résolues par les mêmes règles, et le résultat sort dans le même contrat adesio.bom.canonical/v1. Aucune porte ne prétend avoir trouvé une pièce : found veut dire que le fichier l’énonce. Une seule asymétrie est voulue — la CLI n’applique aucune décision d’opérateur, parce qu’un chiffre qu’elle imprime parle de ce que l’outil lit, pas de ce que quelqu’un a confirmé.

L’application

Pour déposer un fichier et le regarder.

Glissez une BOM sur la page d’accueil. Le rapport s’ouvre, vous corrigez les rôles de colonne là où le moteur s’est trompé, vous enregistrez la lecture comme format nommé — et le prochain fichier de cette forme est reconnu sans question. Les lignes qui attendent une décision se retrouvent dans la file de revue, une carte par pièce et non par ligne.

C’est la seule porte où les boutons de confirmation existent : un rapport téléchargé les affiche inertes, parce qu’il n’y a plus de serveur à qui parler.

La ligne de commande

Pour traiter un fichier, ou un dossier entier, sans ouvrir de navigateur.

Elle produit exactement les mêmes livrables que l’application : le rapport autonome, le JSON canonique, les CSV, et la worklist de recherche. Elle n’applique aucune décision d’opérateur et ne lit aucun format appris — ce qu’elle mesure, c’est ce que l’outil comprend seul.

npm install

# un seul fichier — rapport, JSON canonique, CSV, et la liste de recherches
npm run analyze -- ma-bom.xlsx \
  -o rapport.html --canonical canonical.json --csv bom.csv --queries recherches.csv

# une feuille par son nom, un encodage que le fichier a menti sur, un profil client
npm run analyze -- ma-bom.xlsx --sheet "BOM" --profile analyzer/profiles/cadence-atdm.json

# un dossier entier, deux fois : la passe 1 apprend un format par forme, la passe 2 relit avec lui
npm run corpus-run -- --dir ./boms

L’API HTTP

Pour appeler Intake depuis votre propre système.

Le tableau ci-dessous est rendu depuis la table de routage elle-même, celle dont sort openapi.json. Une route non déclarée y est donc invisible et injoignable, et une route déclarée y figure forcément — le document ne peut pas mentir sur ce que le serveur fait.

Le schéma du contrat est servi sur /api/schema, la description OpenAPI sur /api/openapi.json. HEAD répond comme GET ; un verbe qui n’existe pas sur un chemin qui existe rend 405 avec l’en-tête Allow, pas 404.

Le connecteur Claude

Pour que Claude lise vos BOM, avec la mémoire de l’installation.

Un serveur MCP sur stdio. Claude ouvre la même installation que l’application web : mêmes formats appris, mêmes alias fabricants, même catalogue, mêmes décisions. Une pièce confirmée dans l’application est déjà réglée la fois suivante. Aucun outil ne rend jamais une BOM entière — chaque liste est paginée, et la ligne complète est un second appel.

Les outils exposés

analyze_bom

Lit une BOM depuis cette machine et rend sa couverture, ses compteurs et l’identifiant du rapport.

list_reports

Les rapports que cette installation détient, avec leur fichier et leur couverture.

get_coverage

Les compteurs d’un rapport, nommés de façon à ne pas pouvoir être aplatis en « résolu / pas résolu ».

list_lines

Une page de lignes, filtrable par résolution ou par motif de revue.

get_line

Le dossier canonique complet d’une ligne : identité, base, candidats, valeur, boîtier.

search_queries

Les lignes que le fichier décrit sans les nommer, en requêtes dédupliquées.

lookup_worklist

Les pièces distinctes qu’une recherche fournisseur interrogerait — le chiffre sur lequel une facture à la pièce se compte.

review_queue

Les pièces qui attendent une décision, toutes analyses confondues, groupées par pièce.

record_decision

ÉCRIT. Enregistre qu’une pièce est celle d’une ligne, qu’elle ne l’est pas, ou annule.

Déclarez-le dans la configuration MCP de votre client Claude :

{
  "mcpServers": {
    "adesio-intake": {
      "command": "npm",
      "args": ["run", "--silent", "mcp", "-w", "analyzer"],
      "cwd": "/chemin/vers/bom-analyzer"
    }
  }
}