Skip to main content

Funcionalidades do Sistema

📋 Visão Geral​

O Portal FindUP oferece um conjunto completo de funcionalidades para gestão comercial, desde a criação de propostas até o controle de comissões. Cada funcionalidade é adaptada conforme o role do usuário.

🎯 Dashboard Inteligente​

Métricas em Tempo Real​

  • Vendas do Mês: Total de vendas realizadas no período
  • Comissões Pendentes: Valor aguardando pagamento
  • Propostas Ativas: Propostas em andamento
  • Meta de Vendas: Progresso em relação à meta

Visão por Role​

Super Admin / Admin​

  • Visão consolidada de todos os técnicos
  • Métricas gerais do sistema
  • Performance por técnico
  • Gráficos de tendências

Technician​

  • Métricas pessoais
  • Comissões próprias
  • Clientes e propostas
  • Metas individuais

Componentes do Dashboard​

  • StatsCards: Cards com métricas principais
  • RecentActivity: Timeline das últimas ações
  • QuickActions: Ações rápidas para o usuário

👥 Gestão de Usuários e Roles​

Sistema Hierárquico de Permissões​

Super Admin​

  • Criar/editar administradores
  • Acesso total aos dados
  • Configurações globais
  • Logs de auditoria completos
  • Reset de senhas

Admin​

  • Gestão de técnicos
  • Visualização de dados gerais
  • Ativação de propostas
  • Gestão do catálogo de produtos
  • Relatórios consolidados

Technician​

  • Gestão de clientes próprios
  • Criação de propostas
  • Acompanhamento de comissões
  • Catálogo de produtos (visualização)

User​

  • Acesso básico limitado
  • Visualização do próprio perfil

Funcionalidades por Role​

// Exemplo de verificação de permissões
const canCreateProduct = userRole === "admin" || userRole === "super_admin";
const canViewAllClients = userRole === "admin" || userRole === "super_admin";
const canEditOwnProfile = true; // Todos os usuários

📦 Gestão de Produtos​

Catálogo Completo​

  • Google Workspace (Business, Enterprise)
  • Microsoft 365 (Business Premium, E3, E5)
  • Outros produtos configuráveis

Tipos de Produto​

  • Serviços: Configuração única
  • Produtos: Venda única
  • Assinaturas: Pagamento recorrente

Funcionalidades​

Para Admins​

  • Criar produtos: Novos itens no catálogo
  • Editar produtos: Atualizar preços e descrições
  • Ativar/desativar: Controle de disponibilidade
  • Definir comissões: Percentual de comissionamento

Para Técnicos​

  • Visualizar catálogo: Produtos disponíveis
  • Calcular comissões: Preview de ganhos
  • Criar propostas: Com produtos selecionados

Estrutura de Produto​

interface Product {
  id: string;
  name: string;
  description: string;
  product_type: "google_workspace" | "microsoft_365" | "other";
  price: number;
  monthly_price?: number;
  commission_percentage: number;
  features: string[];
  image_url?: string;
  is_active: boolean;
}

👨‍💼 Gestão de Clientes​

Cadastro Completo​

  • Dados empresariais: Razão social, CNPJ
  • Contato principal: Nome, email, telefone
  • Endereço: CEP, logradouro, cidade, estado
  • Vinculação: Associação ao técnico responsável

Validações Brasileiras​

  • CNPJ: Validação de dígitos verificadores
  • CEP: Preenchimento automático via ViaCEP
  • Telefone: Formato brasileiro (11) 99999-9999

Funcionalidades​

Para Técnicos​

  • Cadastrar clientes: Novos prospects
  • Editar dados: Atualizar informações
  • Histórico: Propostas e interações
  • Buscar: Filtros por nome, CNPJ, etc.

Para Admins​

  • Visualizar todos: Clientes de todos os técnicos
  • Relatórios: Análises por técnico/região
  • Transferir: Reassociar cliente a outro técnico

Hook Customizado​

// src/hooks/use-cep.ts
export const useCep = () => {
  const searchCep = async (cep: string) => {
    const response = await fetch(`https://viacep.com.br/ws/${cep}/json/`);
    return response.json();
  };

  return { searchCep };
};

📋 Sistema de Propostas​

Geração Automática de Códigos​

