ADR 0003 — Respostas propostas as perguntas abertas (P1-P6)

Data: 2026-04-17 Status: superado pelos ADRs 0004-0008 (aceitos por coerencia, aguardam ratificacao de Ale) Autor: Claude (provocacao tecnica) Validadores esperados: Rafa (CTO) + Ale (socio de negocio) Contexto: escrito apos o escopo inicial (ADRs 0001 e 0002 e docs/requisitos.md) como material de preparacao para a call com o Ale.

---

Atualizacao 2026-04-17 — superacao

Rafa (CEO) decidiu que bloqueio operacional (call com Ale pendente) nao pode travar execucao indefinidamente. As propostas P1-P6 abaixo foram promovidas a decisoes aceitas por coerencia, formalizadas em ADRs proprios:

Todos com status "aceito por coerencia, aguarda ratificacao de Ale". Se Ale discordar de alguma decisao, o ADR correspondente e substituido por um bis.

---

Aviso

Este ADR e uma proposta de respostas, nao decisoes. Cada resposta aqui, ao ser validada na call com o Ale, vira um ADR proprio (0004, 0005, ...), ou e descartada. Nada aqui deve ser tratado como decidido.

Ordem temporal:

1. requisitos.md transcreveu o email do Ale (fonte primaria) e listou perguntas abertas P1-P6
2. ADR 0001 fechou escopo v1 (so Mapeamento, 1 vertical, 1 municipio)
3. ADR 0002 fechou stack inicial (FastAPI + PocketBase + Next.js)
4. Este ADR 0003 vem depois: Rafa pediu posicao do Claude para preparar a call com Ale
5. Call com Ale → decisoes viram ADRs 0004+ (ou ajustam este)

---

P1 — Cliente-alvo da v1 (vertical + municipio)

Recomendacao: posto de combustivel, se o Ale ja tem acesso a um; senao, restaurante/bar. Municipio: onde o cliente real ja opera.

Racional:

• Posto: dor mensuravel (multa ANP/CETESB/IBAMA e pesada), 10-15 licencas por unidade — ticket fecha o modelo R$ 10/licenca, catalogo estavel entre unidades (bom para generalizar pra v2)
• Restaurante/bar: 5-8 licencas (alvara funcionamento, sanitario, bombeiros, CADAN, ambiental light), catalogo delimitado, dor real mas ticket menor
• Evitar na v1: construcao civil (catalogo volatil por obra), industria quimica (catalogo imenso), clinicas (LGPD delicada)
• Municipio e derivacao do cliente — nao decidir no abstrato

Pergunta a Ale: "Voce ja tem um cliente real em mente? Qual o ramo e onde opera?" A resposta dele fecha P1.

---

P2 — Licenca vs. alvara vs. cadastro

Recomendacao: no codigo, entidade unica ObrigacaoRegulatoria com campo natureza (licenca, alvara, registro, cadastro, autorizacao). Na UI, usar "licenca" (linguagem do cliente e do Ale).

Racional:

• Juridicamente sao coisas diferentes, operacionalmente o problema e o mesmo: prazo, documentos, renovacao, risco de multa
• Modelar tres entidades separadas = over-engineering sem ganho real
• O campo natureza preserva a distincao para relatorios juridicos se precisar, sem explodir o modelo
• Glossario formal: vira ADR 0004 (ou parte do ADR que modela dominio)

---

P3 — Responsavel tecnico

Recomendacao: v1 = o cliente ja tem o responsavel tecnico dele; GLC nao assume responsabilidade tecnica no papel.

Racional:

• Assumir RT = outro negocio (consultoria de engenharia/arquitetura), outro risco juridico, outro preco
• GLC na v1 = software de gestao + coordenacao operacional, nao consultoria tecnica
• Fluxo: GLC prepara docs → cliente ou RT do cliente assina → GLC protocola
• Quando escalar: GLC pode virar marketplace de RTs parceiros (fee por indicacao) — mas isso e v3+

