Pular para o conteúdo principal
Versão: Versão Cestas

Guia de Instalação

Agora que você conhece o sistema e entende como operá-lo, este guia mostrará como instalar o Divino Alimento em seu próprio servidor. Este processo é recomendado para administradores de sistemas ou pessoas com conhecimento técnico em servidores Linux e Docker.

Para Quem é Este Guia​

Este guia é recomendado para:

  • Administradores de sistemas
  • Desenvolvedores com experiência em Docker
  • Técnicos de TI familiarizados com Linux
  • Usuários que desejam testar o sistema localmente
  • Comunidades que desejam hospedar sua própria instância

Pré-requisitos​

Antes de iniciar a instalação, certifique-se de que seu sistema possui:

Dependências Obrigatórias​

  1. Docker Compose v2

    # Ubuntu/Debian
    sudo apt-get update
    sudo apt-get install docker-compose-plugin

    # CentOS/RHEL
    sudo yum install docker-compose-plugin

  2. Rake

    # Ubuntu/Debian
    sudo apt-get install rake

    # CentOS/RHEL
    sudo yum install rubygem-rake

  3. Git

    # Ubuntu/Debian
    sudo apt-get install git

    # CentOS/RHEL
    sudo yum install git

Requisitos de Sistema​

  • Sistema Operacional: Linux (Ubuntu 18.04+, CentOS 7+, Debian 9+)
  • RAM: Mínimo 2GB, recomendado 4GB
  • Armazenamento: Mínimo 5GB livres
  • Rede: Acesso à internet para download das imagens Docker
Ambiente de Produção

Esta é uma instalação básica adequada para testes e pequenas comunidades. Para ambientes de produção com muitos usuários, recomendamos configuração adicional de HTTPS, proxy reverso, backup automatizado e monitoramento. Consulte a seção "Deploy em Produção" ou entre em contato para suporte profissional.

Instalação Passo a Passo​

1. Clone do Repositório​

Primeiro, clone o repositório em um diretório de sua escolha:

git clone https://git.disroot.org/Akarui/DivinoAlimento_dev.git

2. Acesse o Diretório​

cd DivinoAlimento_dev

3. Configuração do Ambiente​

Copie o arquivo de configuração exemplo:

cp env.example .env

4. Personalização da Configuração​

Edite o arquivo .env conforme suas necessidades:

nano .env

Configurações principais:

# Porta de acesso ao sistema (padrão: 13000)
PORT=13000

# Configurações do banco de dados
DB_HOST=db
DB_PORT=5432
DB_NAME=divino_alimento
DB_USER=postgres
DB_PASS=sua_senha_segura

# Configurações OAuth Google
GOOGLE_CLIENT_ID=seu_client_id_google
GOOGLE_CLIENT_SECRET=seu_client_secret_google

# URL base da aplicação
BASE_URL=http://localhost:13000

# Ambiente (development/production)
NODE_ENV=production

5. Comandos Rake Disponíveis​

Visualize todos os comandos disponíveis:

rake --tasks

Saída esperada:

rake git:submodules_atualiza  # Atualiza submódulos Git
rake git:submodules_inicia   # Inicializa submódulos Git
rake vivo:liga               # Inicia containers Docker
rake vivo:para               # Para containers Docker
rake vivo:popular            # Popula banco com dados iniciais
rake dev:liga                # Inicia em modo desenvolvimento
rake test:roda               # Executa testes automatizados

6. Inicialização e Atualização​

Inicialize e atualize os submódulos:

rake git:submodules_inicia
rake git:submodules_atualiza

7. Inicialização do Sistema​

Inicie os containers Docker:

rake vivo:liga

Este comando irá:

  • Baixar imagens Docker necessárias
  • Criar containers para aplicação e banco
  • Configurar rede entre containers
  • Inicializar banco de dados PostgreSQL

8. População Inicial do Banco​

Popule o banco com dados básicos:

rake vivo:popular

Este comando cria:

  • Estrutura básica de tabelas
  • Duas cestas padrão iniciais
  • Configurações básicas do sistema
informação

Importante: Na tela do sistema é possível adicionar outras cestas ou editar as existentes. Porém, os relatórios padrão incluem apenas as cestas iniciais.

9. Definir Usuário Administrador​

Após primeiro login via Google OAuth:

  1. O primeiro usuário será automaticamente administrador
  2. Usuários subsequentes precisarão ter perfil definido pelo administrador
  3. Acesse /usuarios para gerenciar perfis

Primeiro Acesso​

Com a instalação concluída, acesse o sistema:

URL Local:

http://localhost:13000

URL Personalizada:

http://seu-servidor:PORTA_CONFIGURADA
Autenticação

O sistema utiliza Google OAuth para autenticação. Para instruções detalhadas de configuração do OAuth, consulte a documentação técnica no repositório do projeto.

Comandos Essenciais​

Comandos Vivo (Produção)​

# Iniciar sistema
rake vivo:liga

# Parar sistema
rake vivo:para

# Popular banco (apenas primeira vez)
rake vivo:popular

# Visualizar logs
docker-compose logs -f

Comandos Dev (Desenvolvimento)​

# Iniciar em modo desenvolvimento
rake dev:liga

# Parar desenvolvimento
rake dev:para

Comandos Test (Testes)​

# Executar testes automatizados
rake test:roda

Configurações Avançadas​

Configuração de Portas​

Para alterar a porta padrão:

  1. Edite arquivo .env:

    PORT=8080  # Sua porta desejada

  2. Reinicie o sistema:

    rake vivo:para
    rake vivo:liga

Backup do Banco de Dados​

# Criar backup
docker-compose exec db pg_dump -U postgres divino_alimento > backup_$(date +%Y%m%d).sql

# Restaurar backup
docker-compose exec -T db psql -U postgres divino_alimento < backup_20241201.sql

Deploy em Produção​

Configurações Recomendadas​

  1. Usar HTTPS com certificado SSL
  2. Configurar proxy reverso (Nginx/Apache)
  3. Implementar backup automático
  4. Configurar logs centralizados
  5. Monitorar recursos do sistema

Exemplo Nginx​

server {
    listen 80;
    server_name seu-dominio.com;

    location / {
        proxy_pass http://localhost:13000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

Backup Automatizado​

# Adicionar ao crontab
0 2 * * * cd /caminho/para/sistema && ./backup.sh

# Conteúdo do backup.sh
#!/bin/bash
DATE=$(date +%Y%m%d_%H%M%S)
docker-compose exec -T db pg_dump -U postgres divino_alimento > "backup_${DATE}.sql"
gzip "backup_${DATE}.sql"

Próximos Passos​

Após a instalação bem-sucedida:

  1. Configure o primeiro administrador - Faça login via Google OAuth (primeiro usuário será admin automaticamente)
  2. Realize os cadastros básicos - Siga o Guia de Início Rápido
  3. Teste com um ciclo piloto - Use o Exemplo de Ciclo como referência
  4. Configure backup automático - Veja seção "Backup Automatizado" acima

Recursos Adicionais​

Suporte​

Instalação concluída! 🎉

Seu Sistema Divino Alimento está instalado e pronto para configuração. Comece criando os cadastros básicos para operar seu primeiro ciclo de comercialização.