Sistema de Gestão de Processos Seletivos

Sistema web para gestão completa de processos seletivos públicos de colaboradores, abrangendo inscrições online, formulários dinâmicos, envio de documentação em PDF, distribuição para banca avaliadora, interposição de recursos e publicação de resultados.

Note

🌐 Documentação do Projeto: Esta documentação reúne o Guia de Início Rápido, Guia de Execução & Arquitetura, Guia de Contribuição e o Documento de Requisitos de Sistema (DRS).

📋 Conteúdo da Documentação

Sumário:

• Guia de Início Rápido
  • 📋 Requisitos Prévios
  • 🚀 Passos para Instalação e Execução
  • 🧪 Executando Testes Unitários
• ⚙️ Execução, Arquitetura e Deploy
  • 🏗️ Estrutura dos Serviços
  • 🔑 Variáveis de Ambiente
  • 🛠️ Utilitário de Linha de Comando (CLI prosel)
• 🔧 Guia de Desenvolvimento e Contribuição
  • 💻 Setup de Desenvolvimento Local
  • 🎨 Padrões de Código e Formatação
  • 🧪 Testes Automatizados
  • 👥 Fluxo de Contribuição Git
• Documento de Requisitos de Sistema (DRS)
  • Sistema de Gestão de Processos Seletivos
  • 1. Introdução
  • 2. Visão Geral do Sistema
  • 3. Requisitos de Negócio
  • 4. Requisitos Funcionais (RF)
  • 5. Requisitos Não Funcionais (RNF)
  • 6. Arquitetura do Software
  • 7. Auditoria e Rastreabilidade
  • 8. Considerações Finais

✨ Funcionalidades Principais

• 🔐 Autenticação Integrada: Login unificado via gov.br (OAuth2) e integração com o SUAP.

• 📋 Gestão de Processos Seletivos: Cadastro de editais, fases sequenciais (Inscrição, Fases Intermediárias e Resultado Final) e etapas personalizadas.

• 📝 Formulários Dinâmicos: Criação de formulários customizáveis por fase com validações de dados e armazenamento estruturado.

• 📄 Gestão de Documentos PDF: Envio de comprovantes em formato PDF com controle de obrigatoriedade e limite de tamanho (padrão 2 MB).

• ⚖️ Banca Avaliadora Flexível: Avaliação por múltiplos avaliadores com garantia de número ímpar (1, 3, 5, 7…), notas, checklists e pareceres.

• 📣 Resultados e Transparência: Divulgação pública resumida (nº de inscrição) e visão detalhada para o candidato autenticado.

• 💬 Módulo de Recursos: Formulário específico para interposição e resposta a recursos sobre os resultados parciais.

• 🛡️ Auditoria & Rastreabilidade: Trilha de auditoria detalhada armazenando usuário, data/hora e valores alterados em todas as operações críticas.

🏗️ Módulos da Aplicação

A aplicação Django está dividida nos seguintes aplicativos principais dentro de src/:

Módulo	Descrição
accounts	Gerenciamento de usuários, perfis (Candidato, Administrador, Coordenador, Avaliador) e CustomAnonymousUser.
processos	Estruturação de processos seletivos, fases, etapas e controle de prazos.
inscricoes	Submissão de inscrições, cancelamento, reinscrição e upload de PDFs.
formularios	Motor de formulários configuráveis e armazenamento de respostas.
avaliacoes	Distribuição de inscrições para a banca, notas, pareceres e critérios.
recursos	Gestão de recursos interpostos por candidatos e publicação de respostas.
resultados	Consolidação e publicação de resultados parciais e finais.
auditoria	Log centralizado de ações e eventos auditáveis.
tema	Componentes visuais e integração com o Design System Gov.BR e AdminLTE.

🚀 Início Rápido (Comandos CLI prosel)

Para iniciar rapidamente o ambiente de desenvolvimento via Docker:

# 1. Clonar repositório e configurar ambiente
git clone git@github.com:kelsoncm/processo-seletivo.git
cd processo-seletivo
cp .env.example .env

# 2. Subir os serviços com o utilitário prosel
./prosel deploy

# 3. Aplicar migrações e criar superusuário
./prosel migrate web
./prosel manage web createsuperuser

# 4. Executar os testes automatizados
./prosel test web

Acesse a aplicação em http://localhost:8000.

📝 Licença

Este projeto está licenciado sob a Licença MIT.

👥 Contato & Suporte

Kelson da Costa Medeiros

• Email: kelsoncm@gmail.com

• GitHub: @kelsoncm