Ir para o conteúdo principal

3) Estudo de Implantação do Pipe de Desenvolvimento

OBJETIVO

Definir arcabouço para implantação do monitoramento dos Pipes dos times de Desenvolvimento. Em conformidade ao documento de Integração com o Painel Gerencial da CODE

JUSTIFICATIVA

Após realização de diversas reuniões com gestão, os mesmos solicitaram que os dados gerados pelo fluxo de trabalho da SETIC-CODE dentro da ferramenta Pipefy fossem persistidos em  um banco de dados próprio, permitindo aos mesmos a criação de relatórios para a avaliação e tomada de decisões.

ENVOLVIDOS

  • Baymax (BI Team)

MAPEAMENTO

Após avaliação prévia, foi identificada a necessidade de mapear quais Pipes e Campos serão utilizados para atender a demanda. As informações estão descritas a seguir.

Pipes Mapeados

Pipes de Desenvolvimento

PIPE ID PIPE NAME PIPE URL
725642 Caveiras https://app.pipefy.com/pipes/725642
786310 Defensores https://app.pipefy.com/pipes/786310
451637 Guardiões https://app.pipefy.com/pipes/451637
451635 Vingadores https://app.pipefy.com/pipes/451635
877708 Esquadrão Suicída https://app.pipefy.com/pipes/877708
979418 Tambaqui https://app.pipefy.com/pipes/979418
961531 Baymax https://app.pipefy.com/pipes/961531
786390 Black Ops https://app.pipefy.com/pipes/786390
301411216 AC/DC https://app.pipefy.com/pipes/301411216

Pipes de Demandas

PIPE ID PIPE NAME PIPE URL
1158684 Demandas https://app.pipefy.com/pipes/1158684
1158790 Projetos https://app.pipefy.com/pipes/1158790
451374 Produtos https://app.pipefy.com/pipes/451374
735403 Dark Souls https://app.pipefy.com/pipes/735403
1083563 Amazonas https://app.pipefy.com/pipes/1083563
1263167 300 https://app.pipefy.com/pipes/1263167
Campos Mapeados

Pipes de Desenvolvimento

PROPRIEDADE TIME DE PARA
Sprint Caveiras field_20_connector  sprint
Defensores field_17_connector
Guardiões field_41_connector
Vingadores field_39_connector
Esquadrão Suicida field_10_connector
Tambaqui field_13_connector
Baymax field_11_connector
Black Ops field_13_connector
AC/DC field_15_connector
Produto Caveiras field_11_connector produto
Defensores field_3_connector
Guardiões field_31_connector
Vingadores field_28_connector
Esquadrão Suicida field_1_connector
Tambaqui field_5_connector
Baymax field_1_connector
Black Ops field_5_connector
AC/DC field_8_connector
Pontos de História de Usuário Caveiras field_6_number pontos
Defensores field_6_number
Guardiões field_8_number
Vingadores field_4_number
Esquadrão Suicida field_2_number
Tambaqui field_2_number
Baymax field_3_number
Black Ops field_4_number
AC/DC field_2_number
Tipo de Demanda Caveiras field_16_connector tipo
Defensores field_12_connector
Guardiões field_48_connector
Vingadores field_35_connector
Esquadrão Suicida field_6_connector
Tambaqui field_9_connector
Baymax field_7_connector
Black Ops field_11_connector
AC/DC field_13_connector
Release Caveiras field_17_connector release
Defensores field_13_connector
Guardiões field_46_connector
Vingadores field_36_connector
Esquadrão Suicida field_7_connector
Tambaqui field_10_connector
Baymax field_8_connector
Black Ops field_12_connector
AC/DC field_14_connector
Planejado na Sprint Caveiras field_10_string planejado
Defensores field_10_string
Guardiões field_36_string
Vingadores field_34_string
Esquadrão Suicida field_12_string
Tambaqui field_14_string
Baymax field_11_string
Black Ops field_8_string
AC/DC field_11_string
O quê? Caveiras field_2_string oque
Defensores field_2_string
Guardiões field_12_string
Vingadores field_5_string
Esquadrão Suicida field_2_string
Tambaqui field_2_string
Baymax field_1_string
Black Ops field_1_string
AC/DC field_2_string

 

Pipes de Desenvolvimento (Antigo)

Pontos de História (antigo) Caveiras field_5_number pontos_old
Defensores field_5_number
Guardiões field_6_number
Vingadores field_3_number
Esquadrão Suicida field_1_number
Tambaqui field_1_number
Baymax field_2_number
Black Ops field_3_number
AC/DC field_1_number
Necessidade (Antigo) Caveiras field_15_connector necessidade_old
Defensores field_7_connector
Guardiões field_34_connector
Vingadores field_34_connector
Esquadrão Suicida  
Tambaqui field_8_connector
Baymax field_5_connector
Black Ops field_4_connector
AC/DC field_9_connector
Projeto (Antigo) Caveiras field_14_connector projeto_old
Defensores field_5_connector
Guardiões field_33_connector
Vingadores field_33_connector
Esquadrão Suicida field_5_connector
Tambaqui field_7_connector
Baymax field_4_connector
Black Ops field_6_connector
AC/DC field_7_connector
Planejado na Sprint? (Antigo) Caveiras field_9_string planejado_old
Defensores field_10_string
Guardiões field_31_string
Vingadores field_30_string
Esquadrão Suicida field_9_string
Tambaqui field_10_string
Baymax field_9_string
Black Ops field_5_string
AC/DC field_7_string
Tipo de Demanda (label) (Antigo) Caveiras field_1_label_select atividade_old
Defensores field_1_label_select
Guardiões field_25_label_select
Vingadores field_20_label_select
Esquadrão Suicida field_1_label_select
Tambaqui field_1_label_select
Baymax field_1_label_select
Black Ops field_1_label_select
AC/DC field_1_label_select

