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

Next.js 16React 19TypeScriptPrisma 7PostgreSQL 16Tailwind CSS 4shadcn/uiBetter AuthVercel AI SDKOpenAIAnthropic ClaudeGoogle GeminiStripeOpen Banking PSD2Teledec EDIDockerVitestPlaywright

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

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

Modulos autonomos

Rotas API

382

Endpoints REST

Modelos de BD

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. Documentacao sobre plataformas de desmaterializacao (PDP) tambem foi preparada, incluindo especificacoes DGFIP v3.1.

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

Documentacao PDP completa preparada para o mandato de faturacao eletronica 2026-2027

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

Identificacao da necessidade: gerenciar a contabilidade internamente sem provedor externo
Analise concorrencial: mapeamento de funcionalidades das solucoes SaaS contabeis existentes
Definicao do escopo funcional alvo adaptado a uma pequena empresa (SAS sob regime IS)
Pesquisa sobre Open Banking PSD2, declaracoes fiscais EDI e regulamentacao de faturacao eletronica

Phase 2

Arquitetura e setup tecnico

T1 2025

Next.js 16 + TypeScript + Tailwind CSS 4 + 25 componentes shadcn/ui
Docker Compose (PostgreSQL 16) + Prisma ORM (91 modelos)
Arquitetura Feature-Driven com 42 modulos autonomos

Phase 3

Desenvolvimento de funcionalidades core

T2 2025 - T4 2025

Autenticacao: Better Auth com MFA (email, TOTP, SMS), tokens de login de contador
Banco: integracao de 3 provedores (Nordigen/GoCardless via PSD2, Bridge, Qonto)
Faturamento: faturas de venda, orcamentos, faturas de compra com workflows de status completos
Contabilidade: plano de contas, diarios, lancamentos, razao geral, balancete, FEC
Declaracoes fiscais: TVA (CA3), IS, CFE, CVAE, DAS2, PAS com EDI via Teledec
Extensao Chrome: preenchimento automatizado de formularios fiscais em impots.gouv.fr

Phase 4

Funcionalidades avancadas

T1 2026

Assistente IA: 3 provedores (OpenAI, Claude, Gemini) com ajuda contextual
Relatorios: dashboard, balanco, DRE, SIG, orcamento, previsoes de fluxo de caixa
Juridico: assembleias gerais, registros, workflows de auditor estatutario
Folha de pagamento: holerites, DSN, imposto retido na fonte, contribuicoes sociais
Baixador de faturas: microsservico Node.js para recuperacao automatica de faturas

Os atores - As interacoes

Equipe, partes interessadas e dinamicas de colaboracao

Por que o papel humano foi critico

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.

Jose DA COSTA - Direcao & Expertise (~15-20%)

Visao do produto e priorizacao de funcionalidades para 42 modulos
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 (234K+ linhas)
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

Competencias tecnicas

Full-stack TypeScript/React/Next.js em escala de producao (234K+ linhas)
Arquitetura Feature-Driven para aplicacoes SaaS complexas
Modelagem de dados relacionais complexos (91 tabelas, relacoes, enums)
Integracao de API REST (Open Banking PSD2, Stripe, Teledec EDI)
Integracao IA multi-provedor (streaming SSE, extracao estruturada)
Desenvolvimento de extensao Chrome (Manifest V3, content scripts)
Seguranca de aplicacoes (auditoria OWASP, deteccao IDOR, MFA, RBAC)
Engenharia reversa de aplicacao web

Dominio contabil e fiscal

Plano Geral de Contas frances (PCG)
Regimes TVA e declaracoes CA3/CA12 com declaracao EDI
Imposto corporativo (IS - parcelas e saldo)
Contribuicoes economicas (CFE, CVAE)
Folha de pagamento e contribuicoes sociais (DSN, PAS)
Normas de faturacao eletronica (PDP, DGFIP v3.1)
Obrigacoes legais das empresas (AG, registros, contas anuais)
Open Banking (PSD2, STET) - 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)

Tipos de declaracoes fiscais

Automatizadas via EDI Teledec

Sage

Folha externalizada

DSN e folha de pagamento geridas via Sage Business Cloud Paie, parcialmente automatizadas

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

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

Pontos fortes

Cobertura funcional excepcional
42 funcionalidades, 114 paginas, 382 rotas API - quase todo o escopo de um software contabil profissional.
Arquitetura limpa e escalavel
Abordagem Feature-Driven com 42 modulos autonomos e independentes (componentes, hooks, servicos, tipos).
Abordagem metodica
Auditoria de seguranca, estudo de mercado e analise de cobertura antes de escrever qualquer codigo.

Pontos de melhoria

Historico de commits a segmentar melhor
Agrupar commits por feature com branches dedicadas teria melhorado a rastreabilidade e a revisao de codigo.
Cobertura de testes a reforcar
Modulos criticos (calculos fiscais, lancamentos contabeis, declaracoes) se beneficiariam de mais testes unitarios e de integracao.

O que eu faria diferente

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

Licoes duradouras

Um desenvolvedor motivado com as ferramentas certas pode produzir software de nivel empresarial

234.000 linhas de codigo em ~14 meses, sozinho - uma conquista significativa viabilizada pelo desenvolvimento assistido por IA.

Trajetoria relacionada

Experiencia profissional ligada a esta realizacao

ACCENSEO - CTO & Fundador

Trajetoria

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.