Contato
Plataforma SaaS de Contabilidade Inteligente

Plataforma SaaS de Contabilidade Inteligente

Plataforma SaaS full-stack cobrindo contabilidade, gestao fiscal e inteligencia financeira - projetada para pequenas empresas.

Janeiro 2025 - Marco 2026
14 meses
Fundador & CTO - Desenvolvedor solo
ACCENSEO
Next.js 16React 19TypeScriptPrisma 7PostgreSQL 16Tailwind CSS 4shadcn/uiBetter AuthVercel AI SDKOpenAIAnthropic ClaudeGoogle GeminiStripeOpen Banking PSD2Teledec EDIDockerVitestPlaywright

Linhas de codigo

234.292

TypeScript, React, CSS

Funcionalidades

42

Modulos autonomos

Rotas API

382

Endpoints REST

Modelos de BD

91

Modelos Prisma

Apresentacao

Definicao e escopo do projeto

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.

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)

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

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
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.

Desafios de negocio

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

Riscos identificados

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.

As etapas - O que eu fiz

Fases cronologicas e contribuicoes pessoais

Phase 1
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
Phase 2
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
Phase 3
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
Phase 4
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

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.

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
Workflow de desenvolvimento iterativo

Inspirado nas metodologias SDD: Spec Kit, OpenSpec, BMAD, Kiro (AWS) & Tessl

Os resultados

Impacto para mim e para a empresa

Distribuicao de funcionalidades (42 features)
Distribuicao de modelos de BD (91 modelos + 63 enums)
Para mim - Competencias adquiridas e reforcadas gracas a este projeto

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
Para a empresa - Impacto de negocio

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

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.

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.

Competências aplicadas

Competências técnicas e humanas aplicadas

Competências técnicas

Arquitetura & Design5/5

Arquitetura de Software & Sistemas

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 de software5/5

Desenvolvimento Fullstack

Plataforma SaaS de 234K linhas: Next.js 16, React 19, TypeScript, 42 features, 382 rotas API

DevOps & Cloud4/5

DevOps, Cloud & Industrializacao de Produção

Docker Compose + PostgreSQL 16 + Open Banking PSD2 (Bridge, Qonto, GoCardless)

Dados & IA4/5

Dados, IA & Machine Learning

91 modelos Prisma com esquema relacional complexo: plano de contas, diários, lançamentos, conciliação bancária, FEC

Segurança4/5

Seguranca de Aplicacoes & Conformidade

Auditoria de segurança dos concorrentes (IDOR, KYC) que orientou o design seguro da plataforma

Galeria de imagens

Capturas e visuais do projeto

Painel do calendario fiscal com prazos proximos, alertas de atraso e resumo por tipo de declaracao
Calendario fiscal - Prazos e acompanhamento de declaracoes
Pre-visualizacao PDF de fatura com modelo Accenseo mostrando itens, IVA e totais
Pre-visualizacao de fatura - Geracao PDF com identidade visual
Formulario de declaracao IVA CA12 anual com detalhamento de IVA, linhas dedutiveis e configuracoes de regime simplificado
Declaracao IVA - Formulario CA12 anual com calculos automaticos
Painel de personalizacao de modelos de faturas PDF com 4 estilos e seletor de cores
Editor de modelos - Personalizacao de estilo e cores
Biblioteca de modelos juridicos com filtro por forma juridica mostrando decisoes por tipo de empresa
Modelos juridicos - Documentos filtrados por forma juridica

Voce 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