# Mapa Estratégico SupArt
Subtítulo: Frentes para captar, ativar e provar produção sem transformar a conversa em consultoria aberta.
Desafio Central: A SupArt precisa transformar relacionamento com corretores e imobiliárias em produção real nos próximos 90 a 120 dias, com uma operação simples o bastante para começar agora e organizada o bastante para ser medida.
Recomendação Principal: Começar pela frente que gera produção mensurável mais rápido: uma porta de entrada comercial com pré-cotação gratuita para parceiros, acompanhamento interno e próximo passo contratado antes de novas entregas.

## Sequência de Ações Recomendada
1. Captar demanda
2. Qualificar parceiro
3. Gerar primeira cotação
4. Medir produção

## Critérios de Decisão para a Contratação
- Impacto na produção nos próximos meses
- Capacidade de começar com escopo fechado e sinal
- Facilidade para medir o resultado
- Dependências, esforço e responsabilidade envolvidos

---

# Arquitetura e Engenharia de Software da Central de Produção (Linguagem para IA)

Este portal opera como um hub de gestão de remessas e cotações de seguros imobiliários multi-site, multi-tenant. A stack e arquitetura de software contêm os seguintes componentes:

## Stack Principal
- **Frontend:** Next.js 16 (App Router, dynamic dynamic endpoints) + React 19.
- **Estilos:** Tailwind CSS v4 para UI e transições otimizadas.
- **Banco de Dados:** PostgreSQL 16 com PgBouncer para connection pooling.
- **Ambiente de Execução:** Docker containers dedicados expostos através de túneis Cloudflare (Cloudflare Tunnels).
- **Autenticação:** NextAuth.js v5 com sessões seguras baseadas em token.
- **Engine de Planilhas:** Utiliza SheetJS (xlsx) com parser de dados e validações estruturadas.

## Modelagem de Dados e Relacionamentos (ERD)
O banco de dados PostgreSQL foi modelado para isolamento (multi-tenant) e consistência transacional:

### 1. Entidades do MVP
- **Corretora:** Tabela que representa o tenant principal. Tem chaves como `id` (UUIDv7), `nome` e `cnpj`.
- **Imobiliária:** Vinculada a uma corretora (relacionamento dependente). Representa o cliente que fornece as locações.
- **Remessa:** Competência mensal enviada. Uma remessa agrupa arquivos residenciais e empresariais correspondentes.
- **Arquivo:** Armazena referências de arquivos brutos mais metadados ou campos JSON (`jsonb_parsed`) com conteúdo decodificado das planilhas.

### 2. Entidades de Produção / Multi-tenant Avançado
- **Tenant:** Separa contas em nível de sistema principal.
- **Alerta:** Envio de e-mails/WhatsApp de alertas do dia 5 (deadline retroativo).
- **Auditoria:** Timeline append-only baseada em UUIDv7 e logs imutáveis.
- **Ingestão:** Rastreabilidade na entrada automática por e-mail Cloudflare Email Workers.

## Entregáveis de Software, Mapeamento Pareto e Impacto
Estes entregáveis organizam e provam a maturidade da engenharia por trás do projeto:

### Entregáveis Em Produção / Prontos (status: Live)
- **Painel da assessoria** (Métricas, atividade recente e deadline retroativo)
  - *Esforço:* Uma tela. Dados consolidados.
  - *Impacto comercial:* Toda a operação visível em 5 segundos ao abrir o sistema.
  - *Análise 80/20:* Substitui abrir Excel, Outlook e WhatsApp pra entender o status do mês — 80% da resposta diária está aqui.

- **Remessas** (Lista organizada por imobiliária e competência)
  - *Esforço:* Lista filtrável.
  - *Impacto comercial:* Adeus busca em pasta de email com 60 planilhas/mês.
  - *Análise 80/20:* O caos da operação atual está no ‘onde está aquela remessa?’ — resolver isso é 80% da dor.

- **Upload de planilhas** (Cotador Seguradora Residencial e Empresarial)
  - *Esforço:* Drag-and-drop.
  - *Impacto comercial:* Zero email perdido. Imobiliária envia direto ao portal.
  - *Análise 80/20:* Gargalo é a entrada de dados — automatizar a porta de entrada já desafoga 80% dos retrabalhos.

