Carvalho Consultoria · Plano de Desenvolvimento · v6

AgroService
a operação no sistema, a contabilidade onde já está.

Software custom enxuto pra empresa de manutenção agrícola: roda a operação (OS, ativo, estoque, custeio, portal do cliente) e alimenta a contabilidade que o Hugo já usa. Sem reinventar fiscal/razão. Stack, CAPEX × OPEX e métricas de construção.

Preparado por Claude / Ash Para Humberto (Pokebola) Com Hugo (CRC ativo) 16/06/2026
Sumário executivo

Construir a operação. Não reconstruir a contabilidade.

Como o Hugo é contador (CRC ativo) e já fecha os livros no sistema dele, o software novo não precisa ser a contabilidade — precisa alimentá-la com dado limpo. Isso libera o melhor caminho pro time de vocês: construir custom só a camada operacional (a praia de vocês dois), emitir nota por API e exportar pra contabilidade do Hugo. Sem carregar o passivo de um motor fiscal próprio bem no meio da Reforma Tributária.

~143h
Suas horas (caminho C)
~5–7
Semanas em burn (não meses)
100%
Do código operacional é seu
~R$ 5,7k
TCO 12 meses

Veredito

Caminho C — custom enxuto que alimenta a contabilidade do Hugo. Você constrói o miolo operacional (OS, ativo, estoque e custeio = sua especialidade), o portal do cliente e o app de campo. A parte chata e perigosa — razão contábil, motor de tributos, emissão de NF-e — você não constrói: nota sai por API (PlugNotas/Focus) e a contabilidade fica no sistema que o Hugo já roda. Você possui 100% do código operacional (vira ativo revendável) sem o passivo fiscal eterno.

Por que C, e não A nem B

O time de vocês muda a conta — mas não como parece

Ter Hugo (CRC) + você (suprimentos/planejamento) é raro e de-risca o projeto. Mas isso barateia especificação e validação, não a engenharia. Saber a regra fiscal ≠ ser barato construir e manter um motor fiscal que sobrevive a auditoria e a mudança de lei. Daí o ranking frio:

CaminhoEsforçoManutenção fiscalVeredito
A · Custom ERP completo do zero~280–320hSua, eterna, na ReformaNão reinventa razão + tributos
B · Odoo all-in-one~140hOCA/comunidadePlano B troca a ferramenta do Hugo
C · Custom enxuto + alimenta o Hugo~143hNão é sua (API + Hugo)Recomendado encaixa nas 2 expertises

Os 3 motivos frios de não construir o motor fiscal: (1) NF-e/NFS-e do zero é armadilha — certificado, webservice por estado, contingência, NFS-e por município migrando pra Nacional; time pequeno usa API. (2) Reforma Tributária 2026–2033 (CBS+IBS substituindo PIS/COFINS/ICMS/ISS) — motor próprio = você re-engenheira durante 7 anos de transição. (3) O Hugo carimba o CRC nos números — ele não troca um razão validado por um caseiro.

O que o software faz

A camada operacional (o que vocês constroem)

🔧

Ordem de Serviço

Ciclo completo: abertura → avaliação → orçamento → aprovação → execução por etapas → fechamento, com fotos e assinatura.

🚜

Controle de Ativo

Cadastro dos equipamentos dos clientes (frota, horímetro, histórico) — base da manutenção preventiva e corretiva.

📦

Estoque + Custeio

Sua praia: entrada/saída de peças, custo médio, custo real da OS, margem. O coração operacional.

📲

Portal do Cliente

Pedir manutenção, ver prévia de custo, acompanhar etapas, aprovar valores. Detalhe abaixo.

🧾

Nota por API

NF-e/NFS-e emitida a partir da OS via PlugNotas/Focus. Você não constrói SEFAZ — você chama.

🔗

Ponte com a contabilidade

Receita, custo e movimento de estoque exportados pro sistema que o Hugo já usa. A operação alimenta os livros.

O fluxo do dado: a operação acontece no AgroService → gera receita/custo/baixa de estoque → a nota sai por API → tudo é exportado limpo pra contabilidade do Hugo, que fecha os livros e cuida do fiscal lá. "As operações refletem na contabilidade" — seu pedido original, feito do jeito certo.

