UC09 - Gerenciar Tipos de Denúncias
1. Atores
Atores principais: Administrador
2. Objetivo
Permitir que administradores criem, visualizem, editem e excluam categorias de denúncias utilizadas pelos usuários durante o registro de denúncias.
3. Pré-condições
- O ator deve estar autenticado no aplicativo.
- O ator deve possuir perfil de administrador.
- O ator deve acessar a página de gerenciamento de categorias de denúncias.
- 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 Categoria de Denúncia
- O administrador acessa a página de gerenciamento de categorias de denúncias. (RF32)
- O sistema identifica o administrador autenticado. (RF32)
- O sistema apresenta a lista de categorias cadastradas e a opção de criar uma nova categoria. (RF32)
- O administrador seleciona a opção de criar categoria. (RF30)
- O sistema apresenta o formulário de cadastro da categoria. (RF30)
- O administrador informa o nome da categoria e, opcionalmente, uma descrição. (RF30)
- O administrador confirma o cadastro. (RF30)
- O sistema valida as informações fornecidas. (RF30)
- O sistema registra a categoria no banco de dados. (RF30)
- O sistema atualiza a lista de categorias. (RF30, RF32)
- O sistema exibe mensagem de sucesso informando que a categoria foi criada. (RF30)
5. Fluxos Alternativos
FA01 - Listar Categorias
- O administrador acessa a página de gerenciamento de categorias. (RF32)
- O sistema busca as categorias cadastradas. (RF32)
- O sistema exibe a lista de categorias disponíveis. (RF32)
- O administrador visualiza as categorias cadastradas. (RF32)
FA02 - Editar Categoria
- O administrador seleciona uma categoria existente. (RF31)
- O administrador aciona a opção de edição. (RF31)
- O sistema carrega as informações atuais da categoria. (RF31)
- O administrador altera os dados desejados. (RF31)
- O administrador confirma a alteração. (RF31)
- O sistema valida as informações fornecidas. (RF31)
- O sistema atualiza a categoria no banco de dados. (RF31)
- O sistema exibe mensagem de sucesso informando que a categoria foi atualizada. (RF31)
FA03 - Excluir Categoria
- O administrador seleciona uma categoria existente. (RF33)
- O administrador aciona a opção de exclusão. (RF33)
- O sistema solicita confirmação da operação. (RF33)
- O administrador confirma a exclusão. (RF33)
- O sistema remove ou inativa a categoria, conforme a existência de denúncias vinculadas. (RF33)
- O sistema atualiza a lista de categorias. (RF33, RF32)
- O sistema exibe mensagem de sucesso informando que a categoria foi removida. (RF33)
FA04 - Cancelar Operação
- Durante a criação ou edição de uma categoria, o administrador seleciona a opção de cancelar ou voltar. (RF30, RF31)
- O sistema descarta as alterações não salvas. (RF30, RF31)
- O sistema retorna para a tela anterior. (RF30, RF31)
- Nenhuma alteração é realizada no banco de dados. (RF30, RF31)
6. Fluxos de Exceção
FE01 - Categoria Duplicada
- O administrador informa o nome de uma categoria já existente. (RF30)
- O sistema verifica as categorias cadastradas. (RF30)
- O sistema identifica a duplicidade. (RF30)
- O sistema impede o cadastro da categoria. (RF30)
- O sistema informa que já existe uma categoria com esse nome. (RF30)
FE02 - Campo Obrigatório Não Preenchido
- O administrador tenta criar ou editar uma categoria sem informar o nome. (RF30, RF31)
- O sistema identifica a ausência do campo obrigatório. (RF30, RF31)
- O sistema impede o salvamento. (RF30, RF31)
- O sistema destaca o campo obrigatório. (RF30, RF31)
FE03 - Categoria Indisponível
- O administrador tenta editar ou excluir uma categoria. (RF31, RF33)
- O sistema verifica a existência da categoria. (RF31, RF33)
- O sistema identifica que a categoria foi removida ou tornou-se indisponível. (RF31, RF33)
- O sistema impede a operação. (RF31, RF33)
- O sistema atualiza a listagem de categorias. (RF32)
FE04 - Usuário Sem Permissão
- Um usuário sem perfil de administrador tenta acessar o gerenciamento de categorias. (RF30, RF31, RF32, RF33)
- O sistema identifica a ausência de permissões administrativas. (RF30, RF31, RF32, RF33)
- O sistema bloqueia o acesso à funcionalidade. (RF30, RF31, RF32, RF33)
- O sistema informa que o acesso é restrito a administradores. (RF30, RF31, RF32, RF33)
FE05 - Falha de Conectividade
- O administrador tenta executar uma operação sem conexão com o backend. (RF30, RF31, RF32, RF33)
- O sistema não consegue concluir a operação. (RF30, RF31, RF32, RF33)
- O sistema exibe mensagem de falha de conexão. (RF30, RF31, RF32, RF33)
- O sistema orienta o administrador a tentar novamente quando a conexão for restabelecida. (RF30, RF31, RF32, RF33)
FE06 - Erro Interno no Banco de Dados
- O administrador confirma uma operação válida envolvendo categorias de denúncias. (RF30, RF31, RF32, RF33)
- O sistema tenta registrar, atualizar, excluir ou consultar dados no Firestore. (RF30, RF31, RF32, RF33)
- O banco de dados retorna erro ou indisponibilidade. (RF30, RF31, RF32, RF33)
- O sistema cancela a operação. (RF30, RF31, RF32, RF33)
- O sistema exibe mensagem de erro interno. (RF30, RF31, RF32, RF33)
7. Regras de Negócio
8. Requisitos Relacionados
| RF | Relação com a UC |
|---|---|
| RF30 - Criar categoria de denúncia | Permite que administradores criem novas classificações para organizar os tipos de denúncia. |
| RF31 - Editar categoria de denúncia | Permite que administradores alterem o título ou descrição de uma categoria existente. |
| RF32 - Listar categorias de denúncia | Permite que o sistema exiba as categorias disponíveis no momento do preenchimento de uma denúncia. |
| RF33 - Excluir categoria de denúncia | Permite que administradores removam categorias de denúncias obsoletas. |
9. Protótipo
UC não foi implementada.
10. Aplicação do DoR
Link da Issue: Uc09
Checklist não aplicado, pois a UC09 não foi desenvolvida no escopo implementado.
11. Fluxo de Acesso à UC
UC não foi implementada.