Calcular a medida `Team Throughput`

[herickport]

Descrição

Eu, como Valeria Desejo calcular o valor da medida Team Throughput Para eu poder quantificar uma percepção da subcaracterística completude funcional e sua respectiva característica, adequação funcional

Critérios de Aceite:

• [ ] Garantir que as métricas são validas e não nulas
• [ ] Garantir que os valores de referência estejam definidos
• [ ] O cálculo deve ser baseado na formula:

OBS:

• IF_7 representa a função de interpretação da medida em7 e iota, a função de interpolação linear da IF_7
• O procedimento de cálculo desta medida será semelhante ao da medida passed_tests
• O threshold será o mesmo da medida passed_tests (0, 1)

[hneri]

ajuste na escrita da história:

Eu, como Valeria Desejo calcular o valor da medida Team Throughput Para eu poder quantificar uma percepção da subcaracterística completude funcional e sua respectiva característica, adequação funcional @herickport @KiSobral

[hneri]

Essa história foi inicialmente definida em: https://github.com/fga-eps-mds/2022-1-MeasureSoftGram-Doc/issues/133#issuecomment-1193175995

[durvalcarvalho]

Questões

• Como iremos identificar as US que foram planejadas para a sprint que será coletado as métricas?

Opções

1. Forçar o usuário usar millestones como planejamento de sprints

Se o usuário planejar suas sprints usando millestones, o MSG poderá calcular o team throughput da millestone (abstração da sprint).

Para isso iremos receber o (nome OR ID) da millestone e iremos consultar na API.

• Iremos supor que a label das US são US ou iremos parametrizar a label de US usado pelo repositório?

Problemas:

• O usuário pode usar o millestone para outra coisa

2. Usar uma política de labels nas US que foram planejadas para essa sprint

O usuário terá que informar qual a label que ele tá usando para agrupar as US de determinada sprint. O MSG irá buscar por sprints

O MSG irá consultar na API do Git para obter a label do tipo "Sprint: " e irá supor que todas as US com a label com o maior são da sprint atual.

[herickport]

Foi conversado com o cliente e ficou decidido que a identificação das US planejadas para a release e, consequentemente, utilizadas no cálculo da medida Team Throughput, será feita utilizando a data de criação da issue.

[durvalcarvalho]

@herickport Enviar o formulário de aceitação para o @hneri

[herickport]

Roteiro de Teste no Core

Faça uma requisição para o endpoint /calculate-measures/ indicando o nome da medida e os valores das métricas necessárias.

Exemplo de JSON:

{
    "measures": [
        {
            "key": "team_throughput",
            "parameters": {
                "number_of_resolved_issues_with_US_label_in_the_last_x_days": 4,
                "total_number_of_issues_with_US_label_in_the_last_x_days": 7
            }
        }
    ]
}

Exemplo de requisição:

curl --location --request POST 'https://measuresoftgram-core.herokuapp.com/calculate-measures/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "measures": [
        {
            "key": "team_throughput",
            "parameters": {
                "number_of_resolved_issues_with_US_label_in_the_last_x_days": 4,
                "total_number_of_issues_with_US_label_in_the_last_x_days": 7
            }
        }
    ]
}'

A resposta esperada para essa requisição de exemplo é:

{
    "measures": [
        {
            "key": "team_throughput",
            "value": 0.5714285714285714
        }
    ]
}

Observações:

• Para garantir a validação dos critérios de aceite a função que que calcula a medida pode ser conferida em: Link
• A garantia de que as métricas são válidas e não nulas é feita com Schemas conferindo o corpo da requisição. O Schema da medida Team Throughput garante que os valores das métricas necessárias são inteiros e obrigatórios, ele pode ser conferido em: Link

[hneri]

Validado @herickport