O diferencial do produto

O fluxo do cliente (e do backoffice)

É o trecho mais custom — e o que separa isto de um sistema de OS genérico. Duas entradas:

Cliente aderente (usa o portal)

Pede manutenção Prévia de custo (antes da avaliação) Avaliação inicial do técnico Escopo + custo da OS atualizados Aprova ou recusa Execução por etapas Aprova cada etapa / valores Fechamento + nota

Cliente não-aderente (backoffice abre por ele)

Backoffice abre OS em nome do cliente Cliente acompanha as etapas Confirma concordância de valores Aprova as etapas Execução + fechamento

ação do cliente   ação do backoffice   interno/técnico — adoção do portal é opcional: o backoffice cobre quem não quiser usar.

Como se constrói

Stack (caminho C)

Referência de padrão-ouro: o mercado (ServiceTitan) é cloud-native, mobile-first, API-first e modular. O caminho C honra esses pilares no que importa pra operação, e deliberadamente terceiriza os dois pilares mais caros de manter — fiscal e contábil — pra quem já faz (API de nota + Hugo). Decisão de engenharia, não de preguiça.

O comparativo

CAPEX × OPEX × custo total (12 meses)

Ordem de grandeza (R$), operação de uma empresa (a do Hugo). CAPEX = build único (assinatura Claude; suas horas entram como presença, não caixa). OPEX = recorrente mensal.

A assinatura é custo por mês corrido, não por hora. O lever do CAPEX não é "quantas horas" — é quantos meses você segura o tier alto. Como o build queima em ~5–7 semanas, você fica no Max 20× só nas ~3–4 semanas de construção pesada e cai pro 5× na validação/piloto. Por isso ~R$1,3–1,7k, não 3 meses de assinatura. Comprimir o calendário corta o CAPEX direto.

CaminhoCAPEX (build)OPEX (R$/mês)Manutenção fiscal
A · Custom ERP completo~R$ 4,5–6,6k~R$ 150–400Alta sua, na Reforma
B · Odoo all-in-one~R$ 2,8–3,3k~R$ 200–500Compartilhada OCA
C · Custom enxuto + Hugo~R$ 1,3–1,7k (Max 20× só nas ~3–4 sem de build, 5× no resto)~R$ 200–450 infra + API de nota + WhatsAppNão é sua API + sistema do Hugo
Custo total em 12 meses (CAPEX + 12× OPEX)
B e C empatam em dinheiro. C ganha no encaixe: 100% do código é seu, não mexe na contabilidade do Hugo, sem passivo fiscal.
A · Custom ERP ~R$ 9,7k B · Odoo ~R$ 5,7k C · Custom enxuto ~R$ 5,5k · recomendado
Reinventa tudo Pronto, mas framework alheio Seu código + encaixe no time
Dinheiro no tempo

CAPEX inicial (F0) e fluxo de caixa do projeto

CAPEX inicial — o que custa pra ligar a F0

Quase nada de caixa novo. A F0 é majoritariamente tempo (você + Hugo); o desembolso pra começar é mínimo:

ItemCustoNota
Certificado digital A1 (e-CNPJ)R$ 0–150Reusar o da empresa — ela já emite nota
Domínio .com.br~R$ 40/ano
Hosting (VPS) 1º mês~R$ 100Sobe pouco conforme uso
Conta API de nota (PlugNotas/Focus)R$ 0 setupPaga por documento emitido, depois
Pra ligar (fora a assinatura Claude)~R$ 140–290O resto é tempo
Assinatura Claude (mês do build)R$ 550–1.1005× na F0, sobe p/ 20× quando o build pega

Fluxo de caixa projetado (6 meses)

Saídas do projeto. O build comprime em ~M0–M1; daí vira só OPEX. Sem linha de receita aqui — o retorno é a eficiência operacional da empresa (e o upside de virar SaaS do setor depois, fora deste escopo).

