Requisitos de software (teste)
8.1 Requisitos Funcionais — RFs
Os requisitos funcionais abaixo descrevem as capacidades que o sistema deve oferecer ao treinador e ao auxiliar, elicitadas a partir das reuniões de levantamento de requisitos com o cliente (Marcus Vinícius) e organizadas segundo as Características do Produto (CPs) definidas pela equipe:
- CP01 — Registro Categorizado dos Treinos
- CP02 — Estruturador de Periodização Esportiva
- CP03 — Dashboard Analítico
- CP04 — Geração Automática de Relatórios
- CP05 — Controle de Perfis de Acesso
Filtrar requisitos
Entrega
Situação
Iteração de desenvolvimento
Característica de produto
RF01 · Cadastrar macrocicloEntrega: MVPSituação: ConcluídoIteração: Iteração 07Produto: CP02
Declara??o RF: Cadastrar macrociclo: o sistema deve permitir que o treinador e o auxiliar cadastrem um novo macrociclo, informando campos como nome e data de início para organizar a periodização dos treinos.
Declaração US: Como membro da equipe t?cnica, eu quero Cadastrar macrociclo, para atender ao objetivo do requisito.
Critérios de Aceitação
- Interface Responsiva e Adaptável: A interface do sistema deve ser responsiva, adaptando o layout automaticamente de acordo com a resolução do dispositivo para não prejudicar a visualização dos gráficos na tela.
- Hierarquia e Integridade da Periodização: A estrutura esportiva organiza-se estritamente na árvore hierárquica:
Macrociclo (Temporada) ⊃ Mesociclo ⊃ Microciclo (Semana) ⊃ Sessão (Treino) ⊃ Atividades
Nenhum registro subordinado pode ser persistido sem vínculo obrigatório a um elemento pai válido. Não é permitido excluir elementos pais que possuam ciclos ou treinos associados sem validação prévia de integridade. - Dado que preencho um nome, data de início e data de fim, quando salvo, o sistema deve criar o ciclo raiz da temporada.
- Se os campos obrigatórios não forem preenchidos, o sistema deve exibir alerta e impedir o cadastro.
- Se a data de fim for antes da data da inicio, o sistema deve exibir alerta e impedir o cadastro.
Definition of Ready (DoR)
- [x] A estrutura da User Story está bem definida
- [x] A User Story está rastreável
- [x] A User Story está mensurável
- [x] A User Story foi prototipada
- [x] A User Story foi validada com o cliente
RF02 · Editar macrocicloEntrega: MVPSituação: ConcluídoIteração: Iteração 07Produto: CP02
Declara??o RF: Editar macrociclo: o sistema deve permitir que o treinador e o auxiliar editem os dados de um macrociclo anteriormente cadastrado.
Declaração US: Como membro da equipe t?cnica, eu quero Editar macrociclo, para atender ao objetivo do requisito.
Critérios de Aceitação
- Interface Responsiva e Adaptável: A interface do sistema deve ser responsiva, adaptando o layout automaticamente de acordo com a resolução do dispositivo para não prejudicar a visualização dos gráficos na tela.
- Hierarquia e Integridade da Periodização: A estrutura esportiva organiza-se estritamente na árvore hierárquica:
Macrociclo (Temporada) ⊃ Mesociclo ⊃ Microciclo (Semana) ⊃ Sessão (Treino) ⊃ Atividades
Nenhum registro subordinado pode ser persistido sem vínculo obrigatório a um elemento pai válido. Não é permitido excluir elementos pais que possuam ciclos ou treinos associados sem validação prévia de integridade. - Dado que seleciono um macrociclo existente, quando altero o nome, data de início ou data de fim e salvo, as modificações devem refletir na visualização da temporada.
- A edição das datas não deve quebrar a hierarquia dos ciclos filhos já vinculados nem permitir data de fim anterior à data de início.
Definition of Ready (DoR)
- [x] A estrutura da User Story está bem definida
- [x] A User Story está rastreável
- [x] A User Story está mensurável
- [x] A User Story foi prototipada
- [x] A User Story foi validada com o cliente
RF03 · Excluir macrocicloEntrega: Escopo AdicionalSituação: Não concluídoIteração: Não definidaProduto: CP02
Declara??o RF: Excluir macrociclo: o sistema deve permitir que o treinador e o auxiliar excluam um macrociclo cadastrado, removendo-o da estrutura de periodização.
Declaração US: Como membro da equipe t?cnica, eu quero Excluir macrociclo, para atender ao objetivo do requisito.
Critérios de Aceitação
- Interface Responsiva e Adaptável: A interface do sistema deve ser responsiva, adaptando o layout automaticamente de acordo com a resolução do dispositivo para não prejudicar a visualização dos gráficos na tela.
- Hierarquia e Integridade da Periodização: A estrutura esportiva organiza-se estritamente na árvore hierárquica:
Macrociclo (Temporada) ⊃ Mesociclo ⊃ Microciclo (Semana) ⊃ Sessão (Treino) ⊃ Atividades
Nenhum registro subordinado pode ser persistido sem vínculo obrigatório a um elemento pai válido. Não é permitido excluir elementos pais que possuam ciclos ou treinos associados sem validação prévia de integridade.
Definition of Ready (DoR)
- [ ] A estrutura da User Story está bem definida
- [ ] A User Story está rastreável
- [ ] A User Story está mensurável
- [ ] A User Story foi prototipada
- [ ] A User Story foi validada com o cliente
RF04 · Cadastrar mesocicloEntrega: MVPSituação: ConcluídoIteração: Iteração 07Produto: CP02
Declara??o RF: Cadastrar mesociclo: o sistema deve permitir que o treinador e o auxiliar cadastrem um novo mesociclo vinculado a um macrociclo existente, informando o nome do mesociclo.
Declaração US: Como membro da equipe t?cnica, eu quero Cadastrar mesociclo, para atender ao objetivo do requisito.
Critérios de Aceitação
- Interface Responsiva e Adaptável: A interface do sistema deve ser responsiva, adaptando o layout automaticamente de acordo com a resolução do dispositivo para não prejudicar a visualização dos gráficos na tela.
- Hierarquia e Integridade da Periodização: A estrutura esportiva organiza-se estritamente na árvore hierárquica:
Macrociclo (Temporada) ⊃ Mesociclo ⊃ Microciclo (Semana) ⊃ Sessão (Treino) ⊃ Atividades
Nenhum registro subordinado pode ser persistido sem vínculo obrigatório a um elemento pai válido. Não é permitido excluir elementos pais que possuam ciclos ou treinos associados sem validação prévia de integridade. - Dado que possuo um macrociclo ativo, quando preencho os dados do mesociclo (nome, data de início, data de término) e indico seu macrociclo pai, então ele deve ser salvo com sucesso.
- Se não houver macrociclo prévio selecionado ou ativo, o sistema deve exibir alerta e impedir o cadastro.
Definition of Ready (DoR)
- [x] A estrutura da User Story está bem definida
- [x] A User Story está rastreável
- [x] A User Story está mensurável
- [x] A User Story foi prototipada
- [x] A User Story foi validada com o cliente
RF05 · Editar mesocicloEntrega: MVPSituação: ConcluídoIteração: Iteração 07Produto: CP02
Declara??o RF: Editar mesociclo: o sistema deve permitir que o treinador e o auxiliar editem os dados de um mesociclo anteriormente cadastrado.
Declaração US: Como membro da equipe t?cnica, eu quero Editar mesociclo, para atender ao objetivo do requisito.
Critérios de Aceitação
- Interface Responsiva e Adaptável: A interface do sistema deve ser responsiva, adaptando o layout automaticamente de acordo com a resolução do dispositivo para não prejudicar a visualização dos gráficos na tela.
- Hierarquia e Integridade da Periodização: A estrutura esportiva organiza-se estritamente na árvore hierárquica:
Macrociclo (Temporada) ⊃ Mesociclo ⊃ Microciclo (Semana) ⊃ Sessão (Treino) ⊃ Atividades
Nenhum registro subordinado pode ser persistido sem vínculo obrigatório a um elemento pai válido. Não é permitido excluir elementos pais que possuam ciclos ou treinos associados sem validação prévia de integridade. - Ao alterar o nome, data de início, data de fim de um mesociclo, o sistema deve aplicar a atualização mantendo sua posição e vínculos intactos na árvore da periodização.
- A edição não pode desvincular o mesociclo do seu macrociclo pai.
Definition of Ready (DoR)
- [x] A estrutura da User Story está bem definida
- [x] A User Story está rastreável
- [x] A User Story está mensurável
- [x] A User Story foi prototipada
- [x] A User Story foi validada com o cliente
RF06 · Excluir mesocicloEntrega: Escopo AdicionalSituação: Não concluídoIteração: Não definidaProduto: CP02
Declara??o RF: Excluir mesociclo: o sistema deve permitir que o treinador e o auxiliar excluam um mesociclo cadastrado.
Declaração US: Como membro da equipe t?cnica, eu quero Excluir mesociclo, para atender ao objetivo do requisito.
Critérios de Aceitação
- Interface Responsiva e Adaptável: A interface do sistema deve ser responsiva, adaptando o layout automaticamente de acordo com a resolução do dispositivo para não prejudicar a visualização dos gráficos na tela.
- Hierarquia e Integridade da Periodização: A estrutura esportiva organiza-se estritamente na árvore hierárquica:
Macrociclo (Temporada) ⊃ Mesociclo ⊃ Microciclo (Semana) ⊃ Sessão (Treino) ⊃ Atividades
Nenhum registro subordinado pode ser persistido sem vínculo obrigatório a um elemento pai válido. Não é permitido excluir elementos pais que possuam ciclos ou treinos associados sem validação prévia de integridade.
Definition of Ready (DoR)
- [ ] A estrutura da User Story está bem definida
- [ ] A User Story está rastreável
- [ ] A User Story está mensurável
- [ ] A User Story foi prototipada
- [ ] A User Story foi validada com o cliente
RF07 · Cadastrar microcicloEntrega: MVPSituação: ConcluídoIteração: Iteração 07Produto: CP02
Declara??o RF: Cadastrar microciclo: o sistema deve permitir que o treinador e o auxiliar cadastrem um novo microciclo vinculado a um mesociclo existente, informando o nome do microciclo.
Declaração US: Como membro da equipe t?cnica, eu quero Cadastrar microciclo, para atender ao objetivo do requisito.
Critérios de Aceitação
- Interface Responsiva e Adaptável: A interface do sistema deve ser responsiva, adaptando o layout automaticamente de acordo com a resolução do dispositivo para não prejudicar a visualização dos gráficos na tela.
- Hierarquia e Integridade da Periodização: A estrutura esportiva organiza-se estritamente na árvore hierárquica:
Macrociclo (Temporada) ⊃ Mesociclo ⊃ Microciclo (Semana) ⊃ Sessão (Treino) ⊃ Atividades
Nenhum registro subordinado pode ser persistido sem vínculo obrigatório a um elemento pai válido. Não é permitido excluir elementos pais que possuam ciclos ou treinos associados sem validação prévia de integridade. - Dado que existe um mesociclo ativo, quando informo o nome, data de início e data de fim do microciclo e salvo, o registro deve ser efetuado na árvore de periodização.
- Se não houver mesociclo prévio selecionado, o sistema deve exibir alerta e impedir o cadastro.
- Se os campos nome, data de início e data de fim não forem preenchidos, o sistema deve exibir alerta e impedir o cadastro.
Definition of Ready (DoR)
- [x] A estrutura da User Story está bem definida
- [x] A User Story está rastreável
- [x] A User Story está mensurável
- [x] A User Story foi prototipada
- [x] A User Story foi validada com o cliente
RF08 · Editar microcicloEntrega: MVPSituação: ConcluídoIteração: Iteração 07Produto: CP02
Declara??o RF: Editar microciclo: o sistema deve permitir que o treinador e o auxiliar editem os dados de um microciclo anteriormente cadastrado.
Declaração US: Como membro da equipe t?cnica, eu quero Editar microciclo, para atender ao objetivo do requisito.
Critérios de Aceitação
- Interface Responsiva e Adaptável: A interface do sistema deve ser responsiva, adaptando o layout automaticamente de acordo com a resolução do dispositivo para não prejudicar a visualização dos gráficos na tela.
- Hierarquia e Integridade da Periodização: A estrutura esportiva organiza-se estritamente na árvore hierárquica:
Macrociclo (Temporada) ⊃ Mesociclo ⊃ Microciclo (Semana) ⊃ Sessão (Treino) ⊃ Atividades
Nenhum registro subordinado pode ser persistido sem vínculo obrigatório a um elemento pai válido. Não é permitido excluir elementos pais que possuam ciclos ou treinos associados sem validação prévia de integridade. - Dado que altero as informações de um microciclo salvo, o sistema deve atualizar os dados de exibição sem desconectar as sessões de treino atreladas a ele.
Definition of Ready (DoR)
- [x] A estrutura da User Story está bem definida
- [x] A User Story está rastreável
- [x] A User Story está mensurável
- [x] A User Story foi prototipada
- [x] A User Story foi validada com o cliente
RF09 · Excluir microcicloEntrega: Escopo AdicionalSituação: Não concluídoIteração: Não definidaProduto: CP02
Declara??o RF: Excluir microciclo: o sistema deve permitir que o treinador e o auxiliar excluam um microciclo cadastrado.
Declaração US: Como membro da equipe t?cnica, eu quero Excluir microciclo, para atender ao objetivo do requisito.
Critérios de Aceitação
- Interface Responsiva e Adaptável: A interface do sistema deve ser responsiva, adaptando o layout automaticamente de acordo com a resolução do dispositivo para não prejudicar a visualização dos gráficos na tela.
- Hierarquia e Integridade da Periodização: A estrutura esportiva organiza-se estritamente na árvore hierárquica:
Macrociclo (Temporada) ⊃ Mesociclo ⊃ Microciclo (Semana) ⊃ Sessão (Treino) ⊃ Atividades
Nenhum registro subordinado pode ser persistido sem vínculo obrigatório a um elemento pai válido. Não é permitido excluir elementos pais que possuam ciclos ou treinos associados sem validação prévia de integridade.
Definition of Ready (DoR)
- [ ] A estrutura da User Story está bem definida
- [ ] A User Story está rastreável
- [ ] A User Story está mensurável
- [ ] A User Story foi prototipada
- [ ] A User Story foi validada com o cliente
RF10 · Cadastrar comportamentoEntrega: MVPSituação: ConcluídoIteração: Iteração 08Produto: CP01
Declara??o RF: Cadastrar comportamento: o sistema deve permitir que o treinador e o auxiliar cadastrem um comportamento tático (ex: ofensivo, defensivo), para uso nas atividades.
Declaração US: Como membro da equipe t?cnica, eu quero Cadastrar comportamento, para atender ao objetivo do requisito.
Critérios de Aceitação
- Interface Responsiva e Adaptável: A interface do sistema deve ser responsiva, adaptando o layout automaticamente de acordo com a resolução do dispositivo para não prejudicar a visualização dos gráficos na tela.
- Preenchimento Condicional pelo Objetivo Central: O preenchimento dos campos de momento do jogo, fase do jogo, comportamento tático e atributo técnico é opcional por atividade. O preenchimento deve ser restrito ao foco do exercício (ex.: se o objetivo principal for tático de reação pós-perda, o fundamento de passe não deve ser marcado como atributo técnico, evitando distorções nos indicadores de desenvolvimento técnico individual).
- Ao inserir um nome de comportamento, ele deve ser salvo e disponibilizado nas listas de seleção (dropdowns táticos) durante o cadastro de atividades.
- O sistema não deve permitir o cadastro de comportamentos com o exato mesmo nome (duplicidade).
Definition of Ready (DoR)
- [x] A estrutura da User Story está bem definida
- [x] A User Story está rastreável
- [x] A User Story está mensurável
- [x] A User Story foi prototipada
- [x] A User Story foi validada com o cliente
RF11 · Editar comportamentoEntrega: MVPSituação: ConcluídoIteração: Iteração 08Produto: CP01
Declara??o RF: Editar comportamento: o sistema deve permitir que o treinador e o auxiliar editem um comportamento tático já cadastrado.
Declaração US: Como membro da equipe t?cnica, eu quero Editar comportamento, para atender ao objetivo do requisito.
Critérios de Aceitação
- Interface Responsiva e Adaptável: A interface do sistema deve ser responsiva, adaptando o layout automaticamente de acordo com a resolução do dispositivo para não prejudicar a visualização dos gráficos na tela.
- Preenchimento Condicional pelo Objetivo Central: O preenchimento dos campos de momento do jogo, fase do jogo, comportamento tático e atributo técnico é opcional por atividade. O preenchimento deve ser restrito ao foco do exercício (ex.: se o objetivo principal for tático de reação pós-perda, o fundamento de passe não deve ser marcado como atributo técnico, evitando distorções nos indicadores de desenvolvimento técnico individual).
- Ao corrigir o nome do comportamento tático no catálogo, as atividades já salvas que o utilizam devem exibir o nome atualizado automaticamente.
Definition of Ready (DoR)
- [x] A estrutura da User Story está bem definida
- [x] A User Story está rastreável
- [x] A User Story está mensurável
- [x] A User Story foi prototipada
- [x] A User Story foi validada com o cliente
RF12 · Excluir comportamentoEntrega: Escopo AdicionalSituação: Não concluídoIteração: Não definidaProduto: CP01
Declara??o RF: Excluir comportamento: o sistema deve permitir que o treinador e o auxiliar excluam um comportamento tático cadastrado.
Declaração US: Como membro da equipe t?cnica, eu quero Excluir comportamento, para atender ao objetivo do requisito.
Critérios de Aceitação
- Interface Responsiva e Adaptável: A interface do sistema deve ser responsiva, adaptando o layout automaticamente de acordo com a resolução do dispositivo para não prejudicar a visualização dos gráficos na tela.
Definition of Ready (DoR)
- [ ] A estrutura da User Story está bem definida
- [ ] A User Story está rastreável
- [ ] A User Story está mensurável
- [ ] A User Story foi prototipada
- [ ] A User Story foi validada com o cliente
RF13 · Cadastrar atividade na sessãoEntrega: MVPSituação: ConcluídoIteração: Iteração 08Produto: CP01
Declara??o RF: Cadastrar atividade na sessão: o sistema deve permitir que o treinador e o auxiliar cadastrem uma nova atividade diretamente em uma sessão, sem necessidade de ela já existir na biblioteca, informando seus dados invariáveis (tipologia e tipo de SSP) e, de forma opcional, o espaço, a orientação, o comportamento, e o momento e fase do jogo trabalhados.
Declaração US: Como membro da equipe t?cnica, eu quero Cadastrar atividade na sessão, para atender ao objetivo do requisito.
Critérios de Aceitação
- Interface Responsiva e Adaptável: A interface do sistema deve ser responsiva, adaptando o layout automaticamente de acordo com a resolução do dispositivo para não prejudicar a visualização dos gráficos na tela.
- Eficiência no Cadastro de Treinos: O sistema deve possuir fluxos de tela com tempo máximo de preenchimento dos dados inferior ao tempo atual de 4 minutos e meio para o preenchimento dos dados. Como objetivo, o sistema deve garantir que o processo de registro de um novo treino seja concluído pelo treinador em menos de 2 minutos.
- Cálculo da Área por Jogador: A área por jogador em metros quadrados é calculada pela fórmula:
Área (m²/jogador) = (Comprimento × Largura) ÷ Nº de Jogadores
Obrigatório para atividades com orientação de Aquisição, Aplicação e Equilíbrio de Carga. Dispensado para atividades de PDI (Proposta de Desenvolvimento Individual), nas quais comprimento, largura e jogadores são opcionais. - Classificação Automática da Dimensão do Espaço: A dimensão do espaço não é digitada pelo usuário, sendo classificada automaticamente pelo sistema a partir do resultado da cálculo da área por jogador:
• ≤ 100 m²: Espaço Reduzido (Pequeno)
• 101 a 200 m²: Espaço Médio
• > 200 m²: Espaço Amplo (Grande)
• Sem dimensões delimitadas (ex.: PDI): Não Definido - Simultaneidade e Contagem de Tempo da Sessão: Atividades cadastradas com o mesmo número no campo ordem dentro de uma sessão (ex.: duas atividades com Ordem = 1) ocorrem de forma simultânea (elenco dividido em subgrupos). No cálculo da duração líquida da sessão, o tempo de atividades simultâneas é contabilizado uma única vez (ex.: duas atividades de 20 minutos com mesma ordem somam 20 minutos à sessão, e não 40). No contador de execuções, o par (Sessão + Ordem) conta como 1 execução.
- Preenchimento Condicional pelo Objetivo Central: O preenchimento dos campos de momento do jogo, fase do jogo, comportamento tático e atributo técnico é opcional por atividade. O preenchimento deve ser restrito ao foco do exercício (ex.: se o objetivo principal for tático de reação pós-perda, o fundamento de passe não deve ser marcado como atributo técnico, evitando distorções nos indicadores de desenvolvimento técnico individual).
- O sistema deve calcular automaticamente a Área (m²/jogador) ao inserir dimensões (Comprimento e Largura) e o Número de Jogadores.
- O sistema deve classificar automaticamente a dimensão do espaço no ato do cadastro com base na área calculada.
- Atividades salvas com o mesmo número de "ordem" devem ser agrupadas e tratadas como eventos simultâneos na exibição.
- Os campos relacionados aos momentos do jogo, fases do jogo, princípios táticos e atributos técnicos devem permitir salvamento vazios (opcionais).
Definition of Ready (DoR)
- [x] A estrutura da User Story está bem definida
- [x] A User Story está rastreável
- [x] A User Story está mensurável
- [x] A User Story foi prototipada
- [x] A User Story foi validada com o cliente
RF14 · Editar atividade na sessãoEntrega: MVPSituação: Não concluídoIteração: Iteração 09Produto: CP01
Declara??o RF: Editar atividade na sessão: o sistema deve permitir que o treinador e o auxiliar editem os dados de uma atividade incluída em uma sessão, sem alterar a atividade correspondente na biblioteca.
Declaração US: Como membro da equipe t?cnica, eu quero Editar atividade na sessão, para atender ao objetivo do requisito.
Critérios de Aceitação
- Interface Responsiva e Adaptável: A interface do sistema deve ser responsiva, adaptando o layout automaticamente de acordo com a resolução do dispositivo para não prejudicar a visualização dos gráficos na tela.
- Cálculo da Área por Jogador: A área por jogador em metros quadrados é calculada pela fórmula:
Área (m²/jogador) = (Comprimento × Largura) ÷ Nº de Jogadores
Obrigatório para atividades com orientação de Aquisição, Aplicação e Equilíbrio de Carga. Dispensado para atividades de PDI (Proposta de Desenvolvimento Individual), nas quais comprimento, largura e jogadores são opcionais. - Classificação Automática da Dimensão do Espaço: A dimensão do espaço não é digitada pelo usuário, sendo classificada automaticamente pelo sistema a partir do resultado da cálculo da área por jogador:
• ≤ 100 m²: Espaço Reduzido (Pequeno)
• 101 a 200 m²: Espaço Médio
• > 200 m²: Espaço Amplo (Grande)
• Sem dimensões delimitadas (ex.: PDI): Não Definido - Simultaneidade e Contagem de Tempo da Sessão: Atividades cadastradas com o mesmo número no campo ordem dentro de uma sessão (ex.: duas atividades com Ordem = 1) ocorrem de forma simultânea (elenco dividido em subgrupos). No cálculo da duração líquida da sessão, o tempo de atividades simultâneas é contabilizado uma única vez (ex.: duas atividades de 20 minutos com mesma ordem somam 20 minutos à sessão, e não 40). No contador de execuções, o par (Sessão + Ordem) conta como 1 execução.
- Preenchimento Condicional pelo Objetivo Central: O preenchimento dos campos de momento do jogo, fase do jogo, comportamento tático e atributo técnico é opcional por atividade. O preenchimento deve ser restrito ao foco do exercício (ex.: se o objetivo principal for tático de reação pós-perda, o fundamento de passe não deve ser marcado como atributo técnico, evitando distorções nos indicadores de desenvolvimento técnico individual).
- Ao alterar as dimensões do campo ou o número de jogadores, o sistema deve recalcular instantaneamente a área por jogador e atualizar a classificação do espaço.
- Ao alterar o campo "ordem" da atividade, a interface e o banco devem reagrupar ou separar as atividades simultâneas afetando o tempo total.
Definition of Ready (DoR)
- [ ] A estrutura da User Story está bem definida
- [ ] A User Story está rastreável
- [ ] A User Story está mensurável
- [ ] A User Story foi prototipada
- [ ] A User Story foi validada com o cliente
RF15 · Excluir atividade na sessãoEntrega: Escopo AdicionalSituação: Não concluídoIteração: Não definidaProduto: CP01
Declara??o RF: Excluir atividade na sessão: o sistema deve permitir que o treinador e o auxiliar excluam uma atividade de uma sessão, sem afetar o registro dela na biblioteca.
Declaração US: Como membro da equipe t?cnica, eu quero Excluir atividade na sessão, para atender ao objetivo do requisito.
Critérios de Aceitação
- Interface Responsiva e Adaptável: A interface do sistema deve ser responsiva, adaptando o layout automaticamente de acordo com a resolução do dispositivo para não prejudicar a visualização dos gráficos na tela.
Definition of Ready (DoR)
- [ ] A estrutura da User Story está bem definida
- [ ] A User Story está rastreável
- [ ] A User Story está mensurável
- [ ] A User Story foi prototipada
- [ ] A User Story foi validada com o cliente
RF16 · Cadastrar sessãoEntrega: MVPSituação: ConcluídoIteração: Iteração 08Produto: CP01
Declara??o RF: Cadastrar sessão: o sistema deve permitir que o treinador e o auxiliar cadastrem uma nova sessão de treino vinculada à periodização (macrociclo, mesociclo e microciclo), contendo a data e o número sequencial da sessão.
Declaração US: Como membro da equipe t?cnica, eu quero Cadastrar sessão, para atender ao objetivo do requisito.
Critérios de Aceitação
- Interface Responsiva e Adaptável: A interface do sistema deve ser responsiva, adaptando o layout automaticamente de acordo com a resolução do dispositivo para não prejudicar a visualização dos gráficos na tela.
- Eficiência no Cadastro de Treinos: O sistema deve possuir fluxos de tela com tempo máximo de preenchimento dos dados inferior ao tempo atual de 4 minutos e meio para o preenchimento dos dados. Como objetivo, o sistema deve garantir que o processo de registro de um novo treino seja concluído pelo treinador em menos de 2 minutos.
- Atualização em Tempo Real do Dashboard: Os gráficos e indicadores do dashboard devem ser recalculados e atualizados na interface do usuário em um tempo máximo de 5 segundos após a confirmação de sucesso no cadastro, edição ou exclusão de um treino.
- Simultaneidade e Contagem de Tempo da Sessão: Atividades cadastradas com o mesmo número no campo ordem dentro de uma sessão (ex.: duas atividades com Ordem = 1) ocorrem de forma simultânea (elenco dividido em subgrupos). No cálculo da duração líquida da sessão, o tempo de atividades simultâneas é contabilizado uma única vez (ex.: duas atividades de 20 minutos com mesma ordem somam 20 minutos à sessão, e não 40). No contador de execuções, o par (Sessão + Ordem) conta como 1 execução.
- Hierarquia e Integridade da Periodização: A estrutura esportiva organiza-se estritamente na árvore hierárquica:
Macrociclo (Temporada) ⊃ Mesociclo ⊃ Microciclo (Semana) ⊃ Sessão (Treino) ⊃ Atividades
Nenhum registro subordinado pode ser persistido sem vínculo obrigatório a um elemento pai válido. Não é permitido excluir elementos pais que possuam ciclos ou treinos associados sem validação prévia de integridade. - O sistema só deve salvar o cadastro da sessão se ela estiver corretamente vinculada a um microciclo válido.
- O tempo líquido total da sessão deve ser calculado automaticamente pelo somatório da duração das atividades inseridas nela.
- Se a sessão possuir atividades marcadas com o mesmo número de ordem, a duração da maior atividade assumirá o bloco de tempo, sem duplicar a contagem.
Definition of Ready (DoR)
- [x] A estrutura da User Story está bem definida
- [x] A User Story está rastreável
- [x] A User Story está mensurável
- [x] A User Story foi prototipada
- [x] A User Story foi validada com o cliente
RF17 · Editar sessãoEntrega: MVPSituação: ConcluídoIteração: Iteração 08Produto: CP01
Declara??o RF: Editar sessão: o sistema deve permitir que o treinador e o auxiliar editem os dados de uma sessão de treino já cadastrada.
Declaração US: Como membro da equipe t?cnica, eu quero Editar sessão, para atender ao objetivo do requisito.
Critérios de Aceitação
- Interface Responsiva e Adaptável: A interface do sistema deve ser responsiva, adaptando o layout automaticamente de acordo com a resolução do dispositivo para não prejudicar a visualização dos gráficos na tela.
- Atualização em Tempo Real do Dashboard: Os gráficos e indicadores do dashboard devem ser recalculados e atualizados na interface do usuário em um tempo máximo de 5 segundos após a confirmação de sucesso no cadastro, edição ou exclusão de um treino.
- Simultaneidade e Contagem de Tempo da Sessão: Atividades cadastradas com o mesmo número no campo ordem dentro de uma sessão (ex.: duas atividades com Ordem = 1) ocorrem de forma simultânea (elenco dividido em subgrupos). No cálculo da duração líquida da sessão, o tempo de atividades simultâneas é contabilizado uma única vez (ex.: duas atividades de 20 minutos com mesma ordem somam 20 minutos à sessão, e não 40). No contador de execuções, o par (Sessão + Ordem) conta como 1 execução.
- Hierarquia e Integridade da Periodização: A estrutura esportiva organiza-se estritamente na árvore hierárquica:
Macrociclo (Temporada) ⊃ Mesociclo ⊃ Microciclo (Semana) ⊃ Sessão (Treino) ⊃ Atividades
Nenhum registro subordinado pode ser persistido sem vínculo obrigatório a um elemento pai válido. Não é permitido excluir elementos pais que possuam ciclos ou treinos associados sem validação prévia de integridade. - A alteração de data, nome, mês deve salvar com sucesso e refletir imediatamente nos gráficos que agrupam esses dados.
- Alterar ou remover atividades dentro desta edição deve disparar o recálculo imediato do tempo total da sessão.
Definition of Ready (DoR)
- [x] A estrutura da User Story está bem definida
- [x] A User Story está rastreável
- [x] A User Story está mensurável
- [x] A User Story foi prototipada
- [x] A User Story foi validada com o cliente
RF18 · Excluir sessãoEntrega: Escopo AdicionalSituação: Não concluídoIteração: Não definidaProduto: CP01
Declara??o RF: Excluir sessão: o sistema deve permitir que o treinador e o auxiliar excluam uma sessão de treino cadastrada.
Declaração US: Como membro da equipe t?cnica, eu quero Excluir sessão, para atender ao objetivo do requisito.
Critérios de Aceitação
- Interface Responsiva e Adaptável: A interface do sistema deve ser responsiva, adaptando o layout automaticamente de acordo com a resolução do dispositivo para não prejudicar a visualização dos gráficos na tela.
- Atualização em Tempo Real do Dashboard: Os gráficos e indicadores do dashboard devem ser recalculados e atualizados na interface do usuário em um tempo máximo de 5 segundos após a confirmação de sucesso no cadastro, edição ou exclusão de um treino.
- Hierarquia e Integridade da Periodização: A estrutura esportiva organiza-se estritamente na árvore hierárquica:
Macrociclo (Temporada) ⊃ Mesociclo ⊃ Microciclo (Semana) ⊃ Sessão (Treino) ⊃ Atividades
Nenhum registro subordinado pode ser persistido sem vínculo obrigatório a um elemento pai válido. Não é permitido excluir elementos pais que possuam ciclos ou treinos associados sem validação prévia de integridade.
Definition of Ready (DoR)
- [ ] A estrutura da User Story está bem definida
- [ ] A User Story está rastreável
- [ ] A User Story está mensurável
- [ ] A User Story foi prototipada
- [ ] A User Story foi validada com o cliente
RF19 · Cadastrar atividade na bibliotecaEntrega: MVPSituação: ConcluídoIteração: Iteração 08Produto: CP01
Declara??o RF: Cadastrar atividade na biblioteca: o sistema deve permitir que o treinador e o auxiliar cadastrem uma atividade na biblioteca de treinos, independentemente do cadastro em uma sessão específica, para que ela fique disponível para reutilização futura, informando seus dados invariáveis (tipologia e tipo de SSP) e, de forma opcional, o espaço, a orientação, o comportamento, e o momento e fase do jogo trabalhados.
Declaração US: Como membro da equipe t?cnica, eu quero Cadastrar atividade na biblioteca, para atender ao objetivo do requisito.
Critérios de Aceitação
- Interface Responsiva e Adaptável: A interface do sistema deve ser responsiva, adaptando o layout automaticamente de acordo com a resolução do dispositivo para não prejudicar a visualização dos gráficos na tela.
- Cálculo da Área por Jogador: A área por jogador em metros quadrados é calculada pela fórmula:
Área (m²/jogador) = (Comprimento × Largura) ÷ Nº de Jogadores
Obrigatório para atividades com orientação de Aquisição, Aplicação e Equilíbrio de Carga. Dispensado para atividades de PDI (Proposta de Desenvolvimento Individual), nas quais comprimento, largura e jogadores são opcionais. - Classificação Automática da Dimensão do Espaço: A dimensão do espaço não é digitada pelo usuário, sendo classificada automaticamente pelo sistema a partir do resultado da cálculo da área por jogador:
• ≤ 100 m²: Espaço Reduzido (Pequeno)
• 101 a 200 m²: Espaço Médio
• > 200 m²: Espaço Amplo (Grande)
• Sem dimensões delimitadas (ex.: PDI): Não Definido - Preenchimento Condicional pelo Objetivo Central: O preenchimento dos campos de momento do jogo, fase do jogo, comportamento tático e atributo técnico é opcional por atividade. O preenchimento deve ser restrito ao foco do exercício (ex.: se o objetivo principal for tático de reação pós-perda, o fundamento de passe não deve ser marcado como atributo técnico, evitando distorções nos indicadores de desenvolvimento técnico individual).
- Ao preencher os dados de uma nova atividade na área "Biblioteca", o sistema deve aplicar o cálculo automático de área e classificar a dimensão, salvando de forma independente no catálogo.
- A atividade pode ser salva mantendo campos de momento de jogo, atributos técnicos, princípios táticos, fases de jogo totalmente em branco (opcionais).
Definition of Ready (DoR)
- [x] A estrutura da User Story está bem definida
- [x] A User Story está rastreável
- [x] A User Story está mensurável
- [x] A User Story foi prototipada
- [x] A User Story foi validada com o cliente
RF20 · Editar atividade na bibliotecaEntrega: MVPSituação: ConcluídoIteração: Iteração 08Produto: CP01
Declara??o RF: Editar atividade na biblioteca: o sistema deve permitir que o treinador e o auxiliar editem uma atividade cadastrada na biblioteca de treinos.
Declaração US: Como membro da equipe t?cnica, eu quero Editar atividade na biblioteca, para atender ao objetivo do requisito.
Critérios de Aceitação
- Interface Responsiva e Adaptável: A interface do sistema deve ser responsiva, adaptando o layout automaticamente de acordo com a resolução do dispositivo para não prejudicar a visualização dos gráficos na tela.
- Cálculo da Área por Jogador: A área por jogador em metros quadrados é calculada pela fórmula:
Área (m²/jogador) = (Comprimento × Largura) ÷ Nº de Jogadores
Obrigatório para atividades com orientação de Aquisição, Aplicação e Equilíbrio de Carga. Dispensado para atividades de PDI (Proposta de Desenvolvimento Individual), nas quais comprimento, largura e jogadores são opcionais. - Classificação Automática da Dimensão do Espaço: A dimensão do espaço não é digitada pelo usuário, sendo classificada automaticamente pelo sistema a partir do resultado da cálculo da área por jogador:
• ≤ 100 m²: Espaço Reduzido (Pequeno)
• 101 a 200 m²: Espaço Médio
• > 200 m²: Espaço Amplo (Grande)
• Sem dimensões delimitadas (ex.: PDI): Não Definido - Preenchimento Condicional pelo Objetivo Central: O preenchimento dos campos de momento do jogo, fase do jogo, comportamento tático e atributo técnico é opcional por atividade. O preenchimento deve ser restrito ao foco do exercício (ex.: se o objetivo principal for tático de reação pós-perda, o fundamento de passe não deve ser marcado como atributo técnico, evitando distorções nos indicadores de desenvolvimento técnico individual).
- Modificar valores como comprimento, largura ou número sugerido de jogadores deve engatilhar o recálculo e a reclassificação automática de dimensão do espaço na biblioteca.
- Atividades já importadas para sessões de treino passadas não devem sofrer alterações retroativas com esta edição.
Definition of Ready (DoR)
- [x] A estrutura da User Story está bem definida
- [x] A User Story está rastreável
- [x] A User Story está mensurável
- [x] A User Story foi prototipada
- [x] A User Story foi validada com o cliente
RF21 · Excluir atividade na bibliotecaEntrega: Escopo AdicionalSituação: Não concluídoIteração: Não definidaProduto: CP01
Declara??o RF: Excluir atividade na biblioteca: o sistema deve permitir que o treinador e o auxiliar excluam uma atividade cadastrada na biblioteca de treinos.
Declaração US: Como membro da equipe t?cnica, eu quero Excluir atividade na biblioteca, para atender ao objetivo do requisito.
Critérios de Aceitação
- Interface Responsiva e Adaptável: A interface do sistema deve ser responsiva, adaptando o layout automaticamente de acordo com a resolução do dispositivo para não prejudicar a visualização dos gráficos na tela.
Definition of Ready (DoR)
- [ ] A estrutura da User Story está bem definida
- [ ] A User Story está rastreável
- [ ] A User Story está mensurável
- [ ] A User Story foi prototipada
- [ ] A User Story foi validada com o cliente
RF22 · Exibir indicador de treinoEntrega: MVPSituação: Não concluídoIteração: Iteração 09Produto: CP03
Declara??o RF: Exibir indicador de treino: o sistema deve exibir, para o treinador e o auxiliar, indicadores como número de sessões, minutos totais de treino, variabilidade de exercícios e número de execuções.
Declaração US: Como membro da equipe t?cnica, eu quero Exibir indicador de treino, para atender ao objetivo do requisito.
Critérios de Aceitação
- Interface Responsiva e Adaptável: A interface do sistema deve ser responsiva, adaptando o layout automaticamente de acordo com a resolução do dispositivo para não prejudicar a visualização dos gráficos na tela.
- Atualização em Tempo Real do Dashboard: Os gráficos e indicadores do dashboard devem ser recalculados e atualizados na interface do usuário em um tempo máximo de 5 segundos após a confirmação de sucesso no cadastro, edição ou exclusão de um treino.
- Simultaneidade e Contagem de Tempo da Sessão: Atividades cadastradas com o mesmo número no campo ordem dentro de uma sessão (ex.: duas atividades com Ordem = 1) ocorrem de forma simultânea (elenco dividido em subgrupos). No cálculo da duração líquida da sessão, o tempo de atividades simultâneas é contabilizado uma única vez (ex.: duas atividades de 20 minutos com mesma ordem somam 20 minutos à sessão, e não 40). No contador de execuções, o par (Sessão + Ordem) conta como 1 execução.
- Cálculo da Variabilidade de Treinos: O índice percentual de rotatividade de exercícios em um determinado período é calculado por:
Variabilidade (%) = (Atividades Distintas no Período ÷ Total de Execuções no Período) × 100
Faixa de referência metodológica estipulada pelo treinador: entre 50% e 70% (cada atividade repetida em média de 1 a 2 vezes no ciclo). - Tratamento e Estabilidade em Consultas com Resultado Vazio: Ao filtrar consultas (indicadores, listas de atividades, dimensões de treino e gráficos comparativos) sem dados no período selecionado, o sistema não deve acusar erros ou disparar exceções de divisão por zero: mantém os filtros ativos, exibe valores neutros (
0 sessões,0 min,0%) e apresenta mensagem orientadora ao usuário, conforme o detalhamento da tabela abaixo. - O card de "Minutos Totais" deve expor o tempo líquido, desconsiderando tempos sobrepostos decorrentes de atividades simultâneas na mesma sessão.
- O card de "Variabilidade" deve calcular e expor o número de exercícios distintos em relação ao total de execuções.
- Se o período filtrado não possuir sessões ou dados cadastrados, exibir marcações limpas como "0" ou estados vazios padronizados sem gerar erro.
Definition of Ready (DoR)
- [ ] A estrutura da User Story está bem definida
- [ ] A User Story está rastreável
- [ ] A User Story está mensurável
- [ ] A User Story foi prototipada
- [ ] A User Story foi validada com o cliente
RF23 · Reutilizar atividade cadastradaEntrega: MVPSituação: ConcluídoIteração: Iteração 08Produto: CP01
Declara??o RF: Reutilizar atividade cadastrada: o sistema deve permitir que o treinador e o auxiliar adicionem a uma sessão de treino uma atividade já cadastrada na biblioteca, preenchendo automaticamente, no momento da seleção, os campos inerentes à atividade.
Declaração US: Como membro da equipe t?cnica, eu quero Reutilizar atividade cadastrada, para atender ao objetivo do requisito.
Critérios de Aceitação
- Interface Responsiva e Adaptável: A interface do sistema deve ser responsiva, adaptando o layout automaticamente de acordo com a resolução do dispositivo para não prejudicar a visualização dos gráficos na tela.
- Eficiência no Cadastro de Treinos: O sistema deve possuir fluxos de tela com tempo máximo de preenchimento dos dados inferior ao tempo atual de 4 minutos e meio para o preenchimento dos dados. Como objetivo, o sistema deve garantir que o processo de registro de um novo treino seja concluído pelo treinador em menos de 2 minutos.
- Atualização em Tempo Real do Dashboard: Os gráficos e indicadores do dashboard devem ser recalculados e atualizados na interface do usuário em um tempo máximo de 5 segundos após a confirmação de sucesso no cadastro, edição ou exclusão de um treino.
- Cálculo da Área por Jogador: A área por jogador em metros quadrados é calculada pela fórmula:
Área (m²/jogador) = (Comprimento × Largura) ÷ Nº de Jogadores
Obrigatório para atividades com orientação de Aquisição, Aplicação e Equilíbrio de Carga. Dispensado para atividades de PDI (Proposta de Desenvolvimento Individual), nas quais comprimento, largura e jogadores são opcionais. - Classificação Automática da Dimensão do Espaço: A dimensão do espaço não é digitada pelo usuário, sendo classificada automaticamente pelo sistema a partir do resultado da cálculo da área por jogador:
• ≤ 100 m²: Espaço Reduzido (Pequeno)
• 101 a 200 m²: Espaço Médio
• > 200 m²: Espaço Amplo (Grande)
• Sem dimensões delimitadas (ex.: PDI): Não Definido - Ao selecionar uma atividade via lista da biblioteca durante o fluxo de cadastro da sessão, os campos descritivos e métricos já configurados devem ser populados automaticamente.
- Após a importação, o sistema deve permitir ao usuário editar as informações da atividade (sem alterar a matriz original na biblioteca).
Definition of Ready (DoR)
- [x] A estrutura da User Story está bem definida
- [x] A User Story está rastreável
- [x] A User Story está mensurável
- [x] A User Story foi prototipada
- [x] A User Story foi validada com o cliente
RF24 · Consultar informação de atividade do treinoEntrega: MVPSituação: Não concluídoIteração: Iteração 09Produto: CP03
Declara??o RF: Consultar informação de atividade do treino: o sistema deve permitir que o treinador e o auxiliar consultem, em gráfico e por meio de filtro, a informação de atividade, atualizando automaticamente as informações exibidas.
Declaração US: Como membro da equipe t?cnica, eu quero Consultar informação de atividade do treino, para atender ao objetivo do requisito.
Critérios de Aceitação
- Interface Responsiva e Adaptável: A interface do sistema deve ser responsiva, adaptando o layout automaticamente de acordo com a resolução do dispositivo para não prejudicar a visualização dos gráficos na tela.
- Atualização em Tempo Real do Dashboard: Os gráficos e indicadores do dashboard devem ser recalculados e atualizados na interface do usuário em um tempo máximo de 5 segundos após a confirmação de sucesso no cadastro, edição ou exclusão de um treino.
- Tratamento e Estabilidade em Consultas com Resultado Vazio: Ao filtrar consultas (indicadores, listas de atividades, dimensões de treino e gráficos comparativos) sem dados no período selecionado, o sistema não deve acusar erros ou disparar exceções de divisão por zero: mantém os filtros ativos, exibe valores neutros (
0 sessões,0 min,0%) e apresenta mensagem orientadora ao usuário, conforme o detalhamento da tabela abaixo. - O usuário deve conseguir visualizar um gráfico com as atividades executadas.
- Quando os parâmetros de filtro selecionados não retornarem nenhuma correspondência, o sistema deve apresentar um layout de estado vazio em vez de mensagens de erro cruas.
Definition of Ready (DoR)
- [ ] A estrutura da User Story está bem definida
- [ ] A User Story está rastreável
- [ ] A User Story está mensurável
- [ ] A User Story foi prototipada
- [ ] A User Story foi validada com o cliente
RF25 · Gerar relatório de treinoEntrega: MVPSituação: Não concluídoIteração: Iteração 10Produto: CP04
Declara??o RF: Gerar relatório de treino: o sistema deve permitir que o treinador e o auxiliar gerem um relatório do treino em formato PDF.
Declaração US: Como membro da equipe t?cnica, eu quero Gerar relatório de treino, para atender ao objetivo do requisito.
Critérios de Aceitação
- Interface Responsiva e Adaptável: A interface do sistema deve ser responsiva, adaptando o layout automaticamente de acordo com a resolução do dispositivo para não prejudicar a visualização dos gráficos na tela.
- Classificação Automática da Dimensão do Espaço: A dimensão do espaço não é digitada pelo usuário, sendo classificada automaticamente pelo sistema a partir do resultado da cálculo da área por jogador:
• ≤ 100 m²: Espaço Reduzido (Pequeno)
• 101 a 200 m²: Espaço Médio
• > 200 m²: Espaço Amplo (Grande)
• Sem dimensões delimitadas (ex.: PDI): Não Definido - Simultaneidade e Contagem de Tempo da Sessão: Atividades cadastradas com o mesmo número no campo ordem dentro de uma sessão (ex.: duas atividades com Ordem = 1) ocorrem de forma simultânea (elenco dividido em subgrupos). No cálculo da duração líquida da sessão, o tempo de atividades simultâneas é contabilizado uma única vez (ex.: duas atividades de 20 minutos com mesma ordem somam 20 minutos à sessão, e não 40). No contador de execuções, o par (Sessão + Ordem) conta como 1 execução.
- Cálculo da Variabilidade de Treinos: O índice percentual de rotatividade de exercícios em um determinado período é calculado por:
Variabilidade (%) = (Atividades Distintas no Período ÷ Total de Execuções no Período) × 100
Faixa de referência metodológica estipulada pelo treinador: entre 50% e 70% (cada atividade repetida em média de 1 a 2 vezes no ciclo). - Tratamento e Estabilidade em Consultas com Resultado Vazio: Ao filtrar consultas (indicadores, listas de atividades, dimensões de treino e gráficos comparativos) sem dados no período selecionado, o sistema não deve acusar erros ou disparar exceções de divisão por zero: mantém os filtros ativos, exibe valores neutros (
0 sessões,0 min,0%) e apresenta mensagem orientadora ao usuário, conforme o detalhamento da tabela abaixo.
Definition of Ready (DoR)
- [ ] A estrutura da User Story está bem definida
- [ ] A User Story está rastreável
- [ ] A User Story está mensurável
- [ ] A User Story foi prototipada
- [ ] A User Story foi validada com o cliente
RF26 · Alternar unidade de tempoEntrega: MVPSituação: Não concluídoIteração: Iteração 10Produto: CP03
Declara??o RF: Alternar unidade de tempo: o sistema deve permitir que o treinador e o auxiliar alternem, nos gŕaficos, a visualização do tempo das atividades entre tempo absoluto (em minutos) e tempo relativo (em porcentagem do tempo total da sessão).
Declaração US: Como membro da equipe t?cnica, eu quero Alternar unidade de tempo, para atender ao objetivo do requisito.
Critérios de Aceitação
- Interface Responsiva e Adaptável: A interface do sistema deve ser responsiva, adaptando o layout automaticamente de acordo com a resolução do dispositivo para não prejudicar a visualização dos gráficos na tela.
- Atualização em Tempo Real do Dashboard: Os gráficos e indicadores do dashboard devem ser recalculados e atualizados na interface do usuário em um tempo máximo de 5 segundos após a confirmação de sucesso no cadastro, edição ou exclusão de um treino.
- Simultaneidade e Contagem de Tempo da Sessão: Atividades cadastradas com o mesmo número no campo ordem dentro de uma sessão (ex.: duas atividades com Ordem = 1) ocorrem de forma simultânea (elenco dividido em subgrupos). No cálculo da duração líquida da sessão, o tempo de atividades simultâneas é contabilizado uma única vez (ex.: duas atividades de 20 minutos com mesma ordem somam 20 minutos à sessão, e não 40). No contador de execuções, o par (Sessão + Ordem) conta como 1 execução.
Definition of Ready (DoR)
- [ ] A estrutura da User Story está bem definida
- [ ] A User Story está rastreável
- [ ] A User Story está mensurável
- [ ] A User Story foi prototipada
- [ ] A User Story foi validada com o cliente
RF27 · Criar contaEntrega: MVPSituação: Não concluídoIteração: Iteração 09Produto: CP05
Declara??o RF: Criar conta: o sistema deve permitir que o treinador e o auxiliar criem uma conta de acesso à aplicação.
Declaração US: Como membro da equipe t?cnica, eu quero Criar conta, para atender ao objetivo do requisito.
Critérios de Aceitação
- Proteção de Dados Pessoais dos Atletas: O sistema deve utilizar a aplicação de hash irreversível de senhas via bcrypt para guardar as senhas dos usuários.
- Interface Responsiva e Adaptável: A interface do sistema deve ser responsiva, adaptando o layout automaticamente de acordo com a resolução do dispositivo para não prejudicar a visualização dos gráficos na tela.
- O preenchimento de e-mail e criação de senha válidos deve persistir o usuário na base de dados de forma criptografada.
- Se o usuário tentar cadastrar um e-mail já existente na plataforma, o sistema deve retornar um alerta de e-mail duplicado ou em uso.
Definition of Ready (DoR)
- [ ] A estrutura da User Story está bem definida
- [ ] A User Story está rastreável
- [ ] A User Story está mensurável
- [ ] A User Story foi prototipada
- [ ] A User Story foi validada com o cliente
RF28 · Fazer loginEntrega: MVPSituação: Não concluídoIteração: Iteração 09Produto: CP05
Declara??o RF: Fazer login: o sistema deve permitir que o treinador e o auxiliar se autentiquem na aplicação a partir de um login e senha de acesso.
Declaração US: Como membro da equipe t?cnica, eu quero Fazer login, para atender ao objetivo do requisito.
Critérios de Aceitação
- Proteção de Dados Pessoais dos Atletas: O sistema deve utilizar a aplicação de hash irreversível de senhas via bcrypt para guardar as senhas dos usuários.
- Interface Responsiva e Adaptável: A interface do sistema deve ser responsiva, adaptando o layout automaticamente de acordo com a resolução do dispositivo para não prejudicar a visualização dos gráficos na tela.
- A submissão de credenciais válidas redireciona o usuário para a página de dashboard de gráficos.
- Credenciais inválidas (senha/e-mail errados ou não encontrados) exibem mensagem de erro e impedem a navegação para rotas internas.
Definition of Ready (DoR)
- [ ] A estrutura da User Story está bem definida
- [ ] A User Story está rastreável
- [ ] A User Story está mensurável
- [ ] A User Story foi prototipada
- [ ] A User Story foi validada com o cliente
RF29 · Anexar imagem à atividadeEntrega: Escopo AdicionalSituação: Não concluídoIteração: Não definidaProduto: CP01
Declara??o RF: Anexar imagem à atividade: o sistema deve permitir que o treinador e o auxiliar anexem uma imagem a uma atividade cadastrada na biblioteca, exibindo-a junto à atividade na biblioteca e nas sessões de treino em que ela for incluída.
Declaração US: Como membro da equipe t?cnica, eu quero Anexar imagem à atividade, para atender ao objetivo do requisito.
Critérios de Aceitação
- Interface Responsiva e Adaptável: A interface do sistema deve ser responsiva, adaptando o layout automaticamente de acordo com a resolução do dispositivo para não prejudicar a visualização dos gráficos na tela.
Definition of Ready (DoR)
- [ ] A estrutura da User Story está bem definida
- [ ] A User Story está rastreável
- [ ] A User Story está mensurável
- [ ] A User Story foi prototipada
- [ ] A User Story foi validada com o cliente
RF30 · Registrar pontuação da atividadeEntrega: Escopo AdicionalSituação: Não concluídoIteração: Não definidaProduto: CP03
Declara??o RF: Registrar pontuação da atividade: o sistema deve permitir que o treinador e o auxiliar registrem, para cada atividade de uma sessão, a pontuação planejada e a pontuação obtida em cada repetição.
Declaração US: Como membro da equipe t?cnica, eu quero Registrar pontuação da atividade, para atender ao objetivo do requisito.
Critérios de Aceitação
- Interface Responsiva e Adaptável: A interface do sistema deve ser responsiva, adaptando o layout automaticamente de acordo com a resolução do dispositivo para não prejudicar a visualização dos gráficos na tela.
- Eficiência no Cadastro de Treinos: O sistema deve possuir fluxos de tela com tempo máximo de preenchimento dos dados inferior ao tempo atual de 4 minutos e meio para o preenchimento dos dados. Como objetivo, o sistema deve garantir que o processo de registro de um novo treino seja concluído pelo treinador em menos de 2 minutos.
- Atualização em Tempo Real do Dashboard: Os gráficos e indicadores do dashboard devem ser recalculados e atualizados na interface do usuário em um tempo máximo de 5 segundos após a confirmação de sucesso no cadastro, edição ou exclusão de um treino.
Definition of Ready (DoR)
- [ ] A estrutura da User Story está bem definida
- [ ] A User Story está rastreável
- [ ] A User Story está mensurável
- [ ] A User Story foi prototipada
- [ ] A User Story foi validada com o cliente
RF31 · Gerar análise textual do treinoEntrega: Escopo AdicionalSituação: Não concluídoIteração: Não definidaProduto: CP03
Declara??o RF: Gerar análise textual do treino: o sistema deve permitir que o treinador e o auxiliar gerem, com inteligência artificial, uma análise textual (insight) sobre as informações do treino.
Declaração US: Como membro da equipe t?cnica, eu quero Gerar análise textual do treino, para atender ao objetivo do requisito.
Critérios de Aceitação
- Interface Responsiva e Adaptável: A interface do sistema deve ser responsiva, adaptando o layout automaticamente de acordo com a resolução do dispositivo para não prejudicar a visualização dos gráficos na tela.
- Atualização em Tempo Real do Dashboard: Os gráficos e indicadores do dashboard devem ser recalculados e atualizados na interface do usuário em um tempo máximo de 5 segundos após a confirmação de sucesso no cadastro, edição ou exclusão de um treino.
Definition of Ready (DoR)
- [ ] A estrutura da User Story está bem definida
- [ ] A User Story está rastreável
- [ ] A User Story está mensurável
- [ ] A User Story foi prototipada
- [ ] A User Story foi validada com o cliente
RF32 · Registrar atributo técnico da atividadeEntrega: MVPSituação: Não concluídoIteração: Iteração 10Produto: CP01
Declara??o RF: Registrar atributo técnico da atividade: o sistema deve permitir que o treinador e o auxiliar registrem, de forma opcional, o atributo técnico trabalhado em uma atividade (ex: domínio orientado, cabeceira defensiva).
Declaração US: Como membro da equipe t?cnica, eu quero Registrar atributo técnico da atividade, para atender ao objetivo do requisito.
Critérios de Aceitação
- Interface Responsiva e Adaptável: A interface do sistema deve ser responsiva, adaptando o layout automaticamente de acordo com a resolução do dispositivo para não prejudicar a visualização dos gráficos na tela.
- Preenchimento Condicional pelo Objetivo Central: O preenchimento dos campos de momento do jogo, fase do jogo, comportamento tático e atributo técnico é opcional por atividade. O preenchimento deve ser restrito ao foco do exercício (ex.: se o objetivo principal for tático de reação pós-perda, o fundamento de passe não deve ser marcado como atributo técnico, evitando distorções nos indicadores de desenvolvimento técnico individual).
Definition of Ready (DoR)
- [ ] A estrutura da User Story está bem definida
- [ ] A User Story está rastreável
- [ ] A User Story está mensurável
- [ ] A User Story foi prototipada
- [ ] A User Story foi validada com o cliente
RF33 · Editar atributo técnico da atividadeEntrega: Escopo AdicionalSituação: Não concluídoIteração: Não definidaProduto: CP01
Declara??o RF: Editar atributo técnico da atividade: o sistema deve permitir que o treinador e o auxiliar editem um atributo técnico registrado em uma atividade.
Declaração US: Como membro da equipe t?cnica, eu quero Editar atributo técnico da atividade, para atender ao objetivo do requisito.
Critérios de Aceitação
- Interface Responsiva e Adaptável: A interface do sistema deve ser responsiva, adaptando o layout automaticamente de acordo com a resolução do dispositivo para não prejudicar a visualização dos gráficos na tela.
- Preenchimento Condicional pelo Objetivo Central: O preenchimento dos campos de momento do jogo, fase do jogo, comportamento tático e atributo técnico é opcional por atividade. O preenchimento deve ser restrito ao foco do exercício (ex.: se o objetivo principal for tático de reação pós-perda, o fundamento de passe não deve ser marcado como atributo técnico, evitando distorções nos indicadores de desenvolvimento técnico individual).
Definition of Ready (DoR)
- [ ] A estrutura da User Story está bem definida
- [ ] A User Story está rastreável
- [ ] A User Story está mensurável
- [ ] A User Story foi prototipada
- [ ] A User Story foi validada com o cliente
RF34 · Excluir atributo técnico da atividadeEntrega: Escopo AdicionalSituação: Não concluídoIteração: Não definidaProduto: CP01
Declara??o RF: Excluir atributo técnico da atividade: o sistema deve permitir que o treinador e o auxiliar excluam um atributo técnico registrado em uma atividade.
Declaração US: Como membro da equipe t?cnica, eu quero Excluir atributo técnico da atividade, para atender ao objetivo do requisito.
Critérios de Aceitação
- Interface Responsiva e Adaptável: A interface do sistema deve ser responsiva, adaptando o layout automaticamente de acordo com a resolução do dispositivo para não prejudicar a visualização dos gráficos na tela.
- Preenchimento Condicional pelo Objetivo Central: O preenchimento dos campos de momento do jogo, fase do jogo, comportamento tático e atributo técnico é opcional por atividade. O preenchimento deve ser restrito ao foco do exercício (ex.: se o objetivo principal for tático de reação pós-perda, o fundamento de passe não deve ser marcado como atributo técnico, evitando distorções nos indicadores de desenvolvimento técnico individual).
Definition of Ready (DoR)
- [ ] A estrutura da User Story está bem definida
- [ ] A User Story está rastreável
- [ ] A User Story está mensurável
- [ ] A User Story foi prototipada
- [ ] A User Story foi validada com o cliente
RF35 · Consultar informação de espaço do treinoEntrega: MVPSituação: Não concluídoIteração: Iteração 10Produto: CP03
Declara??o RF: Consultar informação de espaço do treino: o sistema deve permitir que o treinador e o auxiliar consultem, em gráfico e por meio de filtro, a informação de espaço do treino, atualizando automaticamente as informações exibidas.
Declaração US: Como membro da equipe t?cnica, eu quero Consultar informação de espaço do treino, para atender ao objetivo do requisito.
Critérios de Aceitação
- Interface Responsiva e Adaptável: A interface do sistema deve ser responsiva, adaptando o layout automaticamente de acordo com a resolução do dispositivo para não prejudicar a visualização dos gráficos na tela.
- Atualização em Tempo Real do Dashboard: Os gráficos e indicadores do dashboard devem ser recalculados e atualizados na interface do usuário em um tempo máximo de 5 segundos após a confirmação de sucesso no cadastro, edição ou exclusão de um treino.
- Cálculo da Área por Jogador: A área por jogador em metros quadrados é calculada pela fórmula:
Área (m²/jogador) = (Comprimento × Largura) ÷ Nº de Jogadores
Obrigatório para atividades com orientação de Aquisição, Aplicação e Equilíbrio de Carga. Dispensado para atividades de PDI (Proposta de Desenvolvimento Individual), nas quais comprimento, largura e jogadores são opcionais. - Classificação Automática da Dimensão do Espaço: A dimensão do espaço não é digitada pelo usuário, sendo classificada automaticamente pelo sistema a partir do resultado da cálculo da área por jogador:
• ≤ 100 m²: Espaço Reduzido (Pequeno)
• 101 a 200 m²: Espaço Médio
• > 200 m²: Espaço Amplo (Grande)
• Sem dimensões delimitadas (ex.: PDI): Não Definido - Tratamento e Estabilidade em Consultas com Resultado Vazio: Ao filtrar consultas (indicadores, listas de atividades, dimensões de treino e gráficos comparativos) sem dados no período selecionado, o sistema não deve acusar erros ou disparar exceções de divisão por zero: mantém os filtros ativos, exibe valores neutros (
0 sessões,0 min,0%) e apresenta mensagem orientadora ao usuário, conforme o detalhamento da tabela abaixo.
Definition of Ready (DoR)
- [ ] A estrutura da User Story está bem definida
- [ ] A User Story está rastreável
- [ ] A User Story está mensurável
- [ ] A User Story foi prototipada
- [ ] A User Story foi validada com o cliente
RF36 · Consultar informação de orientação do treinoEntrega: MVPSituação: Não concluídoIteração: Iteração 11Produto: CP03
Declara??o RF: Consultar informação de orientação do treino: o sistema deve permitir que o treinador e o auxiliar consultem, em gráfico e por meio de filtro, a informação de orientação do treino, atualizando automaticamente as informações exibidas.
Declaração US: Como membro da equipe t?cnica, eu quero Consultar informação de orientação do treino, para atender ao objetivo do requisito.
Critérios de Aceitação
- Interface Responsiva e Adaptável: A interface do sistema deve ser responsiva, adaptando o layout automaticamente de acordo com a resolução do dispositivo para não prejudicar a visualização dos gráficos na tela.
- Atualização em Tempo Real do Dashboard: Os gráficos e indicadores do dashboard devem ser recalculados e atualizados na interface do usuário em um tempo máximo de 5 segundos após a confirmação de sucesso no cadastro, edição ou exclusão de um treino.
- Tratamento e Estabilidade em Consultas com Resultado Vazio: Ao filtrar consultas (indicadores, listas de atividades, dimensões de treino e gráficos comparativos) sem dados no período selecionado, o sistema não deve acusar erros ou disparar exceções de divisão por zero: mantém os filtros ativos, exibe valores neutros (
0 sessões,0 min,0%) e apresenta mensagem orientadora ao usuário, conforme o detalhamento da tabela abaixo.
Definition of Ready (DoR)
- [ ] A estrutura da User Story está bem definida
- [ ] A User Story está rastreável
- [ ] A User Story está mensurável
- [ ] A User Story foi prototipada
- [ ] A User Story foi validada com o cliente
RF37 · Consultar informação de momento do jogo do treinoEntrega: MVPSituação: Não concluídoIteração: Iteração 11Produto: CP03
Declara??o RF: Consultar informação de momento do jogo do treino: o sistema deve permitir que o treinador e o auxiliar consultem, em gráfico e por meio de filtro, a informação de momento do jogo do treino, atualizando automaticamente as informações exibidas.
Declaração US: Como membro da equipe t?cnica, eu quero Consultar informação de momento do jogo do treino, para atender ao objetivo do requisito.
Critérios de Aceitação
- Interface Responsiva e Adaptável: A interface do sistema deve ser responsiva, adaptando o layout automaticamente de acordo com a resolução do dispositivo para não prejudicar a visualização dos gráficos na tela.
- Atualização em Tempo Real do Dashboard: Os gráficos e indicadores do dashboard devem ser recalculados e atualizados na interface do usuário em um tempo máximo de 5 segundos após a confirmação de sucesso no cadastro, edição ou exclusão de um treino.
- Preenchimento Condicional pelo Objetivo Central: O preenchimento dos campos de momento do jogo, fase do jogo, comportamento tático e atributo técnico é opcional por atividade. O preenchimento deve ser restrito ao foco do exercício (ex.: se o objetivo principal for tático de reação pós-perda, o fundamento de passe não deve ser marcado como atributo técnico, evitando distorções nos indicadores de desenvolvimento técnico individual).
- Tratamento e Estabilidade em Consultas com Resultado Vazio: Ao filtrar consultas (indicadores, listas de atividades, dimensões de treino e gráficos comparativos) sem dados no período selecionado, o sistema não deve acusar erros ou disparar exceções de divisão por zero: mantém os filtros ativos, exibe valores neutros (
0 sessões,0 min,0%) e apresenta mensagem orientadora ao usuário, conforme o detalhamento da tabela abaixo.
Definition of Ready (DoR)
- [ ] A estrutura da User Story está bem definida
- [ ] A User Story está rastreável
- [ ] A User Story está mensurável
- [ ] A User Story foi prototipada
- [ ] A User Story foi validada com o cliente
RF38 · Consultar informação de fase do jogo do treinoEntrega: MVPSituação: Não concluídoIteração: Iteração 11Produto: CP03
Declara??o RF: Consultar informação de fase do jogo do treino: o sistema deve permitir que o treinador e o auxiliar consultem, em gráfico e por meio de filtro, a informação de fase do jogo do treino, atualizando automaticamente as informações exibidas.
Declaração US: Como membro da equipe t?cnica, eu quero Consultar informação de fase do jogo do treino, para atender ao objetivo do requisito.
Critérios de Aceitação
- Interface Responsiva e Adaptável: A interface do sistema deve ser responsiva, adaptando o layout automaticamente de acordo com a resolução do dispositivo para não prejudicar a visualização dos gráficos na tela.
- Atualização em Tempo Real do Dashboard: Os gráficos e indicadores do dashboard devem ser recalculados e atualizados na interface do usuário em um tempo máximo de 5 segundos após a confirmação de sucesso no cadastro, edição ou exclusão de um treino.
- Preenchimento Condicional pelo Objetivo Central: O preenchimento dos campos de momento do jogo, fase do jogo, comportamento tático e atributo técnico é opcional por atividade. O preenchimento deve ser restrito ao foco do exercício (ex.: se o objetivo principal for tático de reação pós-perda, o fundamento de passe não deve ser marcado como atributo técnico, evitando distorções nos indicadores de desenvolvimento técnico individual).
- Tratamento e Estabilidade em Consultas com Resultado Vazio: Ao filtrar consultas (indicadores, listas de atividades, dimensões de treino e gráficos comparativos) sem dados no período selecionado, o sistema não deve acusar erros ou disparar exceções de divisão por zero: mantém os filtros ativos, exibe valores neutros (
0 sessões,0 min,0%) e apresenta mensagem orientadora ao usuário, conforme o detalhamento da tabela abaixo.
Definition of Ready (DoR)
- [ ] A estrutura da User Story está bem definida
- [ ] A User Story está rastreável
- [ ] A User Story está mensurável
- [ ] A User Story foi prototipada
- [ ] A User Story foi validada com o cliente
RF39 · Consultar informação de comportamento do treinoEntrega: MVPSituação: Não concluídoIteração: Iteração 10Produto: CP03
Declara??o RF: Consultar informação de comportamento do treino: o sistema deve permitir que o treinador e o auxiliar consultem, em gráfico e por meio de filtro, a informação de comportamento do treino, atualizando automaticamente as informações exibidas.
Declaração US: Como membro da equipe t?cnica, eu quero Consultar informação de comportamento do treino, para atender ao objetivo do requisito.
Critérios de Aceitação
- Interface Responsiva e Adaptável: A interface do sistema deve ser responsiva, adaptando o layout automaticamente de acordo com a resolução do dispositivo para não prejudicar a visualização dos gráficos na tela.
- Atualização em Tempo Real do Dashboard: Os gráficos e indicadores do dashboard devem ser recalculados e atualizados na interface do usuário em um tempo máximo de 5 segundos após a confirmação de sucesso no cadastro, edição ou exclusão de um treino.
- Preenchimento Condicional pelo Objetivo Central: O preenchimento dos campos de momento do jogo, fase do jogo, comportamento tático e atributo técnico é opcional por atividade. O preenchimento deve ser restrito ao foco do exercício (ex.: se o objetivo principal for tático de reação pós-perda, o fundamento de passe não deve ser marcado como atributo técnico, evitando distorções nos indicadores de desenvolvimento técnico individual).
- Tratamento e Estabilidade em Consultas com Resultado Vazio: Ao filtrar consultas (indicadores, listas de atividades, dimensões de treino e gráficos comparativos) sem dados no período selecionado, o sistema não deve acusar erros ou disparar exceções de divisão por zero: mantém os filtros ativos, exibe valores neutros (
0 sessões,0 min,0%) e apresenta mensagem orientadora ao usuário, conforme o detalhamento da tabela abaixo.
Definition of Ready (DoR)
- [ ] A estrutura da User Story está bem definida
- [ ] A User Story está rastreável
- [ ] A User Story está mensurável
- [ ] A User Story foi prototipada
- [ ] A User Story foi validada com o cliente
RF40 · Consultar informação de atributo técnico do treinoEntrega: MVPSituação: Não concluídoIteração: Iteração 11Produto: CP03
Declara??o RF: Consultar informação de atributo técnico do treino: o sistema deve permitir que o treinador e o auxiliar consultem, em gráfico e por meio de filtro, a informação de atributo técnico, atualizando automaticamente as informações exibidas.
Declaração US: Como membro da equipe t?cnica, eu quero Consultar informação de atributo técnico do treino, para atender ao objetivo do requisito.
Critérios de Aceitação
- Interface Responsiva e Adaptável: A interface do sistema deve ser responsiva, adaptando o layout automaticamente de acordo com a resolução do dispositivo para não prejudicar a visualização dos gráficos na tela.
- Atualização em Tempo Real do Dashboard: Os gráficos e indicadores do dashboard devem ser recalculados e atualizados na interface do usuário em um tempo máximo de 5 segundos após a confirmação de sucesso no cadastro, edição ou exclusão de um treino.
- Preenchimento Condicional pelo Objetivo Central: O preenchimento dos campos de momento do jogo, fase do jogo, comportamento tático e atributo técnico é opcional por atividade. O preenchimento deve ser restrito ao foco do exercício (ex.: se o objetivo principal for tático de reação pós-perda, o fundamento de passe não deve ser marcado como atributo técnico, evitando distorções nos indicadores de desenvolvimento técnico individual).
- Tratamento e Estabilidade em Consultas com Resultado Vazio: Ao filtrar consultas (indicadores, listas de atividades, dimensões de treino e gráficos comparativos) sem dados no período selecionado, o sistema não deve acusar erros ou disparar exceções de divisão por zero: mantém os filtros ativos, exibe valores neutros (
0 sessões,0 min,0%) e apresenta mensagem orientadora ao usuário, conforme o detalhamento da tabela abaixo.
Definition of Ready (DoR)
- [ ] A estrutura da User Story está bem definida
- [ ] A User Story está rastreável
- [ ] A User Story está mensurável
- [ ] A User Story foi prototipada
- [ ] A User Story foi validada com o cliente
RF41 · Consultar análise comparativa por periodizaçãoEntrega: MVPSituação: Não concluídoIteração: Iteração 11Produto: CP03
Declara??o RF: Consultar análise comparativa por periodização: o sistema deve permitir que o treinador e o auxiliar consultem, em gráfico e por meio de filtro, a análise comparativa por periodização (mesociclo, microciclo, mês e sessão), atualizando automaticamente as informações exibidas.
Declaração US: Como membro da equipe t?cnica, eu quero Consultar análise comparativa por periodização, para atender ao objetivo do requisito.
Critérios de Aceitação
- Interface Responsiva e Adaptável: A interface do sistema deve ser responsiva, adaptando o layout automaticamente de acordo com a resolução do dispositivo para não prejudicar a visualização dos gráficos na tela.
- Atualização em Tempo Real do Dashboard: Os gráficos e indicadores do dashboard devem ser recalculados e atualizados na interface do usuário em um tempo máximo de 5 segundos após a confirmação de sucesso no cadastro, edição ou exclusão de um treino.
- Hierarquia e Integridade da Periodização: A estrutura esportiva organiza-se estritamente na árvore hierárquica:
Macrociclo (Temporada) ⊃ Mesociclo ⊃ Microciclo (Semana) ⊃ Sessão (Treino) ⊃ Atividades
Nenhum registro subordinado pode ser persistido sem vínculo obrigatório a um elemento pai válido. Não é permitido excluir elementos pais que possuam ciclos ou treinos associados sem validação prévia de integridade. - Tratamento e Estabilidade em Consultas com Resultado Vazio: Ao filtrar consultas (indicadores, listas de atividades, dimensões de treino e gráficos comparativos) sem dados no período selecionado, o sistema não deve acusar erros ou disparar exceções de divisão por zero: mantém os filtros ativos, exibe valores neutros (
0 sessões,0 min,0%) e apresenta mensagem orientadora ao usuário, conforme o detalhamento da tabela abaixo.
Definition of Ready (DoR)
- [ ] A estrutura da User Story está bem definida
- [ ] A User Story está rastreável
- [ ] A User Story está mensurável
- [ ] A User Story foi prototipada
- [ ] A User Story foi validada com o cliente
8.2 Requisitos Não Funcionais — RNFs
Lista de requisitos não funcionais, contendo: Numeração do Requisito; Nome; Descrição; Classificação FURPS+; Critério de Verificação.
8.3 Regras de Negócio — RNs
As Regras de Negócio (RNs) definem a lógica de domínio esportivo do treinador Marcus Vinicius, as diretrizes de cálculo analítico e as restrições comportamentais do sistema. Elas especificam como as funcionalidades declaradas nos RFs devem operar para garantir a fidelidade metodológica ao futebol de base:
| ID | Regra de Negócio | Categoria | Descrição / Fórmula de Negócio | Requisitos Relacionados |
|---|---|---|---|---|
| RN01 | Cálculo da Área por Jogador | Cálculo Esportivo | A área por jogador em metros quadrados é calculada pela fórmula:Área (m²/jogador) = (Comprimento × Largura) ÷ Nº de JogadoresObrigatório para atividades com orientação de Aquisição, Aplicação e Equilíbrio de Carga. Dispensado para atividades de PDI (Proposta de Desenvolvimento Individual), nas quais comprimento, largura e jogadores são opcionais. |
RF13, RF14, RF19, RF20, RF23, RF35 |
| RN02 | Classificação Automática da Dimensão do Espaço | Validação Automática | A dimensão do espaço não é digitada pelo usuário, sendo classificada automaticamente pelo sistema a partir do resultado da RN01: • ≤ 100 m²: Espaço Reduzido (Pequeno) • 101 a 200 m²: Espaço Médio • > 200 m²: Espaço Amplo (Grande) • Sem dimensões delimitadas (ex.: PDI): Não Definido |
RF13, RF14, RF19, RF20, RF25, RF35 |
| RN03 | Simultaneidade e Contagem de Tempo da Sessão | Cálculo Esportivo | Atividades cadastradas com o mesmo número no campo ordem dentro de uma sessão (ex.: duas atividades com Ordem = 1) ocorrem de forma simultânea (elenco dividido em subgrupos). No cálculo da duração líquida da sessão, o tempo de atividades simultâneas é contabilizado uma única vez (ex.: duas atividades de 20 minutos com mesma ordem somam 20 minutos à sessão, e não 40). No contador de execuções, o par (Sessão + Ordem) conta como 1 execução. | RF13, RF14, RF16, RF17, RF22, RF25, RF26 |
| RN04 | Hierarquia e Integridade da Periodização | Integridade Estrutural | A estrutura esportiva organiza-se estritamente na árvore hierárquica:Macrociclo (Temporada) ⊃ Mesociclo ⊃ Microciclo (Semana) ⊃ Sessão (Treino) ⊃ AtividadesNenhum registro subordinado pode ser persistido sem vínculo obrigatório a um elemento pai válido. Não é permitido excluir elementos pais que possuam ciclos ou treinos associados sem validação prévia de integridade. |
RF01 a RF09, RF16, RF18, RF41 |
| RN05 | Preenchimento Condicional pelo Objetivo Central | Validação de Entrada | O preenchimento dos campos de momento do jogo, fase do jogo, comportamento tático e atributo técnico é opcional por atividade. O preenchimento deve ser restrito ao foco do exercício (ex.: se o objetivo principal for tático de reação pós-perda, o fundamento de passe não deve ser marcado como atributo técnico, evitando distorções nos indicadores de desenvolvimento técnico individual). | RF13, RF14, RF19, RF20, RF32, RF37 a RF40 |
| RN06 | Cálculo da Variabilidade de Treinos | Cálculo Esportivo | O índice percentual de rotatividade de exercícios em um determinado período é calculado por:Variabilidade (%) = (Atividades Distintas no Período ÷ Total de Execuções no Período) × 100Faixa de referência metodológica estipulada pelo treinador: entre 50% e 70% (cada atividade repetida em média de 1 a 2 vezes no ciclo). |
RF22, RF25 |
| RN07 | Tratamento e Estabilidade em Consultas com Resultado Vazio | Comportamento do Sistema | Ao filtrar consultas (indicadores, listas de atividades, dimensões de treino e gráficos comparativos) sem dados no período selecionado, o sistema não deve acusar erros ou disparar exceções de divisão por zero: mantém os filtros ativos, exibe valores neutros (0 sessões, 0 min, 0%) e apresenta mensagem orientadora ao usuário, conforme o detalhamento da tabela abaixo. |
RF22, RF24, RF25, RF35 a RF41 |
8.3.1 Detalhamento da RN07: Comportamento para Consultas com Resultado Vazio
Esta subseção detalha a especificação operacional da RN07, descrevendo o comportamento visual e interativo do sistema nos cenários em que consultas e filtros não retornam dados:
| Requisito | Tipo de Consulta | Condição de Resultado Vazio | Comportamento do Sistema (Regra de Negócio) | Mensagem e Ação Sugerida ao Usuário |
|---|---|---|---|---|
| RF22 | Indicadores na tela inicial | Nenhum treino cadastrado no período selecionado. | Os indicadores quantitativos são exibidos com valor neutro (0 sessões, 0 min, 0 execuções). Não ocorrem erros de renderização. |
"Nenhum treino registrado neste período." O sistema exibe atalho para cadastrar nova sessão. |
| RF24 | Informações de atividades do treino | Filtro aplicado para o qual não existem atividades cadastradas. | A lista de atividades é substituída por um componente visual de estado vazio. | "Nenhuma atividade encontrada para os filtros aplicados." O sistema disponibiliza botão para limpar filtros. |
| RF25 | Geração de relatório em PDF | Exportação de relatório para um período sem sessões registradas. | O sistema emite notificação informativa na interface, evitando gerar arquivos vazios ou erros. | "Não há registros de treinos no período selecionado para compor o relatório." |
| RF35 a RF40 | Informações de dimensões do treino (espaço, orientação, momento, fase, comportamento, atributo) | Período filtrado não possui treinos com a dimensão selecionada. | O gráfico é renderizado com visual neutro (0 min e 0%), sem disparar exceções (ex.: evitar divisão por zero). |
"Sem atividades com [esta dimensão] no período." Mantém os filtros ativos para nova consulta. |
| RF41 | Análise comparativa por periodização | Um ou ambos os ciclos selecionados não possuem treinos. | O sistema renderiza a coluna do ciclo sem dados com indicativo neutro, alertando a impossibilidade de cálculo comparativo. | "O ciclo selecionado não possui treinos registrados para permitir o comparativo." |
8.4 Matriz Síntese de Rastreabilidade
A matriz a seguir mapeia a correlação direta entre os Objetivos Específicos (OEs), as Características de Produto (CPs), os Requisitos Funcionais (RFs), as Regras de Negócio (RNs) e os Requisitos Não Funcionais (RNFs):
| Contribuição principal | Contribuição secundária | CP | RFs relacionados | Regras de Negócio (RNs) | RNFs relacionados |
|---|---|---|---|---|---|
| OE1 | OE4 | CP01 | RF10, RF11, RF12, RF13, RF14, RF15, RF16, RF17, RF18, RF19, RF20, RF21, RF23, RF29, RF32, RF33, RF34 | RN01, RN02, RN03, RN05 | RNF02, RNF03, RNF04 |
| OE2 | OE3 | CP02 | RF01, RF02, RF03, RF04, RF05, RF06, RF07, RF08, RF09 | RN04 | RNF02 |
| OE3 | OE4 | CP03 | RF22, RF24, RF26, RF30, RF31, RF35, RF36, RF37, RF38, RF39, RF40, RF41 | RN01, RN02, RN03, RN05, RN06, RN07 | RNF02, RNF04 |
| OE4 | OE3 | CP04 | RF25 | RN02, RN03, RN06, RN07 | RNF02 |
| OE1 | OE4 | CP05 | RF27, RF28 | - | RNF01, RNF02 |