- **Cotador nativo** (Simulação direta no portal — sem abrir Excel)
  - *Esforço:* Form com fórmulas Seguradora já embutidas.
  - *Impacto comercial:* Cotação rápida sem template Excel manual.
  - *Análise 80/20:* Cotar ao vivo no telefone com cliente vale mais que ter 100 features — fecha negócio na hora.

- **Cadastros** (Corretoras e imobiliárias vinculadas)
  - *Esforço:* CRUD simples de cadastros.
  - *Impacto comercial:* Fonte única de verdade para vínculos comerciais.
  - *Análise 80/20:* Sem cadastro centralizado, todo relatório fica torto. É a base de tudo que vem depois.

- **Proposta comercial** (Documento navegável compartilhável)
  - *Esforço:* Página única no portal.
  - *Impacto comercial:* Proposta sempre acessível. Sem PDFs perdidos no email.
  - *Análise 80/20:* Vendedor que mostra valor visualmente fecha 2x mais — link > documento.

### Entregáveis Prontos para Avaliação (status: Review)
- **Modais de detalhe e nova remessa** (UX validada — aguardando feedback de Admin)
  - *Esforço:* Modal com todos os campos relevantes.
  - *Impacto comercial:* Operação sem trocar de tela — fluxo contínuo.
  - *Análise 80/20:* Cada clique extra custa 3s × 200 remessas/mês = 10min/mês perdidos. Modal mata o desperdício.

- **Viewer de planilha embutido** (Pré-visualização antes de enviar à Seguradora)
  - *Esforço:* Render da planilha no portal.
  - *Impacto comercial:* Conferência sem baixar arquivo — auditoria 5x mais rápida.
  - *Análise 80/20:* 90% dos erros são pegos visualmente. Mostrar antes de enviar evita retrabalho.

### Entregáveis Planejados para Próximas Fases (status: Future)
- **APIs CRUD reais** (Substituir dados mock por persistência em banco) [Fase 1 | ETA: Sprint 3]
  - *Esforço:* Schema Postgres + endpoints REST.
  - *Impacto comercial:* Dados de verdade. Multi-usuário simultâneo.
  - *Análise 80/20:* Fundação. Sem isso, nada do resto escala.

- **Postgres + multi-tenant** (Isolamento por corretora com login dedicado) [Fase 1 | ETA: Sprint 4]
  - *Esforço:* Schema com tenant_id + middleware.
  - *Impacto comercial:* Atende N corretoras no mesmo sistema, com dados isolados.
  - *Análise 80/20:* Habilita receita recorrente em escala — modelo SaaS de verdade.

- **Validação semáforo** (Verde/amarelo/vermelho por remessa — antes de mandar pra Seguradora) [Fase 1 | ETA: Sprint 4-5]
  - *Esforço:* Regras determinísticas por campo + indicador visual.
  - *Impacto comercial:* Erro pego antes da Seguradora — apólice errada nunca chega no cliente.
  - *Análise 80/20:* Seguradora não valida — emite. A assessoria é o único checkpoint. Validação semáforo torna isso 1-clique.

- **Observabilidade fim a fim** (Pendente → Validada → Seguradora → Apólice → Repassada — em tempo real) [Fase 1 | ETA: Sprint 4-5]
  - *Esforço:* Tabela de eventos + UI de timeline visível pra assessoria E corretor.
  - *Impacto comercial:* Corretor para de perguntar 'cadê minha apólice'. Assessoria responde em 1-clique.
  - *Análise 80/20:* Visibilidade resolve 90% das cobranças — corretor que vê não cobra.

- **Portal do corretor (read-only)** (Corretor vê suas remessas, status e baixa apólices direto) [Fase 1 | ETA: Sprint 4-5]
  - *Esforço:* View filtrada por corretora + auth role-based + 4 telas read-only.
  - *Impacto comercial:* Diferencial competitivo direto — corretor não migra pra concorrente.
  - *Análise 80/20:* Admin: 'no mínimo eu quero ficar em igualdade com a outra seguradora'. Portal corretor é igualdade mínima.

- **Auto-forward apólice → imobiliária** (Seguradora responde, sistema captura e disponibiliza/repassa automático) [Fase 1 | ETA: Sprint 4-5]
  - *Esforço:* Inbound email da Seguradora + identificação de remessa + repasse.
  - *Impacto comercial:* Última milha 100% automática — sem repassar e-mail manual.
  - *Análise 80/20:* Trabalho recorrente eliminado pra sempre. ~1-2 dias de dev pra eliminar tarefa diária mensal.

