Passo a passo

...

Clonar repositório GIT 

Image Modified

A estrutura do repositório está dividida nas seguintes pastas:

• APIs
  • Contém documentação OpenAPI 
• Schema
  • Contém os Schemas dos recursos utilizados por APIs e mensagem padronizada (/transactions)
• Transactions
  • Contém propriedades comuns para a definição de um schema como um recurso de mensagem padronizada

Buscar JsonSchema na pasta "Schemas"

Nesse momento, devemos procurar se os modelos que serão utilizados como recursos da API já existem.

...

• Se é uma mensagem padronizada sobre esse recurso que foi aprovada através de XSD, o mesmo teve o seu modelo automaticamente convertido para JsonSchema. 
• Se é um JsonSchema proposto que foi aprovado pelo comitê.

Image Added

Verificar se já existe alguma solicitação similar na lista de "Pull Requests"

Se não for possível encontrar o JsonSchema na pasta "Schemas", precisamos verificar se já existe um Pull Request existente para aquele schema ou API.

É possível utilizar o filtro baseado na descrição e labels (API, Schema).(GIF)

Image Added

Ao encontrar um Pull Request existente, entrar em contato com a equipe que o abriu para alinhar o desenvolvimento.

Se não encontrar, criar uma nova branch para a criação dos JSONs.

Criar branch 

...

(Atualizar GIF)

Padrão nomenclatura para branch que contenha API e Schema

ResourceName/ApiVersion/SchemaVersion 

API version é iniciada pela letra "V"

...

Exemplo: Parameters/V1/1_000

Padrão nomenclatura para branch que contenha apenas a API

ResourceName/ApiVersion

Exemplo: Parameters/V1

Padrão nomenclatura para branch que contenha apenas o eschema

ResourceName/SchemaVersion 

Exemplo: Parameters/1_000

Image Added

Add, Commit e Push

...

Abrir Pull Request

(GIF)

Padrão nomenclatura para Schema

(Definição)

Padrão nomenclatura para API

(Definição)

Padrão nomenclatura para mais de um tipo

O pull request deve ser aberto com o mesmo nome da branch. 

Selecionar os labels "API" e "Schema" se nesse pull request existiram alterações nas duas estruturas. Caso contrário, seleciono apenas aquele label que melhor descreve. 

A descrição é livre.

Image Added(Definição)

Comitê avalia e aprova mensagem

O comitê pode interagir com quem está propondo aqueles schemas e/ou APIs para discutir regras de negócio, e pedir ajustes antes da aprovação. 

Da mesma forma, a equipe TTALK interage sobre possíveis problemas na estrutura dos arquivos, padrões definidos e boas práticas, também pedindo ajustes antes da aprovação.

API Aprovada (merge com a Master)

Ao passar por essas duas etapas de aprovação (TTALK e comitê), os arquivos JSON são aprovados e é realizado um merge com a master.

...