~~ODT~~

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

====== Fórum ======

O fórum tem o intuito de servir de apoio para a troca de idéias, envio de dúvidas, troca de experiência. O mesmo é utilizado no âmbito interno do sistema, podendo ser acessado por todos os usuários do iProject.

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

O caso de uso inicia quando o usuário acessa //iProject -> Interações -> Fórum//.

Inicialmente é exibido uma busca nos fóruns, permitindo que seja realizada uma busca através do campo:
  * **Texto para busca***. Tipo - TEXTO. 

A seguir é exibida uma lista com os fóruns cadastrados, exibindo para cada um as seguintes informações:
  * **__Título__**: Tipo TEXTO.
  * **__Assuntos__**: Tipo NUMÉRICO.
  * **__Mensagens__**: Tipo NUMÉRICO.
  * **__Última Atualização__**: Tipo TEXTO, formato: DD/MM/AAAA HH:MM:SS usuário: LOGIN. 
  * **__Descrição__**: Tipo TEXTO.

É estabelecida a seguinte estrutura de níveis:
  * //**Fórum**//: Neste nível apenas usuários com permissão de gerente podem criar/alterar/remover fóruns.
  * //**Assunto**//: Neste nível apenas usuários com permissão de gerente podem criar/alterar/remover assuntos.
  * //**Tópicos**//: Neste nível qualquer usuário do iProject pode criar tópicos. Para alterar/remover o usuário deve ter permissão de gerente.
  * //**Comentários**//: Neste nível qualquer usuário do iProject pode criar comentário. Para alterar/remover o usuário deve ter permissão de gerente.

Para cada um dos fóruns são mostradas as seguintes opções:
  * //[[desenvolvimento:especificacoes:iproject:casos_de_uso:interacao:visualizar_forum|Visualizar Fórum]]//
  * //Alterar Fórum// : Permite a alteração dos dados principais do fórum inseridos no cadastro ([[#principais_regras_de_negocio|RN01]]).
  * //Remover Fórum// : Permite a remoção do fórum ([[#principais_regras_de_negocio|RN01]]).
  * //Inscrever//: Permite que o usuário se inscreva no fórum. 
  * //Desinscrever//: Permite que o usuário deixe o fórum ao qual se inscreveu. 

Os fóruns que são de //**Visualização Externa**// ([[#principais_regras_de_negocio|RN03]]) são indicados. Já os que não possuem tal marcação não são visíveis aos usuários de cooperação técnica.

Também é possível cadastrar um novo fórum, fornecendo as seguintes informações:
  * **Título***: Tipo TEXTO.
  * **Descrição***: Tipo TEXTO.
  * **Visualização Externa**: Tipo TEXTO, são apresentadas as opções: SIM e NÃO.
  * **E-mail Notificação:**: Tipo TEXTO.

Seguindo a hierarquia também é possível cadastrar um novo assunto e/ou posteriormente um tópico, fornecendo as seguinte informações:
  * **Título***: Tipo TEXTO.
  * **Descrição***: Tipo TEXTO.

Semelhantemente, é possível cadastrar um comentário, fornecendo a seguinte informação:

  * **Comentário***: Tipo TEXTO. É possível publicar com código Java, XML, HTML, JavaScript, CSS ou SQL.

Em relação aos comentários que são exibidos, o usuário pode utilizar das seguintes opções:

  * //Alterar Comentário//, que apenas exibe o comentário para fins de alteração.
  * //Remover Comentário//, que o remove mediante uma confirmação positiva.
  * //Citar Comentário//, exibe o conteúdo do comentário selecionado em um a ser criado pelo usuário.

O caso de uso é finalizado.


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

  * **RN01** - Apenas gerentes tem permissão para criar, alterar ou remover fóruns.
  * **RN02** - Apenas gerentes tem permissão para criar, alterar ou remover assuntos.
  * **RN03** -  Caso o fórum seja marcado para visualização externa, será permitido que os usuários vinculados a cooperação técnica, possam postar comentários.
  * **RN04** - Ao enviar o e-mail automático quando são postadas mensagens nos fóruns, adicionar um link que aponte diretamente para a mensagem no fórum.
  * **RN05** - Quando o usuário se inscrever, para acompanhamento, toda e qualquer publicação (mensagens e comentários) que esteja abaixo do nível do fórum que o usuário se inscreveu, deverá ser mandado e-mail também para o mesmo.

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

Não se Aplica. 

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

^ Classe ^ Tabela |
| br.com.jeebrasil.iproject.forum.dominio.TopicoForum | sistemas_comum.iproject.topico_forum |
| br.com.jeebrasil.iproject.forum.dominio.SubForum | sistemas_comum.iproject.topico_sub_forum |
| br.com.jeebrasil.iproject.forum.dominio.MensagemForum | sistemas_comum.iproject.mensagem_forum |
| br.com.jeebrasil.iproject.forum.dominio.ComentarioMensagemForum | sistemas_comum.iproject.comentario_mensagem_forum |


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

Sistema: iProject

Link(s): Interação -> Fórum

Usuário: dalton (gerente), alyppyo (funcionário do projeto)

Papel que usuário deve ter: Não se aplica.


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

Utilizar diversos tipos de usuários para verificar se ao marcar o fórum como sendo de visualização externa/interna está aparecendo corretamente para os diversos tipos de usuários.

Para cadastrar usuários externos utilize o caso de uso //**iProject -> Administração -> Projeto -> Cadastrar Usuário de Projeto**// (usuário:gleydson).

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

Não se aplica.