Mini site de documentaçãoDeveloper Atlas

Entrada rápida para navegar arquitetura, APIs, operação e guias técnicos do projeto sem depender da estrutura do repositório.

44 notas

Procure por módulo, API, rota, fluxo operacional ou termo do projeto.

Base do projeto/docs/ecommpanel-operacao

EcommPanel - Operação

O `EcommPanel` é a camada administrativa do e-commerce.

Recorte da seçãoBase estrutural do projeto

Nota de referência para contratos, arquitetura, runbook e organização do workspace. É a camada mais estável da documentação.

Atualizado19 de mar. de 2026
Seções19
Tags2
adminecommpanel

Papel do app

O EcommPanel é a camada administrativa do e-commerce.

Hoje ele concentra:

  • dashboard operacional;
  • analytics operacional e integrações de medição;
  • data studio para modelagem e bootstrap do banco;
  • configuração de auth e e-mail transacional do painel;
  • operacao do catalogo de produtos;
  • autenticação e permissão;
  • login alternativo por código de e-mail;
  • template do storefront;
  • tema visual;
  • mega menu;
  • criação de rotas;
  • editor visual de páginas;
  • operação do blog;
  • publicação para a loja.

Áreas principais do menu

Template

Subrotas:

  • visão geral
  • header
  • home
  • footer

Observação nova:

  • a rota home agora também controla o override opcional da home por uma página dinâmica já publicada.
  • template, tema, textos do header/footer e mega menu agora podem operar em files, hybrid ou database via ECOM_STOREFRONT_PERSISTENCE_MODE.

Tema

Subrotas:

  • visão geral
  • preset
  • overrides

Mega Menu

Subrotas:

  • visão geral
  • base
  • arvore

Builder

Áreas:

  • rotas
  • editor
  • blocos

Persistência:

  • páginas e rotas agora podem operar em files, hybrid ou database via ECOM_SITE_PERSISTENCE_MODE.
  • quando o modo usa banco, o painel grava no PostgreSQL e atualiza o snapshot publicado consumido pela loja.

Blog

Áreas:

  • visão geral dos posts
  • editor editorial
  • moderação de comentários

Papéis editoriais disponíveis:

  • content_author
  • content_editor
  • content_publisher
  • comment_moderator

Area:

  • gestao de produtos

Escopo atual:

  • cadastro e edicao de produto;
  • preco, imagem, estoque e disponibilidade;
  • categorias, departamentos e colecoes por produto;
  • persistencia hibrida entre arquivo e PostgreSQL.

Analytics

Área:

  • dashboard de analytics

Escopo:

  • sessões ativas e duração média;
  • páginas, buscas e cliques;
  • carrinho, checkout e compras;
  • receita, ticket médio e método de pagamento;
  • configuração interna de coleta;
  • configuração de GTM e GA4 por input administrativo.

Persistência:

  • a configuração de analytics agora pode operar em files, hybrid ou database via ECOM_PANEL_SETTINGS_PERSISTENCE_MODE;
  • os eventos continuam em arquivos particionados por dia;
  • a configuração publicada da loja continua sendo projetada para snapshot.

Configurações do painel

Áreas:

  • analytics;
  • dados e banco;
  • auth e e-mail;
  • usuários.

Escopo:

  • definir a caixa responsável pelos e-mails de autenticação;
  • trocar remetente exibido e usuário SMTP;
  • apontar a variável de ambiente que resolve a senha SMTP;
  • ajustar a base pública usada nos links de redefinição de senha;
  • manter o restante do fluxo de segurança sem depender de mudança manual no código.

Persistência:

  • auth/e-mail do painel agora também pode operar em files, hybrid ou database via ECOM_PANEL_SETTINGS_PERSISTENCE_MODE.

Acesso

Escopo:

  • login por senha;
  • login por código de 6 dígitos enviado por e-mail;
  • acesso demo pré-preenchido na tela de login;
  • recuperação de senha por link e token;
  • sessão com CSRF e trilha de auditoria.

Demonstração controlada

Existe um usuário de demonstração para apresentar o painel sem tocar no estado oficial.

Regras:

  • sessão com duração máxima de 30 minutos;
  • pré-preenchido na tela de login;
  • pode navegar por áreas operacionais centrais do admin;
  • alterações de catálogo ficam em um sandbox temporário por sessão;
  • quando a sessão expira, o sandbox é descartado;
  • o usuário pode ser ativado ou desativado pela gestão de usuários.

Dados

Área:

  • data studio

Escopo:

  • conexão principal do banco;
  • assistente de implantação do banco;
  • inspeção remota da VPS;
  • provisionamento oficial em PostgreSQL via SSH, com instalação do serviço quando necessário;
  • estado detectado e também declarado de bootstrap;
  • modelagem de entidades e campos;
  • importação manual em JSON;
  • importação de pacote completo;
  • geração de schema.json, postgres-content-bootstrap.sql, postgres-panel-bootstrap.sql, mysql-content-bootstrap.sql, mysql-panel-bootstrap.sql e seed-imports.json.

Papéis principais:

  • main_admin
  • data_manager
  • data_editor
  • data_viewer

Comportamento de publicação

Páginas

  • Salvar rascunho: atualiza o documento administrativo
  • Publicar: envia a página para o snapshot consumido pela loja
  • Rascunho: tira a página do snapshot público

Template, tema e mega menu

  • o painel pode usar arquivo, híbrido ou banco como fonte administrativa;
  • independentemente da fonte, a publicação continua atualizando um snapshot estrutural único para leitura rápida da loja;
  • a loja continua lendo essa projeção publicada em runtime no modo servidor.

Dashboard operacional

A home administrativa deixou de ser descritiva e passou a resumir:

  • status de publicação do builder;
  • status do blog;
  • storage publicado (workspace ou ECOM_CONTENT_PATH);
  • override da home da loja;
  • sinais recentes de auditoria;
  • atalhos operacionais para rotas centrais.

API pública versionada

Além das rotas internas do admin, o projeto agora expõe uma camada pública versionada em /api/v1 para consumo por integrações e futuro app mobile.

Entradas principais:

  • /api/v1/content/pages
  • /api/v1/content/blog/posts
  • /api/v1/catalog/products
  • /api/v1/catalog/categories
  • /api/v1/system/health

Leitura seguinte