Skip to main content

Requisitos junto com Users Storys

Requisitos Funcionais

Requisitos Não Funcionais

ID Descrição do Requisito Não Funcional
RNF01 A expiração de sessão deve ocorrer automaticamente após um período de inatividade configurável.
RNF02 As credenciais de usuário devem ser protegidas com hash (ex: bcrypt).
RNF03 A autenticação deve ser protegida por Tokens JWT.
RNF04 Nenhuma informação sensível do usuário deve ser armazenada localmente no navegador (LocalStorage/SessionStorage).
RNF05 O sistema deve responder a ações do usuário (cliques, navegação, envios) em até 2 segundos, em rede estável (ping 200ms, banda 10 Mbps), medido no navegador.
RNF06 A geração de relatórios (ex: frequência) deve ser concluída em no máximo 5 segundos.
RNF07 O sistema deve obrigatoriamente usar HTTPS em todas as comunicações.
RNF08 O sistema deve registrar logs contendo: ID do usuário, IP de origem, endpoint acessado, data/hora, tipo de ação (login, edição, falha, erro), código de resposta (200, 500 etc.).
RNF09 Logs devem ser armazenados em sistema seguro com retenção mínima de 6 meses para fins de auditoria e diagnóstico.
RNF10 Toda a interface textual do sistema (rótulos, mensagens de erro, botões e descrições) deve ser escrita em linguagem clara e formal, evitando termos técnicos de TI.
RNF11 O horário, direção (entrada, saída) do ponto devem ser fornecidos e processados no backend (para segurança e integridade).

Histórias de Usuário

eférias.

Critérios
textuale/ouupload deAceitação:
saídapordia.

deformaeficiente

Critérios

Critérios

de

Critérios

deAceitação:quandonecessário.

emgrupo).

Critérios

deAceitação:
ID História
US01 - Visualizar Informações de UsuárioPonto
e Critérios de Aceitação
US01

Como um Desenvolvedor do Sistema, eu desejo que a conta do Administrador Mestre seja criada automaticamente na implantação, para que o sistema tenha um ponto de partida seguro para a gestão de usuários.

US02Como um Administrador Mestre, eu desejo poder fazer login no sistema, para que eu possa gerenciar todos os aspectos do ambiente, incluindo usuários e configurações.
US03Como um Administrador Mestre, eu desejo acessar um painel exclusivo, para que eu possa cadastrar e gerenciar diferentes tipos de usuários no sistema.
US04Como um usuário (PONTISTA, SUPERVISOR ou ADMINISTRADOR), eu desejo fazer login na plataforma, para que eu possa acessar as funcionalidades específicas do meu perfil, como gerenciar meus pontos ou supervisionar estagiários.
US05Como um Pontista, eu desejoquero visualizar meu saldo de horas devidas, para que eu saiba se preciso compensar horas ou se tenho banco de horas positivo. 
US06Como um Pontista,  eu desejo visualizar meus diassaldo de férias disponíveis,veis para que eu possa planejar minhas próximas férias. 
US07Como um Pontista, eu desejo visualizar meue histórico de registros de ponto por data,ponto, para que eu possa acompanhar minhasminha presençassituação atual de horas trabalhadas e identificarplanejar possíveisfolgas inconsistências.
de Aceitação:

    • Deve exibir o saldo total de horas devidas.

    • Deve exibir o saldo de férias disponíveis.

    • Deve apresentar o histórico de registros de ponto, com datas e horários.

    • O acesso deve ser seguro e restrito ao próprio Pontista.

US08US02 - Justificar Faltas

Como um Pontista, euquero desejojustificar terminhas umfaltas calendárioanexando pessoaldocumentos noou sistema,inserindo uma explicação textual, e visualizar o status das justificativas (Pendente, Aprovada, Reprovada), para que eu possa verregularizar meusminha diaspresença e acompanhar o andamento das minhas justificativas.

Critérios de trabalho,Aceitação:

feriados
    e
  • faltas

    • Deve permitir o envio de formajustificativa organizada.
