Configuração e Instalação
Esta seção descreve como instalar, configurar e manter o Ello Dash no servidor.
Requisitos do servidor
O Ello Dash roda em um servidor com:
- Sistema operacional Linux
- Docker e Docker Compose instalados
- Acesso à internet para receber os dados enviados pelo Transmissor das lojas
Configuração do ambiente
O sistema utiliza um arquivo de configuração com as seguintes informações necessárias:
| Variável | Descrição |
|---|---|
| Modo de operação | Define se o sistema roda em modo de desenvolvimento (banco local) ou produção (banco MySQL) |
| Nome do banco de dados | Nome do banco de dados utilizado em produção |
| Usuário do banco | Usuário com acesso ao banco de dados |
| Senha do banco | Senha de acesso ao banco de dados |
| Endereço do banco | Endereço do servidor de banco de dados |
| Porta do banco | Porta de conexão ao banco de dados |
Como fazer o deploy
O sistema é organizado em dois componentes que rodam em paralelo:
- Banco de dados: MySQL 8.0 com armazenamento persistente em disco
- Aplicação: O painel Ello Dash em si, disponível na porta 80 (HTTP)
Ao iniciar pela primeira vez, o sistema executa automaticamente:
- Atualização da estrutura do banco de dados
- Criação do usuário administrador padrão
- Preparação dos arquivos necessários para o painel (imagens, estilos, etc.)
- Configuração da limpeza automática de dados antigos
Acesso ao painel administrativo
O painel de administração completo está disponível em: dash.ellotecnologia.com/admin
As credenciais do administrador padrão são definidas durante a configuração inicial do servidor.
Manutenção automática
Limpeza de dados antigos
Todos os dias às 2h da manhã, o sistema remove automaticamente os registros de vendas com mais de 90 dias. Isso mantém o banco de dados leve e garante bom desempenho ao longo do tempo.
Os demais dados (contas a pagar, contas a receber, contas financeiras, notas de entrada) não são removidos automaticamente — eles são sempre substituídos pelos dados mais recentes enviados pelo Transmissor.
Atualizando a versão do Transmissor
Quando uma nova versão do Transmissor é lançada, é necessário registrá-la no sistema para que os programas instalados nas lojas saibam que precisam se atualizar. Isso é feito pelo administrador diretamente no servidor.
Ao registrar uma nova versão:
- Os Transmissores com versão mais antiga verificarão automaticamente a nova versão e se atualizarão na próxima execução
- Transmissores que não conseguirem se atualizar automaticamente receberão uma mensagem de erro e precisarão ser atualizados manualmente
Backup
Recomenda-se realizar backup regular do banco de dados. Como os dados de vendas têm retenção de 90 dias e são reenviados periodicamente pelo Transmissor, o risco de perda permanente de dados de vendas é baixo. No entanto, o backup garante a preservação de:
- Cadastro de usuários e senhas
- Cadastro de empresas
- Configurações de permissões
- Dados financeiros (contas a pagar, contas a receber) que não são reenviados automaticamente com histórico