Painel - Clientes

Objetivo deste guia

Explicar como o painel passou a operar o cadastro real de clientes sem depender do fluxo público de Minha conta.

Papel do módulo

A seção Clientes do EcommPanel existe para operação assistida.

Ela atende cenários como:

• cadastro interno de cliente por telefone, WhatsApp ou balcão;
• complemento de dados antes de um pedido manual;
• correção de dados cadastrais sem forçar o cliente a entrar na conta;
• manutenção de múltiplos endereços;
• revisão de consentimentos e status da conta.

Onde fica no painel

Rota principal:

• /ecommpanel/admin/customers

Pontos do código:

• src/app/ecommpanel/admin/customers/page.tsx
• src/features/ecommpanel/components/CustomerOperationsManager.tsx
• src/app/api/ecommpanel/customers/route.ts
• src/app/api/ecommpanel/customers/[customerId]/route.ts
• src/features/ecommerce/server/customerAccountStore.ts
• src/features/ecommerce/types/account.ts

O que essa tela já faz

Lista operacional

• busca por nome, e-mail ou telefone;
• leitura rápida de status;
• quantidade de pedidos por cliente;
• quantidade de endereços;
• sinalização de conta ativa e pendência LGPD.

Cadastro completo

Pessoa física:

• e-mail;
• telefone principal e alternativo;
• primeiro nome e sobrenome;
• data de nascimento;
• CPF;
• RG.

Pessoa jurídica:

• e-mail;
• telefones;
• razão social;
• nome fantasia;
• CNPJ;
• inscrição estadual.

Consentimentos e status

• conta ativa/inativa;
• aceite de privacidade;
• aceite de termos;
• opt-in de marketing.

Política de ativação

• o painel de Auth e e-mail controla se o cadastro do cliente exige verificação por código;
• também define se domínios de e-mail temporário ficam bloqueados;
• a operação pode ajustar o prazo do cadastro pendente e a lista extra de bloqueio.

Endereços

• múltiplos endereços por cliente;
• rótulo operacional;
• destinatário;
• endereço completo;
• endereço padrão de entrega;
• endereço padrão de cobrança.

Tabelas usadas

Cadastro base

• customer_accounts
• customer_addresses

Acesso do cliente

• customer_login_tokens
• customer_pending_registrations
• customer_sessions
• customer_audit_events

Relação comercial

• customer_orders
• commerce_orders

Como isso conversa com o storefront

O painel não cria uma base paralela.

Ele grava no mesmo domínio de clientes que a área Minha conta usa.

Na prática:

1. o operador cadastra ou ajusta o cliente pelo admin;
2. o cliente continua podendo entrar por código no ecommerce;
3. checkout, pedidos e endereços usam o mesmo cadastro;
4. o app mobile futuro pode reutilizar o mesmo contrato.

Diferença entre painel e Minha conta

Minha conta

• voltada ao cliente final;
• login por código;
• atualização de dados pelo próprio consumidor;
• consulta de pedidos e endereços.

Painel

• voltado à operação interna;
• cria e edita cadastro sem depender do cliente;
• prepara conta para suporte, atendimento e pedido assistido;
• atua com mais contexto operacional.

Cuidados de segurança

• dados sensíveis ficam cifrados em repouso;
• documentos não são expostos em APIs públicas;
• a conta do cliente não reutiliza usuários do admin;
• a trilha de auditoria é separada do painel administrativo.

LGPD e dados

O módulo agora também conversa com um centro dedicado de privacidade no painel.

Isso cobre:

• fila de solicitações de exportação e exclusão;
• aprovação ou rejeição antes da execução;
• exportação administrativa da conta;
• anonimização controlada;
• política de retenção por categoria de dado;
• separação entre conta removida e pedido operacional retido.

Próxima evolução prevista

• integração com criação de pedido manual;
• consulta unificada de conta, pedidos e atendimento;
• SLA e automação de expurgo por política.

Leitura seguinte

• 23 - Ecommerce - Minha Conta
• 24 - Ecommerce - Pedidos Operacionais
• 28 - LGPD - Conta do Cliente e Retencao
• 03 - EcommPanel - Operacao