Operação do Data Studio

Papel do módulo

O Data Studio não serve só para a primeira criação do banco.

Depois da implantação inicial, ele continua sendo a área de:

• governança das conexões;
• leitura do estado do ambiente;
• modelagem de entidades;
• manutenção de campos;
• importação de registros;
• importação e exportação CSV por tabela;
• geração do pacote base.

Como pensar a operação

Conexão

Usada para definir qual ambiente está sendo preparado ou acompanhado.

Bootstrap

É a preparação inicial do ambiente.

No nosso caso, isso significa:

• validar o acesso;
• instalar PostgreSQL quando necessário;
• criar o banco;
• criar o usuário do app;
• aplicar o boilerplate do painel;
• registrar o Main Admin inicial.

Entidade

É um tipo de dado do sistema, como:

• clientes;
• posts do blog;
• produtos;
• categorias;
• pedidos.

Campo

É uma propriedade da entidade, como:

• email;
• slug;
• status;
• description;
• is_active.

Registro

É um item concreto importado ou salvo para uma entidade.

Exemplo:

• um cliente específico;
• um post específico;
• um produto específico.

Fluxos operacionais mais comuns

Rodar local apontando para o banco real

1. abrir um túnel SSH até a VPS;
2. definir no .env.local:

- ECOMMPANEL_DB_RUNTIME_MODE=env ou auto; - APP_DB_HOST=127.0.0.1; - APP_DB_PORT com a porta local do túnel; - APP_DB_NAME, APP_DB_USER e APP_DB_PASSWORD;

1. iniciar o projeto normalmente com npm run dev.

Esse caminho é o mais seguro para desenvolvimento quando o PostgreSQL da VPS não fica exposto publicamente.

Criar ou ajustar uma entidade

1. selecionar a entidade na lateral ou clicar em Nova entidade;
2. preencher nome, slug e tabela;
3. definir campos;
4. marcar obrigatoriedade, unicidade e índice;
5. salvar;
6. regenerar o pacote base se a estrutura mudou.

Importar registros

1. selecionar a entidade;
2. colar o JSON no bloco de importação;
3. usar Importar registros;
4. confirmar o log de importação na lateral.

Importar pacote completo

Usar quando já existir um pacote com:

• entidades;
• cargas de registros.

Exportar ou importar CSV por tabela

1. abrir a seção Importar e exportar CSV por tabela;
2. recarregar a lista de tabelas quando necessário;
3. selecionar a tabela física do PostgreSQL;
4. usar Gerar CSV da tabela para baixar os dados atuais;
5. carregar um arquivo .csv ou colar o conteúdo manualmente;
6. escolher:

- append para só inserir linhas novas; - upsert para atualizar pelo primary key, quando existir;

1. importar o CSV e revisar o resumo da operação.

Regra importante:

• esta área é reservada ao perfil forte do módulo de dados porque pode alcançar tabelas sensíveis como autenticação, sessões e auditoria.

Regenerar o pacote base

Usar quando houver mudança em:

• entidades;
• campos;
• estrutura inicial do ambiente.

Regra prática de operação

• conexão e bootstrap: responsabilidade do main_admin;
• entidades: main_admin ou data_manager;
• registros: main_admin, data_manager ou data_editor;
• leitura: qualquer perfil com visibilidade da área.

O que não fazer

• não usar permissões avançadas do painel para substituir o papel correto do operador;
• não tratar o Data Studio como banco transacional final;
• não presumir que importação em JSON resolve estoque, pedido ou concorrência crítica;
• não misturar ambiente de teste e produção na mesma conexão principal.

Leitura seguinte

• 13 - Implantacao Inicial do Banco
• 15 - Checklist Pos-Provisionamento
• 19 - Painel - Data Studio Modelagem Importacao e Pacote Base
• 20 - Desenvolvimento Local com Banco Remoto