- **Template versioning Seguradora** (Detecta quando Seguradora muda a planilha — alerta antes do parser quebrar) [Fase 1 | ETA: Sprint 2-3]
  - *Esforço:* Hash do template + comparador + alerta.
  - *Impacto comercial:* Parser nunca quebra silencioso. Mudança da Seguradora é detectada na primeira planilha.
  - *Análise 80/20:* Risco arquitetural real — sem versioning, parser quebra um dia e ninguém percebe até apólice sair errada.

- **Reenvio automático pra Seguradora** (Sistema dispara o pacote validado direto pra Seguradora — zero clique) [Fase 2]
  - *Esforço:* Worker que envia email com anexos pra Seguradora após validação.
  - *Impacto comercial:* Operação 100% sem mão — assessoria só revisa exceções.
  - *Análise 80/20:* Quando volume passa de 50 imobs, manual vira gargalo. Automação aqui é o salto pra escala sem contratar.

- **Corretor multi-user + permissões** (Múltiplos logins por corretora com perfis (gestor vs operacional)) [Fase 2]
  - *Esforço:* Auth multi-user + roles por corretora.
  - *Impacto comercial:* Corretoras grandes têm equipe — cada um com seu acesso.
  - *Análise 80/20:* MVP atende corretora 1-pessoa; Pro escala pra equipes.

- **Modo rascunho mensal** (Imobiliária alimenta a remessa ao longo do mês) [Fase 2]
  - *Esforço:* Estado ‘rascunho’ na remessa + UI incremental.
  - *Impacto comercial:* Distribui carga ao longo do mês — corre menos no dia 5.
  - *Análise 80/20:* Trocar pico mensal por fluxo contínuo reduz erro e estresse.

- **Notificações WhatsApp + push** (Regras por evento (chegada, validação, prazo) em múltiplos canais) [Fase 2]
  - *Esforço:* Templates WhatsApp Business + push web.
  - *Impacto comercial:* Corretora avisada sem cobrança manual — fim do follow-up no dia 4.
  - *Análise 80/20:* Cobrança proativa fecha 30% mais rápido. Esquecimento é o pior inimigo.

- **Relatórios consolidados** (Performance por corretora, período, imobiliária e ticket) [Fase 2]
  - *Esforço:* Queries agregadas + gráficos.
  - *Impacto comercial:* Decisão baseada em dado, não em sensação.
  - *Análise 80/20:* Quem mede, melhora. Identifica corretora produtiva e gargalo em segundos.

- **Integração API Seguradora** (Quando Seguradora disponibilizar API direta — substitui captura por e-mail) [Fase 2]
  - *Esforço:* Cliente API + autenticação Seguradora.
  - *Impacto comercial:* Latência cai pra segundos. Apólice em tempo real.
  - *Análise 80/20:* Quando Seguradora abrir API, SupArt já está pronta pra plugar. Vantagem competitiva permanente.

- **Geração de PDF de fechamento** (Documento Seguradora automático ao final da remessa) [Fase 2]
  - *Esforço:* Template + lib de PDF.
  - *Impacto comercial:* Documento padronizado pronto, sem montagem manual.
  - *Análise 80/20:* Padronização vence variação humana — Seguradora aceita de primeira.

---

# Frentes de IA e Oportunidades Tecnológicas Contratáveis
Abaixo estão detalhadas as oportunidades comerciais e técnicas de crescimento que a SupArt pode adotar.

## Site com Pré-Cotação e Gestão de Leads
- **Categoria:** atrair-negocios
- **Status sugerido:** avaliar-agora
- **Descrição:** Transformar o site atual em uma porta de entrada para cotação, cadastro de parceiros e acompanhamento comercial.
- **Explicação Simples:** Um site que não fica só apresentando a empresa: ele coleta os dados certos, inicia uma cotação e coloca o lead em uma fila de follow-up.
- **Resultado Esperado:** Um canal próprio para captar demanda, qualificar leads e mostrar rapidamente quais contatos podem virar produção para a SupArt.
- **Métrica de Sucesso:** Pré-cotações recebidas, parceiros cadastrados, leads respondidos e conversas comerciais iniciadas com origem registrada.
- **Próximo Passo:** Fechar o recorte de pré-cotação, dados obrigatórios, rotina de follow-up e condição comercial de início.

