UC01 - Gerenciar Atividades Educacionais
1. Atores
Atores principais: Professor, Administrador, Moderador
2. Objetivo
Permitir que professores criem atividades educacionais e que professores, administradores e moderadores visualizem, editem e excluam atividades educacionais em suas respectivas páginas no aplicativo.
3. Pré-condições
- O ator deve estar autenticado no aplicativo.
- Para criar atividades, o ator deve possuir perfil de professor.
- Para listar atividades, o ator deve possuir perfil de professor, administrador ou moderador.
- Para editar ou excluir atividades, o ator deve possuir perfil de professor, administrador ou moderador.
- O ator deve acessar a página de atividades correspondente ao seu perfil.
- O sistema deve possuir conexão ativa com o backend.
- O backend deve estar integrado ao banco de dados Firebase/Firestore.
4. Fluxo Principal
FP01 - Criar Atividade Educacional
- O professor acessa a seção de criação de atividade educacional. (RF01)
- O sistema identifica o perfil do ator autenticado. (RF01)
- O sistema valida se o ator possui perfil de professor. (RF01)
- O sistema apresenta o formulário de criação de atividade educacional. (RF01)
- O professor informa o título da atividade. (RF01)
- O professor informa, opcionalmente, a descrição da atividade. (RF01)
- O professor adiciona uma ou mais questões à atividade. (RF01)
- Para cada questão, o professor informa o enunciado, as alternativas disponíveis e a alternativa correta. (RF01)
- O professor confirma a criação da atividade. (RF01)
- O sistema valida os dados obrigatórios da atividade. (RF01)
- O sistema registra a atividade no banco de dados. (RF01)
- O sistema disponibiliza a atividade criada para acesso conforme as permissões dos perfis autorizados. (RF01, RF02)
- O sistema exibe mensagem de sucesso informando que a atividade foi criada. (RF01)
5. Fluxos Alternativos
FA01 - Listar Atividades Educacionais
- O professor, administrador ou moderador acessa sua página de atividades educacionais. (RF02)
- O sistema identifica o perfil do ator autenticado. (RF02)
- O sistema busca as atividades educacionais disponíveis para o perfil do ator. (RF02)
- O sistema exibe a lista de atividades educacionais na página correspondente ao perfil do ator. (RF02)
- O ator visualiza as atividades cadastradas. (RF02)
FA02 - Editar Atividade Educacional
- O professor, administrador ou moderador acessa a lista de atividades cadastradas em sua respectiva página. (RF02, RF05)
- O ator seleciona uma atividade existente. (RF05)
- O sistema carrega os dados atuais da atividade. (RF05)
- O ator altera um ou mais campos da atividade, como título, descrição, questões, alternativas ou alternativa correta. (RF05)
- O ator confirma a edição da atividade. (RF05)
- O sistema valida os dados alterados. (RF05)
- O sistema atualiza o registro da atividade no banco de dados. (RF05)
- O sistema exibe mensagem de sucesso informando que a atividade foi atualizada. (RF05)
FA03 - Excluir Atividade Educacional
- O professor, administrador ou moderador acessa a lista de atividades cadastradas em sua respectiva página. (RF02, RF06)
- O ator seleciona uma atividade existente. (RF06)
- O ator aciona a opção de exclusão. (RF06)
- O sistema solicita confirmação da exclusão. (RF06)
- O ator confirma a exclusão. (RF06)
- O sistema remove a atividade do banco de dados ou altera seu status para indisponível. (RF06)
- O sistema exibe mensagem de sucesso informando que a atividade foi excluída. (RF06)
FA04 - Cancelar Criação ou Edição
- Durante a criação ou edição da atividade, o ator aciona a opção de cancelar ou voltar. (RF01, RF05)
- O sistema descarta alterações não salvas. (RF01, RF05)
- O sistema retorna o ator para a tela anterior. (RF01, RF05)
- Nenhum dado é registrado ou alterado no banco de dados. (RF01, RF05)
6. Fluxos de Exceção
FE01 - Interface Indisponível para o Perfil do Ator
- O professor, administrador ou moderador acessa o aplicativo autenticado. (RF01, RF05, RF06)
- O sistema identifica o perfil do ator autenticado. (RF01, RF05, RF06)
- O sistema exibe apenas as interfaces e ações permitidas para aquele perfil. (RF01, RF05, RF06)
- Caso o perfil do ator não possua permissão para determinada ação, a opção correspondente não é exibida na interface. (RF01, RF05, RF06)
FE02 - Dados Obrigatórios Ausentes
- O professor tenta criar uma atividade ou o professor, administrador ou moderador tenta editar uma atividade sem preencher campos obrigatórios. (RF01, RF05)
- O sistema identifica a ausência de dados obrigatórios. (RF01, RF05)
- O sistema impede o salvamento da atividade. (RF01, RF05)
- O sistema destaca os campos inválidos. (RF01, RF05)
- O sistema orienta o ator a preencher as informações necessárias. (RF01, RF05)
Campos obrigatórios mínimos:
- título;
- pelo menos uma questão;
- enunciado da questão;
- pelo menos duas alternativas;
- uma alternativa correta válida.
FE03 - Alternativa Correta Inválida
- O ator informa uma alternativa correta inexistente ou incompatível com a lista de alternativas durante a criação ou edição da atividade. (RF01, RF05)
- O sistema identifica a inconsistência. (RF01, RF05)
- O sistema impede o salvamento da atividade. (RF01, RF05)
- O sistema exibe mensagem informando que a alternativa correta deve corresponder a uma das alternativas cadastradas. (RF01, RF05)
FE04 - Atividade Indisponível por Estado Desatualizado
- O professor, administrador ou moderador visualiza uma atividade na lista antes da atualização completa do estado no banco ou na interface. (RF02)
- O ator tenta acessar a atividade para edição ou exclusão. (RF05, RF06)
- O sistema revalida a disponibilidade da atividade no backend antes de permitir a operação. (RF05, RF06)
- O sistema identifica que a atividade foi removida, desativada ou tornou-se indisponível. (RF02, RF05, RF06)
- O sistema impede a edição ou exclusão da atividade. (RF05, RF06)
- O sistema atualiza a lista de atividades disponíveis. (RF02)
- O sistema informa que a atividade não está mais disponível para a operação solicitada. (RF02, RF05, RF06)
FE05 - Falha de Conectividade
- O ator tenta criar, listar, editar ou excluir uma atividade sem conexão com o backend. (RF01, RF02, RF05, RF06)
- O sistema não consegue concluir a operação. (RF01, RF02, RF05, RF06)
- O sistema exibe mensagem de falha de conexão. (RF01, RF02, RF05, RF06)
- O sistema orienta o ator a tentar novamente quando a conexão for restabelecida. (RF01, RF02, RF05, RF06)
FE06 - Erro Interno no Banco de Dados
- O ator confirma uma operação válida envolvendo uma atividade educacional. (RF01, RF05, RF06)
- O sistema tenta registrar, atualizar, excluir ou consultar dados no Firestore. (RF01, RF02, RF05, RF06)
- O banco de dados retorna erro ou indisponibilidade. (RF01, RF02, RF05, RF06)
- O sistema cancela a operação. (RF01, RF05, RF06)
- O sistema exibe mensagem de erro interno. (RF01, RF02, RF05, RF06)
7. Regras de Negócio
- RN01 - Perfil autorizado para gerenciar atividades educacionais
- RN02 - Estrutura mínima para criação de atividade
- RN03 - Inativação de atividades sem questões válidas
8. Requisitos Relacionados
| RF | Relação com a UC |
|---|---|
| RF01 - Criar atividade educacional | Permite que professores criem atividades educacionais. |
| RF02 - Listar atividades educacionais para gerenciamento | Permite que usuários autorizados visualizem as atividades educacionais cadastradas. |
| RF05 - Editar atividade educacional | Permite que professores, administradores e moderadores editem o conteúdo de uma atividade educacional. |
| RF06 - Excluir atividade educacional | Permite que professores, administradores e moderadores excluam uma atividade educacional. |
9. Protótipo

Link do Figma: Figma
10. Definition of Ready
Esta seção registra o print do checklist de Definition of Ready utilizado para validar a UC01.
Aplicação do DoR: Issue Uc01
Print do checklist DoR:

11. Fluxo de Acesso à UC
