api-certify

Projeto de exemplo para o Desafio Técnico - Sistema de Gerenciamento de Voluntários.

Como usar (com Poetry)

1. Instale o Poetry (se necessário):

   curl -sSL https://install.python-poetry.org | python3 -

2. Instale dependências:

   poetry install

3. Para entrar no shell do poetry (opcional):

   poetry shell

4. Executar a aplicação:

   poetry run task run
   # ou
   poetry run uvicorn main:app --reload

5. Testes:

   poetry run task test

• Swagger UI: http://127.0.0.1:8000/docs
• ReDoc: http://127.0.0.1:8000/redoc

Endpoints

• POST /voluntarios - Cadastrar novo voluntário
• GET /voluntarios - Listar voluntários (com filtros)
• GET /voluntarios/{vol_id} - Buscar voluntário específico
• PUT /voluntarios/{vol_id} - Atualizar voluntário
• DELETE /voluntarios/{vol_id} - Excluir voluntário (soft delete)

Decisões técnicas

• Uso de Poetry para gerenciar dependências (obrigatório).
• Banco de dados fake (lista em memória) para facilitar correção.
• email é único (verificado em criação/atualização).
• soft delete implementado marcando status = "inativo" e deleted_at.
• Testes básicos com pytest incluídos.

Observações

• Para persistência real, substitua o arquivo app/db.py por conexões a um banco (SQLAlchemy, etc).