--- title: "Plataforma SaaS de Contabilidade Inteligente" description: "Plataforma SaaS full-stack cobrindo contabilidade, gestao fiscal e inteligencia financeira - projetada para pequenas empresas." locale: "pt" canonical: "https://portfolio.josedacosta.info/pt/realizacoes/plateforme-comptabilite-saas" source: "https://portfolio.josedacosta.info/pt/realizacoes/plateforme-comptabilite-saas.md" html_source: "https://portfolio.josedacosta.info/pt/realizacoes/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:46:31.833Z" --- # Plataforma SaaS de Contabilidade Inteligente Plataforma SaaS full-stack cobrindo contabilidade, gestao fiscal e inteligencia financeira - projetada para pequenas empresas. **Date:** Janeiro 2025 - Marco 2026 **Duration:** 14 meses **Role:** Fundador & CTO - Desenvolvedor solo **Technologies:** Next.js 16, TypeScript, Prisma, PostgreSQL, Better Auth, AI SDK, Open Banking, Stripe ### Key Metrics - Linhas de codigo: **-** - TypeScript, React, CSS - Funcionalidades: **-** - Modulos autonomos - Rotas API: **-** - Endpoints REST - Modelos de BD: **-** - Modelos Prisma ## Apresentacao _Definicao e escopo do projeto_ ### Domain Contabilidade, tributacao, gestao financeira, obrigacoes legais das empresas francesas (PCG, CGI, Code de commerce) ### Target Users Diretores de PMEs (B2B), contadores, colaboradores contabeis - com 6 funcoes diferenciadas (Admin, Colaborador, Consultor, Contador, Contabilidade, Banco) **Content:** A **Plataforma SaaS de Contabilidade Inteligente** e uma aplicacao web full-stack completa projetada para **PMEs e autonomos franceses**. Ela cobre todo o espectro contabil, fiscal e financeiro que uma empresa precisa gerenciar para permanecer em conformidade legal na Franca. Nascida de uma necessidade concreta - gerenciar a contabilidade da **ACCENSEO**, uma empresa de consultoria em software. **Domain:** Dominio **Target Users:** Usuarios-alvo **Functional Scope:** Escopo funcional **Scope Banking:** Banco & Open Banking **Scope Invoicing:** Faturamento (vendas e compras) **Scope Tax:** Declaracoes fiscais (TVA, IS, CFE...) **Scope Accounting:** Lancamentos contabeis & FEC **Scope A I:** Assistente com IA **Scope Reconciliation:** Conciliacao bancaria **Scope Documents:** Gestao de documentos & OCR **Scope Reporting:** Relatorios financeiros & previsoes **Scope Einvoicing:** Faturacao eletronica (DGFIP v3.1) ## Objetivos, contexto, desafios e riscos _Visao estrategica e restricoes_ ### Context O projeto se baseia em uma **analise aprofundada das solucoes contabeis existentes**: paginas web salvas, respostas de API interceptadas (arquivos JSON), codigo fonte JavaScript extraido e capturas de tela sistematicas. Uma **auditoria de seguranca** das plataformas concorrentes foi realizada, identificando varias vulnerabilidades (IDOR, problemas KYC) - essa auditoria informou o design seguro da plataforma. Um **estudo de mercado de softwares contabeis** foi conduzido, junto com pesquisas sobre **Open Banking PSD2** e agregadores bancarios para escolher os provedores de integracao. Uma documentacao sobre plataformas de desmaterializacao (PDP) tambem foi reunida. ### Stake Autonomy Permitir que a ACCENSEO opere sem provedor contabil externo ### Stake Compliance Cumprir todas as obrigacoes declarativas de uma SAS sob regime IS, regime real simplificado de TVA ### Stake Einvoicing Antecipar o mandato frances 2026-2027 sobre faturacao eletronica para evitar corridas de ultima hora - Construir uma plataforma contabil completa para gerenciar autonomamente a contabilidade da ACCENSEO - Automatizar todas as obrigacoes fiscais: TVA (CA3), IS, CFE, CVAE, DAS2, PAS - com envio EDI via Teledec - Integrar Open Banking para sincronizacao automatica de transacoes bancarias (Nordigen/GoCardless, Bridge, Qonto) - Fornecer uma camada de IA para auxiliar os usuarios na categorizacao, analise de documentos e questoes contabeis/fiscais - Construir uma base de codigo reutilizavel potencialmente comercializavel como SaaS independente **Objectives:** Objetivos **Context:** Contexto **Stakes:** Desafios de negocio **Stake Autonomy:** Autonomia contabil **Stake Compliance:** Conformidade fiscal **Stake Einvoicing:** Pronto para faturacao eletronica **Risks:** Riscos identificados **Risk1 Title:** Complexidade regulatoria **Risk1 Desc:** A contabilidade francesa e extremamente regulamentada (PCG, CGI, Code de commerce). Qualquer erro nos calculos fiscais pode ter consequencias financeiras diretas. **Risk2 Title:** Carga de manutencao **Risk2 Desc:** Com 234.000 linhas de codigo e 91 modelos de BD, o projeto atinge um tamanho consideravel para um desenvolvedor solo. A manutencao a longo prazo exige arquitetura rigorosa. **Risk3 Title:** Obsolescencia regulatoria **Risk3 Desc:** As regras fiscais mudam regularmente (taxas TVA, limites IS, faturacao eletronica prevista 2026-2027). A plataforma deve ser projetada para facilitar a adaptacao. ## As etapas - O que eu fiz _Fases cronologicas e contribuicoes pessoais_ - Ideacao e pesquisa de mercado - Arquitetura e setup tecnico - Desenvolvimento de funcionalidades core - Funcionalidades avancadas **Phase1 Period:** Inicio 2025 **Phase2 Period:** T1 2025 **Phase3 Period:** T2 2025 - T4 2025 **Phase4 Period:** T1 2026 ## Os atores - As interacoes _Equipe, partes interessadas e dinamicas de colaboracao_ ### José DA COSTA - Direcao & Expertise (~15-20%) - Visao do produto e priorizacao de funcionalidades em todo o escopo contabil e fiscal - Expertise no dominio contabil/fiscal (PCG, CGI, TVA, IS, CFE, DAS2) - Especificacoes funcionais e prompts de instrucao detalhados para cada feature - Revisao manual do codigo em cada arquivo gerado - logica, nomenclatura, seguranca - Escrita de scripts de verificacao para validar calculos contabeis e regras fiscais - Testes de nao-regressao sistematicos apos cada iteracao - Auditoria de seguranca das plataformas concorrentes - Pesquisa regulatoria sobre Open Banking e faturacao eletronica ### Claude Code (IA) - Implementacao (~80-85%) - Geracao de codigo TypeScript/React/Next.js em toda a stack - 42 modulos funcionais com CRUD completo e logica de negocio - 382 rotas API com validacao e tratamento de erros - Esquema Prisma com 91 modelos e 63 enums - Integracao de APIs de terceiros (Stripe, Open Banking, EDI) - Componentes UI com shadcn/ui e layouts responsivos **Human Essential Text:** Este projeto foi construido como um **duo humano + IA**. O desenvolvedor humano dirige a IA atraves de prompts detalhados para gerar codigo de nivel producao em uma plataforma contabil complexa. Uma plataforma contabil manipula **dados financeiros regulamentados** - calculos fiscais, conciliacoes bancarias, declaracoes legais. A IA gera codigo rapidamente, mas nao consegue entender o **direito tributario frances** (CGI, PCG), validar a **exatidao contabil**, nem tomar **decisoes de produto** sobre o que construir. Cada funcionalidade exigiu **profunda expertise no dominio** para ser especificada corretamente e **verificacao rigorosa** para evitar erros financeiros. **Stakeholders:** Partes interessadas externas **Workflow:** Workflow de desenvolvimento iterativo **Wf Inspiration:** Inspirado nas metodologias SDD: Spec Kit, OpenSpec, BMAD, Kiro (AWS) & Tessl ## Os resultados _Impacto para mim e para a empresa_ **Codebase Metrics:** Metricas do codigo **Feature Dist:** Distribuicao de funcionalidades (42 features) **Comparison:** Feature Coverage Analysis **Db Dist:** Distribuicao de modelos de BD (91 modelos + 63 enums) **Effort Dist:** Distribuicao do esforco de desenvolvimento **For Me:** Para mim - Competencias adquiridas e reforcadas **Technical Skills:** Competencias tecnicas **Domain Skills:** Dominio contabil e fiscal **For Company:** Para a empresa - Impacto de negocio **Delivered Features:** **Resumo das funcionalidades entregues:** - **Contabilidade e lancamentos**: Plano de contas (geral, auxiliar, analitico), diarios, lancamentos (vendas, compras, banco), razao geral, balancete, conciliacao bancaria, FEC (geracao, controles, historico), lancamentos de encerramento - **Banco**: Conexoes multi-banco (Nordigen, Bridge, Qonto), sincronizacao automatica de transacoes, categorizacao assistida por IA, gestao de recibos, conciliacao faturas/transacoes - **Faturamento**: Faturas de venda (rascunho, pendente, atrasada, recebida, cancelada), orcamentos (rascunho, enviado, aceito, recusado, faturado, expirado), faturas de compra, geracao PDF, notas de credito, faturacao eletronica - **Fiscal**: TVA (CA3 mensal/trimestral + simulacao), IS (parcelas + saldo), CFE, CVAE, DAS2, PAS, imposto salarial, RCM 2777, calendario fiscal, declaracao EDI via Teledec, extensao Chrome para impots.gouv.fr - **IA**: Assistente chat contabil/fiscal (3 provedores), ajuda contextual com niveis de detalhe, analise de documentos com extracao estruturada (esquemas Zod) ## Os desdobramentos do projeto _O que aconteceu depois e estado atual_ **Content:** **Futuro imediato**: A plataforma ainda esta em **desenvolvimento ativo** em marco de 2026. As ultimas modificacoes de arquivos fonte datam de 12 de marco de 2026 (rotas API de colaborador). O foco esta na estabilizacao das funcionalidades core e na preparacao para uso em producao. **Trajetoria de medio prazo**: Varias direcoes estrategicas estao sendo exploradas: - **Deploy em producao** para as necessidades contabeis proprias da ACCENSEO - **Prontidao para faturacao eletronica** para o mandato frances 2026-2027 - documentacao PDP completa (especificacoes DGFIP v3.1, anexos semanticos, estudos de viabilidade) ja esta preparada - **Potencial comercializacao SaaS** - a arquitetura Feature-Driven com 42 modulos autonomos foi projetada desde o inicio para suportar operacao multi-tenant A abordagem Feature-Driven garante que novos modulos possam ser adicionados independentemente sem impactar funcionalidades existentes, e a estrategia IA multi-provedor protege contra lock-in de fornecedor. ## Meu olhar critico _Analise retrospectiva e licoes aprendidas_ ### Would Do Differently - **Commits regulares desde o inicio** para preservar um historico exploravel e permitir rollbacks seguros - **Testes desde o inicio** (TDD ou no minimo testes para funcoes de calculo fiscal) - a logica de negocio mais critica deveria ter sido testada conforme escrita - **Documentacao automatica de API** (Swagger/OpenAPI) para as 382 rotas - isso facilitaria o onboarding de futuros desenvolvedores e o consumo da API **Strengths:** Pontos fortes **Improvements:** Pontos de melhoria **Would Do Differently:** O que eu faria diferente **Lessons:** Licoes duradouras