Caixa acumulado do projeto (R$ mil)
Build pesado em M0–M1 (~R$ 2,15k); depois ~R$ 350/mês de OPEX. 12 meses ≈ R$ 5,7k (= o TCO).
BUILD 1,25 2,15 2,50 2,85 3,20 3,55 M0M1M2M3M4M5
MêsO que rodaClaudeInfra+API+WppSaídaAcum.
M0F0→F4 (build pesado)R$ 1.100 (20×)R$ 150R$ 1.250R$ 1.250
M1F5→F7 (tail + piloto)R$ 550 (5×)R$ 350R$ 900R$ 2.150
M2operaçãoR$ 350R$ 350R$ 2.500
M3operaçãoR$ 350R$ 350R$ 2.850
M4operaçãoR$ 350R$ 350R$ 3.200
M5operaçãoR$ 350R$ 350R$ 3.550

Consistência: build (M0–M1) = ~R$ 2,15k, dos quais ~R$ 1,65k é a assinatura Claude (1 mês 20× + 1 mês 5×) — bate com o "IA do build ~R$ 1,3–1,7k". OPEX estabiliza em ~R$ 350/mês. Em 12 meses: R$ 2,15k + 10×R$ 350 ≈ R$ 5,7k = o TCO. Quando virar SaaS do setor, uma linha de receita per-seat por oficina inverte o fluxo pra positivo — fora do escopo deste build.

Métricas de construção

Esforço & cronograma

Claude codifica, você valida e dá as chaves; Hugo define o que a contabilidade precisa receber e valida o fiscal. ~143h de presença sua. A 35h/semana, isso é ~4 semanas do seu tempo; com as esperas externas, ~5–7 semanas corridas.

O calendário não é gargalo das suas horas — é das esperas externas. O que estica além das suas ~4 semanas de trabalho não acelera por você queimar mais: a sessão de mapeamento com o Hugo (F0), o certificado A1 + homologação da NF-e, e o piloto rodando OS real (F7 precisa de mundo rodando, não dá pra forjar). Se o Hugo estiver disponível e o certificado sair rápido, encurta.

Cronograma em burn (~6–7 semanas, fases sobrepostas)
As fases não são sequenciais em burn — sobrepõem. O portal de aprovação é o trecho mais longo; o piloto fecha no mundo real.
S1S2S3S4S5S6S7 F0 Mapeamento F1 OS+Ativo F2 Estoq+Custeio F3 Portal+aprov F4 Nota por API F5 Ponte contábil F6 App de campo F7 Piloto
Fundação Build operacional Custom (crítico) Validação real (mundo)
FaseEntregável visívelSuas horas
F0 · MapeamentoHugo: o que a contabilidade precisa receber + mapeamento. Você: fluxo de OS/suprimentos. Stack e ambiente decididos~10h
F1 · OS + AtivoCiclo da OS rodando + equipamentos dos clientes cadastrados~22h
F2 · Estoque + CusteioEntrada/saída de peças, custo médio, custo real da OS, margem~20h
F3 · Portal + aprovação críticoCliente pede, vê prévia, aprova escopo/etapas; backoffice abre OS em nome do cliente~28h
F4 · Nota por APINF-e/NFS-e emitida a partir da OS via PlugNotas/Focus~15h
F5 · Ponte contábilExport/integração de receita, custo e estoque pro sistema do Hugo~14h
F6 · App de campoSkin do protótipo como PWA offline-first + WhatsApp~20h
F7 · PilotoOperação real do Hugo rodando de ponta a ponta~14h
TotalSistema operando a empresa, alimentando a contabilidade~143h

Custo de IA do build: ~R$ 1,3–1,7k — Max 20× só nas ~3–4 semanas de build pesado, 5× na validação/piloto. Não 3 meses de assinatura. Praticamente o único gasto de caixa pra sair do zero.

O que pode travar

Caminhos críticos

