====== Permissão de Acesso a Documentos ======


O processo de permissão de acesso a documentos tem o objetivo de que usuários possam utilizar um determinado documento ou tipo de documento no [[https://docs.info.ufrn.br/doku.php?id=desenvolvimento:especificacoes:siged:estudo:proposta_ged_ufrn|SIGED]] e qual o tipo de permissão que eles possuem, se é escrita ou apenas leitura.


===== Descrição do Caso de Uso =====

Para cadastrar a Permissão de Documento para um usuário deve ser seguido os passos abaixo:

   * Informar para quem deseja dar a permissão (para um usuário específico, para um grupo de usuários ou para todo um papel)

   * Informar o nome do usuário o grupo ou o papel.

   * Infomar o Tipo de Documento selecionando Sim ou Não para escrita e para a leitura e clicar em Adicionar. 

   * OU

   * Clicar nas pastas da árvore de documentos, escolher os documentos, marcar o tipo de permissão (leitura e/ou escrita) e clicar em Adicionar

   * Após escolher todos os documentos e tipos de documentos, clicar em confirmar para efetuar o cadastro das permissões.
===== Principais Regras de Negócio =====

  * **RN01** - Uma permissão pode ser associada a um papel, a um usuário ou a um grupo de usuários
  * **RN02** - Uma permissão pode ser associada a um tipo de documento ou a um documento
  * **RN03** - Se for associado a um usuário, apenas o usuário possui a permissão
  * **RN04** - Se for associado a um grupo de usuários, todos os usuários do grupo possuem a permissão
  * **RN05** - Se for associado a um papel, todos os usuários que possuem o papel possuem a permissão
  * **RN06** - Se for associado a um documento, a permissão é para esse documento exclusivamente
  * **RN07** - Se for associado a um tipo de documento, a permissão é para todos os documentos desse tipo

===== Classes Persistentes e Tabelas Envolvidas =====

^ Classe ^ Tabela |
| br.ufrn.siged.dominio.PermissaoDocumento | sistemas_comum.ged.permissao_documento |
====== Plano de Teste ======

Sistema: SIGED

Módulo: Administração

Link(s): Administração -> Permissões -> Tipo de Documento

Papel que usuário deve ter: SigedPapeis.GESTOR_SIGED

Usuários: david, gleydson
===== Cenários de Teste =====

  - Cadastrar uma permissão de leitura para um documento ou tipo de documento, verificar se o usuário está podendo acessá-lo através da busca e da listagem de documentos
  - Cadastrar uma permissão de escrita para um documento ou tipo de documento, verificar se o usuário está podendo cadastrar documentos do tipo especificado ou se está podendo alterar o documento para o qual foi dada a permissão.

===== Dados para o Teste =====

  * Escolher para quem se dará a permissão. Escolher qualquer usuário, qualquer papel ou qualquer grupo.

  * Cadastrar permissões para quaisquer tipos de documentos ou documentos.

  * Verificar se o usuário possui realmente a permissão para acessar o documento.