--- 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.net/pt/realizacoes/plateforme-comptabilite-saas" source: "https://portfolio.josedacosta.net/pt/realizacoes/plateforme-comptabilite-saas.md" html_source: "https://portfolio.josedacosta.net/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-06-02T15:38:28.229Z" --- # Plataforma SaaS de Contabilidade Inteligente Plataforma SaaS full-stack cobrindo contabilidade, gestao fiscal e inteligencia financeira - projetada para pequenas empresas. **Data:** Janeiro 2025 - Marco 2026 **Duração:** 14 meses **Função:** Fundador & CTO - Desenvolvedor solo **Tecnologias:** Next.js 16, TypeScript, Prisma, PostgreSQL, Better Auth, AI SDK, Open Banking, Stripe ### Indicadores-chave - Linhas de codigo: **-** - TypeScript, React, CSS - Funcionalidades: **-** - Modulos autonomos - Rotas API: **-** - Endpoints REST - Modelos de BD: **-** - Modelos Prisma ## Apresentacao _Definicao e escopo do projeto_ ### Dominio Contabilidade, tributacao, gestao financeira, obrigacoes legais das empresas francesas (PCG, CGI, Code de commerce) ### Usuarios-alvo Diretores de PMEs (B2B), contadores, colaboradores contabeis - com 6 funcoes diferenciadas (Admin, Colaborador, Consultor, Contador, Contabilidade, Banco) 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. ### Escopo funcional ### Banco & Open Banking ### Faturamento (vendas e compras) ### Declaracoes fiscais (TVA, IS, CFE...) ### Lancamentos contabeis & FEC ### Assistente com IA ### Conciliacao bancaria ### Gestao de documentos & OCR ### Relatorios financeiros & previsoes ### Faturacao eletronica (DGFIP v3.1) ## Objetivos, contexto, desafios e riscos _Visao estrategica e restricoes_ ### Contexto 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. ### Autonomia contabil Permitir que a ACCENSEO opere sem provedor contabil externo ### Conformidade fiscal Cumprir todas as obrigacoes declarativas de uma SAS sob regime IS, regime real simplificado de TVA ### Pronto para faturacao eletronica Antecipar o mandato frances 2026-2027 sobre faturacao eletronica para evitar corridas de ultima hora ### Complexidade regulatoria A contabilidade francesa e extremamente regulamentada (PCG, CGI, Code de commerce). Qualquer erro nos calculos fiscais pode ter consequencias financeiras diretas. ### Carga de manutencao 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. ### Obsolescencia regulatoria As regras fiscais mudam regularmente (taxas TVA, limites IS, faturacao eletronica prevista 2026-2027). A plataforma deve ser projetada para facilitar a adaptacao. ### Objetivos - 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 ### Desafios de negocio ### Riscos identificados ## As etapas - O que eu fiz _Fases cronologicas e contribuicoes pessoais_ ### Evolucao do desenvolvimento de funcionalidades ### Ideacao e pesquisa de mercado (Inicio 2025) - Formalizei a iniciativa e validei a necessidade de negocio interna - No campo concorrencial, mapeei as funcionalidades das solucoes SaaS contabeis existentes - Défini o escopo funcional alvo adaptado a uma pequena empresa (SAS no regime IS) - No lado regulatorio, pesquisei Open Banking PSD2, declaracoes fiscais EDI e regulamentacao de faturacao eletronica ### Arquitetura e setup tecnico (T1 2025) - Montei a stack frontend: Next.js 16 + TypeScript + Tailwind CSS 4 + 25 componentes shadcn/ui - No lado dos dados, provisionei Docker Compose (PostgreSQL 16) e Prisma ORM (91 modelos) - Optei por uma arquitetura Feature-Driven estruturada em 42 modulos autonomos ### Desenvolvimento de funcionalidades core (T2 2025 - T4 2025) - Na autenticacao, implementei o Better Auth com MFA (email, TOTP, SMS) e os tokens de login de contador - No lado bancario, integrei 3 provedores (Nordigen/GoCardless via PSD2, Bridge, Qonto) - Para o faturamento, construi faturas de venda, orcamentos e faturas de compra, cada um com seu workflow de status completo - Na contabilidade, desenvolvi plano de contas, diarios, lancamentos, razao geral, balancete e FEC - Automatizei as declaracoes fiscais (TVA CA3, IS, CFE, CVAE, DAS2, PAS) com envio EDI via Teledec - Como complemento, codifiquei uma extensao Chrome para o preenchimento automatizado de formularios fiscais em impots.gouv.fr ### Funcionalidades avancadas (T1 2026) - Integrei um assistente IA multi-provedor (OpenAI, Claude, Gemini) com ajuda contextual - No lado de relatorios, entreguei dashboard, balanco, DRE, SIG, orcamento e previsoes de fluxo de caixa - No lado juridico, construi assembleias gerais, registros e workflows de auditor estatutario - Para a folha de pagamento, implementei holerites, DSN, imposto retido na fonte e contribuicoes sociais - Em paralelo, projetei um microsservico Node.js dedicado a recuperacao automatica de faturas ## Os atores - As interacoes _Como colaborei com meu parceiro IA e com as partes interessadas_ ### Por que meu papel humano foi critico ### Meu papel - Direcao & Expertise (~15-20%) - Carreguei a visao do produto e priorizei as funcionalidades em todo o escopo contabil e fiscal - Trouxe a expertise no dominio contabil/fiscal (PCG, CGI, TVA, IS, CFE, DAS2) - Para cada feature, escrevi as especificacoes funcionais e prompts de instrucao detalhados - Em cada arquivo gerado, conduzi uma revisao manual do codigo - logica, nomenclatura, seguranca - Para validar os calculos contabeis e as regras fiscais, escrevi scripts de verificacao dedicados - Apos cada iteracao, conduzi testes de nao-regressao sistematicos - No inicio, auditei a seguranca das plataformas concorrentes - Em paralelo, conduzi a 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 ### Partes interessadas externas - Teledec - Parceiro EDI aprovado pela DGFiP para declaracao fiscal eletronica - GoCardless (Nordigen) - Provedor Open Banking PSD2 (2400+ bancos europeus) - Bridge - Provedor de agregacao bancaria - Qonto - Neobanco com API dedicada - Stripe - Plataforma de pagamento para assinaturas SaaS - OpenAI / Anthropic / Google - Provedores de IA para o assistente contabil Conduzi este projeto como um **duo humano + IA**. Como desenvolvedor humano, dirijo a IA atraves de prompts detalhados para que ela gere 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 de mim **profunda expertise no dominio** para especifica-la corretamente e **verificacao rigorosa** para evitar erros financeiros. ### Workflow de desenvolvimento iterativo Inspirado nas metodologias SDD: Spec Kit, OpenSpec, BMAD, Kiro (AWS) & Tessl ## Os resultados _Impacto para mim e para a empresa_ ### Competencias tecnicas - Reforcei meu dominio de full-stack TypeScript/React/Next.js em escala de producao - No lado da arquitetura, aprofundei a abordagem Feature-Driven para aplicacoes SaaS complexas - Modelei dados relacionais complexos (91 tabelas, relacoes, enums) - Integrei APIs REST exigentes (Open Banking PSD2, Stripe, Teledec EDI) - Na IA multi-provedor, dominei o streaming SSE e a extracao estruturada - Desenvolvi uma extensao Chrome (Manifest V3, content scripts) - No lado da seguranca de aplicacoes, auditei OWASP, detectei IDORs e implementei MFA e RBAC - Em paralelo, pratiquei engenharia reversa em aplicacoes web concorrentes - Este projeto mudou minha forma de trabalhar: agora concebo cada funcionalidade como uma spec testavel e verificavel, e raciocino como desenvolvedor em duo com a IA, nao mais isolado ### Dominio contabil e fiscal - Dominei o Plano Geral de Contas frances (PCG) - Apropriei-me dos regimes TVA e das declaracoes CA3/CA12 com declaracao EDI - Geri o imposto corporativo (IS - parcelas e saldo) - Assimilei as contribuicoes economicas (CFE, CVAE) - No lado da folha, assumi DSN, imposto retido na fonte e contribuicoes sociais - Capacitei-me nas normas de faturacao eletronica (PDP, DGFIP v3.1) - No lado juridico, integrei as obrigacoes das empresas (AG, registros, contas anuais) - Aprofundei Open Banking (PSD2, STET) no plano tecnico e regulatorio - 5 000 EUR/ano - Economia contabil - Honorarios de contador tradicional eliminados (5 000 EUR s/ impostos/ano, excluindo folha) - 10 - Tipos de declaracoes fiscais - Automatizadas via EDI Teledec - Sage - Folha externalizada - DSN e folha de pagamento geridas via Sage Business Cloud Paie, parcialmente automatizadas - 42 - Modulos autonomos - Cobertura funcional completa da contabilidade automatizada ### Metricas do codigo ### Distribuicao de funcionalidades (42 features) ### Feature Coverage Analysis ### Distribuicao de modelos de BD (91 modelos + 63 enums) ### Distribuicao do esforco de desenvolvimento Para mim - Competencias adquiridas e reforcadas gracas a este projeto ### Para a empresa - Impacto de negocio **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, contrôles, 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_ **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 _Como julgo este projeto com o recuo_ ### Pontos fortes - Cobertura funcional excepcional - Com 42 funcionalidades, 114 paginas e 382 rotas API, cubro quase todo o escopo de um software contabil profissional. - Arquitetura limpa e escalavel - No lado da arquitetura, aprofundei uma abordagem Feature-Driven com modulos autonomos e independentes (componentes, hooks, servicos, tipos). - Abordagem metodica - Antes de escrever uma unica linha de codigo, conduzi uma auditoria de seguranca, um estudo de mercado e uma analise de cobertura. ### Pontos de melhoria - Historico de commits a segmentar melhor - Eu deveria ter agrupado meus commits por feature com branches dedicadas - teria melhorado a rastreabilidade e a revisao de codigo. - Cobertura de testes a reforcar - Nos modulos criticos (calculos fiscais, lancamentos contabeis, declaracoes), eu teria ganhado em posicionar mais testes unitarios e de integracao. ### O que eu faria diferente - **Commits regulares desde o inicio**: teria disciplinado meus commits para preservar um historico exploravel e permitir rollbacks seguros. - **Testes desde o inicio** (TDD ou no minimo testes para funcoes de calculo fiscal) - eu deveria ter testado a logica de negocio mais critica conforme era escrita. - **Documentacao automatica de API** (Swagger/OpenAPI): eu a teria configurado para as 382 rotas, para facilitar o onboarding de futuros desenvolvedores e o consumo da API. ### Os ensinamentos duradouros que este projeto me trouxe - Um desenvolvedor motivado com as ferramentas certas pode produzir software de nivel empresarial - Entreguei 234.000 linhas de codigo em ~14 meses, sozinho - uma conquista significativa que me mostrou ate onde o desenvolvimento assistido por IA pode levar um desenvolvedor solo. ## Competências aplicadas _Competências técnicas e humanas aplicadas_ - **[Resolucao de Problemas & Adaptabilidade](https://portfolio.josedacosta.net/pt/habilidades/resolucao-de-problemas-adaptabilidade.md)** - PCG, CGI, Code de commerce, EDI Teledec, PSD2 e preparação para a e-fatura 2026-2027 - Aprendizado do domínio contábil francês, Open Banking PSD2 e da declaração fiscal EDI - **[Arquitetura de Software & Sistemas](https://portfolio.josedacosta.net/pt/habilidades/arquitetura-de-software-sistemas.md)** - Arquitetura Feature-Driven com 42 módulos autônomos e 91 modelos de dados. 382 rotas REST API com controle de acesso multi-perfis (6 papéis) e e-fatura DGFIP v3.1 - **[Desenvolvimento Fullstack](https://portfolio.josedacosta.net/pt/habilidades/desenvolvimento-fullstack.md)** - Plataforma SaaS de 234K linhas: Next.js 16, React 19, TypeScript, 42 features, 382 rotas API - **[DevOps, Cloud & Industrializacao de Produção](https://portfolio.josedacosta.net/pt/habilidades/devops-cloud-industrializacao-de-producao.md)** - Docker Compose + PostgreSQL 16 + Open Banking PSD2 (Bridge, Qonto, GoCardless) - **[Dados, IA & Machine Learning](https://portfolio.josedacosta.net/pt/habilidades/dados-ia-machine-learning.md)** - 91 modelos Prisma com esquema relacional complexo: plano de contas, diários, lançamentos, conciliação bancária, FEC - **[Seguranca de Aplicacoes & Conformidade](https://portfolio.josedacosta.net/pt/habilidades/seguranca-de-aplicacoes-conformidade.md)** - Auditoria de segurança dos concorrentes (IDOR, KYC) que orientou o design seguro da plataforma ## Trajetória relacionada _Experiência profissional ligada a está realização_ - **ACCENSEO - CTO & Fundador** - Empresa de consultoria e desenvolvimento de TI fornecendo serviços completos: desenvolvimento de software sob medida, integração de sistemas, infraestrutura em nuvem, hospedagem de bancos de dados e consultoria técnica. Ajudando PMEs e empresas de médio porte a transformar seus sistemas de TI em vantagens competitivas. ## Galeria de imagens _Capturas e visuais do projeto_ ## Você tem um SaaS de contabilidade para projetar ? Entreguei este SaaS para escritorios de contabilidade: entrada automatizada, relatorios consolidados e fluxos de validacao sob medida. Vamos conversar sobre seu contexto. **Entrar em contato**