#RiscoPor quêMitigação
1Portal de aprovação médioPrévia pré-avaliação + escopo pós-avaliação + aprovação por etapa = regra customEspelhar o processo real do Hugo na F0; é o foco da F3
2Ponte com a contabilidade médioMapear receita/custo/estoque pro plano de contas do sistema do HugoHugo define o de-para (é a praia dele); confirmar qual sistema na F0
3Integração de nota (API) baixoCertificado + particularidades do município/estadoAPI (PlugNotas/Focus) abstrai; Hugo valida o enquadramento
4Custeio de estoque baixoÉ dado financeiro — erro vira custo erradoSua especialidade; Hugo confere o resultado contábil
5Conectividade no campo baixoFazenda sem sinalPWA offline-first; sincroniza ao voltar o sinal
6Adoção pelos clientes negócioNem todo cliente vai usar o portalBackoffice abre OS por ele — adoção é opcional

Repara: sumiram os riscos fiscais pesados (motor de tributos, SEFAZ, Reforma). É o ganho central do caminho C.

Pré-mortem

É daqui a 8 meses e o projeto fracassou. O que matou?

Exercício invertido: assumir o fracasso e trabalhar de trás pra frente. Não é pessimismo — é blindagem. Os antídotos viram itens de checklist de cada fase.

As 3 mortes mais prováveis (onde olhar primeiro)

  • O projeto nunca arranca — a F0 não fecha porque o Hugo não engaja ou a sociedade não foi batida. Assassino nº1 de projeto-paralelo: morre antes da 1ª linha.
  • O Hugo deixa de confiar nos números — ponte contábil suja (F5) ou custo mentiroso (F2) → ele volta a lançar na mão → o sistema perde o propósito e vira tela morta.
  • Nunca entra em produção real — piloto de mentira + escopo que não fecha (F7) → roda pra sempre "quase pronto" em paralelo ao sistema antigo.
FaseComo o projeto morre aquiSinal precoceAntídoto (vira checklist)
F0 · Mapeamento alto Levantamento raso: modela a operação ideal, não a real. Ou o Hugo não engaja e a F0 nunca fecha. Respostas "depende"; passou de 2 sessões; ninguém abriu o sistema contábil real. F0 só fecha com artefato concreto: fluxo da OS real validado por quem opera + tabela de serviços/peças + plano de contas exportado + formato da ponte definido.
F1 · OS + Ativo médio Máquina de estados errada (falta retrabalho, garantia, OS reaberta) → reescrita cara. Ativo subdimensionado (sem implemento/horímetro/série). Técnico dizendo "e quando acontece X?" que o fluxo não cobre. Validar a máquina de estados contra 5–10 OSs históricas reais antes de codar. Ativo espelha o que a operação já controla.
F2 · Estoque + Custeio alto Custo da OS mentiroso (custo médio errado, baixa que não bate) → margem falsa → Hugo não confia no número. Custo que não bate com o que o Hugo sabe; saldo de estoque impossível. Sua praia: reconciliar com o estoque físico real; Hugo confere o custo contra a realidade; testar com movimentações reais.
F3 · Portal + aprovação crítico O fluxo não espelha como o cliente decide. Ou over-engineering: 28h num portal lindo que o cliente não usa. Ou a prévia gera expectativa que a avaliação quebra. No piloto, o cliente liga em vez de usar o portal; o backoffice abre tudo por ele. Backoffice primeiro (sempre funciona), portal opcional. Testar a prévia com cliente real antes de generalizar. Manter o fluxo simples.
F4 · Nota por API crítico Enquadramento errado (CFOP/NCM/ISS/CST) → nota rejeitada ou, pior, aceita errada = problema fiscal real. Homologação de NFS-e municipal arrasta. Rejeições na homologação; Hugo apontando enquadramento errado. Hugo valida o enquadramento antes de emitir em produção; homologar com casos reais; a API existe pra abstrair a SEFAZ.
F5 · Ponte contábil alto De-para errado/incompleto → dado sujo entra na contabilidade → Hugo volta a lançar na mão → o projeto perde o propósito. Hugo reconciliando na mão o que devia vir pronto; divergência no fechamento. Hugo define o de-para (é dele); confirmar na F0 se o sistema dele importa (formato); reconciliar o 1º mês inteiro antes de confiar.
F6 · App de campo médio Offline-first mal feito (perde registro/foto no sync) ou UX ruim no campo (sol, mão suja, muitos toques) → técnico volta pro papel. Técnico usando WhatsApp/papel em paralelo "porque é mais rápido". Testar offline de verdade (modo avião + conflito de sync); manter a UX simples do protótipo; um técnico real testa antes.
F7 · Piloto crítico Piloto de mentira (2 OSs forçadas e declara vitória). Ou escopo que nunca fecha (cada OS revela um caso novo). Ou a operação resiste à mudança. Sistema antigo rodando em paralelo "por segurança"; lista de ajustes que só cresce. Piloto = N OSs reais de ponta a ponta (ex 15–20), antigo desligado pra esses casos. Congelar o escopo do MVP (caso novo = backlog v2, não bloqueia). Medir adoção.

