Skip to main content

Módulo 02: Multi-Tenant & Configuração

Status: Pendente de Aprovação

Domínio: ver Domínio/Entidade: Tenant

ATA de Referência: (Ainda não aprovada)

1. Visão Geral da Regra​

Um tenant é uma empresa/organização que contrata o CRM. Cada tenant possui isolamento total de dados e configurações independentes, operando no seu próprio subdomínio DNS.

2. Níveis de Administração​

  • Super Admin (Plataforma): Acessa apenas dados de faturamento do CRM e configurações técnicas de infraestrutura. Jamais acessa os clientes do Tenant. Pode suspender o tenant por falta de pagamento.
  • Admin do Tenant: Configura as regras da sua própria empresa (Hierarquia, FIPE, Integrações, Usuários e Planos).

3. Regras de Onboarding (Nova Empresa)​

  1. O Super Admin cria o tenant e define o subdomínio (empresa.crm.com). O subdomínio é imutável após criado.
  2. O sistema dispara o acesso inicial para o Admin da Empresa.
  3. O Tenant só passa a operar (Status: ATIVO) após o Admin preencher o "Wizard" obrigatório:
    • Dados Legais da Empresa
    • Identidade Visual (Cores e Logo carregam antes do login para dar percepção de white-label)
    • Aceite dos termos da Plataforma

4. Configurações de Comportamento (Regras Inegociáveis)​

A empresa pode ligar ou desligar comportamentos globais:

  • Hierarquia: Limite de alcance da subida de comissão/vendas (ex: travado em 3 níveis ou livre).
  • Leads: Prazo para alerta de falta de interação (ex: 7 dias) e expiração automática de leads (ex: 30 dias).
  • Registro: O cadastro de consultores pode ser fechado por Convite (Padrão) ou Aberto.
  • Segurança da Senha: Obriga complexidade média ou forte.
  • Propostas: Validade máxima de uma proposta enviada (ex: 15 dias) e o limite de desconto que o consultor e o gestor podem dar.
  • FIPE: Define se o sistema usa Cache Local, API Externa, ou API com fallback para CSV mensal.
  • Vistoria: O tenant escolhe quais modalidades de vistoria (Self-service, Presencial) vai usar e se a aprovação gerencial do laudo é obrigatória antes da assinatura.

5. Plano de Assinatura da Plataforma (SaaS)​

O atributo plano_contratado (SaaS) define o nível de serviço que o Tenant consome da plataforma do CRM (ex: BRONZE, PRATA, OURO, ENTERPRISE).

5.1 Origem do Dado​

  • Contratação Inicial: Definido na criação do Tenant pelo Super Admin no painel de administração da plataforma (SaaS Admin).
  • Sincronização com Gateway de Faturamento: Integrado com o provedor de recorrência da plataforma (ex: Stripe, Asaas, Iugu). Quando o Tenant realiza um upgrade/downgrade de plano no portal de faturamento ou há cancelamento por falta de pagamento, o gateway envia um webhook para o CRM atualizando plano_contratado e status do Tenant.

5.2 Impacto nas Regras e Limites do Tenant​

O plano_contratado atua como chave limitadora de recursos no CRM Core:

  • Limite de Usuários Ativos: Número máximo de consultores/gestores ativos cadastrados.
  • Armazenamento de Storage: Cota de GB para documentos e laudos.
  • Módulos Adicionais Habilitados: Acesso a integrações com ERPs (Hinova) ou microserviços de vistoria.

5.3 Visibilidade do Tenant​

  • O Admin do Tenant visualiza o plano atual e histórico de faturas do SaaS na aba "Configurações do Tenant" → "Minha Assinatura / Faturamento".
  • Consultores e usuários comuns não possuem acesso a esta informação.