Requisitos do projeto
Fonte primaria: email do Ale Pinzon (socio de negocio). Analise critica com riscos, decomposicao em 4 blocos independentes e recorte por versao. Perguntas abertas foram resolvidas em ADRs 0004-0008.
As 4 versoes
v1 e o MVP que vai pra proposta. v2+ fica congelado ate v1 validar.
**Objetivo de negocio:** levar a Ale uma ferramenta funcional que mostre para o cliente o mapa de licencas com semaforo — base de conversa comercial. **Escopo tecnico:** - 1 vertical + 1 municipio (a definir — ver Pergunta P1) - Catalogo manual das ~10-20 licencas desse vertical (construido com Ale) - Cadastro da empresa (CNPJ, socios, endereco, atividade, estrutura) - Cadastro manual de cada licenca ativa do cliente (tipo, numero, data emissao, data vencimento) - Classificacao simples: quais licencas desse catalogo sao aplicaveis a essa empresa - Dashboard com semaforo (OK / proxima a vencer…
- Calendario de renovacao por licenca com SLAs do orgao - Coleta de docs do cliente via WhatsApp (Evolution + Chatwoot) - Validacao por LLM dos docs recebidos contra checklist - Aprovacao pela lider do projeto antes de seguir
- Geracao semi-automatica do documento de solicitacao - Registro de protocolo apos submissao manual - Acompanhamento com prazos do orgao - v3.x: scrapers dedicados a orgaos com volume (se justificar custo)
- Revisao juridica LGPD/ToS primeiro - Identificacao de empresas com licencas vencidas em bases publicas - Enriquecimento com decisores (fontes legitimas) - Apresentacao personalizada como hook comercial ---
4 blocos independentes
Cada frente tem entrada, processamento e saida proprios. Qualquer bloco pode ser desligado sem quebrar os outros (Regra 1).
10 riscos mapeados
Alta: 6 · Media: 4 · Baixa: 0. Severidade inferida por categoria e texto — Rafa pode ajustar no proprio md.
Brasil tem milhares de licencas distintas por combinacao de municipio + estado + CNAE + porte + produto + estrutura. Nao existe base unica. Construir um catalogo universal na v1 e infactivel.
recortar por vertical + municipio na v1 (ver escopo v1).
Cada prefeitura, secretaria, conselho tem portal proprio. Muitos sem API, alguns sem busca publica (exigem login do proprio cliente). Scraper individual por orgao.
v1 comeca com cadastro manual da situacao atual pelo cliente; automacao de consulta e incremental, orgao a orgao, conforme volume justifique.
Fazer A+B+C+D de primeira demora 6-12 meses. Ale quer apresentar proposta rapido.
v1 = so MAPEAMENTO (Bloco A), o que ja entrega valor visivel (cliente ve mapa + alertas) e permite cobrar. Resto vira roadmap.
Coletar dados de decisores em LinkedIn + contato direto por canal nao-publico (WhatsApp) pode violar LGPD e ToS do LinkedIn.
Bloco D fica para v4 com revisao juridica antes. Marketing deve ser opt-in (conteudo + captura de lead) e nao predatorio.
WhatsApp Business API exige templates HSM aprovados para mensagens fora da janela de 24h. Custo por conversa. Violacao pode bloquear numero.
usar Evolution API para janela ativa, Chatwoot para historico, HSM so para avisos criticos de renovacao.
Algumas licencas exigem assinatura de profissional habilitado (engenheiro, arquiteto, responsavel tecnico). Sistema automatiza tudo ate esse ponto, mas nao substitui a assinatura.
modelar papel "responsavel tecnico" no fluxo desde v1; e atividade manual de aprovacao, nao automacao.
Custo unitario a modelar: scraper (0 se manual), LLM (classificacao + validacao docs ~R$ 0.50-2 por licenca/mes), WhatsApp HSM (~R$ 0.05-0.15 por mensagem), storage, VPS. Se um cliente tem 20 licencas, sao R$ 200/mes. Com 10 clientes, R$ 2.000/mes — 50/50 = R$ 1.000 por socio.
modelar custo antes de fechar preco. Possivel que precise precificar por faixa de complexidade (municipal simples vs. ambiental complexa).
Indictria, comercio, restaurante, posto de combustivel tem licencas muito diferentes. Focar em 1 vertical na v1 nao so corta escopo como da credibilidade (proposta + case).
decidir vertical com Ale antes de comecar.
Email mistura "licenca", "alvara", "autorizacao", "cadastro". Cada um tem peso juridico diferente.
glossario em `docs/decisoes/0003-glossario.md` quando for modelar dominio.
Factivel com OCR + LLM comparando contra checklist. Mas nao e 100%. Precisa gate humano.
IA classifica e aponta problemas; lider do projeto valida. ---
Todas as perguntas resolvidas
Perguntas P1-P6 foram promovidas a ADRs 0004-0008 (aceitos por coerencia, aguardam ratificacao de Ale).