Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Índice

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 

Image Removed

(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

O pull request deve ser aberto com o mesmo nome da branch, e com os 

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

A descrição é livre.

Image Added(GIF)


Comitê avalia e aprova mensagem

...

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.

...