FactureCraft
Devis et factures en local, pour les personnes et pour leurs outils.
- Conception et développement
- Projet personnel open source.
- Actif
Le problème
Les logiciels de facturation en ligne gardent les données chez eux et se pilotent mal depuis d’autres outils. L’objectif : pouvoir préparer un devis depuis un assistant IA, tout en gardant la main sur ce qui part réellement chez un client.
Les contraintes
- Les données restent sur la machine (SQLite locale).
- Un assistant peut préparer un brouillon, mais seul l’humain finalise : ni la CLI ni le serveur MCP ne peuvent émettre un document.
- La numérotation légale doit continuer la série existante importée depuis Facture.net.
- Documents conformes Factur-X.
La solution
Un espace de travail Cargo avec trois interfaces sur le même cœur métier :
| Interface | Rôle |
|---|---|
| Application native | Tableau de bord, documents avec aperçu en direct, catalogue, finalisation, paiements |
CLI facturecraft |
Préparer les brouillons, dériver les documents, aperçus PDF, import, sauvegarde |
facturecraft mcp |
Chercher contacts et produits, lire les documents, préparer des brouillons |
Ce qui a été réalisé
- Contacts, lignes de devis avec taxes et remises, aperçus PDF.
- Import des exports Facture.net avec aperçu et confirmation.
- Conversion devis → facture, acomptes, paiements, avoirs.
- Numérotation réelle qui reprend la série importée, PDF daté et figé à la finalisation.
Résultats
Les cinq premières étapes de la feuille de route sont en place. La reprise de l’historique et les avoirs sont couverts par des tests de non-régression synthétiques, et la validation Factur-X est documentée dans le dépôt. Les paquets macOS ne sont pas encore signés ; Windows et Linux restent à vérifier.
Ce que le projet démontre
Comment ouvrir un outil métier aux agents IA sans leur donner les clés : une seule source de règles, trois interfaces, et une frontière nette entre préparer et engager.