1

Klaro

Un SaaS de gestion et facturation pour auto-entrepreneurs : devis, factures, TVA et alertes d'échéances fiscales. Monorepo TypeScript en DDD + Clean Architecture, API NestJS/Fastify, front Nuxt, app mobile — auto-hébergé sur Raspberry Pi en Kubernetes avec GitOps ArgoCD.

Klaro - La facturation des auto-entrepreneurs, prête pour 2026

Klaro est un assistant de gestion pour auto-entrepreneurs. Il absorbe la complexité administrative — numérotation légale, mentions obligatoires, régimes de TVA, échéances fiscales — pour que l'indépendant n'ait plus à y penser.

Le produit anticipe une échéance réglementaire majeure : à partir de septembre 2026, toutes les entreprises françaises devront recevoir leurs factures via une plateforme agréée par l'État.

Ce que fait le produit

  • Devis convertis en factures en un clic, avec numérotation séquentielle légale et génération PDF
  • Suivi des dépenses
  • Récapitulatif TVA : collectée, due, et gestion de la franchise en base (article 293 B)
  • Alertes mail avant chaque échéance fiscale — URSSAF, TVA, impôt sur le revenu — avec relance jusqu'à confirmation
  • Page publique SEO de l'entreprise, en option

L'architecture

C'est un monorepo pnpm, TypeScript du front à l'infra, structuré en DDD et Clean Architecture. Le langage métier est entièrement en français et documenté dans un glossaire : les mêmes mots — devis, franchise en base, échéance — se retrouvent à l'identique dans le domaine, les contrats d'API et l'interface.

  • API : NestJS sur Fastify, documentée en OpenAPI/Swagger
  • Front : Nuxt (Vue) déployé sur Vercel
  • Mobile : application dédiée
  • Packages partagés : domain (le cœur métier, sans dépendance framework), contracts, sdk (client typé) et un jeu de données de démo rejouable

L'infrastructure, auto-hébergée

La partie que je trouve la plus intéressante : tout tourne sur mon propre matériel, sans facture cloud.

  • Raspberry Pi en production, avec Docker Compose et des timers systemd qui gèrent la mise à jour automatique, plus un environnement de préproduction séparé
  • Kubernetes (cluster kind) : deployments, services, HPA, ingress, le tout en Kustomize
  • GitOps avec ArgoCD — l'état du cluster est réconcilié depuis le dépôt
  • Stack AWS simulée en local via LocalStack (S3, SES, SQS, CloudWatch) et provisionnée en AWS CDK, ce qui permet de développer et tester l'intégralité des intégrations cloud hors ligne
  • Exposition par tunnel Cloudflare, sans ouvrir le moindre port sur le réseau domestique
  • Observabilité : Prometheus et Grafana

Le tout est couvert par des tests unitaires et end-to-end, et les décisions d'architecture sont consignées en ADR.

Klaro est né d'un besoin que je connais de l'intérieur : je facture mes propres clients en auto-entreprise depuis plus de cinq ans.


À découvrir sur klaro.alexandre-devaux.com.