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