[api] Criar o endpoint de registrar fase em uma oportunidade

[henriquelopeslima]

WHAT

Desenvolver um endpoint de API para cadastro de fases em uma oportunidade específica. Cada fase deve estar associada a uma oportunidade existente, mantendo essa relação como obrigatória.

Exemplo de rota: POST /opportunities/{id}/phases

DESCRIPTION

Este endpoint permitirá o cadastro de novas fases em uma oportunidade, com todas as validações necessárias para garantir integridade e coerência dos dados. Além disso, deverá ser acompanhado de testes e documentação para garantir que a funcionalidade esteja de acordo com os padrões do projeto.

ADDITIONAL INFO

1. Rota: Definir a rota do endpoint de cadastro de fases dentro de uma oportunidade.
2. Regras de Negócio:
   • As fases devem ser obrigatoriamente associadas a uma oportunidade válida e existente.
   • Validar as entradas do usuário, como dados obrigatórios e formato.
3. Validações:
   • Garantir que uma fase só possa ser cadastrada se houver uma oportunidade com o {id} fornecido.
4. Resposta de Sucesso: O endpoint deve retornar:
   • Status: 201 Created ao cadastrar com sucesso.
   • Corpo: Dados da fase registrada.

CHECKLIST

• [x] Definir a rota do endpoint: configurar o caminho para cadastro de fases em oportunidades.
• [x] Implementar a lógica de criação de fase: desenvolver a funcionalidade para armazenar as fases, respeitando as regras de negócio e validações definidas.
• [x] Implementar Testes Automatizados: para cobrir os casos de sucesso e erro.
• [x] Documentar o Endpoint: adicionar à documentação da API uma seção para o endpoint de criação de fases, com exemplos de requisição, resposta, e códigos de erro.