Feature Flags

Este tópico descreve como funcionam as Feature Flags no nosso serviço e como tratar as exceções que elas podem causar.

O que são Feature Flags?

Feature Flags são ferramentas que permitem habilitar ou desabilitar funcionalidades de software dinamicamente, sem a necessidade de alterar o código ou reiniciar o serviço. Elas são utilizadas no nosso sistema para:

• Lançamento Contínuo: Implementar novas funcionalidades de forma gradual, reduzindo riscos.

• Hotfixes: Desativar rapidamente uma funcionalidade problemática sem a necessidade de parar todas as funções.

Como tratar exceções de Feature Flags?

Sempre que uma funcionalidade estiver desativada por uma Feature Flag, será retornada a seguinte resposta:

{
  "code": "FEATURE_FLAG_DISABLED",
  "message": "A funcionalidade \"Novo funcionário\" está atualmente indisponível devido a: \"Manutenção na lógica de funcionamento da funcionalidade\", tente acessar novamente mais tarde.",
  "status_code": 503,
  "timestamp": "2024-08-06T13:13:22.139Z",
  "path": "/api/v1/error-path",
  "handled": true,
  "errors": []
}

Recomendamos retornar o mesmo erro ao usuário final, já que ele contém detalhes sobre o motivo da indisponibilidade. No entanto, você pode personalizar a mensagem para melhor atender suas necessidades.

Note que o ErrorCode FEATURE_FLAG_DISABLED e o StatusCode 503 sempre serão os mesmos, facilitando a identificação e o tratamento dessa exceção.

Você pode obter mais informações sobre as manutenções e problemas que ocorrem no nosso serviço através da página status.pontodigital.me, onde todos os incidentes são explicados em detalhes.

---

Em caso de problemas ou dúvidas entre em contato com o [email protected].