SGES¶
CSU04 (RF04) — Cadastrar instrutor¶
Matriz de Priorização
Quadro MVP
Cronograma e Planejamento
Objetivo:¶
Permitir o cadastro de novos instrutores.
Ator principal:¶
Gestor
Atores secundários:¶
Nenhum
Pré-condições:¶
O Gestor deve estar autenticado e possuir perfil de acesso administrador.
Fluxo principal:¶
- O Gestor acessa o painel de administração e solicita o cadastro de um novo instrutor. (FE-1-A)
- O sistema exibe o formulário de cadastro solicitando: Nome Completo e E-mail.
- O Gestor preenche as informações e seleciona o perfil de acesso apropriado. (RN04-02)
- O Gestor confirma a operação.
- O sistema valida a unicidade do E-mail, além de garantir o preenchimento de todos os dados obrigatórios. (RN04-01; RN04-02; FE-5-A; FE-5-B; FE-5-C)
- O sistema salva o instrutor, envia à base de dados e gera o registro na trilha de auditoria. (RNF02; FE-6-A)
- O sistema exibe uma mensagem confirmando o cadastro com sucesso.
Fluxos alternativos:¶
Não há fluxos alternativos identificados.
Fluxos de exceção:¶
FE-1-A — Permissão Insuficiente¶
Este fluxo inicia no passo 1 do fluxo principal. Se o usuário autenticado não possuir o perfil de Gestor/Administrador, o sistema bloqueia o acesso, impede a operação e exibe uma mensagem de acesso negado. O caso de uso é encerrado.
FE-5-A — Campos Obrigatórios Ausentes¶
Este fluxo inicia no passo 5 do fluxo principal. Se algum campo obrigatório estiver em branco, o sistema impede a gravação, exibe uma mensagem de alerta e destaca os campos que precisam ser preenchidos. O fluxo retorna ao passo 3 do fluxo principal.
FE-5-B — E-mail já Cadastrado¶
Este fluxo inicia no passo 5 do fluxo principal. Se o e-mail informado já constar na base de dados de outro instrutor, o sistema bloqueia a gravação e apresenta um alerta informando a duplicidade do e-mail. O fluxo retorna ao passo 3 do fluxo principal.
FE-5-C — Dados Inválidos¶
Este fluxo inicia no passo 5 do fluxo principal. Se algum dado fornecido estiver em formato incorreto (ex: e-mail inválido), o sistema impede a gravação e solicita a correção. O fluxo retorna ao passo 3 do fluxo principal.
FE-6-A — Falha de Persistência¶
Este fluxo inicia no passo 6 do fluxo principal. Se ocorrer uma falha ao tentar salvar o instrutor no banco de dados, o sistema aborta a transação, exibe uma mensagem de erro e não altera o estado do sistema. O caso de uso é encerrado.
Regras de negócio:¶
RN04-01 — Unicidade de E-mail¶
O e-mail do instrutor deve ser único na base de dados, impedindo duplicidades.
RN04-02 — Campos Obrigatórios¶
É obrigatório o preenchimento de Nome Completo e E-mail, além da definição do Perfil de Acesso (RBAC).
Requisitos não funcionais:¶
RNF02 — Trilha de Auditoria¶
A criação de perfis de instrutor deve registrar um log automático contendo o ID do Gestor, ação realizada e timestamp.
Pós-condições:¶
O novo instrutor é persistido na base de dados com um identificador exclusivo e o perfil de acesso adequado.