# Analisa Franquias

> Plataforma SaaS de matching inteligente e validação de franquias para investidores no Brasil. "Não compre franquia sem validar antes."

Este arquivo serve como guia de contexto para modelos de linguagem (LLMs) que interagem com a estrutura, regras de negócio e diretrizes de design da Analisa Franquias.

---

## 1. Contexto do Produto & Posicionamento
- **Domínio**: [analisafranquias.com.br](https://analisafranquias.com.br)
- **Instagram**: [@analisafranquia](https://instagram.com/analisafranquia)
- **Proposta de Valor**: Mitigar o risco de investimento em franquias. Estatisticamente, 34% dos investidores se arrependem da escolha no mercado brasileiro (Referência ABF 2025). O sistema resolve essa dor central validando dados de COF, DRE, e payback antes do fechamento do negócio.
- **Público-alvo**: Investidores individuais buscando validação de perfil e Franqueadoras buscando captação qualificada de leads.

---

## 2. Identidade Visual (Design Tokens)
Todos os elementos de interface devem respeitar estritamente os tokens abaixo para consistência estética e contraste WCAG adequado:
- **Primary / Ação**: `#D42B2B` (`--red`) | Hover: `#E83535` (`--red2`) | Light bg: `#FDF2F2` (`--red-light`)
- **Backgrounds Escuros / Hero**: `#1C1C1E` (`--dark`)
- **Cards Escuros**: `#2C2C2E` (`--dark2`)
- **Destaque / Rankings / Avisos**: `#F5A623` (`--gold`) | Light bg: `#FFF8EC` (`--gold-light`)
- **Sucesso / Verificado / Positivo**: `#00B37A` (`--green`) | Light bg: `#F0FBF6` (`--green-light`)
- **B2B / Informação**: `#2563EB` (`--blue`) | Light bg: `#EEF2FF` (`--blue-light`)
- **Background Geral Claro**: `#F7F8FC` (`--bg`)
- **Bordas**: `#E8E8F0` (`--border`)
- **Texto Secundário**: `#9A9AA8` (`--gray3`)

### Fontes
- **Títulos**: `Nunito` (sans-serif) — pesos 800 ou 900
- **Corpo**: `DM Sans` (sans-serif)
- **Dados / Monospace**: `JetBrains Mono` (monospace)

---

## 3. Arquitetura de Rotas (URLs Principais)
- `/`: Landing page pública com buscador de franquias e estatísticas de inteligência.
- `/validar`: Busca detalhada de franquia por nome e exibição do nível de maturidade da marca.
- `/inteligencia`: Painel público de rankings, segmentos em alta e estatísticas setoriais da ABF.
- `/diagnostico`: Questionário de 4 blocos para traçar o perfil de investimento do usuário.
- `/planos`: Tabela comparativa de planos de monetização do investidor.
- `/franqueadora/*`: Dashboard restrito para marcas cadastradas visualizarem seus leads.
- `/crm/*`: Painel operacional de consultores internos e suporte ao investidor.
- `/admin/*`: Painel master de controle, KPIs gerais, auditorias e relatórios de faturamento.

---

## 4. Motor de Match (Algoritmo de Afinidade)
O grau de adequação do investidor a uma franquia segue a fórmula:
$$\text{Score Final} = \text{Score Bruto} \times \text{Multiplicador de Confiabilidade}$$

### Pesos do Score Bruto
1. **Capital vs. Investimento Mínimo**: 30%
2. **Segmento de Interesse**: 25%
3. **Modelo de Operação**: 15%
4. **Prazo de Retorno (Payback)**: 15%
5. **Nível de Dedicação Requerido**: 10%
6. **Região / Estado**: 5%

### Multiplicadores de Confiabilidade (Verificação)
- **✅ Verificada** (dados confirmados pela franqueadora): `1.00×`
- **🟡 Dados ABF** (fontes públicas): `0.92×`
- **🔴 Não verificada**: `0.80×`

---

## 5. Monetização & Lógica de Leads (Gatilho de Conversão B2B)
A plataforma possui fluxo de conversão dupla (B2C e B2B) integrado com o gateway **Pagar.me** (Account ID: `acc_bdN918yT78CmBmqG`, Public Key: `pk_lAzLDJCJ9C3gKZO6`).

### Lado Investidor
- **Gratuito (R$ 0)**: Diagnóstico e matches básicos por nome. Exclui informações financeiras sensíveis.
- **Gold (R$ 197)**: Acesso a dados financeiros detalhados (DRE, payback exato) e download de COF.
- **Black (R$ 497)**: Acesso total + Dossiê de COF completa + Mentoria 1:1 com especialista.

### Lado Franqueadora
- **Visibilidade (R$ 500/mês + 12% sucesso)**: Aparece no topo do motor de match. Recebe apenas notificações de novos leads com dados pessoais ofuscados/bloqueados (gatilho de conversão B2B).
- **Indicação (R$ 1.997/mês + 10% sucesso)**: Recebe leads completos (com nome, e-mail e WhatsApp) vindos do diagnóstico de investidores Gold/Black.
- **Parceiro (R$ 3.994/mês + 8% sucesso)**: Prioridade máxima nas recomendações do motor de match + integração direta.

---

## 6. Sistema de Badges e Confiabilidade
### Dados Financeiros
- **🟢 Oficial**: Fornecido e garantido de forma direta pela própria franqueadora.
- **🟡 Estimado**: Baseado em histórico setorial ou fontes públicas da ABF.
- **🔴 Não Informado**: Campo omitido ou indisponível.

### Status de Auditoria
- **✅ Verificada**: Documentação e balanço checados pela equipe técnica da Analisa Franquias.
- **🟡 Em Verificação**: Cadastro realizado pela marca, aguardando validação de COF.
- **🔴 Não Verificada**: Dados importados de bases públicas, sem contato direto estabelecido.

---

## 7. Cláusula Jurídica Obrigatória (Disclaimer)
Todo componente ou página contendo dados financeiros estimativos de franquias deve obrigatoriamente exibir a seguinte nota em destaque:
> *"Estimativas baseadas em dados históricos da rede. Resultados variam conforme localização, gestão e mercado. A Analisa Franquias não garante retorno financeiro. Dados financeiros são de responsabilidade da franqueadora. Lei de Franquias nº 13.966/2019 · LGPD nº 13.709/2018."*