CONSTRUÇÃO DA API

Conforme estudo anterior, os dados do Pipefy são obtidos a partir da utilização de consultas em GRAPHQL. Optamos por desenvolver uma API que atua como intermediária entre o GRAPHQL e nossos bancos de dados. 

O PAPIFY (PipeFY API) é uma solução em Python 3.8 + Flask + Simple GraphQL Cleinte (SGQLC) que a partir de determinadas consultas, retorna um JSON array contendo os cards de determinado Pipe com as defidas informações. Este Json array passa por processos de transformações utilizando ferramentas como o PENTAHO e é disponibilizado em nossa base de dados DashboardPipefy. Um exemplo de utilização da API segue a seguir.

Para o usuário que deseja retornar todos os cards do Pipe de Testes (ID 576534), o mesmo deverá realizar a seguinte consulta:

https://papify.master.local/allCards?pipeId=576534

A requisição acima aciona a aplicação PAPIFY, o comando allCards lista todos os cards de um determinado pipe, e o atributo pipeId, indica para a aplicação qual o pipe será consultado, nesse caso, o pipe Quer fazer Testes? FAÇA AQUI.

/ 20210324200618
// https://papify.master.local/allCards?pipeId=576534

[
  {
    "node": {
      "id": "413078163",
      "title": "Testando a API PAPIFY",
      "createdAt": "2021-03-24T20:05:50-04:00",
      "finished_at": null,
      "done": false,
      "current_phase": {
        "id": "310131251",
        "name": "Priorizar Reunião"
      },
      "labels": [
        
      ],
      "fields": [
        {
          "indexName": "field_24_string",
          "name": "Email do solicitante",
          "updated_at": "2021-03-24T20:05:51-04:00",
          "value": "pg@baymax.com",
          "report_value": "pg@baymax.com",
          "label_values": null
        },
        {
          "indexName": "field_2_datetime",
          "name": "Data e hora de fim",
          "updated_at": "2021-03-24T20:05:51-04:00",
          "value": "25/03/2021 00:00",
          "report_value": "25 de Março de 2021, 00:00",
          "label_values": null
        },
        {
          "indexName": "field_1_datetime",
          "name": "Data e hora de início",
          "updated_at": "2021-03-24T20:05:51-04:00",
          "value": "24/03/2021 00:00",
          "report_value": "24 de Março de 2021, 00:00",
          "label_values": null
        },
        {
          "indexName": "field_13_string",
          "name": "Por que?",
          "updated_at": "2021-03-24T20:05:51-04:00",
          "value": "para disponibilizar o resultado no spike.",
          "report_value": "para disponibilizar o resultado no spike.",
          "label_values": null
        },
        {
          "indexName": "field_12_string",
          "name": "O que?",
          "updated_at": "2021-03-24T20:05:51-04:00",
          "value": "Testando a API PAPIFY",
          "report_value": "Testando a API PAPIFY",
          "label_values": null
        }
      ]
    }
  },
  {
    "node": {
      "id": "404217766",
      "title": "Teste mover",
      "createdAt": "2021-01-28T08:55:23-04:00",
      "finished_at": null,
      "done": false,
      "current_phase": {
        "id": "310149812",
        "name": "Cancelada"
      },
      "labels": [
        
      ],
      "fields": [
        {
          "indexName": "field_24_string",
          "name": "Email do solicitante",
          "updated_at": "2021-01-28T08:55:23-04:00",
          "value": "gabrielf.oliveira97@gmail.com",
          "report_value": "gabrielf.oliveira97@gmail.com",
          "label_values": null
        },
        {
          "indexName": "field_2_datetime",
          "name": "Data e hora de fim",
          "updated_at": "2021-01-28T08:55:23-04:00",
          "value": "29/01/2021 02:30",
          "report_value": "29 de Janeiro de 2021, 02:30",
          "label_values": null
        },
        {
          "indexName": "field_1_datetime",
          "name": "Data e hora de início",
          "updated_at": "2021-01-28T08:55:23-04:00",
          "value": "29/01/2021 00:00",
          "report_value": "29 de Janeiro de 2021, 00:00",
          "label_values": null
        },
        {
          "indexName": "field_13_string",
          "name": "Por que?",
          "updated_at": "2021-01-28T08:55:23-04:00",
          "value": "Vendo se as integrações básicas do pipefy ajudam",
          "report_value": "Vendo se as integrações básicas do pipefy ajudam",
          "label_values": null
        },
        {
          "indexName": "field_12_string",
          "name": "O que?",
          "updated_at": "2021-01-28T08:55:23-04:00",
          "value": "Teste mover",
          "report_value": "Teste mover",
          "label_values": null
        }
      ]
    }
  }

No momento da requisição, o Pipe de Testes contava com os seguintes cards:

Screenshot_14.png

Ao comparar os dados de um card com o retorno da API, podemos observar que os dados foram obtidos corretamente:

papi.png

RESULTADOS

Diante do exposto, fica evidente a implantação do projeto nas seguintes etapas:

# ETAPA PREVISÃO CONCLUSÃO
1 Estudo de viabilização da implantação dos Pipes de Desenvolvimento 25/11/2020 17/11/2020
2 Disponibilização da consulta na API PAPIFY. 11/12/2020  
3 Persistência dos dados obtidos em um DataMart 29/03/2021  
4 Disponibilização do DataMart    
5 Ideação do DashBoard de Monitoramento    
6 Disponibilização do DashBoard de Monitoramento    

CONCLUSÃO

Diante do exposto, seguiremos com as demandas conforme identificado. Conforme avanço das etapas este documento será atualizado.