de documento.

  • Deve notificar o Supervisor sobre a nova justificativa pendente.

  • Deve exibir o status atualizado da justificativa

    • US09US03 - Solicitar Férias

    Como um Pontista,  eu desejo poder justificar minhas faltas, para que elas sejam consideradas e não impactem negativamente meu registro. 

    US10Como um Pontista, eu desejoquero solicitar meus períodos de férias diretamente pelo sistema, com notificação ao Supervisor, para que oeu processopossa sejaformalizar formalizadomeu pedido de férias de forma prática e acompanhadoacompanhar peloo meuprocesso.

    Supervisor.

    Critérios

    • Deve permitir indicar o período de férias desejado.

    • Deve notificar o Supervisor sobre a nova solicitação.

    • Deve exibir o status da solicitação para o Pontista.

    • US11US04 - Registrar Ponto

    Como um Pontista, eu desejo poderquero registrar meus horários de entrada e saída,da de forma segura, garantindo que apenas um ponto de entrada e um ponto de saída sejam registrados por dia, para que eu tenhamanter um controle precisoconfiável da minha presença,jornada ausênciasde trabalho.

    Critérios de Aceitação:

      • Deve permitir apenas um ponto de entrada e horasum trabalhadas.de

  • O horário e a direção (entrada/saída) devem ser processados no backend.

  • Deve ser registrado FALTA caso o ponto não seja batido.

    • US12US05 - Visualizar Calendário Pessoal

    Como Pontista, quero acessar um calendário pessoal com marcação de pontos, feriados, faltas e justificativas, para ter uma visão clara da minha frequência e organização do mês.

    Critérios de Aceitação:

      • Deve exibir dias com pontos registrados.

      • Deve indicar feriados e pontos facultativos.

      • Deve destacar dias de falta e justificativas pendentes/aprovadas/reprovadas.

    US06 - Gerenciar Pontistas

    Como Supervisor, eu desejoquero listar e visualizar os perfis dos Pontistas, incluindo saldo de horas devidas e status das justificativas e férias, para que eu possa acompanhar a equipe e realizar asa gestõesgestão necessárias.
    US13Comode umAceitação: Supervisor,
      eu
    • desejo
        visualizar
      • as

        Deve permitir filtrar Pontistas por nome e status.

      • Deve exibir saldo de horas devidas e status de cadajustificativas Pontista,e paraférias.

        que
        • eu
      • possa

        O gerenciaracesso adeve cargaser horáriarestrito daao minhaperfil equipe.Supervisor.
    US14US07 - Aprovar/Rejeitar Justificativas e Férias

    Como um Supervisor,  eu desejoquero aprovar ou rejeitar as justificativas de faltas submetidas pelos Pontistas, para que eu possa validar as ausências e manter os registros precisos.

    US15Como um Supervisor, eu desejo aprovar ou rejeitar os pedidos de férias dos Pontistas, para quemanter euo possacontrole planejarcorreto de presenças e férias da equipe.

    Critérios de Aceitação:

      • Deve permitir visualizar detalhes da justificativa antes da aprovação/rejeição.

      • Deve permitir visualizar o período solicitado de férias antes da decisão.

      • Deve registrar a escaladecisão dado equipeSupervisor (Aprovada/Reprovada).

    US08 - Gerenciar Pontos Facultativos e garantirFeriados
    a cobertura adequada.
    US16

    Como um Supervisor, euquero desejo visualizar, adicionarvisualizar e editar pontos facultativos e feriados locais no calendário, para quemanter o registro de pontocalendário da minha equipe estejaatualizado sempree alinhado com as políticas da empresa.
    Aceitação:

      • Deve permitir cadastrar, editar e excluir pontos facultativos e feriados.

      • Deve exibir os feriados nacionais integrados no calendário.

      • Deve ter confirmação antes de excluir registros.

    US17US09 - Gerar Relatórios de Frequência

    Como um Supervisor, eu desejoquero gerar relatórios de frequência da equipe,equipe por usuário e período e exportá-los em PDF ou Excel, para que eu possa analisar a assiduidade e pontualidade dos Pontistas.

      • Deve permitir escolher usuário(s) e período para o relatório.

      • Deve permitir exportar o relatório em PDF e Excel.

    US18US10 - Histórico de Aprovações e Reprovações

    Como um Supervisor, eu desejoquero visualizar o histórico de minhas aprovações e reprovações (justificativas,justificativas e férias), para que eu tenhater um registro das minhas decisões e possa consultá-las

    Critérios de Aceitação:

      • Deve exibir a lista de aprovações e reprovações com data, usuário afetado e status.

      • Deve ser possível filtrar por tipo (justificativa, férias).

      • O histórico deve ser mantido por no mínimo 6 meses.

    US19US11 - Enviar Mensagens e Notificações

    Como um Supervisor, eu desejoquero enviar mensagens oue notificações aos Pontistas, para que eu possa comunicar informações importantes e alertas de forma prática e rápida.

    Critérios de Aceitação:

    • Deve permitir redigir e enviar mensagens personalizadas.

    • Deve ser possível escolher os destinatários (individual ou alertas.

  • Deve notificar o Pontista de forma clara e rastreável.

    • US20US12 - Cadastrar Novos Usuários

    Como um Administrador, euquero desejocadastrar novos usuários no sistema e atribuir perfis de acesso, para permitir que novas pessoas utilizem a plataforma com os direitos adequados.

    Critérios de Aceitação:

      • Deve permitir escolher o perfil de acesso (Pontista, Supervisor ou Administrador).

      • Deve validar o e-mail antes de salvar.

      • Deve exigir senha segura e confirmação de senha.

    US13 - Configurar Carga Horária Padrão

    Como Administrador, quero configurar a carga horária padrão do sistema, para garantir que os cálculos de horas devidas e banco de horas sejam precisoscorretos para todos os usuários.

      • Deve permitir definir quantidade de horas por dia/semana.

      • Deve ser possível atualizar essa configuração a qualquer momento, com controle de versão.

    US21US14 - Configurar Período de Férias Permitido

    Como um Administrador, eu desejoquero configurar o período de férias permitido aos usuários, para garantir que as solicitações de férias estejam alinhadas com asa políticastica da empresa. 

    US22Como um Administrador, eu desejo cadastrar novos usuários no sistema, para que novas pessoas possam utilizar a plataforma com seus devidos perfis. 

    Critérios de aceitação para as Users Storys

    US01 - Gerenciamento Inicial do Administrador

    Critérios de Aceitação:

      • A criação da conta de Administrador Mestre deve ser configurada por variáveis de ambiente (.env).
      • O sistema deve permitir a criação de apenas uma conta de Administrador Mestre durante a configuração inicial.

    US02 - Acesso do Administrador ao Sistema

    Critérios de Aceitação:

      • O login deve ser realizado utilizando e-mail e senha.
      • As credenciais de login devem ser as mesmas configuradas automaticamente na criação da conta de Administrador Mestre.
      • A autenticação deve ser protegida por Tokens JWT.
      • Nenhuma informação sensível do usuário deve ser armazenada localmente no navegador (LocalStorage). Todas as informações necessárias devem ser gerenciadas e fornecidas pelo backend.

    US03 - Painel de Controle do Administrador

    Critérios de Aceitação:

      • Deve ser possível cadastrar, editar e excluir usuários com os perfis de PONTISTA, SUPERVISOR e ADMINISTRADOR.
      • Validações de identidade e permissões devem ser realizadas a cada operação crítica.
      • Todas as rotas do painel do administrador devem ser protegidas, permitindo acesso exclusivo ao perfil de ADMINISTRADOR.

    US04 - Autenticação Universal

    Critérios de Aceitação:

      • O login deve ser realizado utilizando e-mail e senha em uma única tela de autenticação.
      • A senha fornecida deve ser criptografada antes do armazenamento e verificação.
      • Deve ser possível acessar a funcionalidade de recuperação de senha diretamente da tela de autenticação.
      • A segurança da sessão deve ser garantida por meio de Tokens JWT, com todas as informações gerenciadas pela API e sem armazenamento local no navegador.

    US05 - Visualização de Saldo de Horas

    Critérios de Aceitação:

      • Deve exibir o total de horas negativas (devidas) acumuladas.

    US06 - Visualização de Saldo de Férias

    Critérios de Aceitação:

      • Deve exibir o total de dias de férias que o pontista tem direito e ainda não utilizou.

    US07 - Visualização de Histórico de Ponto

    Critérios de Aceitação:

      • Deve permitir a navegação por datas ou períodos.

    US08 - Calendário Pessoal

    Critérios de Aceitação:

      • O calendário deve indicar dias com pontos registrados, feriados e dias de falta.

    US09 - Justificativa de Faltas

    Critérios de Aceitação:

      • Deve permitir anexar documentos (ex: atestado médico) e/ou inserir texto explicativo.
      • O sistema deve notificar o Supervisor sobre a nova justificativa pendente.
      • Deve ser possível visualizar o status da justificativa (Pendente, Aprovada, Reprovada).

    US10 - Solicitação de Férias

    Critérios de Aceitação:

      • Deve permitir indicar o período desejado.
      • O sistema deve notificar o Supervisor sobre a nova solicitação.

    US11 - Registro de Ponto Diário

    Critérios de Aceitação:

      • Apenas pontistas com sessões ativas devem ser capazes de registrar o ponto.
      • O horário e a direção do ponto (entrada/saída) devem ser fornecidos e processados pelo backend.
      • Deve ser possível registrar no máximo um ponto de entrada e um ponto de saída por dia.
      • Caso não haja registro de ponto (entrada e saída) em um dia útil, o sistema deve registrar FALTA para o usuário.
      • Se for registrado apenas o ponto de entrada em um dia útil, o sistema deve registrar FALTA para o período de saída.

    US12 - Visualização e Filtro de Pontistas

    Critérios de Aceitação:

      • Deve ser possível filtrar a lista de pontistas por nome e status de ponto.

    US13 - Visualização de Saldo de Horas da Equipe

    Critérios de Aceitação:

      • Deve exibir o saldo individual de horas devidas por cada pontista sob sua supervisão.

    US14 - Gestão de Justificativas de Faltas

    Critérios de Aceitação:

      • Deve permitir a visualização do documento/texto da justificativa antes da aprovação/rejeição.

    US15 - Gestão de Pedidos de Férias

    Critérios de Aceitação:

      • Deve permitir visualizar o período solicitado antes da aprovação/rejeição.

    US16 - Gestão de Pontos Facultativos e Feriados Locais

    Critérios de Aceitação:

      • Deve ser possível definir a data e o nome do ponto facultativo.

    US17 - Geração de Relatórios de Frequência

    Critérios de Aceitação:

      • Deve permitir filtrar o relatório por usuário e período.
      • Deve ser possível exportar o relatório em formatos PDF e Excel.

    US18 - Histórico de Aprovações/Reprovações do Supervisor

    Critérios de Aceitação:

      • Deve exibir o tipo de aprovação/reprovação, o usuário afetado e a data.

    US19 - Envio de Mensagens e Notificações aos Pontistas

    Critérios de Aceitação:

      • Deve permitir a criação de mensagens personalizadas.

    US20 - Configuração de Carga Horária Padrão

    Critérios de Aceitação:

      • Deve permitir definir a quantidade de horas padrão por dia/semana.

    US21 - Configuração de Período de Férias Permitido

    Critérios de Aceitação:

      • Deve permitir definir regras para ode acúmulo e utilização de dias de férias.

      • Deve validar se as solicitações seguem as regras configuradas.

    US22US15 - CadastroCriar Conta de NovosAdministrador UsuáriosMestre

    Como Desenvolvedor do Sistema, quero permitir a criação automática da conta de Administrador Mestre via variáveis de ambiente, restringindo a apenas uma conta, para garantir a segurança e centralização da gestão administrativa.

    Critérios de Aceitação:

      • A criação deve ocorrer na configuração inicial do sistema.

      • Deve haver validação para permitir atribuirapenas ouma perfilconta de acessoAdministrador (Pontista,Mestre.

        Supervisor, Administrador) ao novo usuário.

     

    Back to top