Guia de Início Rápido

Este guia apresenta os passos necessários para configurar e executar o Sistema de Gestão de Processos Seletivos em seu ambiente de desenvolvimento ou produção local.

📋 Requisitos Prévios

Antes de iniciar, certifique-se de ter instalado em sua máquina:

  • Docker (versão 20.10 ou superior)

  • Docker Compose (versão 2.0 ou superior)

  • Python (3.12+ / 3.14+)

  • Git

🚀 Passos para Instalação e Execução

1. Clonar o Repositório

Execute o comando abaixo para clonar o repositório em seu ambiente local:

git clone git@github.com:kelsoncm/processo-seletivo.git ~/projetos/PESSOAL/processo-seletivo
cd ~/projetos/PESSOAL/processo-seletivo

2. Configurar Arquivo de Ambiente (.env)

Copie o arquivo de exemplo e ajuste as variáveis de ambiente conforme necessário:

cp .env.example .env

3. Subir os Serviços com Docker Compose ou CLI prosel

Utilizando Docker Compose:

docker compose up --build -d

Ou utilizando a CLI inclusa no projeto (prosel):

./prosel deploy

4. Executar Migrações do Banco de Dados

Para aplicar as migrações no banco PostgreSQL:

./prosel migrate web

5. Criar Usuário Administrador

Para criar um superusuário no Django:

./prosel manage web createsuperuser

6. Coletar Arquivos Estáticos (Opcional em Dev)

./prosel collectstatic web

7. Acessar o Sistema

Após subir os serviços, acesse o sistema no navegador:

🧪 Executando Testes Unitários

Para rodar a suíte de testes com cobertura de código:

./prosel test web

Isso executará o coverage e gerará relatórios em terminal e em HTML.