Consequencia no dominio: modelar papel "responsavel tecnico" como relacionado a empresa ou a licenca, nao a GLC.

---

P4 — Pais de operacao

Recomendacao: Brasil. Colombia fica como hipotese estrategica para v3+.

Racional:

• Infra ja esta toda em pt-BR (VPS Hostinger, Coolify, Chatwoot, Evolution)
• Legislacao brasileira e colombiana nao compartilham nada — sistema bilingue = dois produtos
• Rafa opera daqui; Ale e bilingue mas executar em dois paises em v1 = dobra de complexidade
• Ale escrever em pt/es nao significa que o cliente e colombiano — validar na call

Pergunta a Ale: "O cliente que voce tem em mente e Brasil ou Colombia?" Se for Colombia, ADR 0001 (escopo v1) muda: nao conseguimos entregar v1 aqui.

---

P5 — Modelo de receita

Recomendacao: tres componentes, nao so um.

1. Fee de onboarding (one-time): ~R$ 50-100 por licenca mapeada no setup inicial. Cobre o trabalho pesado de consulta a orgaos e cadastro.
2. Mensalidade por licenca gerenciada: R$ X/licenca/mes (status ativa ou em renovacao). X a modelar com custo unitario real.
3. Bonus de renovacao concluida (opcional, v2+): taxa extra quando GLC entrega a licenca renovada dentro do prazo do orgao.

Por que nao so R$ 10/licenca/mes:

• Sem onboarding, o mapeamento inicial (trabalho mais pesado) sai de graca
• Sem bonus de renovacao, o incentivo alinhado some (GLC ganha igual se renovar ou nao)
• Receita so recorrente = oscilacao grande dependendo da periodicidade das renovacoes

Tarefa antes de fechar X: modelar custo unitario em planilha (1 dia). Variaveis: LLM por classificacao (~R$ 1-3), HSM WhatsApp (~R$ 0.15/msg, 5-10 msg por renovacao), storage, VPS rateada. Piso pra nao dar prejuizo + multiplicador pra cobrir trabalho operacional da lider.

---

P6 — Lider do projeto

Recomendacao: v1 = Ale e a lider. Proposta ao cliente = "servico de gestao de licencas com ferramenta propria" (servico + software), nao SaaS puro.

Racional:

• Valida a hipotese comercial sem precisar estruturar time
• Ale tem o conhecimento de dominio pra operar a v1 junto do cliente
• Empresa de servico + software cobra mais do que SaaS puro, que e o que o modelo de receita (P5) pede
• SaaS self-service vira v2+ quando o fluxo estiver maduro o suficiente para cliente operar sozinho
• Modelos convivem: cliente pode usar o software sozinho OU terceirizar operacao pra GLC (duas receitas)

---

Tabela resumo

---

O que acontece quando validado

Cada resposta validada na call vira um ADR proprio (numero sequencial a partir de 0004). Rastreabilidade:

• P1 validado → ADR 0004 — Cliente-alvo v1 (vertical + municipio + primeiro cliente)
• P2 validado → ADR 0005 — Modelagem de dominio (entidade unica + glossario)
• P3 validado → ADR 0006 — Modelo de responsabilidade tecnica
• P4 validado → atualiza ADR 0001 (escopo) se necessario
• P5 validado → ADR 0007 — Modelo de cobranca e custo unitario
• P6 validado → ADR 0008 — Modelo operacional (servico + software)

Se alguma resposta for descartada, este ADR 0003 e atualizado com status "superada" e a nova posicao fica registrada no ADR que a substituir.

---

Ligacao com as regras

• Regra 1 (princ. 6 — IA executa, humano arquiteta): Claude propoe, humano decide
• Regra 2 (ADRs numerados): toda decisao arquitetural e rastreavel
• Regra 1 (princ. 3 — validar antes de empilhar): nao tomar decisao final sem call com Ale