Árvore de páginas

Versões comparadas

Chave

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

Índice
outlinetrue

O objetivo deste guia é ajudar os desenvolvedores a entender a composição do projeto e como nos organizamos para desenvolver o TAF TSI. 
A documentação disponibilizada para os clientes consta em TSI - TAF Service Integration.

Configuração

A configuração para integração com o Sonarqube pode ser encontrada no arquivo sonar-project.properties, dentro da estrutura do projeto TAF-THF.

Execução

Os procedimentos abaixo devem ser executados após publicação de nova versão da aplicação. Existem duas alternativas, utilizando os artefatos gerados na própria publicação do projeto, ou manualmente, sincronizando o repositório do servidor em sua máquina local:

Utilizando artefatos da publicação

  •  Passo 1: Na sua plataforma de desenvolvimento, baixar/atualizar do repositório remoto a branch master do projeto TAF-THF.
  •  Passo 2: Substituir os arquivos da pasta coverage ( Imagem 1 ) em sua máquina local com os arquivos contidos em coverage.zip ( Imagem 2 ) gerado na expedição da última versão do projeto.
Informações

Imagem 1 - Diretório coverage, localizada ao mesmo nível que a pasta do projeto TAF-THF, e que deve ser atualizada com os arquivos do coverage.zip da última publicação.


Imagem 2 - Arquivo coverage.zip da última publicação, que deve ser utilizado para substituir os arquivos no diretório coverage da sua máquina local.

  •  Passo 3: Executar o analisador do projeto para coleta e envio das métricas ao Sonarqube ( npm run sonar ).
Informações

Caso esta operação seja realizada com sucesso, deve ser apresentado uma mensagem similar a imagem abaixo:

Consultando Dashboard TAF do Futuro é possível analisar os dados atuais do projeto.

Sincronizando repositório do servidor

  •  Passo 1: Na sua plataforma de desenvolvimento, baixar/atualizar do repositório remoto a branch master do projeto TAF-THF.
  •  Passo 2: Remover as dependências ( rm -r .\package-lock.json ) e a pasta node_modules ( rm -r .\node_modules\ ).
  •  Passo 3: Restaurar as dependências e a pasta node_modules ( npm i, npm i protheus-lib-core --registry https://npm.totvs.io, npm i angular-erp-integration --registry https://npm.totvs.io ), assim garantimos que nosso pacote local está atualizado de acordo com as dependências do repositório remoto.
  •  Passo 4: Executar os testes automatizados ( ng test ou ng test --source-map --code-coverage --no-watch ).
Informações

Após a execução dos testes, caso sejam bem sucedidos, a pasta coverage, localizada ao mesmo nível que a pasta do projeto TAF-THF, será atualizada com os arquivos de métricas.

  •  Passo 5: Executar o analisador do projeto para coleta e envio das métricas ao Sonarqube ( npm run sonar ).
Informações

Caso esta operação seja realizada com sucesso, deve ser apresentado uma mensagem similar a imagem abaixo:

Consultando Dashboard TAF do Futuro é possível analisar os dados atuais do projeto.