Linha de Nicho ZX Control v3 · Contábil

Contabilidade ZX Control5 agentes de IA para o contador solo e o escritório pequeno

Um mini sistema com login onde o contador digita ou cola a informação e a IA devolve o trabalho pronto: calendário de obrigações, enquadramento, comunicado ao cliente, orientação tributária e resposta ao Fisco.

"O trabalho burocrático do mês resolvido em minutos — com o contador sempre no comando."

Cloudflare Workers Supabase · RLS Painel em Pages Gemini Flash Login multiusuário
🖥️ Ver o sistema ao vivo (demo local)

// O que é este setup

Um produto pronto que você revende — não um código pra escrever

A lógica dos 5 agentes é congelada e validada (suíte de testes verde). Sua instalação aqui no Claude Code só configura o produto para o escritório cliente: credenciais, banco, deploy e validação. Nada de programar.

📦 Núcleo congelado

Mesma engenharia dos demais pacotes da linha. Versionado por tag vX.Y.Z — você nunca toca em src/.

⌨️ Texto → texto, sem upload

Nenhum agente lê PDF, XML ou extrato. O contador digita ou cola; a IA nunca emite número extraído de arquivo — na contabilidade um valor mal lido vira lançamento errado.

🔐 Roda na infra do cliente

Supabase + Cloudflare por escritório (free tier dá conta). Login multiusuário: cada pessoa do escritório tem o seu acesso, dados compartilhados, RLS em toda tabela.

💸 Você instala e cobra

White-label. Acompanha uma masterclass de como vender e precificar para contadores e escritórios contábeis pequenos.

// O motor

Os 5 agentes

Todos texto→texto. Toda saída de IA traz o disclaimer obrigatório "conferência pelo contador é obrigatória" e nunca afirma valor de imposto, alíquota ou número de lei — orientação genérica, conferência com o profissional.

1

Calendário de Obrigações Fiscais

Regime + competência → obrigações aplicáveis com data fatal em dias úteis (fuso de São Paulo, feriados e antecipação de vencimento), gravadas na agenda de prazos.

texto → texto
2

Triagem / Enquadramento de Empresa

Dados da empresa em texto → ficha, regime sugerido (Simples / Presumido / Real), obrigações, documentos a pedir e parecer preliminar.

texto → texto
3

Gerador de Comunicado ao Cliente

Situação do mês digitada → texto simples pro empresário (o que pagar, prazos, pendências), pronto pra copiar ou baixar.

texto → texto
4

Consultor Tributário / Tira-dúvidas

Pergunta do contador → orientação fundamentada e genérica, sempre com remissão à legislação vigente.

texto → texto
5

Redator de Respostas ao Fisco

Intimação/notificação colada como texto → minuta de resposta estruturada, exportável.

texto → texto

// Como funciona na prática

Do login ao trabalho pronto

Sem integração externa, sem upload. O contador opera tudo pelo painel, no navegador.

1
Faz logine-mail e senha do escritório
2
Escolhe o agente1 dos 5 cards
3
Digita ou colaregime, dados, dúvida...
4
IA geracom disclaimer embutido
5
Salva / exportahistórico + agenda

// O que vamos colocar no ar

A stack que a instalação monta

Cloudflare WorkerAPI dos agentes
🗄️
Supabasebanco · auth · RLS
📊
Painel (Pages)operação do escritório
🧠
Gemini Flashredação dos textos

Tabelas no banco: empresas_cliente, competencias, prazos (agenda) e saidas_geradas (histórico). O cálculo de prazos em dias úteis é determinístico e testado; o Gemini só redige os textos — nunca inventa datas nem valores.

// O passo a passo que faremos juntos

6 passos — eu conduzo, você responde

Vou conversar com você um item de cada vez, explicando onde pegar cada credencial. Ao final, deploy e smoke test.

Boas-vindas e checagem

Confirmar que você tem as 3 contas em mãos.

Coletar credenciais

Uma de cada vez, com o "onde pegar".

Escrever os configs

.env + painel/config.js (não vão pro git).

Aplicar o banco

Migrations com RLS no Supabase do escritório.

Deploy

Worker + painel no Cloudflare, com os secrets.

Smoke test

Cria o 1º usuário, gera uma saída de teste e confere a agenda. Se falhar, a gente para e corrige.

// Tenha isto em mãos antes de começar

As 3 contas necessárias

🗄️
SupabaseBanco e login do escritório. Project URL + service_role key.
CloudflareHospeda o Worker (agentes) e o painel. Wrangler logado.
🧠
Google GeminiChave em aistudio.google.com/apikey — tem free tier.

Sem WhatsApp na v1: este produto não dispara mensagens — é texto→texto no painel. A notificação de prazo fica para uma versão futura.

// O que destrava o valor

O que ensinar ao cliente

⚠️ Como o escritório tira o máximo

  • Cadastrar a carteira de empresas — com regime correto, o Agente 1 monta a agenda certa de cada cliente.
  • Conferir toda saída de IA — o disclaimer não é decoração: a responsabilidade técnica é sempre do contador.
  • Marcar prazos como cumpridos — mantém a agenda limpa e o destaque de vencidos/≤5 dias confiável.

💸 Como você ganha: ancore o preço nas horas que o escritório economiza por mês — poucas horas de trabalho manual já pagam o sistema. Prefira setup maior + mensalidade baixa pra reduzir churn.

// Antes de começar, espie o filme inteiro

Veja a instalação acontecendo

É assim que a conversa rola dentro do Claude Code — o Claude pergunta, você responde, ele executa. Do zero ao painel no ar.

🤖 Claude Code Bem-vindo! Vou configurar o Contabilidade ZX Control para o escritório que você vai atender. Você tem as 3 contas? (Supabase, Cloudflare, Gemini)
👤 Aluno Tenho todas.
🤖 Claude Code Beleza, vamos uma de cada vez. SUPABASE_URL → Project Settings ▸ API ▸ Project URL. Cole aqui.
🤖 Claude Code Aplicando o banco (migrations + RLS)
Deploy: wrangler deploy (Worker) + wrangler pages deploy painel/
🤖 Claude Code Instalação concluída. Criei o primeiro login do escritório e gerei um calendário de teste — está na agenda. Pode acessar o painel.

Este é o painel que o escritório recebe — já populado com dados de demonstração.

🖥️ Ver o sistema ao vivo (demo local)

Pronto pra instalar?

Abra o Claude Code e cole o comando abaixo — ele clona o repositório e inicia a instalação guiada com você.

> https://github.com/zxmarketingdigital/contabilidade-zx-control.git — Faz o clone deste repositório e inicia a instalação do setup
1) Abra o terminal e digite claude  ·  2) Cole o prompt acima  ·  3) O Claude clona, te apresenta o produto e conduz a instalação credencial por credencial.