Entendendo Subcontas
O Levy Fleets utiliza um sistema de subcontas para suportar multiplas localizacoes de frota ou regioes operacionais dentro de uma unica plataforma. Este guia explica como as subcontas funcionam, quando voce precisa delas e como gerenciar dados em sua organizacao.
O Que e uma Subconta?
Uma subconta representa uma operacao de frota independente dentro do Levy Fleets. Cada subconta e uma entidade autonoma com:
- Seus proprios veiculos e inventario de frota
- Seus proprios clientes e historico de viagens
- Suas proprias zonas e limites geograficos
- Seus proprios precos e configuracao de cobranca
- Suas proprias configuracoes e preferencias
- Seus proprios membros da equipe e permissoes
Analogia
Pense nas subcontas como filiais de uma empresa. Cada filial (subconta) opera de forma independente com sua propria equipe e recursos, mas a matriz (Super Admins) pode ver e gerenciar todas as filiais.
Quando Voce Precisa de Multiplas Subcontas?
Use multiplas subcontas quando:
- Voce opera em multiplas cidades - Nova York e Los Angeles cada uma precisa de zonas, precos e equipes separadas
- Voce administra diferentes marcas - Multiplas operacoes white-label sob uma unica administracao
- Voce gerencia franquias - Cada franqueado opera sua propria frota
- Diferentes tipos de veiculos - Operacoes separadas para patinetes vs carrinhos de golfe
- Requisitos regulatorios - Diferentes regioes tem diferentes requisitos legais
Use uma unica subconta quando:
- Voce opera em uma cidade ou regiao
- Todos os veiculos compartilham os mesmos precos e zonas
- Uma equipe gerencia todas as operacoes
- Nao ha necessidade de separacao de dados
Como as Subcontas Funcionam
Isolamento de Dados
Cada elemento de dados no Levy Fleets pertence a uma subconta especifica:
| Tipo de Dado | Escopo | Exemplo |
|---|---|---|
| Veiculos | Por Subconta | "Patinete NYC-001" pertence apenas a subconta NYC |
| Viagens | Por Subconta | Viagens em Miami nao podem ser vistas pela subconta LA |
| Clientes | Visibilidade Entre Subcontas | Um cliente pode fazer viagens em multiplas cidades |
| Zonas | Por Subconta | Zonas de estacionamento de NYC nao afetam LA |
| Precos | Por Subconta | Tarifas diferentes para mercados diferentes |
| Membros da Equipe | Por Subconta | Equipe de NYC nao pode acessar painel de LA |
| Configuracoes | Por Subconta | Diferentes fusos horarios, idiomas, documentos legais |
Dados de Clientes
Enquanto os clientes sao tecnicamente visiveis entre subcontas (eles podem fazer viagens em multiplas cidades), seu historico de viagens e atividade e filtrado para a subconta atual no painel.
Niveis de Acesso de Usuario
Existem dois padroes de acesso fundamentais:
Usuarios de Subconta Unica
- Atribuidos a UMA subconta especifica
- So podem ver e gerenciar dados daquela subconta
- Seletor de subconta mostra apenas sua subconta
- Exemplos: Gerentes de Frota, Suporte ao Cliente, Tecnicos de Servico
Usuarios Globais (Super Admin / Admin Global)
- Podem acessar TODAS as subcontas
- Podem alternar entre subcontas usando o seletor
- Tem uma opcao especial de visualizacao "Global"
- Podem gerenciar configuracoes entre subcontas
- Exemplos: Lideranca corporativa, Administradores de plataforma
O Seletor de Subconta
Posicao
O seletor de subconta aparece no canto superior esquerdo da barra de navegacao do painel.
Aparencia
Para usuarios de subconta unica:
- Exibido como um badge nao interativo
- Mostra nome e localizacao da subconta
- Estilo azul indica contexto atual
Para usuarios globais:
- Exibido como um menu suspenso
- Mostra selecao atual com uma seta
- Lista todas as subcontas acessiveis
- Inclui opcao "Global" no topo
Alternando Entre Subcontas
Para alternar entre subcontas (apenas usuarios globais):
- Clique no seletor de subconta no canto superior esquerdo
- Selecione a subconta desejada no menu suspenso
- O painel recarrega com os dados da nova subconta
Contexto de Dados
Quando voce alterna subcontas, TODOS os dados do painel sao atualizados para mostrar apenas as informacoes daquela subconta. Certifique-se de que voce esta visualizando a subconta correta antes de fazer alteracoes.
A Visualizacao Global
Usuarios globais tem acesso a uma visualizacao especial "Global" que agrega dados de todas as subcontas:
O que a visualizacao global mostra:
- Metricas combinadas de todas as subcontas
- Contagens agregadas de viagens e receita
- Todos os veiculos de todas as localizacoes
- Todos os clientes de todas as regioes
Limitacoes da visualizacao global:
- Algumas acoes sao desativadas para prevenir alteracoes entre subcontas
- Melhor para relatorios e monitoramento de alto nivel
- Gerenciamento detalhado deve ser feito em subcontas especificas
Distincao visual:
- Visualizacao global usa estilo indigo/roxo
- Subcontas individuais usam estilo azul
- Icone de globo indica contexto global
Propriedades da Subconta
Cada subconta tem estas propriedades principais:
Informacoes Basicas
| Campo | Descricao | Exemplo |
|---|---|---|
| Nome | Nome de exibicao para a subconta | "Operacoes Nova York" |
| Cidade | Cidade principal de operacao | "Nova York" |
| Estado | Estado ou provincia | "NY" |
| Status da Frota | Status operacional | "Ativo", "Inativo", "Suspenso" |
Informacoes de Contato
| Campo | Descricao |
|---|---|
| E-mail de Contato | E-mail de contato principal |
| Nome do Contato | Pessoa de contato principal |
| Telefone | Numero de telefone de contato |
| Nome da Empresa | Nome da entidade legal do negocio |
Informacoes Financeiras (Apenas Admin)
| Campo | Descricao |
|---|---|
| % de Participacao do Parceiro | Percentual de divisao de receita |
| % de Participacao Levy | Percentual de taxa da plataforma |
| Receita Mensal | Receita mensal rastreada |
| Taxa Stripe | Custo de processamento de pagamentos |
| Retainer Minimo | Compromisso mensal minimo |
Configuracao
| Campo | Descricao |
|---|---|
| Senhas IoT | Senhas especificas de dispositivos (JSON) |
| Fuso Horario | Fuso horario operacional |
| Idioma | Idioma padrao da interface |
| Documentos Legais | URLs de Termos, Privacidade, Contrato de Aluguel |
Gerenciando Multiplas Subcontas
Criando uma Nova Subconta
Novas subcontas sao tipicamente criadas por:
- Super Admin: Atraves do painel de administracao
- Equipe de Parcerias Levy: Durante onboarding de parceiros
- Migracao: A partir de envio de formulario de parceiro
Contate a Levy
Para criar uma nova subconta para uma nova localizacao, entre em contato com a equipe de parcerias Levy em partnerships@levyelectric.com.
Status da Subconta
| Status | Significado | Impacto |
|---|---|---|
| Ativo | Totalmente operacional | Veiculos disponiveis, viagens processadas |
| Inativo | Nao em operacao | Veiculos ocultos, viagens desativadas |
| Suspenso | Temporariamente pausado | Todas as operacoes pausadas |
| Rascunho | Em configuracao | Ainda nao operacional |
Melhores Praticas para Operacoes em Multiplas Localizacoes
Organizacao:
- Use convencoes de nomenclatura consistentes (ex: "Cidade - Marca")
- Agrupe subcontas relacionadas logicamente
- Documente o proposito e escopo de cada subconta
Gerenciamento de Equipe:
- Atribua gerentes locais a cada subconta
- Reserve acesso de admin global para pessoal essencial
- Treine membros da equipe apenas em sua subconta especifica
Configuracao:
- Defina fuso horario corretamente para cada localizacao
- Configure documentos legais especificos da localizacao
- Personalize precos para condicoes do mercado local
Monitoramento:
- Use visualizacao global para metricas de alto nivel
- Mergulhe em subcontas especificas para analise detalhada
- Configure alertas para cada subconta independentemente
Atribuindo Usuarios a Subcontas
Como Usuarios Sao Atribuidos
Quando voce convida um membro da equipe, ele e atribuido a uma subconta especifica:
- Navegue ate Configuracoes > Equipe
- Clique em Convidar Membro da Equipe
- Insira e-mail e selecione funcao
- O convite e vinculado a subconta atual
O novo membro so tera acesso a subconta de onde foi convidado.
Alterando Atribuicao de Subconta de Usuario
Para mover um usuario para uma subconta diferente:
- Remova-o da subconta atual
- Convide-o novamente da nova subconta
- Ele precisa aceitar o novo convite
Acesso a Multiplas Localizacoes
Se um usuario precisa de acesso a multiplas subcontas mas nao deve ter acesso global, ele precisa de contas separadas (enderecos de e-mail diferentes) para cada subconta.
Acesso de Super Admin
Super Admins sao especiais:
- Nao vinculados a uma unica subconta
- Podem acessar qualquer subconta
- Podem ver a visualizacao agregada global
- Podem criar e gerenciar outros Super Admins
- Tipicamente reservado para lideranca corporativa ou administradores de plataforma
Como Subcontas Afetam Recursos
Veiculos
- Veiculos pertencem a exatamente uma subconta
- Nao podem ser transferidos entre subcontas
- Lista de veiculos filtra pela subconta atual
- Visualizacao de mapa mostra apenas veiculos da subconta atual
Viagens
- Viagens sao registradas na subconta onde ocorreram
- Precos de viagem usam configuracao da subconta
- Historico de viagens filtra pela subconta atual
- Receita e atribuida a subconta da viagem
Clientes
- Clientes podem fazer viagens em multiplas subcontas
- Perfil do cliente e acessivel de qualquer subconta
- Historico de viagens no perfil filtra pela subconta atual
- Saldo de carteira e global (compartilhado entre localizacoes)
Carteira do Cliente
O saldo de carteira de um cliente e compartilhado entre todas as subcontas. Se ele adicionar R$ 20 em NYC, pode usa-lo em LA.
Zonas
- Zonas pertencem a exatamente uma subconta
- Aplicacao de zona so se aplica dentro da subconta
- Sem sobreposicao ou conflitos entre zonas de subcontas
- Cada subconta gerencia suas proprias areas geograficas
Precos
- Configuracoes de precos sao por subconta
- Mesmo modelo de veiculo pode ter precos diferentes em mercados diferentes
- Pacotes de assinatura sao especificos da subconta
- Codigos promocionais podem ser especificos da subconta ou globais
Configuracoes
- Cada aba de configuracoes se aplica a subconta atual
- Mudancas de configuracao afetam apenas aquela subconta
- Super Admins podem ver configuracoes de qualquer subconta
- Algumas configuracoes (como senhas IoT) sao criticas por localizacao
Equipe
- Convites de equipe sao especificos da subconta
- Lista de equipe mostra apenas membros da subconta atual
- Permissoes de funcao se aplicam dentro da subconta
- Usuarios globais aparecem em todas as listas de equipe de subcontas
Fluxo e Filtragem de Dados
Como a Filtragem Funciona
Cada requisicao de API inclui o contexto da subconta atual:
- Painel determina subconta atual do seletor
- Chamadas de API incluem parametro de ID da subconta
- Consultas ao banco de dados filtram por subconta
- Resultados retornam apenas dados relevantes
Exemplo de fluxo:
Usuario seleciona "Operacoes NYC" →
Painel define contexto →
GET /api/vehicles?subaccount_id=nyc-uuid →
Banco de dados: WHERE subaccount_id = 'nyc-uuid' →
Retorna apenas veiculos de NYC
Filtragem de Visualizacao Global
Quando visualizacao global e selecionada:
- Filtro de subconta e removido
- Todos os dados de todas as subcontas sao retornados
- Resultados agregam entre localizacoes
- Algumas operacoes de escrita sao desativadas
Persistencia
Sua selecao de subconta e salva:
- Armazenada no armazenamento local do navegador
- Sobrevive a atualizacoes de pagina
- Persiste entre sessoes
- Limpa ao fazer logout
Cenarios Comuns
Cenario 1: Operacao em Cidade Unica
Configuracao:
- Uma subconta para sua cidade
- Todos os membros da equipe atribuidos a essa subconta
- Sem seletor de subconta (opcao unica nao mostra dropdown)
Experiencia:
- Painel sempre mostra dados da sua cidade
- Sem necessidade de alternancia de contexto
- Interface simples e simplificada
Cenario 2: Empresa Multi-Cidades
Configuracao:
- Uma subconta por cidade
- Gerentes locais atribuidos por cidade
- Super Admins na matriz
Experiencia:
- Gerentes locais veem apenas sua cidade
- Super Admins podem alternar entre cidades
- Visualizacao global para relatorios executivos
Cenario 3: Modelo de Franquia
Configuracao:
- Uma subconta por franqueado
- Franqueados tem acesso de admin a sua subconta
- Franqueador tem acesso de Super Admin
Experiencia:
- Franqueados operam independentemente
- Franqueador supervisiona todas as localizacoes
- Cobranca e rastreamento de receita separados por franquia
Cenario 4: Operacoes White-Label
Configuracao:
- Diferentes subcontas para diferentes marcas
- Configuracoes separadas, branding, documentos legais por marca
- Equipe de gerenciamento central
Experiencia:
- Cada marca opera com sua propria identidade
- Modelos de veiculos compartilhados possiveis
- Relatorios centralizados entre marcas
Solucionando Problemas de Subcontas
"Nao Consigo Ver Meus Veiculos"
- Verifique se voce selecionou a subconta correta
- Verifique se veiculos foram adicionados a essa subconta
- Confirme que sua funcao tem permissoes para ver veiculos
"Dados Parecem Incorretos"
- Verifique o seletor de subconta - voce pode estar na visualizacao global
- Atualize a pagina para garantir selecao atual
- Verifique se filtros nao estao escondendo dados esperados
"Nao Consigo Acessar Outra Subconta"
- Apenas Super/Global Admins podem alternar subcontas
- Usuarios regulares sao vinculados a sua subconta atribuida
- Contate seu admin se precisar de acesso mais amplo
"Membro da Equipe Nao Consegue Fazer Login"
- Verifique se ele aceitou o convite
- Verifique se ele esta usando o e-mail correto
- Confirme que o convite nao era para uma subconta diferente
"Configuracoes Nao Estao Sendo Aplicadas"
- Confirme que voce esta na subconta correta
- Configuracoes so se aplicam a subconta atual
- Atualize e verifique se configuracoes foram salvas
Consideracoes de Seguranca
Isolamento de Dados
Subcontas fornecem forte isolamento de dados:
- Consultas de banco de dados aplicam filtragem de subconta
- APIs validam acesso a subconta
- Usuarios so podem acessar subcontas atribuidas
- Vazamentos de dados entre subcontas sao prevenidos em multiplas camadas
Trilha de Auditoria
Todas as acoes sao registradas com contexto de subconta:
- Quem fez alteracoes
- Qual subconta foi afetada
- Quando alteracoes ocorreram
- O que foi alterado
Controle de Acesso
Permissoes baseadas em funcao complementam o acesso de subconta:
- Usuario deve ter acesso a subconta E permissao necessaria
- Super Admins ignoram restricoes de subconta
- Acoes sensiveis requerem funcao de Admin
O Que Vem a Seguir?
Agora que voce entende subcontas:
- Guia de Inicio Rapido - Configure sua primeira frota
- Configuracao de Conta e Membros da Equipe - Configure sua equipe
- Checklist da Primeira Frota - Verifique configuracao completa
Pronto para Multiplas Localizacoes
Seja operando uma localizacao ou dezenas, o sistema de subcontas escala com seu negocio. Comece com uma subconta e adicione mais conforme expande para novos mercados.