Sistema Portuário

Projeto da disciplina de Engenharia de Software

Veja o sistema rodando:

• https://sistema-portuario-backend.herokuapp.com/ (Apenas o backend)

Desenvolvimento

Estas são as etapas para executar o projeto:

Com o Docker

Pré-requisitos:

• Docker
• Docker Compose

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/

2. Instalar os pacotes node necessários

npm install

3. Iniciar a aplicação

npm run serve

Testes

Rodar os testes do backend:

cd backend
PYTHONPATH=sistema_portuario poetry run pytest