ADR 0001 — Escopo v1: so Mapeamento, 1 vertical, 1 municipio

Data: 2026-04-17 Status: proposta (aguardando alinhamento com Ale) Contexto: inicio do projeto, proposta ao cliente ainda nao apresentada.

---

Decisao

A v1 do GLC entrega apenas o Bloco A (Mapeamento), restrita a 1 vertical + 1 municipio a definir com Ale. Workplan, Producao e Promocao ficam para v2, v3, v4.

Criterio concreto da v1:

• Catalogo manual (nao automatizado) de 10-20 licencas do vertical/municipio escolhido
• Cadastro manual das licencas que o cliente ja tem
• Dashboard com semaforo (OK / proxima a vencer / vencida / faltando)
• Alertas por email em D-60, D-30, D-15
• Multi-cliente, 1 operador (lider GLC)

---

Alternativas consideradas

A — Escopo completo do email (A+B+C+D) em v1. Rejeitada. Estimativa 6-12 meses, atrasa proposta ao cliente, risco alto de nao fechar (Risco R3 em requisitos.md).

B — Catalogo universal de licencas Brasil. Rejeitada. Nao existe base unica, cada municipio/estado/CNAE tem regras proprias (Risco R1). Construir catalogo universal e problema de 1-2 anos sozinho.

C — So Mapeamento, mas com scraping automatico dos orgaos. Rejeitada para v1. Scrapers por orgao sao blocos individuais complexos (Risco R2), muitos portais exigem login do cliente. Custo alto, beneficio incerto antes de validar com cliente real.

D — Mapeamento manual, vertical unico, 1 municipio (escolhida). Escopo cortavel em 4-6 semanas. Entrega valor visivel (mapa + alertas) para cliente real. Valida hipoteses comerciais antes de investir em automacao. Catalogo construido junto com Ale (conhecimento de dominio dele).

---

Consequencias

Positivas:

• Proposta ao cliente em semanas, nao meses
• Aprendizado real com cliente ativo antes de construir Workplan/Producao
• Catalogo inicial construido com especialista (Ale) — mais confiavel que scraper
• Blocos B, C, D ficam no roadmap, arquitetura ja considera entrada deles (ver arquitetura.md)

Negativas / a monitorar:

• Cliente pode achar que "so mapeamento" nao justifica pagamento. Mitigacao: Ale operando o Workplan manualmente + sistema mostrando o mapa ja e servico completo, so nao automatizado.
• Expansao para outros municipios/verticais exige novo catalogo. Isso vira ADR proprio quando acontecer — decidir se generaliza catalogo ou se vira "SaaS vertical" (1 vertical = 1 produto).

---

Ligacao com as regras

• Regra 1 (princ. 5 — simples ate provar que precisa ser complexo)
• Regra 1 (princ. 3 — validar antes de empilhar): validar v1 antes de construir v2+
• Regra 2 (requisitos antes do editor): escopo fechado antes de codar