Compatibilidade entre versões das aplicações

A compatibilidade entre as aplicações da Senior X requer atenção, pois pode haver diferenças entre as versões das APIs de backend e frontend.

Esta página apresenta como a compatibilidade funciona e como consultar as versões atuais de cada aplicação.

Versionamento semântico

O versionamento semântico segue a regra MAJOR.MINOR.PATCH-DESCR, onde:

• MAJOR: indica quebra de compatibilidades nas APIs existentes.
• MINOR: indica adição de novas funcionalidades sem quebra de compatibilidade.
• PATCH: correções de falhas mantendo as funcionalidades.
• DESCR: descrições adicionais sobre a liberação.

Frontend x Backend

Na Senior X o Frontend é considerado um componente separado do backend, ou seja, é autônomo. Entretanto, diferente do backend, um frontend que é comum entre os módulos não possui APIs, pois se trata de um consumidor. Portanto, para o Frontend utiliza-se o modelo semântico MAJOR.MINOR.PATCH, onde MINOR indica novas funcionalidades e o PATCH uma correção ou melhoria sem adição de funcionalidade. Contudo, a mudança no MAJOR ocorre apenas quando este Frontend precisa se comunicar com APIs de serviços que antes não eram necessárias e não fizeram parte de uma adição de funcionalidade. Ou seja, quando houver quebra de compatibilidade no Frontend em si.

Compatibilidade entre Frontend e BackEnd:

• Ambos são incompatíveis se a versão MAJOR é diferente.
• Ambos são incompatíveis se a versão MINOR do Frontend é maior que a do Backend.

Exemplo

Versão Frontend	Versão Backend	Compatível?
1.0.1	1.0.0	Sim
1.0.1	1.1.0	Sim
1.0.1	2.0.0	Não
2.0.1	1.1.0	Não

Consulta das versões de Frontend e Backend