DadosAbertosDeFeira / laia

Cadastre e acompanhe o status dos seus pedidos de informação 📃

Laiá

Cadastre e acompanhe o status dos seus pedidos de informação 📃✨

---

Configurando seu ambiente

Carregue as variáveis de ambiente

Para a aplicação funcionar, é necessário criarmos um arquivo .env, um arquivo de configuração que é individual por possuir dados sensíveis. Para configurar sua .env, busque pelo exemplo de configuração .env.example na raiz do projeto, faça uma cópia e deixe o arquivo com a extensão .env.

Para rodar o projeto Laiá, você pode instalar o Poetry, para conseguir instalar automaticamente todas as dependências do projeto.

A execução é feita com Docker e docker-compose.

Instale as dependências do projeto

poetry install

Utilizando docker-compose

docker-compose up --build

Para aplicar as migrations, execute:

make migrate

Outros atalhos podem ser vistos em nosso Makefile.

Rodando os testes

Você pode executar os testes no ambiente virtual criado pelo Poetry com pytest ou rodando make tests para executar os testes dentro do container.

Configure o pre-commit

Instale o pre-commit localmente rodando pre-commit install. Dessa forma, o código que você commitar já estará formatado, com os imports ordenados e mais arrumado.

Rode o shell do Poetry e inicie o ambiente virtual.

poetry shell

Crie um usuário para incluir seus pedidos

make createsuperuser

Aplique as migrations

make migrate

Rodando a aplicação

make run

Acesse localhost:8000.

Deploy

Atualmente estamos fazendo o deploy manual dessa aplicação. Para isso, precisamos fazer o pull do código e reiniciar a aplicação para que ela seja atualizada.

Para preparar o código para atualização é preciso que você:

• Atualize as dependências:

poetry export --without-hashes --format=requirements.txt > requirements.txt

• Atualize as variáveis de ambiente no .env do servidor

• Reinicie o serviço