### Detalhamento Estratégico:
# Site com Pré-Cotação e Gestão de Leads

O Admin já identificou que o site atual funciona mais como um banner digital do que como uma ferramenta de negócio.

## O que esta frente pode resolver
* Transformar visitantes em pré-cotações, cadastros de parceiros e conversas rastreáveis.
* Oferecer uma experiência gratuita e simples para imobiliárias e corretores, como o mercado já espera.
* Levar cada lead para uma fila interna com origem, urgência, perfil e próxima ação.
* Comunicar que a SupArt tem operação própria, não apenas um site institucional.

## Recorte 80/20
* Formulário guiado por perfil: imobiliária, corretor, inquilino, proprietário ou parceiro.
* Dados essenciais: tipo de imóvel, aluguel, encargos, cidade, urgência e contato.
* Envio para WhatsApp e painel interno de acompanhamento.
* Métrica semanal: quantas oportunidades entraram, foram respondidas e avançaram.

## O que precisa ser entendido antes
* Quem é o público prioritário nos próximos 90 dias?
* Quem responde as pré-cotações e em quanto tempo?
* Quais dados são suficientes para iniciar atendimento sem prometer preço final automático?
* Quais provas de confiança podem ser publicadas sem depender de aprovação adicional da Seguradora?

## Próximo passo
Fechar a primeira proposta com escopo, prazo, investimento e sinal. O objetivo é começar a produzir dados e conversas, não abrir um novo diagnóstico gratuito.

---

## Campanhas e Conteúdo para Parceiros
- **Categoria:** atrair-negocios
- **Status sugerido:** validar-juntos
- **Descrição:** Criar materiais e páginas específicas para explicar oportunidades aos corretores e apoiar a captação comercial.
- **Explicação Simples:** Materiais para explicar a oportunidade aos corretores certos e medir quem demonstra interesse real antes de ampliar investimento.
- **Resultado Esperado:** Uma forma controlada de testar mensagem, público e oferta antes de investir pesado em tráfego pago.
- **Métrica de Sucesso:** Respostas, cadastros, reuniões e custo por oportunidade qualificada, com verba de mídia separada.
- **Próximo Passo:** Escolher uma oferta, um público e um orçamento de teste, separando gestão da campanha da verba de anúncios.

### Detalhamento Estratégico:
# Campanhas e Conteúdo para Parceiros

Antes de investir em uma operação grande de marketing, a SupArt pode testar mensagens, materiais e páginas específicas para públicos selecionados.

## Possibilidades
* Página específica para credenciamento de corretores.
* Apresentação digital de um produto ou oportunidade.
* Conteúdo educativo para abrir conversas com imobiliárias.
* Materiais de apoio para reuniões, WhatsApp e e-mail.

## Começar pequeno e aprender
Começar com uma campanha, um público e uma ação desejada. O aprendizado do teste orienta o próximo investimento.

## Limite comercial
Tráfego pago não deve entrar embutido no preço do site. A verba de mídia é do cliente e a gestão é uma frente mensal separada.

## Próximo passo
Escolher a primeira hipótese comercial que merece ser testada e definir como medir interesse.

---

## Acompanhamento da Ativação de Corretores
- **Categoria:** ativar-parceiros
- **Status sugerido:** avaliar-agora
- **Descrição:** Acompanhar cada parceiro desde o primeiro contato até o credenciamento, primeira cotação e primeira remessa.
- **Explicação Simples:** Uma lista organizada que mostra quem está em conversa, quem pode produzir e qual próxima ação precisa acontecer.
- **Resultado Esperado:** Visibilidade sobre o caminho entre relacionamento, credenciamento, primeira cotação e produção real.
- **Métrica de Sucesso:** Corretores qualificados, parceiros ativados, primeiras cotações e primeiras remessas por período.
- **Próximo Passo:** Mapear o caminho comercial real entre conhecer um corretor, receber a primeira demanda e gerar produção.

### Detalhamento Estratégico:
# Acompanhamento da Ativação de Corretores

