Aller au contenu
Cadre
Produit personnel
Type
SaaS en production
Rôle
Fondateur & Software Engineer
Période
2026 — en cours
Stack
Docker, Laravel, PHP, PostgreSQL, Tailwind CSS, TypeScript, Vue.js

FACTio

Mon propre SaaS de facturation et de suivi des paiements, destiné aux indépendants et aux petites entreprises.

Les petites entreprises n’ont pas les moyens de payer un comptable au quotidien. Les factures sont émises au fil de l’eau, éparpillées, avec les connaissances du bord. Et en fin d’année, au moment de produire les états financiers à transmettre à l’État, tout le monde est surmené.

FACTio est né de ce constat. Je l’ai construit pour émettre des factures et des devis, suivre les dépenses et donner une vue sur la comptabilité sans que l’utilisateur ait à renseigner quoi que ce soit. Avec l’arrivée de la FNE en Côte d’Ivoire, il simplifie aussi une intégration difficile.

C’est mon propre SaaS, du premier commit de janvier 2026 au déploiement automatisé en production. Cette étude de cas raconte les décisions qui ont façonné son architecture, ce que j’ai choisi de reporter et ce qui reste à faire.

Page d'accueil de FACTio
Fig. 1 — Page d'accueil de FACTio

En bref

Les décisions clés.

  1. 01WhatsApp, de l'embarqué au service dédié

    Problème : un moteur WhatsApp dans le dépôt lie le produit à une brique instable. Décision : FACTio devient client de Wasly, mon autre SaaS (WhatsApp), avec une session par entreprise et des webhooks signés HMAC-SHA256. Conséquence : la messagerie devient un service à part entière, que FACTio utilise comme n’importe quel client.

  2. 02Numéroter sans doublon

    Un compteur par entreprise, type et année, incrémenté sous SELECT … FOR UPDATE. Un numéro pris est sauté, jamais réutilisé ; le format (préfixe, séparateur, longueur) se configure.

  3. 03Une comptabilité qu'on ne réécrit pas

    Écritures OHADA automatiques, corrections par contre-passation, clôture qui verrouille la période, export FEC, tests d’équilibre.

  4. 04FNE : un lien par entreprise, avec garde-fous

    Chaque entreprise saisit son URL de production, validée avant tout appel ; une même certification ne peut pas être lancée deux fois en parallèle.

  5. 05Déployer sans casser

    Le déploiement de production ne part qu’après une CI verte sur la branche principale, sans interruption de service, avec des images de base à jour.

Le constat de départ

J’ai voulu répondre à ce constat avec un outil simple : on émet ses factures et ses devis, on suit ses dépenses, et tout cela donne une vue sur la comptabilité sans que l’utilisateur ait à renseigner quoi que ce soit. L’effet recherché est double. L’entrepreneur apprend des notions de comptabilité en voyant ce que produisent ses propres opérations ; et, comme tout est centralisé, le comptable peut établir en fin d’année un état financier de qualité, avec sûreté.

Deuxième déclencheur : l’arrivée de la FNE en Côte d’Ivoire. L’intégrer dans un système est difficile ; FACTio la simplifie, et c’est ma façon d’encourager les entreprises à être en règle.

Je ne publie pas ici de chiffres d’adoption : ce n’est pas le sujet de cette étude de cas.

Les premières briques

Le dépôt naît le 3 janvier 2026 avec une API Laravel et une application Vue dans un même monorepo. Les premiers jours, j’écris les écrans d’authentification et la configuration de déploiement. Puis le projet s’interrompt jusqu’à la fin mars.

En mars, le vrai sujet devient la mise en ligne. Pendant une semaine, les commits racontent le quotidien d’un premier déploiement : ports, nginx, variables d’environnement, CORS, délais d’attente. À la fin, un pipeline GitHub Actions déploie sur un VPS. En avril viennent les abonnements, les permissions, les premiers canaux de support et le suivi d’erreurs avec Sentry. En septembre, j’ajoute l’affiliation et ma première suite de tests complète avec une CI.

Une architecture simple, volontairement

Le backend est une API Laravel authentifiée par Sanctum, avec trois espaces séparés : utilisateur, administrateur et affilié. Le frontend est une application Vue en TypeScript (Vite, Pinia, Tailwind), installable comme application web.