E o seu lado? Os riscos de build

Crítica justa: a tabela acima jogou quase toda a morte no Hugo. Dois motivos — um real, um viés. Real: o caminho C tirou de propósito a engenharia mais perigosa (motor fiscal/contábil), então sobra menos risco de código. Viés: tratar "Claude constrói" como seguro — e é onde mais se bateu cabeça no ecossistema. O que é seu:

  • "Parece pronto, mas não tá" (casca) — fase declarada feita, as bordas quebram no piloto. Já vivido: Bloco B, painel que não renderizava, o ) extra que quebrou o JS inteiro e foi racionalizado como "pré-existente". Atinge F1/F3/F6. Antídoto: validar no sistema vivo, nunca no doc; node --check; testar no real antes de declarar feito.
  • Escopo instável — este plano pivotou 4× num papo (marketplace → all-in-one → enxuto). Spec que se mexe é o risco. Antídoto: congelar o MVP; caso novo = backlog v2.
  • Claude como vetor de erro — alucina, bate limite de sessão, subagente mete código errado e racionaliza. Você é o único revisor. Antídoto: conferir no sistema vivo; desconfiar de código plausível-demais; teste real.
  • Atenção dividida trava em 80% — Atho, grana e vida puxam; o ecossistema tem frente meio-feita por isso. Antídoto: blocos de burn fechados, piloto com data marcada.

Padrão por trás das mortes: do lado da operação, quase nenhuma é técnica — é realidade não capturada (F0/F1), confiança perdida no número (F2/F5) ou adoção que não acontece (F3/F6/F7); antídoto = validar contra a operação real, cedo, com quem opera. Do seu lado o padrão é outro: casca, escopo que escorrega e código não-revisado no sistema vivo; antídoto = conferir no real, nunca no doc, e congelar escopo. Os dois lados morrem de excesso de confiança — um no "parece bem" do cliente, outro no "parece pronto" da tela.

Como tocar em conjunto

Divisão Pokebola × Hugo

As duas expertises cobrem o miolo: você (suprimentos/planejamento/custeio) constrói a operação; Hugo (CRC) garante que o dado chega certo na contabilidade dele.

Pokebola — Operação & Tech

  • Build da camada operacional com o Claude
  • Estoque, custeio, OS, ativo (sua praia)
  • Portal, app de campo, integrações (nota, WhatsApp)
  • Infra e deploy

Hugo — Contábil, Fiscal & Processo

  • Define o que a contabilidade precisa receber (o de-para)
  • Valida fiscal/enquadramento da nota
  • Mantém os livros no sistema dele (não muda nada do lado dele)
  • Mapeia o processo real da OS na operação
  • Porta de entrada do 1º cliente (a própria empresa)

Sinergia: a empresa onde o Hugo atua é o cliente-piloto perfeito — ele tem o processo, o sistema contábil e a decisão. O produto nasce resolvendo uma dor real, validado por um contador de dentro, sem mexer no que já funciona pra ele. Depois vira SaaS do setor.

Antes da F0

Decisões pendentes

Próximo passo: uma sessão com o Hugo pra mapear o processo da operação e bater as decisões. Com isso, a F0 fecha numa sessão e a F1 (primeira OS rodando) começa. Quando bater o martelo, chama "vamo no AgroService".