Áreas, perfis e acesso
Quem entra onde, com qual papel, e o que cada perfil pode ver ou fazer — incluindo a verificação em duas etapas para a equipe VC1 e como cada revenda fica isolada no próprio endereço.
Quatro áreas de trabalho
O produto não é um site único: cada tipo de usuário abre um endereço (host) diferente. A voz do cliente não passa por esta plataforma — aqui ficam cadastro, preço, proposta, cobrança e painéis.
| Área | Quem usa | Endereço (produção) | O que faz ali | Exemplo no protótipo |
|---|---|---|---|---|
| Painel VC1 (staff) | Equipe interna da operadora | admin.vc1.com.br |
Faixas de atacado, revendas, faturas, bloqueios, repasses, STFC, suporte com “ver como revenda” | VC1-01 · VC1-36 |
| Painel da revenda | Dono, admin, financeiro e vendedores da parceira | {slug}.vc1.com.br/painel |
Planos, funil de propostas, clientes, extratos, faturas da revenda, marca e usuários — sempre só da revenda logada | REV-01 · REV-17 |
| Área do cliente final | Empresa que usa a telefonia no dia a dia | {slug}.vc1.com.br/app |
SIP, números, extrato de ligações, saldo ou fatura, portabilidade (conforme plano) | CLI-01 · CLI-06 |
| Público e login genérico | Prospecto, convidado, quem esqueceu a senha | {slug}.vc1.com.br/p/{code}; atalho sales.vc1.com.br; login em cliente.vc1.com.br |
Proposta com PIN de 6 dígitos, aceite e assinatura; login genérico redireciona para o host da revenda certa | PUB-07 · PUB-01 |
No ambiente de testes (LAB), os mesmos papéis usam hosts *.lab.vc1.com.br (por exemplo admin.lab.vc1.com.br, {slug}.lab.vc1.com.br, api.lab.vc1.com.br). Detalhes na área técnica → Onde roda.
Perfis de sistema (papéis)
Cada login recebe um ou mais papéis. O sistema só mostra telas e ações permitidas para aquele papel — e, para revenda e cliente, só dados da revenda (tenant) correta.
| Perfil | Onde entra | Pode (resumo) | Não pode (resumo) |
|---|---|---|---|
vc1_admin | Painel VC1 | Tudo no painel staff, impersonation e allowlist do LAB | Deploy ou SSH (fora do aplicativo) |
vc1_finance | Painel VC1 | Faturas, pagamentos, repasses, NFCom | Provisionar SIP; impersonation |
vc1_ops | Painel VC1 | Onboarding de revenda, STFC, conectores, DNS | Ver CDR nominal sem ticket; pagar repasse |
vc1_support | Painel VC1 | Leitura + “ver como revenda” (com banner) | Alterar preço/base; emitir NF; bloquear/desbloquear telefonia manualmente |
reseller_owner | Painel da revenda | Tudo da revenda (marca, faixas, planos, usuários, faturas, upload STFC) | Ver custo VC1 além da tabela de faixas; dados de outra revenda |
reseller_admin | Painel da revenda | Operação e usuários do dia a dia | Encerrar contrato com a VC1 |
reseller_finance | Painel da revenda | Faturas, extratos, crédito, repasse (modo “VC1 fatura”) | Planos e funil de vendas |
reseller_seller | Painel da revenda | Funil, propostas, kanban | Faturas, STFC, markup global |
customer_admin | Área do cliente | Usuários da empresa, portabilidade, extrato, recarga | Preço de atacado; outros clientes |
customer_user | Área do cliente | Extrato, senha SIP própria, números (leitura) | Gerir usuários; abrir portabilidade |
Prospecto na proposta pública não tem “perfil de sistema”: acesso só com PIN válido, com limite de tentativas. Integrações da revenda usam token em api.vc1.com.br (escopos limitados — detalhe na área técnica).
Verificação em duas etapas (2FA / MFA)
Quem precisa e como funciona
A equipe VC1 no painel admin.vc1.com.br usa senha e código do aplicativo autenticador (TOTP) — obrigatório antes do primeiro acesso ao LAB com dado real e sempre em produção. Revendas e clientes finais: 2FA é opcional no MVP (recomendado para o dono da revenda).
Staff VC1
- Papéis:
vc1_admin,vc1_finance,vc1_ops,vc1_support. - 2FA TOTP obrigatório no Filament (painel admin).
- Sessão com tempo limite (padrão proposto: 8 horas).
- Protótipo de tela: PUB-05 (fluxo genérico de 2FA).
Revenda, cliente e prospecto
- Revenda e cliente: login e-mail + senha no host da revenda; 2FA opcional.
- Prospecto: PIN de 6 dígitos por e-mail/SMS — não é 2FA de conta, é proteção da proposta.
- Após 5 PIN errados: bloqueio de 15 minutos (padrão alinhado ao funil existente).
- Login em
cliente.vc1.com.brdescobre a revenda e redireciona; não mantém sessão no host genérico.
Cada revenda no seu endereço (tenancy por host)
Em linguagem simples: o endereço que a pessoa digita no navegador define qual revenda está “dentro” do sistema. Não existe um painel único onde a revenda A enxerga dados da revenda B.
- Cada revenda tem um slug (apelido) e um host próprio, por exemplo
minha-revenda.vc1.com.br, com a marca configurada pela revenda. - O painel da VC1 (
admin.vc1.com.br) enxerga todas as revendas, mas com regras por papel e registro de auditoria — inclusive quando alguém usa “ver como revenda”. - A API pública (
api.vc1.com.br) e os webhooks de pagamento/assinatura também respeitam o tenant; tokens de integração ficam amarrados à revenda. - No LAB, o padrão é o mesmo com
.lab.no meio do endereço; contas demo no legado só com aval explícito do operador.
O que isso significa para você
Revendas operam com marca própria no próprio URL. A VC1 centraliza governança (preço de atacado, STFC, repasse) sem misturar carteiras de clientes entre parceiros.