ZENITH — MVP MAXIMIZADO COM INTELIGÊNCIA ARTIFICIAL

********, uma ferramenta de alta performance para inteligência financeira direcionada a e-commerces (foco nos nichos de Suplementos, Cosméticos e Dropshipping).
O foco absoluto deste projeto é a entrega de um **MVP vendável e extremamente otimizado**, priorizando o impacto visual ("efeito uau") e automações analíticas potencializadas por Inteligência Artificial de custo fixo zero.
### Premissas de Execução:
* **Orçamento Máximo:** R$ 3.000,00 (Preço fechado por escopo).
* **Tempo de Desenvolvimento:** Mínimo de 16 dias.
* **Carga Horária Dedicada:** 5 horas por dia (Totalizando 80 horas de engenharia).
## 2. STACK TECNOLÓGICA & INFRAESTRUTURA
Para garantir custo zero de servidores no lançamento e alta velocidade de carregamento, o desenvolvedor deve seguir estritamente as seguintes tecnologias:
* **Framework Principal:** Next.js (Versão estável mais recente, utilizando App Router).
* **Hospedagem / Deploy:** Vercel (Camada Gratuita).
* **Banco de Dados & Autenticação:** Supabase (PostgreSQL integrado) — Camada Gratuita.
* **Core de Inteligência Artificial:** Google Gemini API ou Groq API (Llama 3) — Camada Gratuita para desenvolvedores (Free Tier via API Key).
* **Estilização de Interface:** TailwindCSS + Shadcn/ui (Componentes de UI).
## 3. DESIGN SYSTEM (ESTÉTICA HARD LUXURY)
A interface deve ignorar os padrões cinzas/brancos de SaaS comuns e adotar uma linha visual exclusiva e sofisticada (Premium Black & Gold):
* **Fundo da Aplicação (Background):** #09090B (Jet Black profundo).
* **Containers, Cards e Modais:** #18181B (Preto Fosco).
* **Bordas de Separação:** 1px solid rgba(212, 175, 55, 0.15) (Fio dourado sutil com opacidade).
* **Cores de Destaque / Ação:** #D4AF37 (Metallic Gold) e #AA7C11 (Dark Gold) aplicados em botões primários, gradientes e números de métricas críticas.
* **Textos:** #FFFFFF para títulos e principais; #8E8E93 para descrições secundárias.
## 4. MODELAGEM DO BANCO DE DADOS (SUPABASE / POSTGRESQL)
O desenvolvedor deverá criar e estruturar as seguintes tabelas relacionais no banco de dados do Supabase:
```sql
-- 1. TABELA DE EMPRESAS (ONBOARDING)
CREATE TABLE empresas (
id UUID REFERENCES ************ NOT NULL PRIMARY KEY,
cnpj VARCHAR(14) UNIQUE NOT NULL,
razao_social VARCHAR(255) NOT NULL,
nicho_mercado VARCHAR(50) NOT NULL, -- Suplementos, Cosméticos, Dropshipping
estado VARCHAR(2) NOT NULL,
criado_em TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP
);
-- 2. TABELA DE MÉTRICAS FINANCEIRAS (DASHBOARD)
CREATE TABLE financeiro_dados (
id BIGSERIAL PRIMARY KEY,
empresa_id UUID REFERENCES empresas(id) ON DELETE CASCADE,
receita_bruta NUMERIC(12, 2) DEFAULT 0.00,
custos_fornecedor NUMERIC(12, 2) DEFAULT 0.00,
investimento_ads NUMERIC(12, 2) DEFAULT 0.00,
taxas_operacionais NUMERIC(12, 2) DEFAULT 0.00,
data_registro DATE DEFAULT CURRENT_DATE
);
```
## 5. REQUISITOS DETALHADOS POR FASE (PASSO A PASSO)
### FASE 1: Estrutura Base e Design (Dias 1-3 | 15h)
* Setup completo do repositório Next.js com as configurações do Supabase SDK.
* Configuração do TailwindCSS aplicando as variáveis de cores do Design System Black & Gold.
* Criação do layout global (*sidebar* de navegação e cabeçalho fixo).
### FASE 2: Autenticação Segura (Dias 4-5 | 10h)
* Tela de Login, Cadastro e Recuperação de senha utilizando o Supabase Auth.
* Habilitar nativamente a opção "Entrar com o Google" via painel do Supabase.
* Bloqueio de rotas: o usuário não autenticado não pode visualizar o dashboard.
### FASE 3: Onboarding Inteligente com Zero Atrito (Dias 6-7 | 10h)
* **Regra de Negócio:** Reduzir o formulário de entrada para apenas 1 campo.
* **Fluxo Técnico:** O usuário digita o **CNPJ**. O sistema faz uma chamada à API pública [************(************){cnpj}.
* O sistema extrai a Razão Social, Estado e o código CNAE.
* **Mapeamento de Nicho Automático (Lógica em Código):**
* Se CNAE for 4772-5/00 \rightarrow Salva como **Cosméticos**.
* Se CNAE for 4729-6/99 \rightarrow Salva como **Suplementos**.
* Qualquer outro CNAE de comércio eletrônico (4791-4/00) ou intermediação \rightarrow Salva como **Dropshipping**.
* Persistir dados no banco e redirecionar imediatamente para o Dashboard.
### FASE 4: Layout do Dashboard Premium (Dias 8-11 | 20h)
Construção da interface principal exibindo uma grade (*grid*) com 4 Cards Financeiros de alto impacto visual:
1. **Card Receita Bruta:** Faturamento total em Real (R\$).
2. **Card Custos Operacionais:** Soma de custos de fornecedor, taxas e logística.
3. **Card ROI de Tráfego (Ads ROAS):** Indicador de eficiência dos anúncios.
4. **Card Dinâmico de Margem Líquida (Gatilho Visual):** Barra de progresso ou indicador que altera a cor dinamicamente com base no cálculo da Fase 5:
* Margem Líquida acima de 20%: Cor Dourada Metálica (#D4AF37).
* Margem Líquida entre 10% e 19%: Cor Cinza Metálico (#8E8E93).
* Margem Líquida abaixo de 10%: Cor Vermelho Carmesim Neon (#FF3B30).
### FASE 5: Lógica Financeira de Precisão (Dias 12-13 | 10h)
* Desenvolvimento das fórmulas matemáticas no backend para consolidação dos dados:
* *Lucro Líquido = Receita Bruta - (Custos Fornecedor + Investimento Ads + Taxas Operacionais)*
* *Margem Líquida (%) = (Lucro Líquido / Receita Bruta) * 100*
* Disparar alertas em texto em formato de *banners* discretos no topo do painel caso a margem feche o dia em vermelho.
### FASE 6: Simulador Interativo & Copiloto IA (Dia 14 | 5h)
* Interface contendo 3 componentes de controle deslizante (*Sliders* do Shadcn/ui) para o usuário simular cenários de mercado:
* *Slider 1:* Preço pretendido de venda do produto (R\$).
* *Slider 2:* Custo por Aquisição (CPA) estimado nas redes de anúncio.
* *Slider 3:* Orçamento diário planejado para anúncios.
* **Integração do Copiloto IA (Nova Funcionalidade):**
* O desenvolvedor deve integrar o SDK oficial da **Google Gemini API** ou **Groq** via variáveis de ambiente seguras.
* Ao alterar os valores dos *sliders*, o sistema envia os dados consolidados em background para a API com um *system prompt* pré-definido (Ex: *"Você é o Diretor Financeiro da ******. Analise estes dados de e-commerce e dê um diagnóstico curto de até 3 linhas sobre a viabilidade dessa escala"*).
* Abaixo do simulador, renderizar um container em destaque com borda dourada contendo a resposta textual da inteligência artificial em tempo real.
### FASE 7: Integração de Paywall e Cobrança (Dia 15 | 5h)
* Integração do Webhook do gateway de pagamento escolhido (Stripe API ou Mercado Pago).
* **Regra de Acesso:** Ao se cadastrar, o usuário passa por uma tela de cobrança transparente com o valor fixo do **Plano Pro: R$ 297,00/mês**.
* O acesso ao Dashboard só é liberado no banco de dados após o webhook retornar o status de ativo.
### FASE 8: Homologação, Testes e Deploy (Dia 16 | 5h)
* Revisão de segurança de rotas no Supabase (Políticas RLS ativas para impedir que um usuário veja dados de outro).
* Testes de quebra de layout em dispositivos móveis (Garantir 100% de responsividade).
* Deploy de produção na Vercel conectado ao repositório master do GitHub.
## 6. CATÁLOGO DE INTEGRACÕES (APIs)
O desenvolvedor deve implementar as chamadas utilizando as seguintes documentações de API:
1. **BrasilAPI (Dados Cadastrais):** GET [************(************){cnpj} (Uso: Onboarding / Sem custo e sem chaves de autenticação).
2. **Supabase JS Client:** Biblioteca @supabase/supabase-js (Uso: Controle de sessões e queries do banco).
3. **Google Gemini SDK / Groq SDK:** Integração do modelo de linguagem (Uso: Diagnósticos automáticos do simulador via camada gratuita/Free Tier).
4. **Stripe API / Mercado Pago SDK:** Integração para o checkout de assinaturas recorrentes.
5. **Meta Graph API Integration Prep:** Deixar estruturado no banco de dados um campo de texto para receber o token de anúncios ("Meta Access Token") para futuras atualizações automáticas de tráfego.
## 7. CRONOGRAMA FINANCEIRO DE DESEMBOLSOS (TETO DE R$ 3.000)
O pagamento do projeto será dividido estritamente em entregáveis atrelados às fases concluídas e testadas:

| Entrega / Marco | Fase Vinculada | Valor do Repasse |
| :--- | :--- | :--- |
| **Sinal de Início / Setup** | Conclusão das Fases 1 e 2 (Ambiente pronto e Login funcional). | R$ 1.000,00 |
| **Entrega Intermediária** | Conclusão das Fases 3, 4 e 5 (Onboarding CNPJ e Dashboard populado com regras de cálculo ativos). | R$ 1.200,00 |
| **Homologação e Entrega Final** | Conclusão das Fases 6, 7 e 8 (Simulador interativo com diagnóstico IA, Checkout integrado e Deploy). | R$ 800,00 |
| **VALOR TOTAL DO CONTRATO** | **Sistema ****** Pro MVP Homologado com IA** | **R$ 3.000,00** |

**FIM DO DOCUMENTO DE REQUISITOS TÉCNICOS**