Requisitos Funcionais

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

Identificador	Descrição	CP de origem
RF01	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.	CP02
RF02	Editar macrociclo: o sistema deve permitir que o treinador e o auxiliar editem os dados de um macrociclo anteriormente cadastrado.	CP02
RF03	Excluir macrociclo: o sistema deve permitir que o treinador e o auxiliar excluam um macrociclo cadastrado, removendo-o da estrutura de periodização.	CP02
RF04	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.	CP02
RF05	Editar mesociclo: o sistema deve permitir que o treinador e o auxiliar editem os dados de um mesociclo anteriormente cadastrado.	CP02
RF06	Excluir mesociclo: o sistema deve permitir que o treinador e o auxiliar excluam um mesociclo cadastrado.	CP02
RF07	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.	CP02
RF08	Editar microciclo: o sistema deve permitir que o treinador e o auxiliar editem os dados de um microciclo anteriormente cadastrado.	CP02
RF09	Excluir microciclo: o sistema deve permitir que o treinador e o auxiliar excluam um microciclo cadastrado.	CP02
RF10	Cadastrar comportamento: o sistema deve permitir que o treinador e o auxiliar cadastrem um comportamento tático (ex: ofensivo, defensivo), para uso nas atividades.	CP01
RF11	Editar comportamento: o sistema deve permitir que o treinador e o auxiliar editem um comportamento tático já cadastrado.	CP01
RF12	Excluir comportamento: o sistema deve permitir que o treinador e o auxiliar excluam um comportamento tático cadastrado.	CP01
RF13	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.	CP01
RF14	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.	CP01
RF15	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.	CP01
RF16	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.	CP01
RF17	Editar sessão: o sistema deve permitir que o treinador e o auxiliar editem os dados de uma sessão de treino já cadastrada.	CP01
RF18	Excluir sessão: o sistema deve permitir que o treinador e o auxiliar excluam uma sessão de treino cadastrada.	CP01
RF19	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.	CP01
RF20	Editar atividade na biblioteca: o sistema deve permitir que o treinador e o auxiliar editem uma atividade cadastrada na biblioteca de treinos.	CP01
RF21	Excluir atividade na biblioteca: o sistema deve permitir que o treinador e o auxiliar excluam uma atividade cadastrada na biblioteca de treinos.	CP01
RF22	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.	CP03
RF23	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.	CP01
RF24	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.	CP03
RF25	Gerar relatório de treino: o sistema deve permitir que o treinador e o auxiliar gerem um relatório do treino em formato PDF.	CP04
RF26	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).	CP03
RF27	Criar conta: o sistema deve permitir que o treinador e o auxiliar criem uma conta de acesso à aplicação.	CP05
RF28	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.	CP05
RF29	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.	CP01
RF30	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.	CP03
RF31	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.	CP03
RF32	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).	CP01
RF33	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.	CP01
RF34	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.	CP01
RF35	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.	CP03
RF36	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.	CP03
RF37	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.	CP03
RF38	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.	CP03
RF39	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.	CP03
RF40	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.	CP03
RF41	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.	CP03

8.1.1 Regras de Negócio para Consultas com Resultado Vazio

Esta subseção detalha o comportamento esperado do sistema nos cenários em que as consultas e filtros não retornam dados. Nessas situações de resultado vazio, o sistema não deve apontar erros, mas sim manter a estabilidade da interface, preservar os filtros aplicados e exibir uma mensagem orientadora ao usuário, conforme descrito na tabela a seguir:

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.2 Requisitos Não Funcionais - RNFs

Lista de requisitos não funcionais, contendo: Numeração do Requisito; Nome; Descrição; Classificação URPS+; Critério de Verificação.

ID	Nome	Descrição	Classificação URPS+	Critério de Verificação
RNF01	Segurança e Proteção de Credenciais de Usuários	O sistema deve utilizar a aplicação de hash irreversível de senhas via bcrypt com salt para proteger o armazenamento das senhas dos operadores (técnico e auxiliar técnico). Em alinhamento à LGPD (Privacy by Design), o sistema restringe os dados aos operadores e não armazena dados pessoais nominais ou biométricos dos atletas menores de idade.	Segurança	Tentativas de acesso por utilizadores sem permissão devem retornar bloqueio de acesso com o código HTTP 401 (Unauthorized), verificável nos logs do backend.
RNF02	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.	Usabilidade	Ao redimensionar a janela do navegador ou abrir a aplicacao em janelas com larguras de 360px (mobile), 768px (tablet) e 1366px (desktop). O teste é considerado aprovado se nenhum gráfico ficar cortado, sobreposto ou exigir barra de rolagem horizonal na página.
RNF03	Eficiência no Cadastro de Treinos	O sistema deve possuir fluxos de tela com tempo máximo de prenchimento 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.	Usabilidade	O teste inicia no momento em que o treinador clica no botão para criar um novo treino e termina no momento em que a mensagem de "Treino cadastrado com sucesso" é exibida. O critério será considerado atendido se, para um cenário de complexidade média (cadastrar um treino utilizando atividades previamente cadastradas na biblioteca), o tempo total for estritamente inferior a 2 minutos.
RNF04	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.	Performance	Durante os testes de sistema, o treinador cadastra um novo treino enquanto visualiza o dashboard. O tempo entre a confirmação do salvamento e a completa re-renderização do gráfico com os novos dados deve ser cronometrado. O critério é atendido se o tempo de atualização for estritamente menor ou igual a 5 segundos.

8.3 Matriz Síntese de Rastreabilidade

Contribuição principal	Contribuição secundária	CP	RFs relacionados	RNFs relacionados
OE1	OE4	CP1	RF10, RF11, RF12, RF13, RF14, RF15, RF16, RF17, RF18, RF19, RF20, RF21, RF23, RF29, RF32, RF33, RF34	RNF02, RNF03, RNF04
OE2	OE3	CP2	RF01, RF02, RF03, RF04, RF05, RF06, RF07, RF08, RF09	RNF02
OE3	OE4	CP3	RF22, RF24, RF26, RF30, RF31, RF35, RF36, RF37, RF38, RF39, RF40, RF41	RNF02, RNF03, RNF04
OE4	OE3	CP4	RF25	RNF02
OE1	OE4	CP5	RF27, RF28	RNF01, RNF02