Formato: PROP-YYYYMM-XXX

  • PROP: Prefixo identificador
  • YYYY: Ano atual
  • MM: Mês atual
  • XXX: Sequencial do mês

Fluxo de Status​

  1. Pending: Proposta criada
  2. Sent: Enviada para cliente
  3. Approved: Aprovada pelo cliente
  4. Activated: Ativada pelo admin
  5. Cancelled: Cancelada

Aprovação Digital​

  • Token único: Gerado automaticamente
  • Link de aprovação: Enviado por email
  • Validação: Email do cliente obrigatório
  • Segurança: Token expira após uso

Funcionalidades​

Criação de Proposta​

const proposal = {
  customer_id: selectedCustomer.id,
  product_id: selectedProduct.id,
  monthly_value: product.monthly_price,
  contract_months: 12,
  total_value: product.monthly_price * 12,
};

Envio para Cliente​

  • PDF automático: Gerado via Edge Function
  • Email personalizado: Com link de aprovação
  • Tracking: Controle de abertura

Aprovação pelo Cliente​

  • Interface amigável: Página de aprovação
  • Confirmação por email: Validação de identidade
  • Aceite/Rejeição: Opções claras para o cliente

💰 Gestão de Comissões​

Cálculo Automático​

Fórmula: (mensalidade × 3) ÷ 2

Exemplo Prático​

Produto: Google Workspace Business
Mensalidade: R$ 100,00
Comissão Total: (100 × 3) ÷ 2 = R$ 150,00
Técnico: R$ 75,00 (50%)
FindUP: R$ 75,00 (50%)

Divisão 50/50​

  • Técnico: 50% da comissão calculada
  • FindUP: 50% da comissão calculada

Calendário de Pagamentos​

Prazos da Vivo​

  • 15 dias úteis após início do mês da venda

Prazos da FindUP​

  • 10 dias após pagamento da Vivo

Exemplo de Cronograma​

Venda: Janeiro 2025
- Vivo paga: 15º dia útil de Fevereiro
- FindUP paga: ~25 de Fevereiro

Status de Pagamento​

  • Pending: Aguardando ativação
  • Scheduled: Data programada
  • Paid: Pago ao técnico

Funcionalidades​

Para Técnicos​

  • Visualizar comissões: Próprias comissões
  • Acompanhar status: Pendente/pago
  • Histórico: Comissões anteriores
  • Projeções: Comissões futuras

Para Admins​

  • Calendário geral: Todos os pagamentos
  • Controle de repasse: Marcar como pago
  • Relatórios: Por técnico/período
  • Exportação: Dados para contabilidade

🔍 Sistema de Auditoria​

Logs Completos​

Todas as ações importantes são registradas:

  • Quem: Usuário que executou
  • Quando: Timestamp da ação
  • O que: Descrição da operação
  • Dados: Informações relevantes

Tipos de Log​

  • Criação: Novos registros
  • Edição: Alterações em dados
  • Exclusão: Remoção de registros
  • Login: Acessos ao sistema
  • Aprovação: Decisões de proposta

Rastreabilidade​

  • Histórico completo: Todas as mudanças
  • Integridade: Logs imutáveis
  • Segurança: Acesso restrito
  • Compliance: Conformidade regulatória

📊 Relatórios e Analytics​

Dashboards Interativos​

  • Gráficos de performance: Vendas por período
  • Métricas de conversão: Taxa de aprovação
  • Análise de produtos: Mais vendidos
  • Performance de técnicos: Ranking e metas

Exportação​

  • CSV: Dados estruturados
  • PDF: Relatórios formatados
  • Excel: Planilhas complexas

Filtros Avançados​

  • Período: Datas personalizadas
  • Técnico: Performance individual
  • Produto: Análise por categoria
  • Status: Propostas por situação

🔔 Notificações​

Tipos de Notificação​

  • Propostas: Nova aprovação/rejeição
  • Comissões: Pagamento processado
  • Vencimentos: Lembretes importantes
  • Sistema: Atualizações e manutenção

Canais​

  • In-app: Notificações no sistema
  • Email: Mensagens importantes
  • WhatsApp: Integração futura

Configurações​

  • Preferências: Tipos desejados
  • Frequência: Periodicidade
  • Canais: Onde receber