Implantação Inicial do Banco

Objetivo

Esta nota explica o primeiro uso operacional do Data Studio para preparar o ambiente de banco na VPS.

Ela serve para responder:

• o que precisa estar pronto antes de começar;
• o que cada passo da implantação faz;
• o que já é automático no painel;
• o que ainda continua manual ou futuro.

Pré-requisitos

Antes de abrir /ecommpanel/admin/data, confirme:

• a VPS está acessível por SSH;
• o operador tem acesso root ou um usuário com permissão para instalar pacotes e operar o serviço postgresql;
• o operador tem perfil main_admin;
• o host, a porta e o usuário SSH foram confirmados;
• o nome do banco e o nome do usuário da aplicação já foram decididos.

Fluxo oficial

1. abrir Configurações do painel -> Dados e banco;
2. selecionar ou criar o perfil de conexão;
3. preencher engine, host, porta, banco, usuário do app e referência da senha;
4. preencher host SSH, porta SSH e usuário SSH;
5. salvar a conexão;
6. rodar Testar alcance;
7. rodar Inspecionar VPS;
8. revisar se o painel detectou:

- acesso válido; - instalação do PostgreSQL existente ou pendente; - existência ou não do banco; - existência ou não do usuário do app; - existência ou não do boilerplate do painel;

1. preencher os dados do Main Admin inicial;
2. rodar Provisionar banco inicial;
3. validar o estado das quatro etapas no assistente.

O que o provisionamento cria

Na versão atual, o assistente remoto automático cria:

• instalação do PostgreSQL quando o serviço ainda não existir na VPS;
• banco dedicado da aplicação;
• usuário do app;
• privilégios do usuário sobre o banco;
• tabelas iniciais de autenticação do painel;
• registro inicial do Main Admin.

O caminho MySQL/MariaDB continua disponível apenas como compatibilidade.

O que já muda no produto

Depois do provisionamento, o painel já pode autenticar lendo esse banco novo, desde que:

• a conexão PostgreSQL provisionada esteja marcada como principal;
• o boilerplate do painel esteja aplicado;
• a variável de ambiente referenciada em passwordReference esteja preenchida no processo da aplicação.

Para desenvolvimento local, existe um segundo caminho oficial:

• abrir um túnel SSH local até a VPS;
• configurar APP_DB_HOST, APP_DB_PORT, APP_DB_NAME, APP_DB_USER e APP_DB_PASSWORD no .env.local;
• usar ECOMMPANEL_DB_RUNTIME_MODE=env ou auto.

Se alguma dessas condições não estiver pronta, o sistema continua com fallback local para não interromper o uso do admin.

Além da autenticação, os módulos administrativos já preparados para essa mesma base incluem:

• usuários, sessões, reset e auditoria do painel;
• blog;
• catálogo;
• páginas dinâmicas e rotas;
• template, tema, textos estruturais e mega menu.

Resultado esperado

Ao fim da primeira implantação, o painel deve mostrar:

• credenciais verificadas;
• base criada;
• boilerplate aplicado;
• Main Admin inicial provisionado.

Quando repetir o fluxo

Repita o assistente apenas quando:

• for preparar uma nova VPS;
• for trocar banco/ambiente;
• a inspeção indicar ausência do banco ou do boilerplate;
• o ambiente tiver sido recriado.

Leitura seguinte

• 14 - Operacao do Data Studio
• 15 - Checklist Pos-Provisionamento
• 20 - Desenvolvimento Local com Banco Remoto
• 90 - Glossario