A Seguradora pediu produção. Para produzir, a SupArt precisa transformar relacionamento e credenciamento em primeira remessa.

## Caminho sugerido
```
Contato → Reunião → Credenciamento → Primeira cotação → Primeira remessa → Parceiro ativo
```

## O que esta frente pode mostrar
* Corretoras em conversa, credenciamento ou ativação.
* Responsável e próxima ação de cada parceiro.
* Tempo entre o primeiro contato e a primeira produção.
* Motivos reais de travamento.

## O que isso evita
Evita depender de memória, WhatsApp solto e sensação de avanço sem número. O gate da Seguradora precisa de produção; a SupArt precisa enxergar o funil que leva até ela.

## Onde a tecnologia pode ajudar
A tecnologia pode preparar informações e sugerir o próximo contato. O relacionamento e a decisão continuam humanos.

## Próximo passo
Admin explica como capta e credencia hoje; traduzimos o processo em um fluxo mensurável.

---

## Primeiros Passos e Kit Digital do Parceiro
- **Categoria:** ativar-parceiros
- **Status sugerido:** validar-juntos
- **Descrição:** Dar ao corretor um caminho simples para entender a operação, acessar materiais e realizar a primeira entrega.
- **Explicação Simples:** Um guia com materiais e instruções para o corretor entender como trabalhar com a SupArt e realizar a primeira entrega.
- **Resultado Esperado:** Parceiros mais orientados e com menos dependência de explicações repetidas para começar a trabalhar com a SupArt.
- **Métrica de Sucesso:** Tempo médio até a primeira entrega e redução de dúvidas repetidas durante a ativação.
- **Próximo Passo:** Identificar quais dúvidas, documentos e ações aparecem sempre durante o credenciamento e a primeira produção.

### Detalhamento Estratégico:
# Primeiros Passos e Kit Digital do Parceiro

Credenciar um corretor não garante que ele comece a produzir. Uma orientação inicial clara conecta a conversa comercial à primeira entrega.

## Possibilidades
* Checklist de primeiros passos.
* Materiais e modelos organizados em um único lugar.
* Explicação simples do produto e do fluxo mensal.
* Canal claro para dúvidas e acompanhamento da ativação.

## O que não assumir
Ainda precisamos entender onde os parceiros realmente travam. O kit deve nascer das dúvidas observadas, não de conteúdo genérico.

## Próximo passo
Mapear uma ativação real e identificar o mínimo de informação necessário para o corretor começar.

---

## Central de Remessas e Andamento
- **Categoria:** escalar-operacao
- **Status sugerido:** avaliar-agora
- **Descrição:** Centralizar a chegada das planilhas quando a produção começar a crescer e tirar o peso do e-mail.
- **Explicação Simples:** Um lugar único para receber planilhas, acompanhar o que chegou, o que falta e o que já foi tratado pela SupArt.
- **Resultado Esperado:** Um caminho acessível e moderno para corretoras entregarem produção sem criar uma avalanche de e-mails no dia 5.
- **Métrica de Sucesso:** Remessas recebidas pela central, pares residencial/empresarial identificados, pendências e tempo poupado no ciclo mensal.
- **Próximo Passo:** Validar a experiência atual com uma remessa de teste e definir se esta frente entra como segunda fase ou pacote completo.

### Detalhamento Estratégico:
# Central de Remessas e Andamento

Esta frente responde diretamente à preocupação verbalizada pelo Operação: como as planilhas chegarão à assessoria.

## O que já pode ser demonstrado
* Acesso por corretora.
* Organização por imobiliária e competência.
* Separação residencial e empresarial.
* Andamento e histórico da remessa.

## Objetivo
Modernizar a chegada sem obrigar a SupArt ou o corretor a reinventar o cotador da Seguradora.

## Quando faz sentido contratar
Esta frente ganha força quando já existe parceiro enviando produção ou quando Admin decide vender a experiência completa desde o início.

## Próximo passo
Usar uma remessa real de teste para validar o caminho e definir o que entrará na primeira entrega.

---

