Sistema Portuário

Projeto da disciplina de Engenharia de Software

Veja o sistema rodando:

Desenvolvimento

Estas são as etapas para executar o projeto:

Com o Docker

Pré-requisitos:

  1. Criar um arquivo de configurações. Use o de exemplo como base: cp backend/.env.sample backend/.env
  2. docker-compose up -d
  3. Acessar a documentação da API em http://localhost:8000/api/swagger/
    Usuário padrão: admin@example.com, 123

Manualmente

Pré-requisitos:

  • Python 3

Backend

  1. Entrar no diretório da aplicação de backend
    cd backend/sistema_portuario/
  2. Instalar o gerenciador de pacotes Poetry:
    pip install --user --pre poetry
  3. Adicionar o caminho de instalação local do pip à variável de ambiente PATH
    export PATH="$PATH:$HOME/.local/bin"
  4. Usar o Poetry para instalar as dependências Python do projeto:
    poetry install
  5. Criar um arquivo de configurações. Use o de exemplo como base:
    cp ../.env.sample ../.env
  6. Inicializar o banco de dados
    poetry run python manage.py migrate
  7. Carregar dados iniciais do banco (obrigatório)
    poetry run python manage.py loaddata essencial
  8. Gerar dados de exemplo (opcional)
    poetry run python manage.py popular_com_exemplos
  9. Executar a aplicação
    poetry run python manage.py runserver
  10. Acessar a documentação da API em http://localhost:8000/api/swagger/
    Usuário padrão: admin@example.com, 123

Frontend

  1. Entrar no diretório da aplicação de frontend
cd frontend/
  1. Instalar os pacotes node necessários
npm install
  1. Iniciar a aplicação
npm run serve

Testes

Rodar os testes do backend:

cd backend
PYTHONPATH=sistema_portuario poetry run pytest