Base do projeto/docs/dados-e-bootstrap

Dados e Bootstrap

O `Data Studio` é a camada do `EcommPanel` usada para começar a modelar o banco do produto antes da migração definitiva para persistência real.

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ções9

Tags4

dadosdatabasebootstrapecommpanel

Papel do módulo

O Data Studio é a camada do EcommPanel usada para começar a modelar o banco do produto antes da migração definitiva para persistência real.

Hoje ele permite:

cadastrar engine, perfil de conexão, SSH e credenciais de referência;
inspecionar uma VPS PostgreSQL via SSH sem expor o banco publicamente;
instalar e configurar PostgreSQL automaticamente quando necessário;
criar banco dedicado, usuário do app e boilerplate inicial de autenticação do painel;
criar entidades;
definir campos e tipos;
marcar obrigatoriedade, unicidade e índice;
importar registros em JSON;
exportar qualquer tabela conectada em CSV;
importar CSV diretamente em tabelas existentes do PostgreSQL;
importar um pacote completo de entidades e cargas;
gerar um pacote base para bootstrap do banco.

Ele fica no menu de Configurações do painel, porque essa área trata:

conexão principal do banco;
estado de bootstrap;
base estrutural de entidades;
imports de apoio para popular o ambiente.

Onde ele entra

Rotas principais:

painel: /ecommpanel/admin/data
dicionário interno: /ecommpanel/admin/data/dictionary
API interna: /api/ecommpanel/data-studio

O que ele gera

O pacote base atual contém:

database/README.md
database/schema.json
database/postgres-content-bootstrap.sql
database/postgres-panel-bootstrap.sql
database/mysql-content-bootstrap.sql
database/mysql-panel-bootstrap.sql
database/seed-imports.json

Esse material serve como ponto de partida para:

revisão técnica do modelo;
bootstrap de PostgreSQL;
carga inicial;
versionamento da estrutura de dados.

Governança de acesso

O módulo foi separado por capacidade:

main_admin: pode configurar conexão, bootstrap, entidades e registros;
data_manager: pode manter entidades e registros, mas não muda conexão nem bootstrap;
data_editor: pode importar e manipular registros, sem criar novas entidades;
data_viewer: leitura apenas.

Isso deixa a ferramenta útil mesmo depois da primeira criação da base, porque ela continua servindo para:

revisar o modelo;
manter imports;
trocar dados com planilhas e processos externos por CSV;
regenerar pacote base;
acompanhar o estado do ambiente.

Persistência atual

Enquanto o banco real ainda não foi ligado, o módulo salva dados localmente em:

src/data/ecommpanel/data-studio/schema.json
src/data/ecommpanel/data-studio/imports/*.json

Isso mantém a operação simples agora, sem travar a futura troca para banco.

Detecção atual

Nesta fase, o painel já faz:

teste básico de host e porta;
inspeção remota da VPS quando a conexão estiver em SSH + PostgreSQL oficial na VPS;
verificação de existência do banco, usuário do app e boilerplate do painel;
provisionamento inicial do banco e do Main Admin.

Ainda existe um limite importante:

o fluxo oficial agora está fechado para PostgreSQL via SSH;
MySQL/MariaDB via SSH continua disponível como caminho de compatibilidade;
a modelagem segue servindo para a futura camada definitiva, mesmo quando o banco principal do produto migrar.

Exemplo de uso

criar a entidade clientes;
configurar uma conexão PostgreSQL com método SSH + PostgreSQL oficial na VPS;
rodar a inspeção da VPS;
provisionar instalação do PostgreSQL quando necessário, banco, usuário do app e Main Admin inicial;
definir campos como email, first_name, accepts_marketing;
importar registros em JSON;
gerar o pacote base;
usar o SQL e o schema como referência para a implementação real.

Relação com o roadmap

Este módulo existe para encurtar a passagem entre:

a operação atual em JSON;
a futura base em PostgreSQL;
o backend dedicado que vai servir web, painel e mobile.