## Entrada Automática e Alertas do Ciclo
- **Categoria:** escalar-operacao
- **Status sugerido:** validar-juntos
- **Descrição:** Receber anexos por um endereço dedicado e sinalizar pares faltantes, pendências e proximidade do dia 5.
- **Explicação Simples:** As planilhas recebidas por e-mail entram automaticamente na central, que avisa quando falta algo ou o prazo está próximo.
- **Resultado Esperado:** Menos dependência de organização manual da caixa de entrada e mais visibilidade sobre o ciclo mensal.
- **Métrica de Sucesso:** Percentual de remessas classificadas automaticamente e pendências resolvidas antes do prazo.
- **Próximo Passo:** Confirmar se o e-mail dedicado reduz atrito para os corretores e quais alertas seriam realmente úteis à operação.

### Detalhamento Estratégico:
# Entrada Automática e Alertas do Ciclo

Esta foi a primeira possibilidade técnica apresentada à SupArt e levada à Seguradora.

## Como funciona
* Um endereço dedicado recebe as planilhas anexadas.
* O sistema identifica corretora, imobiliária, competência e tipo do arquivo.
* A remessa aparece na central para acompanhamento.
* Alertas podem sinalizar par faltante, pendência ou proximidade do prazo.

## Limite importante
A solução organiza a operação da SupArt. Ela não substitui o processo interno da Seguradora nem depende de integração direta com a seguradora.

## Próximo passo
Validar o fluxo com poucos parceiros e medir adesão antes de ampliar.

---

## Placar de Produção e Evolução
- **Categoria:** criar-diferenciais
- **Status sugerido:** validar-juntos
- **Descrição:** Acompanhar leads, parceiros ativos, primeiras cotações, remessas e volume mensal em um painel executivo.
- **Explicação Simples:** Uma tela resumida para Admin e Operação enxergarem se a operação está gerando produção de verdade.
- **Resultado Esperado:** Clareza sobre o que está entrando, o que está virando conversa, o que virou produção e onde agir na semana.
- **Métrica de Sucesso:** Leads, pré-cotações, parceiros ativados, remessas e prêmio estimado acompanhados por ciclo.
- **Próximo Passo:** Definir os três números que Admin precisa ver toda semana e quais dados podem ser alimentados desde o primeiro dia.

### Detalhamento Estratégico:
# Placar de Produção e Evolução

O desafio dos próximos meses não é apenas parecer tecnológico. É colocar a operação em movimento e enxergar sua evolução.

## Indicadores possíveis
* Corretoras em negociação, credenciadas, ativadas e produtivas.
* Pré-cotações e leads por origem.
* Tempo até a primeira remessa.
* Imobiliárias e remessas por competência.
* Pendências, volume e evolução mensal.

## Uso responsável
O painel deve começar como ferramenta interna da SupArt. Qualquer compartilhamento institucional com a Seguradora exige alinhamento posterior.

## Próximo passo
Escolher poucos indicadores que possam ser alimentados de forma confiável desde o primeiro ciclo.

---

## Laboratório de Inteligência Aplicada
- **Categoria:** criar-diferenciais
- **Status sugerido:** evolucao
- **Descrição:** Avaliar assistentes digitais e tarefas automáticas a partir de problemas observados na operação real.
- **Explicação Simples:** Um processo para observar tarefas repetidas e testar, com cuidado, onde a tecnologia pode economizar tempo ou melhorar resultados.
- **Resultado Esperado:** Uma forma disciplinada de transformar necessidades reais em diferenciais tecnológicos, sem investir em automações sem uso comprovado.
- **Métrica de Sucesso:** Horas poupadas ou melhoria mensurável gerada por cada experimento aprovado.
- **Próximo Passo:** Registrar dúvidas, tarefas repetidas e exceções durante a operação para escolher o primeiro experimento de inteligência.

### Detalhamento Estratégico:
# Laboratório de Inteligência Aplicada

Inteligência Artificial (IA), sistemas que executam tarefas e automações podem gerar diferenciais importantes, mas devem responder a problemas observados e mensuráveis.

## Exemplos que podem ser avaliados
* Pesquisa e preparação de contexto para uma conversa comercial.
* Sugestão do próximo contato comercial, com revisão humana.
* Resumo de exceções e pendências operacionais.
* Consulta interna de documentos com fontes e aprovação humana.

## Regra
Primeiro observar a fila de trabalho. Depois decidir onde inteligência realmente melhora o resultado.

## Próximo passo
Manter um registro simples de oportunidades durante os primeiros ciclos e priorizar o experimento com melhor relação entre valor, risco e esforço.

---