Carte graphique et interactive des relations entre documents transactionnels pour Frappe / ERPNext, dans l'esprit de la Relationship Map de SAP Business One.
Depuis n'importe quel document (devis, commande, BL, facture, paiement…), la carte affiche tout le flux : ce qui l'a généré en amont, ce qu'il a généré en aval, et les branches liées (achats, fabrication…).
- une colonne par étape du flux, un groupe par type de document ;
- chaque document affiche son nom et son statut métier (couleur Frappe) ;
- documents déplaçables sur la scène, zoom, recentrage, « Réorganiser » ;
- double-clic : ouvre le document dans un nouvel onglet ;
- survol : met en évidence les liens du document ;
- document non autorisé : grisé avec un cadenas, sans statut ;
- liens « retour » (ex. BL créé depuis une facture) en pointillés ;
- avoir ou amendement placé juste sous son document d'origine, relié par un crochet sur le bord droit ;
- option pour afficher les documents annulés.
Compatible Frappe / ERPNext v15 et v16 (validé sur les deux avec un flux ERPNext réel, voir Tests). Aucune dépendance JS ajoutée : l'affichage utilise Vue Flow, déjà embarqué par Frappe pour le Workflow Builder.
bench get-app <url-du-dépôt> erpnext_document_map
bench --site <site> install-app erpnext_document_map
bench build --app erpnext_document_map- Sur un formulaire transactionnel enregistré : Voir › Carte des relations.
- Ou directement :
/app/document-map?doctype=Sales%20Order&name=SO-0001(/desk/document-map?...en v16). L'URL est partageable.
La page est ouverte à tous les utilisateurs du Desk ; la sécurité s'applique
document par document (permissions de rôle, User Permissions,
permission_query_conditions). Pour restreindre la page elle-même :
Role Permission for Page and Report.
Document Map Settings (System Manager) :
| Réglage | Défaut | Rôle |
|---|---|---|
| Nombre maximum de documents | 150 | Au-delà, la carte est tronquée (indicateur « Tronquée »). |
| Parcourir au-delà des documents non autorisés | oui | Montre le flux complet derrière un cadenas, ou s'arrête dessus. |
| Inclure | — | DocTypes non soumettables à traiter comme transactionnels (Opportunity, Project…). |
| Exclure | — | DocTypes soumettables à ignorer. |
Pour d'autres apps, les mêmes réglages existent en hooks :
document_map_include_doctypes = ["Project"]
document_map_exclude_doctypes = ["Bank Transaction"]
document_map_status_colors = {"To Deliver and Bill": "orange"}Quels documents ? Les DocTypes soumettables (hors tables enfants, singles et virtuels), moins les écritures techniques (GL Entry, Stock Ledger Entry, Payment Ledger Entry, Serial and Batch Bundle, reposts…), plus/moins les réglages. Les données de référence (clients, articles…) ne sont jamais traversées : sinon tout serait relié à tout.
Quels liens ? Tous les champs Link et Dynamic Link entre ces
DocTypes, en entête comme dans les tables enfants, y compris les Custom Fields.
Un document B qui référence A est placé en aval de A (la ligne de BL qui
pointe la commande, la référence de paiement qui pointe la facture,
amended_from, return_against…). Les liens sont lus dans les deux sens,
donc la carte est la même quel que soit le document de départ.
Raccourcis masqués. Les lignes de facture référencent souvent aussi la commande, les lignes de réception aussi la commande client… Un lien A → C est masqué quand le chemin A → B → C existe déjà dans la carte : on lit la chaîne, comme dans SAP. Aucune relation n'est perdue (testé).
Index des liens. Calculé à partir des métadonnées et mis en cache 1 h,
invalidé à l'enregistrement d'un DocType, Custom Field, Property Setter ou des
réglages, et par bench clear-cache.
Parcours. En largeur, niveau par niveau, avec des requêtes groupées par
DocType (pas une requête par document). Les requêtes passent par frappe.qb,
identique en v15 et v16.
Mise en page. Les colonnes suivent le niveau de chaque type dans le flux (plus long chemin). Les types de même niveau sont empilés dans la même colonne, la branche la plus fournie en haut. Dans un groupe, chaque document est placé au plus près de ceux qui l'ont généré. En cas de cycle entre types (BL ↔ facture), l'ordre habituel des étapes ERPNext tranche.
Les chaînes source sont en anglais ; la traduction française est dans
erpnext_document_map/locale/fr.po, compilée par bench build. Les chaînes
déjà traduites par Frappe ou ERPNext (Settings, Refresh…) n'y figurent pas, pour
ne pas écraser leurs traductions dans le reste du Desk.
- Un Dynamic Link utilisé pour la première fois avec un nouveau type de
document peut mettre jusqu'à 1 h à apparaître (ou
bench clear-cache). - Les couleurs de statut suivent une table de mots-clés (Paid, To Bill,
Overdue…) ; les statuts spécifiques se règlent par le hook
document_map_status_colors. - Les positions déplacées à la main ne sont pas mémorisées.
Algorithme de parcours et de mise en page, sans bench :
python -m pytest tests/test_graph.pyIntégration sur un site ERPNext de test (crée des documents : pas sur un site client) :
cd frappe-bench/sites
../env/bin/python ../apps/erpnext_document_map/tests/integration/make_flow.py <site> # affiche le JSON du flux
../env/bin/python ../apps/erpnext_document_map/tests/integration/check_graph.py <site> '<JSON du flux>'
# Desk dans Chromium (Playwright) ; DESK=/desk en v16
DESK=/app python ../apps/erpnext_document_map/tests/integration/check_desk.py http://<site>:8000 <commande> /tmpmake_flow.py crée devis, commande, deux BL partiels, factures, avoir,
paiement, facture annulée puis amendée, achat lié à la commande, un flux sans
rapport et un utilisateur vendeur@example.com (rôle Sales User).