En production, Docker Compose fait tourner cinq services : l’API en php-fpm, un worker de file d’attente pour les envois, un planificateur pour les tâches récurrentes, et deux nginx. Les données vivent dans PostgreSQL ; les tests tournent sur SQLite. Les services externes sont peu nombreux : Lemon Squeezy pour l’abonnement, la plateforme FNE pour la certification, Google pour la connexion, Sentry pour les erreurs, et Wasly, le SaaS de messagerie WhatsApp que je développe en parallèle et dont FACTio est le premier client.

Schéma simplifié de l'architecture de FACTio : application Vue, deux nginx, API Laravel, worker de file d'attente, planificateur, PostgreSQL et services externes

Schéma simplifié, établi d’après la configuration Docker Compose du projet.

Je n’ai pas cherché à faire une architecture « scalable » avant d’avoir des utilisateurs : le choix tient en un monorepo, une base et des services bien séparés.

Octobre : passer d’un produit à une feuille de route

En octobre 2026, j’ai changé de méthode. J’ai écrit une feuille de route à partir de l’état réel du code (routes, modèles, migrations, services), puis je l’ai exécutée par lots : fondations, audit, PDF, facturation, clients, relances, dépenses et trésorerie, comptabilité, authentification et abonnement, observabilité, portail client et PWA. Chaque lot était fusionné avant le suivant.

Je me suis fait aider par un assistant de code (Claude) : pour déboguer certaines erreurs, pour challenger mes propositions par rapport à mes idées de départ et pour implémenter plusieurs lots. Le périmètre, les arbitrages et la validation (tests, CI, mise en production) restaient les miens.

Le 6 octobre, une série de décisions a figé la direction : abonnement par carte à prélèvement automatique (pas de Mobile Money), WhatsApp non plafonné hors essai pour attirer les premiers utilisateurs, et paiement en ligne du client final reporté.

Les décisions qui ont façonné le produit

WhatsApp : séparer le moteur du produit. La première version embarquait un moteur WhatsApp dans le dépôt. Je l’ai sorti de FACTio pour m’appuyer sur Wasly, l’autre SaaS que je développe et dont FACTio est le premier client : une session par entreprise, des envois mis en file d’attente, des webhooks signés. Chaque produit garde ainsi ses propres responsabilités.

Numérotation : un compteur sous verrou. Une facture doit avoir un numéro unique, même si deux utilisateurs créent un document au même instant. Chaque entreprise dispose d’une série par type et par année, incrémentée dans une transaction verrouillée ; un numéro déjà pris est sauté, jamais réutilisé. Le format est configurable.

Comptabilité : on ne réécrit jamais l’histoire. Les écritures OHADA sont générées automatiquement, les corrections passent par des contre-passations, et la clôture d’exercice verrouille la période. Des tests vérifient l’équilibre. Un défaut m’a rappelé pourquoi : des comptes tiers partagés entre clients ont dû être corrigés par une commande de réparation.

FNE : chaque entreprise garde son lien. J’ai décidé que chaque entreprise saisit son propre lien de production FNE. Ce choix demandait des garde-fous : l’adresse est validée avant tout appel, et une même certification ne peut pas être lancée deux fois en parallèle. Le PDF porte le sticker de la DGI avec numéro et QR code.

Déploiement : pas sans CI. Le déploiement de production ne part que si la CI est verte sur la branche principale, sans arrêt des conteneurs, avec récupération des dernières images de base.

Qualité : des tests, et leurs pièges

La CI exécute le lint, les audits de dépendances, les tests backend, les tests frontend, le build et un parcours de bout en bout Playwright sur un build de production. Elle m’a aussi donné des leçons concrètes : un échec intermittent lié au JIT d’OPcache sur les runners, un parcours E2E instable corrigé en passant SQLite en mode WAL, des alertes de sécurité sans correctif que j’ai documentées plutôt que de casser la configuration de lint.

La relecture du code m’a aussi fait trouver plusieurs failles de sécurité, que j’ai corrigées.

Ce que j’ai laissé de côté

Pas d’abonnement en Mobile Money, pas de paiement en ligne pour le client final, pas de rapprochement bancaire, pas de gestion de stock, pas de multi-devise. Ces absences sont des décisions ou des reports, pas des oublis. FACTio n’embarque aucune fonctionnalité d’intelligence artificielle : l’IA a servi à construire le produit, pas à le faire fonctionner.

Où en est FACTio

Le produit est en production, déployé automatiquement après chaque CI verte. Les derniers travaux versionnés portent sur la sécurité des dépendances et des images de base. Autour du code, le projet s’accompagne d’une landing, d’un playbook de démonstration et de vidéos de présentation.

Ce qui reste : relance des devis, import d’historique, rapprochement bancaire, et, selon l’adoption, le paiement en ligne du client final.