--- title: "Plateforme de Comptabilité SaaS Intelligente" description: "Plateforme SaaS full-stack boostée à l'IA couvrant la comptabilité, la gestion fiscale et l'intelligence financière - conçue pour les petites entreprises." locale: "fr" canonical: "https://portfolio.josedacosta.info/fr/realisations/plateforme-comptabilite-saas" source: "https://portfolio.josedacosta.info/fr/realisations/plateforme-comptabilite-saas.md" html_source: "https://portfolio.josedacosta.info/fr/realisations/plateforme-comptabilite-saas" author: "José DA COSTA" date: "2025" type: "achievement" slug: "plateforme-comptabilite-saas" tags: ["Next.js 16", "TypeScript", "Prisma", "PostgreSQL", "Better Auth", "AI SDK", "Open Banking", "Stripe"] generated_at: "2026-04-23T15:44:04.383Z" --- # Plateforme de Comptabilité SaaS Intelligente Plateforme SaaS full-stack boostée à l'IA couvrant la comptabilité, la gestion fiscale et l'intelligence financière - conçue pour les petites entreprises. **Date:** Janvier 2025 - Mars 2026 **Duration:** 14 mois **Role:** Fondateur & CTO - Développeur solo **Technologies:** Next.js 16, TypeScript, Prisma, PostgreSQL, Better Auth, AI SDK, Open Banking, Stripe ### Key Metrics - Lignes de code: **-** - TypeScript, React, CSS - Fonctionnalités: **-** - Modules autonomes - Routes API: **-** - Endpoints REST - Modèles de BDD: **-** - Modèles Prisma ## Présentation _Définition et périmètre du projet_ ### Domain Comptabilite, fiscalite, gestion financiere, obligations legales des entreprises françaises (PCG, CGI, Code de commerce) ### Target Users Dirigeants de TPE/PME (B2B), experts-comptables, collaborateurs comptables - avec 6 rôles differencies (Admin, Collaborateur, Consultant, Comptable, Comptabilite, Banque) **Content:** La **Plateforme de Comptabilité SaaS Intelligente** est une application web full-stack complète conçue pour les **TPE/PME et indépendants français**. Elle couvre l'ensemble du spectre comptable, fiscal et financier qu'une entreprise doit gérer pour rester en conformité legale en France. Nee d'un besoin concret - gérer la comptabilité d'**ACCENSEO**, une société de conseil en logiciels. **Domain:** Domaine **Target Users:** Utilisateurs cibles **Functional Scope:** Périmètre fonctionnel **Scope Banking:** Banque & Open Banking **Scope Invoicing:** Facturation (ventes & achats) **Scope Tax:** Declarations fiscales (TVA, IS, CFE...) **Scope Accounting:** Ecritures comptables & FEC **Scope A I:** Assistant IA **Scope Reconciliation:** Rapprochement bancaire **Scope Documents:** Gestion documentaire & OCR **Scope Reporting:** Reporting financier & prévisions **Scope Einvoicing:** Facturation electronique (DGFIP v3.1) ## Objectifs, contexte, enjeux et risques _Vision stratégique et contraintes_ ### Context Le projet s'appuie sur une **analyse approfondie des solutions comptables existantes** : pages web sauvegardees, réponses API interceptees (fichiers JSON), code source JavaScript extrait et captures d'ecran systematiques. Un **audit de sécurité** des plateformes concurrentes a été réalisé, identifiant plusieurs vulnérabilités (IDOR, problèmes KYC) - cet audit a nourri la conception sécurisée de la plateforme. Une **étude de marché des logiciels comptables** a été menee, ainsi que des recherches sur l'**Open Banking DSP2** et les agregateurs bancaires pour choisir les providers d'intégration. Une documentation sur les plateformes de dématérialisation (PDP) a également été constituée. ### Stake Autonomy Permettre a ACCENSEO de fonctionner sans prestataire comptable externe ### Stake Compliance Respecter toutes les obligations declaratives d'une SAS à l'IS, au regime réel simplifie de TVA ### Stake Einvoicing Anticiper le mandat français 2026-2027 sur la facturation electronique pour éviter tout rattrapage en urgence - Construire une plateforme comptable complète pour gérer la comptabilité d'ACCENSEO de manière autonome - Automatiser toutes les obligations fiscales : TVA (CA3), IS, CFE, CVAE, DAS2, PAS - avec envoi EDI via Teledec - Intégrer l'Open Banking pour la synchronisation automatique des transactions bancaires (Nordigen/GoCardless, Bridge, Qonto) - Fournir une couche d'IA pour assister les utilisateurs dans la categorisation, l'analyse de documents et les questions comptables/fiscales - Construire une base de code réutilisable potentiellement commercialisable en tant que SaaS indépendant **Objectives:** Objectifs **Context:** Contexte **Stakes:** Enjeux business **Stake Autonomy:** Autonomie comptable **Stake Compliance:** Conformité fiscale **Stake Einvoicing:** Pret pour la facturation electronique **Risks:** Risques identifies **Risk1 Title:** Complexité règlementaire **Risk1 Desc:** La comptabilité française est extrêmêment règlementee (PCG, CGI, Code de commerce). Toute erreur dans les calculs fiscaux peut avoir des consequences financieres directes. **Risk2 Title:** Charge de maintenance **Risk2 Desc:** Avec 234 000 lignes de code et 91 modèles de BDD, le projet atteint une taille considérable pour un développeur solo. La maintenance à long terme nécessité une architecture rigoureuse. **Risk3 Title:** Obsolescence règlementaire **Risk3 Desc:** Les règles fiscales changent régulièrement (taux TVA, seuils IS, facturation electronique prévue 2026-2027). La plateforme doit être conçue pour faciliter l'adaptation. ## Les étapes - Ce que j'ai fait _Phases chronologiques et contributions personnelles_ - Idéation & étude de marché - Architecture & setup technique - Développement des fonctionnalités core - Fonctionnalités avancees **Phase1 Period:** Debut 2025 **Phase2 Period:** T1 2025 **Phase3 Period:** T2 2025 - T4 2025 **Phase4 Period:** T1 2026 ## Les acteurs - Les interactions _Équipe, parties prenantes et dynamiques de collaboration_ ### José DA COSTA - Direction & Expertise (~15-20 %) - Vision produit et priorisation des fonctionnalités sur l'ensemble du périmètre comptable et fiscal - Expertise métier comptable/fiscale (PCG, CGI, TVA, IS, CFE, DAS2) - Spécifications fonctionnelles et prompts d'instructions detailles pour chaque feature - Revue manuelle du code sur chaque fichier genere - logique, nommage, sécurité - Ecriture de scripts de verification pour valider les calculs comptables et les regles fiscales - Tests de non-regression systematiques apres chaque iteration - Audit de sécurité des plateformes concurrentes - Recherche réglementaire Open Banking et facturation electronique ### Claude Code (IA) - Implémentation (~80-85 %) - Génération du code TypeScript/React/Next.js sur l'ensemble de la stack - 42 modules fonctionnels avec CRUD complet et logique métier - 382 routes API avec validation et gestion des erreurs - Schema Prisma avec 91 modèles et 63 enums - Intégration APIs tierces (Stripe, Open Banking, EDI) - Composants UI avec shadcn/ui et layouts responsives **Human Essential Text:** Ce projet a été réalisé en **binome humain + IA**. Le développeur humain pilote l'IA a travers des prompts detailles pour générer du code de niveau production sur une plateforme comptable complexe. Une plateforme comptable manipule des **données financieres réglementees** - calculs fiscaux, rapprochements bancaires, declarations legales. L'IA genere du code rapidement, mais elle ne peut pas comprendre le **droit fiscal français** (CGI, PCG), valider l'**exactitude comptable**, ni prendre les **décisions produit** sur ce qu'il faut construire. Chaque fonctionnalite a nécessité une **expertise métier approfondie** pour etre specifiee correctement et une **verification rigoureuse** pour eviter les erreurs financieres. **Stakeholders:** Parties prenantes externes **Workflow:** Workflow de développement itératif **Wf Inspiration:** Inspire des méthodologies SDD : Spec Kit, OpenSpec, BMAD, Kiro (AWS) & Tessl ## Les résultats _Impact pour moi et pour l'entreprise_ **Codebase Metrics:** Métriques du code **Feature Dist:** Répartition des fonctionnalités (42 features) **Comparison:** Feature Coverage Analysis **Db Dist:** Répartition des modèles de BDD (91 modèles + 63 enums) **Effort Dist:** Répartition de l'effort de développement **For Me:** Pour moi - Compétences acquises et renforcees **Technical Skills:** Compétences techniques **Domain Skills:** Domaine comptable & fiscal **For Company:** Pour l'entreprise - Impact business **Delivered Features:** **Resume des fonctionnalités livrées :** - **Comptabilite & écritures** : Plan comptable (général, auxiliaire, analytique), journaux, écritures (ventes, achats, banque), grand livré, balance, rapprochement bancaire, FEC (génération, contrôles, historique), écritures de cloture - **Banque** : Connexions multi-banques (Nordigen, Bridge, Qonto), synchro automatique des transactions, categorisation assistee par IA, gestion des justificatifs, rapprochement factures/transactions - **Facturation** : Factures de vente (brouillon, en attente, en retard, encaissee, annulee), devis (brouillon, envoye, accepte, refuse, facture, expire), factures d'achat, génération PDF, avoirs, facturation electronique - **Fiscalite** : TVA (CA3 mensuelle/trimestrielle + simulation), IS (acomptes + solde), CFE, CVAE, DAS2, PAS, taxe sur les salaires, RCM 2777, calendrier fiscal, teledeclaration EDI via Teledec, extension Chrome pour impots.gouv.fr - **IA** : Assistant chat comptable/fiscal (3 providers), aide contextuelle avec niveaux de detail, analyse de documents avec extraction structuree (schemas Zod) ## Les lendemains du projet _Ce qui s'est passe après et état actuel_ **Content:** **Futur immédiat** : La plateforme est toujours en **développement actif** en mars 2026. Les dernières modifications de fichiers source datent du 12 mars 2026 (routes API collaborateur). L'accent est mis sur la stabilisation des fonctionnalités core et la préparation à l'usage en production. **Trajectoire à moyen terme** : Plusieurs directions stratégiques sont explorées : - **Déploiement en production** pour les besoins comptables propres d'ACCENSEO - **Préparation à la facturation electronique** pour le mandat français 2026-2027 - la documentation PDP complète (spécifications DGFIP v3.1, annexes semantiques, études de faisabilite) est deja preparee - **Potentielle commercialisation SaaS** - l'architecture Feature-Driven avec 42 modules autonomes a été conçue des le départ pour supporter le mode multi-tenant L'approche Feature-Driven garantit que de nouveaux modules peuvent être ajoutes independamment sans impacter les fonctionnalités existantes, et la stratégie IA multi-provider protégé contre le verrouillage fournisseur. ## Mon regard critique _Analyse rétrospective et leçons apprises_ ### Would Do Differently - **Des commits réguliers des le debut** pour conserver un historique exploitable et permettre des rollbacks surs - **Des tests des le debut** (TDD ou au minimum des tests pour les fonctions de calcul fiscal) - la logique métier la plus critique aurait du être testee au fur et a mesure - **Documentation API automatique** (Swagger/OpenAPI) pour les 382 routes - cela faciliterait l'onboarding de futurs développeurs et la consommation de l'API **Strengths:** Points forts **Improvements:** Points d'amelioration **Would Do Differently:** Ce que j'aurais fait différemment **Lessons:** Leçons durables