====== 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.

===== Versão do Transmissor =====

O Transmissor agora faz parte do programa **Gollum** instalado nas lojas e **não se atualiza mais sozinho**: ele é atualizado junto com o Gollum, quando uma nova versão do Gollum é instalada na loja.

O servidor guarda qual é a versão do Transmissor aceita e só recebe dados de lojas com exatamente essa versão. Por isso, quando uma nova versão do Transmissor for lançada:
  - Registre a nova versão no sistema (isso é feito pelo administrador diretamente no servidor) **somente depois** de a nova versão do Gollum estar disponível para as lojas
  - Lojas que ainda não atualizaram o Gollum passam a ter os envios recusados, e o registro de atividades da loja avisa que a versão é diferente da esperada
  - Para voltar a enviar, basta atualizar o Gollum da loja para a versão mais recente

Para o passo a passo de instalação e configuração do Transmissor nas lojas, veja a página [[ello_dash:transmissor|Transmissor de Dados]].

===== 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