~~ODT~~
====== Guia de Implantação - SIGEVENTOS ======

Este guia define os passos para implantação do sistema SIGEventos

Para melhor entender as funcionalidades deste sistema, é importante consultar os seguintes artefatos:

  * [[desenvolvimento:especificacoes:sigeventos:negocio| Documento de negócio]]
  * [[desenvolvimento:especificacoes:sigeventos:principal| Especificações do SIGEventos]]


O projeto do SigEventos é divido em 3 projetos:

  * **SIGEventos**: Contém o código fonte do sistema.
  * **SIGEventosDATABASE**: Contém o versionamento dos scripts SQL do sistema
  * **SIGEventosDOCS**: Contém documentos do SIGEventos, como modelagens das suas entidades.

===== Pré-Requisito =====
  * Definição dos parâmetros corretamente conforme seção abaixo.
  * Popular banco de dados com tabelas envolvidas.

===== Parâmetros do sistema =====

Os parâmetros utilizados no sistema estão contidos na classe ''br.ufrn.sigeventos.interno.parametros.ParametrosGerais''. A tabela abaixo descreve os parâmetros utilizados:

^ Código       ^ Nome    ^ Descrição    ^ Exemplo de valor      ^
|   16_160000_1  |   ENDERECO_AUTENTICIDADE     |URL para realizar autenticação de documentos emitidos pelo SIGEVENTOS          |http://www.sistemas.ufrn.br/eventos/documentos/              |
|   16_160000_2  |   ENDERECO_ACESSO      |URL de acesso ao sig eventos.           |http://www.sigeventos.ufrn.br|
|   16_160000_3  |   ENTIDADE_RESPONSAVEL_EVENTOS_CRIADOS_DE_PROJETOS_SIGAA      |Entidade **Padrão** Responsável pelo Evento para eventos criados a partir de projeto no SIGAA, se o usuário não definir no evento, é impresso o nome da entidade definida aqui.| PRÓ-REITORIA DE EXTENSÃO             |


===== Papéis de Usuários =====

A tabela abaixo descreve os perfis envolvidos:
As permissões são atribuídas no SIGAdmin através do caso de uso [[desenvolvimento:especificacoes:sigadmin:casos_de_uso:portal_da_administracao:config_do_sistema:permissoes:implantar_permissoes|Implantar Permissões]]

^ Nome do papel     ^ Funcionalidade      ^
|        ADMINISTRADOR_SIGEVENTOS|Administrador do sistema, pode fazer coisas administrivas do sistema, como a operação "logar como".**(Usado pelo Setor de TI,  não disponibilizar para os usuários)** |
|        ADMINISTRADOR_EVENTOS   |Administrador de todos os eventos do sistema, poucas pessoas devem ter essa papel, o gestor do sistema, por exemplo  |
|        GESTOR_EVENTO           |Gestor de um Evento específico. Esse é o papel que deve ser dado ao responsável pelo evento.  **(Papel atribuído no próprio sistema, não é gerenciado pelo SigAdmin)** |
|        GESTOR_AVALIACAO_EVENTO |Realiza o parecer final se um trabalho vai ser aprovado ou não **(Papel atribuído no próprio sistema, não é gerenciado pelo SigAdmin)** |
|        AVALIADOR_EVENTO        |Realizar a sua avaliação de trabalhos atribuindo notas a eles. Não tem poder para definir se o trabalho está aprovado ou não. Isso fica por conta do GESTOR_AVALIACAO_EVENTO  **(Papel atribuído no próprio sistema, não é gerenciado pelo SigAdmin)** |

\\
\\
===== Procedimento de carga do banco de dados =====

O Banco de dados do SIGEventos é um schema dentro da base de dados comum.


O SigEventos acessa o banco acadêmico em algumas consultas para saber se o participante do evento é um discente, servidor ou docente.

{{:desenvolvimento:especificacoes:sigeventos:bancos_sigeventos.png?700|}}

Com por exemplo o SQL abaixo:

<code sql>
String sql = " SELECT DISTINCT " +PROJECAO_PESSOA+
 " FROM comum.pessoa p "+
 " LEFT JOIN rh.servidor s ON (s.id_pessoa = p.id_pessoa) "+
 " LEFT JOIN discente d ON (d.id_pessoa = p.id_pessoa) "+
 " INNER JOIN comum.usuario usuario ON usuario.id_pessoa = p.id_pessoa ";
</code>
\\
**Então isso implica que a base de dados de ''comum.usuario'', ''comum.pessoa'', ''rh.servidor'', ''discente'' estejam populadas.   Caso essas tabelas não estejam populadas será possível 
utilizar o SigEventos considerando que todos os usuário sejam usuário externos que possuem uma cadastro próprio dentro do SigEventos.**
\\
\\
\\

==== Tabelas Pré Populadas ====

^ Tabela     ^
|   evento.tipo_evento   |

==== SQLs de criação do banco ====

Para criação do banco de dados do SIGEventos ver os scripts SQLs versionados no projeto  **SIGEventosDATABASE**

\\
\\
\\

===== Deploy do Sistema =====

O SIGEventos roda isolado (com as dependências dentro do EAR do sistema). Para fazer deploy no JBOSS é preciso fazer deploy apenas do artefatos **eventos.ear** e **sharedResources.ear**, conforme imagem abaixo:

{{:desenvolvimento:especificacoes:sigeventos:deploy_sigeentos.png|}}

O SIGEventos roda no **JAVA8**. O JBOSS deve estar rodando sobre essa versão da JVM.

Recomenda-se utilizar o JBOSS disponível do endereço: http://migre.me/sLLui

\\
\\
PS.: O sharedRecources.ear também deve estar isolado. Ou seja as suas dependências devem também estar dentro do diretório lib do EAR.
\\
\\
\\
\\
\\

.