~~ODT~~

<PHP>
echo "<div style='display:block;float:right;'>"; 
echo "Última atualização: ";
ver('', false);
echo "</div>";
</PHP>

====== Associar Fotografias a uma Obra ======

Quando uma [[desenvolvimento:especificacoes:sipac:infra_estrutura:casos_de_uso:obras:obras:cadastrar_obras|obra]] é cadastrada, o gestor de obras, a qualquer momento, pode associar fotografias a esta obra. Essa Associação tem como objetivo estabelecer uma outra forma de acompanhamento das obras, visualizando sua evolução e suas características.

Pré-condição: Ter a obra cadastrada no sistema.

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

Este Caso de Uso está disponível em, SIPAC -> Infra-Estrutura -> Obras -> Obras -> Fotografias -> Associar Fotografias a uma Obra, e inicia com a busca pela obra para a qual deseja-se associar fotografias.

===Passo 1===

O Usuário faz a busca utilizando os parâmetros especificados em [[https://docs.info.ufrn.br/doku.php?id=desenvolvimento:especificacoes:sipac:fluxos:fluxo_busca_requisicao_obra| Busca de Requisição de Obra]]. Neste caso de uso, os atributos abaixo são exibidos:
  * **Origem:** Tipo - TEXTO. Opções: ''EXTERNA'', ''FUNPEC'' e ''UFRN''.
  * **Status:** Tipo - TEXTO. Opções: ''EM ANDAMENTO'', ''EM PROCESSO JUDICIAL'', ''EM RECEBIMENTO PROVISÓRIO'', ''FINALIZADA'' ou ''SUSPENSA''.
  * **Apenas Obras com Fotos:** TIPO - BOLEANO.

O Usuário confirma a busca e o Sistema exibe lista das obras:
  * __**Licitação:**__ Tipo - TEXTO.
  * __**Empresa:**__ Tipo - TEXTO.
  * __**Fiscal:**__ Tipo - TEXTO.
  * __**Período:**__ Tipo - DATA, Formato - DD/MM/AAAA ''a'' DD/MM/AAAA.
  * __**Descrição:**__ Tipo - TEXTO.
  * __**Status:**__ Tipo - TEXTO.

===Passo 2===

O Sistema exibe o resumo da obra, fontes de recursos, fiscais cadastrados e solicita os dados da fotografia.

Resumo da obra:
  * __**Licitação:**__ Tipo - TEXTO.
  * __**Requisição:**__ Tipo - TEXTO.
  * __**Descrição da Obra:**__ Tipo -  TEXTO.
  * __**Unidade:**__ Tipo - TEXTO.
  * __**Fiscal:**__ Tipo - TEXTO.
  * __**Empresa:**__ Tipo - TEXTO.
  * __**Dias:**__ Tipo - NUMÉRICO.
  * __**Status:**__ Tipo - TEXTO.
  * __**Inicio:**__ Tipo - DATA, Formato - dd/mm/aaaa.
  * __**Término:**__ Tipo - DATA, Formato - dd/mm/aaaa.

Exibe as Fontes de Recursos cadastradas. São exibidos os atributos:
  * **__Código__:** TIPO - NUMÉRICO.
  * **__Denominação__:** TIPO - TEXTO.  

Exibe os Fiscais cadastrados. São exibidos os atributos:
  * **__Nome__:** TIPO - TEXTO.
  * **__Cargo__:** TIPO - TEXTO.
  

Dados solicitados da fotografia:
  * **Arquivo *:** Tipo - TEXTO (fotografia que será associada à obra);
  * **Título *:** Tipo TEXTO.
  * **Descrição *:** Tipo - TEXTO.

O Usuário associa a fotografia e o Sistema exibe as fotografias associadas a obra: ( [[#Principais Regras de Negócio| RN01, RN02, RN03, RN04]] )
  * **__Data de Cadastro:__**  Tipo - DATA, FORMATO - DD/MM/AAAA.
  * **__Título:__** Tipo - TEXTO.
  * **__Descrição:__** Tipo - TEXTO.

O Usuário pode visualizar, alterar, excluir e fazer download da fotografia.

**Visualização da Fotografia:** O Sistema exibe a Fotografia, o Título e a Descrição. ( [[#Principais Regras de Negócio| RN04]] )

O Sistema exibe opção para visualizar o Álbum de Fotografias especificado em [[https://docs.info.ufrn.br/doku.php?id=desenvolvimento:especificacoes:sipac:infra_estrutura:casos_de_uso:obras:obras:fotografias:visualizar_album_de_fotos| Visualizar Álbum de Fotos]]

O caso de uso é finalizado.

===== Principais Regras de Negócio =====

  * **RN01**: Apenas são aceitas fotografias cujo tamanho máximo não ultrapasse aos 5Mb.
  * **RN02**: São aceitas imagens dos tipos: .jpg, .jpeg, .gif, .png, .bmp.
  * **RN03**: Não pode existir mais de uma fotografia com o mesmo título.
  * **RN04**: Caso o usuário corrente tenha o papel FISCAL_OBRA ele só poderá associar e visualizar fotos das obras que ele é o fiscal responsável.

==== Resoluções/Legislações Associadas ====

Não se Aplica.  

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

^ Classe ^ Tabela |
| br.ufrn.sipac.supinfra.acompanhamento.dominio.FotoObra | administrativo.infra.foto_obra |
| br.ufrn.sipac.supinfra.acompanhamento.dominio.Obra | administrativo.infra.obra |

===== Plano de Teste =====

Sistema: SIPAC

Módulo: Infra-Estrutura

Link(s): Obras -> Obras -> Fotografias -> Associar Fotografias a uma Obra

Usuário: gustavo (infra-estrutura) e sileno (fiscal)


Papel que usuário deve ter: SipacPapeis.GESTOR_OBRAS, SipacPapeis.FISCAL_OBRA

===== Cenários de Teste =====

Ao associar uma fotografia verificar se o arquivo ao ultrapassar o tamanho de 5Mb a associação não é realizada e uma mensagem de erro é mostrada.

Associar Arquivos que não sejam imagens. Nesse caso não serão aceitos.

Associar fotografia com o título que já esteja presente em outra fotografia associada a mesma obra. Nesse caso não é permitido. Verificar também no caso de alteração.

Observar se o download da fotografia está sendo realizado corretamente.

Logar-se com um usuário portador do papel FISCAL_OBRA e verificar se as obras listadas para ele são apenas as que ele é o fiscal responsável. 

Ainda com este usuário, verificar se é possível associar ou ver fotos de obras nas quais ele não é o fiscal responsável.


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

  * Para associar uma fotografia é necessário informar um arquivo de imagem (jpg, gif, png, etc...) e após informar um título e uma descrição para a mesma.
  * Conferir em [[ desenvolvimento:especificacoes:sipac:infra_estrutura:casos_de_uso:obras:obras:minhas_obras | Minhas Obras]] as obras cujo o fiscal em questão é o responsável.