Requisitos junto com Users Storys

Requisitos Funcionais

ID	Descrição do Requisito Funcional
RF01	Permitir o login de usuários com e-mail e senha.
RF02	Suportar dois perfis de acesso: Supervisor e Usuário Comum (Pontista).
RF03	Oferecer funcionalidade de recuperação de senha via e-mail (SNTP).
RF04	Permitir ao Pontista visualizar o saldo de horas devidas.
RF05	Permitir ao Pontista visualizar o saldo de dias de férias disponíveis.
RF06	Exibir ao Pontista o histórico de registros de ponto por data.
RF07	Apresentar um calendário pessoal ao Pontista, com marcação de pontos, feriados e faltas.
RF08	Permitir ao Pontista justificar faltas com upload de documentos e/ou texto.
RF09	Notificar o Supervisor sobre novas justificativas de faltas pendentes.
RF10	Exibir ao Pontista o status da justificativa (Pendente, Aprovada, Reprovada).
RF11	Permitir ao Pontista solicitar períodos de férias.
RF12	Permitir ao Supervisor listar e visualizar perfis de Pontistas, com filtro por nome e status de ponto.
RF13	Permitir ao Supervisor visualizar as horas devidas de cada Pontista.
RF14	Permitir ao Supervisor aprovar ou rejeitar justificativas de faltas.
RF15	Permitir ao Supervisor aprovar ou rejeitar pedidos de férias.
RF16	Permitir ao Supervisor visualizar pontos facultativos e feriados no calendário.
RF17	Permitir ao Supervisor adicionar e editar pontos facultativos locais.
RF18	Permitir ao Supervisor gerar relatórios de frequência (por usuário, período) e exportá-los em PDF/Excel.
RF19	Exibir ao Supervisor o histórico de aprovações/reprovações (justificativas, férias).
RF20	Permitir ao Supervisor enviar mensagens ou notificações aos Pontistas.
RF21	Permitir o registro de ponto de entrada/saída com horário automático.
RF22	Exibir o histórico de pontos por mês.
RF23	Marcar feriados nacionais e pontos facultativos no calendário.
RF24	Controlar dias úteis e carga horária.
RF25	Enviar e-mails de notificação (justificativa, solicitação de férias, mudança de status).
RF26	Exibir notificações internas (alerta de ponto atrasado, solicitações pendentes para Supervisor).
RF27	Registrar logs de alterações (quem aprovou, quando).
RF28	Manter histórico completo de atividades por Pontista.
RF29	Permitir a exportação de dados para fins de auditoria ou backup.
RF30	Permitir o cadastro de novos usuários.
RF31	Fazer a gestão de permissões (para futura expansão).
RF32	Permitir a configuração da carga horária padrão.
RF33	Permitir a configuração do período de férias permitido.
RF34	Suportar integração com outros sistemas via API (futuramente).
RF35	Permitir a criação automática da conta de Administrador Mestre via variáveis de ambiente.
RF36	Restringir o sistema à criação de apenas um Administrador Mestre.
RF37	Assegurar que as validações de identidade sejam feitas a cada operação crítica.
RF38	Proteger as rotas de administração para acesso exclusivo do perfil ADMIN.
RF39	Permitir o registro de apenas um ponto de entrada e um ponto de saída por dia.
RF40	Registrar FALTA caso o pontista não bata o ponto no dia.
RF41	Registrar FALTA* (período de saída) caso haja apenas ponto de ENTRADA no dia.

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 $l e$ 200ms, banda $g e$ 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

ID	História de Usuário 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.
US02	Como 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.
US03	Como um Administrador Mestre, eu desejo acessar um painel exclusivo, para que eu possa cadastrar e gerenciar diferentes tipos de usuários no sistema.
US04	Como 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.
US05	Como um Pontista, eu desejo visualizar meu saldo de horas devidas, para que eu saiba se preciso compensar horas ou se tenho banco de horas positivo.
US06	Como um Pontista, eu desejo visualizar meus dias de férias disponíveis, para que eu possa planejar minhas próximas férias.
US07	Como um Pontista, eu desejo visualizar meu histórico de registros de ponto por data, para que eu possa acompanhar minhas presenças e identificar possíveis inconsistências.
US08	Como um Pontista, eu desejo ter um calendário pessoal no sistema, para que eu possa ver meus dias de trabalho, feriados e faltas de forma organizada.
US09	Como um Pontista, eu desejo poder justificar minhas faltas, para que elas sejam consideradas e não impactem negativamente meu registro.
US10	Como um Pontista, eu desejo solicitar meus períodos de férias pelo sistema, para que o processo seja formalizado e acompanhado pelo meu Supervisor.
US11	Como um Pontista, eu desejo poder registrar meus horários de entrada e saída, para que eu tenha um controle preciso da minha presença, ausências e horas trabalhadas.
US12	Como um Supervisor, eu desejo listar e visualizar os perfis dos Pontistas, para que eu possa acompanhar a equipe e realizar as gestões necessárias.
US13	Como um Supervisor, eu desejo visualizar as horas devidas de cada Pontista, para que eu possa gerenciar a carga horária da minha equipe.
US14	Como um Supervisor, eu desejo aprovar ou rejeitar as justificativas de faltas submetidas pelos Pontistas, para que eu possa validar as ausências e manter os registros precisos.
US15	Como um Supervisor, eu desejo aprovar ou rejeitar os pedidos de férias dos Pontistas, para que eu possa planejar a escala da equipe e garantir a cobertura adequada.
US16	Como um Supervisor, eu desejo visualizar, adicionar e editar pontos facultativos locais no calendário, para que o registro de ponto da minha equipe esteja sempre alinhado com as políticas da empresa.
US17	Como um Supervisor, eu desejo gerar relatórios de frequência da equipe, para que eu possa analisar a assiduidade e pontualidade dos Pontistas.
US18	Como um Supervisor, eu desejo visualizar o histórico de minhas aprovações e reprovações (justificativas, férias), para que eu tenha um registro das minhas decisões e possa consultá-las
US19	Como um Supervisor, eu desejo enviar mensagens ou notificações aos Pontistas, para que eu possa comunicar informações importantes ou alertas.
US20	Como um Administrador, eu desejo configurar a carga horária padrão do sistema, para que os cálculos de horas devidas e banco de horas sejam precisos para todos os usuários.
US21	Como um Administrador, eu desejo configurar o período de férias permitido aos usuários, para que as solicitações de férias estejam alinhadas com as políticas da empresa.
US22	Como 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 o acúmulo e utilização de dias de férias.

US22 - Cadastro de Novos Usuários

Critérios de Aceitação:

Deve permitir atribuir o perfil de acesso (Pontista, Supervisor, Administrador) ao novo usuário.