For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt, and this page is available as Markdown at /manual/index.md.
Gera Base

    Manual do Usuario

    O Gera Base cria bancos Postgres e adiciona tabelas a bancos existentes com base em templates cadastrados.

    Acessos

    Em producao, os acessos seguem este formato:

    Gerador de bancos: https://gera-base.jvbgprojects.com.br
Conversor DDL:     https://ddl.jvbgprojects.com.br
JSON Explorer:     https://json.jvbgprojects.com.br
Admin:             https://admin.jvbgprojects.com.br
Automacoes n8n:    https://automacao.jvbgprojects.com.br
Automacao em lote: https://gera-base.jvbgprojects.com.br/automacao-lote

    Todos os modulos exigem login. Usuarios comuns acessam o gerador, a Biblioteca SQL, o conversor DDL e o JSON Explorer. Apenas administradores acessam o painel administrativo.

    Criar Banco Postgres

    1. Informe o nome base.
    2. Escolha Criar banco novo.
    3. Selecione o template.
    4. Revise tabelas e colunas.
    5. Preencha os dados do Postgres.
    6. Clique em Testar conexao.
    7. Execute a criacao.

    O sistema adiciona _db ao final do banco quando necessario.

    empresa -> empresa_db

    Adicionar Tabelas

    1. Informe o nome base do banco existente.
    2. Escolha Adicionar tabelas ao banco existente.
    3. Selecione o template.
    4. Marque as colunas desejadas.
    5. Confira a conexao Postgres.
    6. Execute a inclusao.

    Templates

    Use o editor visual para criar, editar, arquivar, restaurar ou excluir templates.

    Use Validar para encontrar problemas antes de salvar. Use Simular para revisar o SQL final sem executar nada no Postgres. O historico permite restaurar versoes anteriores quando uma edicao nao saiu como esperado.

    Use {{nome}} em qualquer posicao quando quiser substituir pelo nome base:

    tmp_{{nome}}_clientes -> tmp_empresa_clientes

    Ao criar uma nova tabela pelo editor, o sistema usa tipos Postgres por padrao. O MariaDB nao e destino de geracao de bancos; ele guarda apenas dados internos da aplicacao.

    JSON Explorer

    Use o JSON Explorer para abrir respostas JSON, JSONL, NDJSON e arquivos exportados. A ferramenta permite buscar, ordenar, paginar, selecionar colunas, visualizar arvore estrutural e exportar CSV.

    Biblioteca SQL

    Use a Biblioteca SQL para salvar consultas por usuario, organizar por categoria e tags, marcar favoritas, duplicar consultas e copiar SQL rapidamente. Os dialetos disponiveis sao Postgres, MariaDB, MySQL, SQL Server, Oracle e Outro.

    Automacao em Lote

    1. Abra Automacao em lote no cabecalho do Gerador.
    2. Mantenha a URL https://automacao.jvbgprojects.com.br/webhook/gera-base-lote.
    3. Informe as credenciais da API e uma conexao Postgres.
    4. Selecione, arraste ou cole o CSV.
    5. Revise o payload e execute.
    6. Consulte ou baixe o resultado.

    Para varios bancos no mesmo host, use uma linha por banco. Informe empresa em name para operar em empresa_db.

    Se aparecer Cloudflare 1010, a comunicacao interna com o n8n precisa ser revisada pelo administrador.

    Painel Administrativo

    Administradores podem criar usuarios, ativar/desativar acessos, trocar senhas, mudar perfis, criar/revogar/excluir tokens de API, consultar logs filtrados por status/servico/busca e importar/exportar backups de templates.

    O painel tambem mostra a saude operacional de MariaDB, templates, n8n e backups.

    Tokens de API

    Use tokens para automacoes como n8n.

    1. Abra o painel Admin.
    2. Na area Tokens de API, informe um nome.
    3. Escolha o perfil Usuario para rotinas comuns.
    4. Clique em Criar token.
    5. Copie o token exibido, pois ele nao sera mostrado novamente.

    Tokens antigos podem ser desativados sem apagar o historico de logs. Exclua apenas tokens que nao serao mais usados por nenhuma automacao.

    Backup de Templates

    No painel Admin:

    1. Abra Backup de templates.
    2. Clique em Baixar backup.
    3. Guarde o JSON fora do container.

    Para restaurar:

    1. Abra Importar templates.
    2. Selecione o JSON exportado.
    3. Escolha se deseja sobrescrever templates existentes.
    4. Clique em Importar.

    Desenvolvimento Local

    No Windows, se o localhost:8000 ou outras portas do Podman nao abrirem, use:

    .\scripts\windows\Iniciar Local Completo.bat

    Ele sobe os containers e cria acessos alternativos:

    Gerador:        http://127.0.0.1:18000
Admin:          http://127.0.0.1:18030
Biblioteca SQL: http://127.0.0.1:18040
n8n:            http://127.0.0.1:15678