~~ODT~~ ====== Guia de Implantação - Módulo Patrimômio ====== Este guia de implantação tem por objetivo abordar os diversos aspectos que devem ser preenchidos para o correto funcionamento do sistema. Serão abordados os parâmetros envolvidos, papéis dos usuários e as tabelas que devem ser preenchidas para o correto funcionamento do sistema. ==== 1. Glossário ==== * SIPAC – Sistema Integrado de Patrimônio, Administração e Contratos; * Banco de Dados – Armazenamento de dados, relacionado com SGBDR, mesmo que base de dados; * SGBDR – Sistema de gerenciamento de banco de dados relacional; * SQL – Linguagem de pesquisa declarativa para banco de dados relacional; * Postgres – Um sistema gerenciador de banco de dados relacional, mesmo que PostgreSQL; * ETL (Extract, Transform, Load) – Extrair, Transformar e Carregar, termo usado para dar carga em SGBDR, usado ao importar ou exportar dados oriundos de um sistema legado para um SGBDR; * Entidade – Tabela em um banco de dados; * Atributo – Coluna ou campo de uma tabela em banco de dados; * Tupla – Registro ou linha de uma ocorrência em uma tabela; * DMR/MR – Diagrama Modelo Relacional; * Dicionário de Dados – É uma coleção de metadados, isto é, dados sobre os dados, que contêm definições e representações de elementos de dados; * Popular tabela – Preencher uma entidade ou tabela com dados. === 1.1 Referências === Para a compreensão deste módulo é importante a consulta dos seguintes artefatos: * [[desenvolvimento:especificacoes:sipac:patrimonio:principal|Especificações de requisitos dos casos de uso do módulo de patrimônio]] * [[suporte:manuais:sipac:patrimonio_movel::lista|Manuais dos casos de uso do módulo de patrimônio]] === 1.2 Pré-Requisitos=== * Definição dos parâmetros corretamente conforme seção abaixo. * Popular banco de dados com entidades envolvidas. === 1.3 Observações === - Nas descrições das entidades a seguir, pode ser encontrada a lista de valores possíveis para alguns campos. Em alguns casos, esses valores não correspondem a uma referência para a chave ou campo de outra entidade. Mas normalmente, os valores listados são correspondentes à chave primária da tabela referenciada onde os valores estão efetivamente armazenados. Portanto, deve-se considerar o preenchimento dessas entidades como pré-requisito para o preenchimento do campo da entidade que está sendo descrita; - Algumas entidades podem possuir campos com o sufixo “_ascii” (ex.“denominacao_ascii”) que armazenam textos sem acentuação com o objetivo de melhorar o processo de busca da informação pelo sistema. Por exemplo, uma busca pelo campo “denominacao” da tabela patrimonio.bem, será feita sobre o campo “denominacao_ascii” pois é um campo indexado e permite uma localização mais precisa das informações; - Para facilitar o preenchimento dos campos com o sufixo “_ascii”, pode ser utilizada a função chamada “sem_acento” do esquema public, passando como parâmetro o valor do campo que se deseja criar o seu correspondente ASCII. - Com o objetivo de ampliar e facilitar entendimento, todas as tabelas e colunas do módulo de Patrimônio foram documentadas, no banco, com o uso da cláusula SQL apropriada para comentários, COMMENT ON, que podem ser visualizados com o uso do programa pgAdmin III, conforme exemplo mostrada na Figura 1 . {{ :desenvolvimento:especificacoes:sipac:guia_de_implantacao:exemplo_de_comentários_no_postgresql.jpg?direct&1000 |}} (Figura 1 - Exemplo de comentários no PostgreSQL) ==== 2. Parâmetros do sistema ==== == Os parâmetros utilizados no módulo de patrimônio estão definidos nas classes: == * br.ufrn.sipac.parametro.dominio.ParametrosGerais: ** parâmetros compartilhados por vários módulos do SIPAC. ** * br.ufrn.sipac.parametro.dominio.ParametrosPatrimonio: ** parâmetros específicos do módulo de patrimônio. ** * br.ufrn.sipac.parametro.dominio.ParametrosGestoraPatrimonio: ** parâmetros específicos do módulo de patrimônio que podem variar por unidade gestora do gestor de patrimônio. Os seus valores podem ser definidos pelo próprio gestor de patrimônio.** {{ :desenvolvimento:especificacoes:sipac:guia_de_implantacao:parâmetros_relativos_ao_sipac_-_patrimônio.jpg?direct&800 |}} (Quadro 1 - Parâmetros do Sistema Relativos ao SIPAC - Patrimônio) === 2.1 Timers === Tarefas assíncronas são aquelas executadas sem que haja uma necessidade de resposta imediata. Diversas operações dos sistemas institucionais devem ser feitas assincronamente, por exemplo, enviar email diariamente para o gestor de patrimônio com dados dos termos de acautelamento em atraso. Uma tarefa assíncrona é representada por uma classe br.ufrn.arq.task.TarefaTimer, representada por uma Thread. No momento em que se desejar criar uma tarefa assíncrona nos sistemas, deve-se criar uma classe quer herda TarefaTimer e inserir um registro na tabela INFRA.REGISTRO_TIMER (Banco SISTEMAS_COMUM) que possuirá informações sobre a periodicidade que a tarefa assíncrona e em que servidor será executada. No caso do módulo de patrimônio, existem os as seguintes classes timers: {{ :desenvolvimento:especificacoes:sipac:guia_de_implantacao:timers.jpg?direct&800 |}} === 2.2. Parâmetros do Arquivo terminologia.properties === Algumas exibições de propriedades na camada de visão são controladas pelo arquivo terminologia.properties situado no pacote br.ufrn.sipac.arq.util do projeto SIPAC, contendo no total quatro parâmetros: * **patrimonio.nome_documento_tombamento** Utilizado para definir o nome do documento que é criado no ato de tombamento de bens patrimoniais. Ex: “Termo de Responsabilidade”, “Nota de Recebimento”. * **patrimonio.nome_documento_transferencia** Utilizado para definir o nome do documento que é criado após as movimentações de bens, tais como transferência, recolhimento, empréstimo/ devolução. Ex: “Termo de Transferência”, “Termo de Responsabilidade”. * **material.nome_grupo_material** Utilizado para definir a nomenclatura utilizada no sistema para a denominação do elemento de despesa detalhado (conceito contábil) . Ex: “Grupo de Material”, “Elemento de Despesa Detalhado”. * **material.nome_sub_grupo_material** Utilizado para especificar mais ainda a catalogação de material, atualmente é necessário para cadastrar um material vinculá-lo a um elemento de despesa detalhado (grupo do material), mas tem-se a opção de vinculá-lo a um destes e em seguida vinculá-lo a um subelemento de despesa (subgrupo de material) associado ao elemento de despesa detalhado. Ex: “Subgrupo de Material”, “Subelemento de Despesa”. ==== 3. Papéis de Usuários==== A tabela abaixo descreve os perfis envolvidos no módulo de patrimônio. {{ :desenvolvimento:especificacoes:sipac:guia_de_implantacao:papeis_dos_usuarios.jpg?direct&800 |}} ==== 4. Carga do Banco de Dados. ==== Este tópico descreve os procedimentos para ETL, no nosso caso Carga do Banco de Dados do módulo de patrimônio, citaremos as principais entidades envolvidas, seus pré-requisitos, dependências, os relacionamentos; serão descritos no decorrer deste tópico através de Diagramas Modelo Relacional, de todo o módulo através do Anexo B, além dos atributos destas entidades. Uma visão geral de todo o módulo de patrimônio, poderá ser vislumbrada através do dicionário de dados no Anexo A Quadro 1 e Quadro 2 e do Diagrama Modelo Relacional de todo o módulo, encontrado no Anexo B. Tomamos por SGBDR base, onde serão importados os dados, o PostgreSQL versão 8.3. ==== 4.1 Cadastro de Material, Grupo, Sub-grupo e Descritores ==== As entidades envolvidas nesta parte do módulo de patrimônio são usadas nos vários módulos existentes no SIPAC. É a base para todo o módulo de patrimônio, a figura 2 mostra o modelo relacional desta parte. {{ :desenvolvimento:especificacoes:sipac:guia_de_implantacao:modelo_relacional_cadastro_de_material_grupo_subgrupo_e_descritores.jpg?direct&1200 |}} (Figura 2 - Modelo Relacional Cadastro de Material, Grupo, Subgrupo e Descritores) ==== 4.1.1 Entidade comum.grupo_material ==== A entidade comum.grupo_material armazena os grupos de materiais e indica um relacionamento 1 x N entre a entidade comum.material. Um grupo_material pode ter vários materiais ou nenhum. A Figura 2 apresenta o modelo relacional da entidade comum.grupo_material e Figura 3 apresenta um exemplo de preenchimento desta entidade. {{ :desenvolvimento:especificacoes:sipac:guia_de_implantacao:preechimento_de_entidade_comum.jpg?direct&800 |}} (Figura 3 - Exemplo de preenchimento da entidade comum.grupo_material.) == 4.1.1.1 Pré-requisitos == Para que a entidade comum.grupo_material conforme exemplo citada na figura 3, seja populada, é necessário que entidade sco.elemento_despesa esteja povoada com a qual ela mantém relacionamento através do atributo id_elemento_despesa que é chave estrangeira para entidade grupo_material. Abaixo segue descrição da entidade que necessita ser populada antes. Entidade sco.elemento_despesa (Entidade que armazena os elementos de despesas.) === 4.1.2 Entidade comum.unidade_medida === A entidade comum.unidade_medida armazena as unidade de medidas de materiais e indica um relacionamento 1 x N entre a entidade comum.material. Uma unidade de medida pode ter apenas vários materiais e um material só pode ter uma unidade de medida. A Figura 4 apresenta o modelo relacional da tabela comum.unidade_medida. {{ :desenvolvimento:especificacoes:sipac:guia_de_implantacao:preechimento_de_entidade_comum.unidade_medida.jpg?direct&600 |}} (Figura 4 - Exemplo de preenchimento da entidade comum.unidade_medida.) == 4.1.2.1 Pré-requisitos == Não existem. === 4.1.3 Entidade comum.sub_grupo_material === A entidade comum.sub_grupo_material armazena os subgrupos de materiais e indica um relacionamento N x 1 entre a entidade comum.grupo_material. Um subgrupo só pertence a um grupo de material e um grupo de material pode ter vários subgrupos. A Figura 5 apresenta o modelo relacional da tabela comum.sub_grupo_material. {{ :desenvolvimento:especificacoes:sipac:guia_de_implantacao:exemplo_de_preenchimento_da_entidade_comum.sub_grupo_material.jpg?direct&600 |}} (Figura 5 - Exemplo de preenchimento da entidade comum.sub_grupo_material.) == 4.1.3.1 Pré-requisitos == Para que a entidade comum.sub_grupo_material seja populada, é necessário que esteja populada a entidade comum.grupo_material com a qual ela mantém relacionamento através do atributo id_gupo_material que é chave estrangeira para a entidade grupo_material. Abaixo segue descrição da entidade que necessita ser populada antes. Entidade comum.grupo_material (Entidade que armazena os grupos materiais.) === 4.1.4 Entidade comum.material === A entidade comum.material armazena os materiais. O quadro abaixo mostra o dicionário de dados desta entidade. {{ :desenvolvimento:especificacoes:sipac:guia_de_implantacao:dicionário_de_dados_da_entidade_comum.material.jpg?direct&1200 |}} (Quadro 3 - Dicionário de dados da entidade comum.material.) == 4.1.4.1 Pré-requisitos == Para que a entidade comum.material seja preenchida é recomendável o preenchimento prévio destas entidades. * Item de lista não ordenadaEntidade comum.grupo_material * Item de lista não ordenada Entidade comum.unidade_medida * Item de lista não ordenadaEntidade comum.marca_produto * Item de lista não ordenadaEntidade almoxarifado.almoxarifado * Item de lista não ordenadaEntidade comum.usuario * Item de lista não ordenadaEntidade comum.solicitacao_cad_material * Item de lista não ordenadaEntidade comum.material * Item de lista não ordenadaEntidade comum.sub_grupo_material === 4.1.5 Observações === As entidades abaixo, usadas nos catálogo de materiais, são opcionais caso não use catálogo de material, é recomendável o preenchimento via sistema: comum.descritor_grupo_valor (Armazena o valor de um descritor para um determinado material) comum.descritor_grupo_material (Armazena os Descritores disponíveis para associação com Materiais de acordo com seu Grupo.) comum.descritor_grupo_opcao_valor (Entidade que representa a listagem dos valores dos descritores de materiais do tipo LISTA) comum.descritor_sub_grupo (Representa um descritor associado a determinado subgrupo de material). ==== 4.2 Tombamento ==== As principais entidades que envolvem a parte de tombamento do patrimônio representam todo o ciclo de tombamento de um bem. A Figura 6 mostra o modelo relacional das entidades que compõem a parte de Tombamento. As entidades envolvidas nesta parte do módulo de patrimônio são usadas nos vários módulos existentes no SIPAC. É a base para todo o módulo de patrimônio e de alguns módulos do SIPAC como um todo, no Anexo A, Quadro 2 encontra-se o dicionário de dados desta entidades, a figura 5 mostra o modelo relacional desta parte. É de extrema importância que o parâmetro ESTRATEGIA_TOMBAMENTO, cujo código é 1_600_62 esteja com o caminho da classe que representa a estratégia de tombo. A estratégia de tombamento é responsável pela geração do tombo, exibição e impressão de etiquetas. Atualmente existem três tipos de estratégias: * **1.0 - br.ufrn.sipac.patrimonio.tombamento.negocio.GeracaoTomboSequencial** A geração de tombo seqüencial consiste na exibição de tombo na formatação seguindo a seqüência dos bens tombados anteriormente. Gravando no banco somente o valor da seqüência. Por ex: 0000000001 , 0000000100 * **2.0 - br.ufrn.sipac.patrimonio.tombamento.negocio.GeracaoTomboSequencialAno** A geração de tombo seqüencial ano, consiste na gravação e exibição dos números de tombamento a partir do ano agregado com a seqüência. A seqüência sempre será zerada a medida que muda o ano. Por ex: 2010000001, 2009000001 * **3.0 -br.ufrn.sipac.patrimonio.tombamento.negocio.GeracaoTomboSequencialAnoUG** A geração de tombo seqüencial ano e unidade gestora consiste na exibição de tombos a partir do ano agregado com a seqüência adicionado da sigla da unidade gestora de tombamento. A junção de duas colunas da entidade patrimônio.bem (num_tombamento + id_ug_tombamento) . Sempre zerando a seqüência quando o ano muda ou a gestora de tombamento é diferente das demais que já tombaram. Por ex: 2010000001UFRN, 2010000001BCZM, 2010000002UFRN === 4.2.1 Descritores Globais (Criação de Número Antigo para Migração do Sistema Legado)=== Os descritores globais são entidades com as propriedades de um descritor comum, mas por ser global, o sistema os trará para preenchimento (a depender do seu destino “Bem” ou “Material” ou “Ambos”.) , independente do grupo de material do bem ou material selecionado. Por exemplo: Tenho um descritor do tipo Memória do grupo 5235 e um descritor global Número Antigo para o grupo 5200, ao tombar um bem do grupo 5235 , ele trará o descritor Memória , como também trará os descritores globais, no caso aí Número Antigo. Para cadastrar descritores globais, é necessário colocar um grupo de material como global. Para isso basta solicitar o comando abaixo: --SETANDO O GRUPO 5200 COMO GLOBAL UPDATE COMUM.GRUPO_MATERIAL SET GRUPO_GLOBAL = TRUE WHERE CODIGO = 5200; Com o grupo 5200 atualizado como grupo global, todos os descritores cadastrados para o tal, serão considerados globais. Para cadastrar um descritor para armazenar o número de tombo do sistema legado, ir em: SIPAC -> Portal Administrativo -> Requisições -> Material -> Catálogo -> Gestão do Catálogo -> Cadastrar Descritor de Material. Exemplo para preenchimento de dados: * Grupo: 5200 EQUIPAMENTOS E MATERIAL PERMANENTE * Nome: Tombamento Antigo (OU CONFORME DESEJAREM) * Descrição: Armazena o número de tombamento do bem usado no sistema legado anterior ao SIPAC.(OU CONFORME DESEJAREM) * Obrigatório: Não (OU CONFORME DESEJAREM) * Destino: Bem * Tipo: Alfanumérico (OU CONFORME DESEJAREM) * Após a execução desses passos: * Durante o tombamento (por qualquer estratégia: empenho, outros tipos de entrada), aparecerá para preenchimento o valor para este descritor para qualquer material permanente * Na consulta geral e na consulta simplificada de bens caso a se consulte por algum grupo do material permanente irá aparecer a opção de filtrar pelo descritor global também. === 4.2.2 Entidades auxiliares, tipos === As entidades: * patrimonio.tipo_documento_tombamento; * patrimonio.indisponibilidade_bem; * patrimonio.tipo_entrada_bem; * patrimonio.finalidade_bem; * patrimonio.tipo_alienacao; * patrimonio.tipo_finalidade_levantamento; * patrimonio.tipo_chamado_patrimonial; * patrimonio.finalidade_movimentacao Compõem as entidades de tipos, isto é, auxiliares, conforme figura 5, não existem relacionamentos obrigatórios, mas é recomendável que sejam previamente preenchidas, segue exemplos destas entidades conforme figuras 7, 8, 9, 10, 11,12,13,14. {{ :desenvolvimento:especificacoes:sipac:guia_de_implantacao:entidades_auxiliares_7.jpg?direct&800 |}} \\ {{ :desenvolvimento:especificacoes:sipac:guia_de_implantacao:entidade_patrimonio.tipo_documento_tombamento.jpg?direct&500 |}} (Figura 7 - Exemplo de preenchimento da entidade patrimonio.tipo_documento_tombamento) \\ \\ \\ {{ :desenvolvimento:especificacoes:sipac:guia_de_implantacao:entidades_auxiliares_8.jpg?direct&800 |}} \\ {{ :desenvolvimento:especificacoes:sipac:guia_de_implantacao:entidade_patrimonio.indisponibilidade_bem.jpg?direct&500 |}} (Figura 8 - Exemplo de preenchimento da entidade patrimonio.indisponibilidade_bem.) \\ \\ \\ {{ :desenvolvimento:especificacoes:sipac:guia_de_implantacao:entidades_auxiliares_9.jpg?direct&800 |}} \\ {{ :desenvolvimento:especificacoes:sipac:guia_de_implantacao:entidade_patrimonio.tipo_entrada_bem.jpg?direct&500 |}} (Figura 9 - Exemplo de preenchimento da entidade patrimonio.tipo_entrada_bem.) \\ \\ \\ {{ :desenvolvimento:especificacoes:sipac:guia_de_implantacao:entidades_auxiliares_10.jpg?direct&800 |}} \\ {{ :desenvolvimento:especificacoes:sipac:guia_de_implantacao:entidade_patrimonio.finalidade_bem.jpg?direct&300 |}} (Figura 10 - Exemplo de preenchimento da entidade patrimonio.finalidade_bem.) \\ \\ \\ {{ :desenvolvimento:especificacoes:sipac:guia_de_implantacao:entidades_auxiliares_11.jpg?direct&800 |}} \\ {{ :desenvolvimento:especificacoes:sipac:guia_de_implantacao:entidade_-_patrimonio.tipo_alienacao.jpg?direct&300 |}} (Figura 11 - Exemplo de preenchimento da entidade patrimonio.tipo_alienacao.) \\ \\ \\ {{ :desenvolvimento:especificacoes:sipac:guia_de_implantacao:entidades_auxiliares_12.jpg?direct&800 |}} \\ {{ :desenvolvimento:especificacoes:sipac:guia_de_implantacao:entidade_patrimonio.tipo_finalidade_levantamento.jpg?direct&600 |}} (Figura 12 - Exemplo de preenchimento da entidade patrimonio.tipo_finalidade_levantamento.) \\ \\ \\ {{ :desenvolvimento:especificacoes:sipac:guia_de_implantacao:entidades_auxiliares_13.jpg?direct&800 |}} \\ {{ :desenvolvimento:especificacoes:sipac:guia_de_implantacao:entidade_patrimonio.tipo_chamado_patrimonial.jpg?direct&500 |}} (Figura 13 - Exemplo de preenchimento da entidade patrimonio.tipo_chamado_patrimonial.) \\ \\ \\ {{ :desenvolvimento:especificacoes:sipac:guia_de_implantacao:entidades_auxiliares_14.jpg?direct&800 |}} \\ {{ :desenvolvimento:especificacoes:sipac:guia_de_implantacao:entidade_patrimonio.finalidade_movimentacao.jpg?direct&500 |}} (Figura 14 - Exemplo de preenchimento da entidade patrimonio.finalidade_movimentacao.) \\ \\ \\ == 4.2.2.1 Pré-requisitos == Não existem. === 4.2.3 Entidade patrimonio.bem === A entidade patrimonio.bem armazena os bens propriamente dito, e indica uma entidade central dentro do contexto de patrimônio e se relaciona com quase todas as entidades do mesmo. O Anexo B mostra um Diagrama Modelo Relacional do módulo de patrimônio no qual está envolvida a entidade patrimonio.bem e no Anexo A, Quadro 2 encontra-se o dicionário de dados desta entidade e das demais que compõem o módulo supra citado, na figura 15 é mostrado um exemplo resumo de preenchimento desta entidade e no quadro 3 é mostrado o dicionário de dados desta mesma entidade. {{ :desenvolvimento:especificacoes:sipac:guia_de_implantacao:exemplo_de_preenchimento_da_entidade_patrimonio.bem..jpg?direct&1000 |}} (Figura 15 - Exemplo de preenchimento da entidade patrimonio.bem.) {{ :desenvolvimento:especificacoes:sipac:guia_de_implantacao:dicionário_de_dados_da_entidade_patrimonio.bem..jpg?direct&1200 |}} (Quadro 4 - Dicionário de Dados da entidade patrimonio.bem.) == 4.2.3.1 Pré-requisitos == Para que a entidade patrimonio.bem seja populada com sucesso, basicamente é necessário prévio preenchimento destas entidades abaixo relacionadas: comum.marca_produto comum.material comum.pessoa comum.unidade comum.usuario liquidacao.item_nota_fiscal patrimonio.bem patrimonio.doador patrimonio.finalidade_bem patrimonio.indisponibilidade_bem patrimonio.local_bem patrimonio.termo_responsabilidade patrimonio.tipo_documento_tombamento patrimonio.tipo_entrada_bem É recomendável também o preenchimento prévio das tabelas auxiliares, isto é, tabela de tipos citadas no tópico 4.2.1 . ==== 4.4 Transferência de Bens ==== As entidades envolvidas dizem respeito, a transferência de bens do patrimônio; que neste caso é a transferência do domínio de um bem para outrem, mudança de responsabilidade, podendo ser empréstimo ou não; são ilustradas através do Diagrama Modelo Relacional conforme figura 16; faz necessário o preenchimento prévio da entidade patrimonio.bem. (Figura 16 - Modelo Relacional Transferência de Bens) {{ :desenvolvimento:especificacoes:sipac:guia_de_implantacao:modelo_relacional_transferência_de_bens.jpg?direct&1000 |}} === 4.4.1 Entidade movimentacao.bem === Responsável pelo registro de movimentação de bens do patrimônio . Em diversas operações do patrimônio utiliza-se essa entidade como base do histórico de determinado bem == 4.4.1.1 Pré-requisitos == Não existem, porém recomenda-se o povoamento da entidade patrimonio.bem. ==== 4.5 Alienação ==== As entidades envolvidas dizem respeito, a alienação de um bem de patrimônio, que neste caso, é quando um bem entra no desuso, isto é, o bem deixa de ser útil, conforme mostrado na figura 17; faz necessário o preenchimento prévio da entidade patrimonio.bem. {{ :desenvolvimento:especificacoes:sipac:guia_de_implantacao:modelo_relacional_alienação.jpg?direct&1000 |}} (Figura 17 - Modelo Relacional Alienação.) === 4.5.1 Entidade patrimonio.alienacao === A entidade patrimonio.alienacao armazena as alienações de bens de patrimônio, na figura 18 ilustra um exemplo de preenchimento desta entidade. {{ :desenvolvimento:especificacoes:sipac:guia_de_implantacao:exemplo_de_preenchimento_da_entidade_patrimonio.alienacao.jpg?direct&1000 |}} (Figura 18 - Exemplo de preenchimento da entidade patrimonio.alienacao) == 4.5.1.1 Pré-requisitos == Não existem, entretanto recomenda-se o povoamento prévio das entidades auxiliares designadas no tópico 4.2.1 Entidades auxiliares, tipos, em particular a entidade patrimonio.tipo_alienacao. Entidade patrimonio.tipo_alienacao (Entidade que armazena os tipos de alienações um bem.) === 4.5.2 Entidade patrimonio.item_alienacao === A entidade patrimonio.item_aliencao armazena os itens de alienações de bens de patrimônio e indica um relacionamento obrigatório 1 x N com a entidade patrimonio.alienacao. {{ :desenvolvimento:especificacoes:sipac:guia_de_implantacao:exemplo_de_preenchimento_da_entidade_patrimonio.item_alienacao.jpg?direct&500 |}} (Figura 19 - Exemplo de preenchimento da entidade patrimonio.item_alienacao) == 4.5.2.1 Pré-requisitos == Entidade entidade patrimonio.alienacao (Entidade que armazena as alienações de um bem.) === 4.5.3 Entidade patrimonio.local_bem === A entidade patrimonio.local_bem armazena os locais designados de uma unidade tipo: salas, divisões, escritórios, etc., podendo ser as divisões de uma planta de um imóvel, indica o local onde um bem pode está, a figura 20 apresenta um exemplo de preenchimento desta entidade. {{ :desenvolvimento:especificacoes:sipac:guia_de_implantacao:exemplo_de_preenchimento_da_entidade_patrimonio.local_bem..jpg?direct&1000 |}} (Figura 20 - Exemplo de preenchimento da entidade patrimonio.local_bem.) == 4.5.3.1 Pré-requisitos == Entidade comum.unidade (id_unidade) (Entidade que armazena as unidades de uma intituição) ==== 4.6 Movimentação Temporária ==== As entidades envolvidas dizem respeito, a movimentação temporária de bens do patrimônio. Define-se como movimentações temporárias as transferências de bens para unidades externas, não vinculadas a instituição, geralmente bens que saem da instituição com data marcada para voltar, conserto de um bem por exemplo; um Diagrama Modelo Relacional é apresentado conforme figura 21. {{ :desenvolvimento:especificacoes:sipac:guia_de_implantacao:modelo_relacional_movimentação_temporária.jpg?direct&1000 |}} (Figura 21 - Modelo Relacional Movimentação Temporária.) === 4.6.1 Entidade patrimonio.movimentacao_temporaria === A entidade patrimonio.movimentacao_temporaria armazena as transferências de bens para unidades externas, não vinculadas a instituição . == 4.6.1.1 Pré-requisitos == Entidade patrimonio.movimentacao_temporaria_bem; (Entidade que armazena as movimentações temporárias de um bem) === 4.6.2 Entidade patrimonio.movimentacao_temporaria_bem === A entidade patrimonio.movimentacao_temporaria_bem armazena as transferências de bens para unidades externas, não vinculadas a instituição e indica um relacionamento 1 x N entre a entidade patrimonio.movimentacao_temporaria e relacionamento 1 x N entre a entidade patrimonio.bem. == 4.6.2.1 Pré-requisitos == Entidade patrimonio.movimentacao_temporaria; (Entidade que armazena as movimentações temporárias de um bem) Entidade patrimonio.bem; (Entidade que armazena os bem de patrimônio) Entidade patrimonio.finalidade_movimentacao; (Entidade que armazena o tipo de movimentação temporária) ==== 4.7 Cautela ==== As entidades envolvidas dizem respeito, a cautela de bens do patrimônio. Define-se como cautela de bens a responsabilidade de um ou mais bens para determinado servidor (funcionário público), que guardará o(s) bem(ns) com cautela e precaução ; um Diagrama Modelo Relacional é apresentado conforme figura 22, no Anexo A, Quadro 2 encontra-se o dicionário de dados desta entidades. {{ :desenvolvimento:especificacoes:sipac:guia_de_implantacao:modelo_relacional_cautela.jpg?direct&1000 |}} (Figura 22 - Modelo Relacional Cautela) === 4.7.1 Entidade patrimonio.cautela === A entidade patrimonio.cautela armazena as cautelas dos servidores (funcionários públicos) responsável por um determinado bem de patrimônio, a figura 23 apresenta um exemplo de preenchimento desta entidade. {{ :desenvolvimento:especificacoes:sipac:guia_de_implantacao:exemplo_de_preenchimento_da_entidade_patrimonio.cautela..jpg?direct&1000 |}} (Figura 23 - Exemplo de preenchimento da entidade patrimonio.cautela.) == 4.7.1.1 Pré-requisitos == Entidade comum.usuario; (Entidade que armazena os usuário, logins, senha dos usuários cadastrado no sistema) Entidade rh.servidor; (Entidade que armazena os servidores (funcionário públicos) registrados na instituição) Entidade comum.unidade; (Entidade que armazena as unidades de uma instituição) === 4.7.2 Entidade patrimonio.item_cautela === A entidade patrimônio.item_cautela armazena os itens da cautela (detalhes) dos servidores (funcionários públicos) responsável por um determinado bem de patrimônio, a figura 24 apresenta um exemplo de preenchimento desta entidade. {{ :desenvolvimento:especificacoes:sipac:guia_de_implantacao:exemplo_de_preenchimento_da_entidade_patrimônio.item_cautela..jpg?direct&1000 |}} (Figura 24 - Exemplo de preenchimento da entidade patrimônio.item_cautela.) == 4.7.2.1 Pré-requisitos == Entidade patrimonio.bem; (Entidade que armazena os bens de patrimônios) Entidade patrimonio.cautela; (Entidade que armazena as cautelas dos servidores (funcionários públicos) ==== 4.8 Chamado Patrimonial ==== As entidades envolvidas dizem respeito, ao chamado patrimonial de bens do patrimônio. Define-se como chamado patrimonial; um Diagrama Modelo Relacional é apresentado conforme figura 25, no Anexo A, Quadro 2 encontra-se o dicionário de dados desta entidades. {{ :desenvolvimento:especificacoes:sipac:guia_de_implantacao:modelo_relacional_chamado_patrimonial.jpg?direct&1000 |}} (Figura 25 - Modelo Relacional Chamado Patrimonial) ==== 4.9 Levantamento Patrimonial ==== As entidades envolvidas dizem respeito, ao levantamento patrimonial de bens do patrimônio. Define-se como levantamento patrimonial o processo de se levantar os bens de determinado setor para saber quais bens de patrimônio estão lá; um Diagrama Modelo Relacional é apresentado conforme figura 26, no Anexo A, Quadro 2 encontra-se o dicionário de dados desta entidades. {{ :desenvolvimento:especificacoes:sipac:guia_de_implantacao:modelo_relacional_levantamento_patrimonial.jpg?direct&1000 |}} (Figura 26 - Modelo Relacional Levantamento Patrimonial) ==== 4.10 Termos de Responsabilidade, Termo Notas, Protocolo. ==== As entidades envolvidas estão nos Diagramas Modelo Relacional e é apresentado conforme figuras 27, 28, 29, no Anexo A, Quadro 2 encontra-se o dicionário de dados desta entidades. {{ :desenvolvimento:especificacoes:sipac:guia_de_implantacao:modelo_relacional_termo_de_responsabilidade.jpg?direct&300 |}} (Figura 27 - Modelo Relacional Termo de Responsabilidade.) \\ \\ \\ {{ :desenvolvimento:especificacoes:sipac:guia_de_implantacao:modelo_relacional_protocolo_de_documento_termo_nota.jpg?direct&300 |}} (Figura 28 - Modelo Relacional Protocolo de Documento Termo Nota.) \\ \\ \\ {{ :desenvolvimento:especificacoes:sipac:guia_de_implantacao:modelo_relacional_alteração_termo_nota.jpg?direct&900 |}} (Figura 29 - Modelo Relacional Alteração Termo Nota.) \\ \\ \\ ==== 4.11 Unidade de Conciliação.==== A entidade envolvida é patrimonio.unidade_conciliacao, define-se como unidades de conciliação, determinadas unidades criadas com a finalidade de alocar bens que não possuem destino definido ou em caso de desconhecimento da localização de um bem. Os bens cuja localização é desconhecida são transferidos para essa unidade a fim de que possa identificar quais e quantos bens estão nessa situação para averiguação física. No Diagrama Modelo Relacional e é apresentado esta entidade conforme figura 30, no Anexo A, Quadro 2 encontra-se o dicionário de dados desta entidades. {{ :desenvolvimento:especificacoes:sipac:guia_de_implantacao:modelo_relacional_unidade_conciliação.jpg?direct&300 |}} (Figura 30 - Modelo Relacional Unidade Conciliação.) ==== 4.12 Localidade. ==== As entidades envolvidas refletem um cenário em que os bens de patrimônio, são localizados por salas, sub-salas departamentos, e seus responsáveis; no Diagrama Modelo Relacional é apresentado conforme figura 31, no Anexo A, Quadro 2 encontra-se o dicionário de dados desta entidades. {{ :desenvolvimento:especificacoes:sipac:guia_de_implantacao:modelo_relacional_localidade.jpg?direct&600 |}} (Figura 31 - Modelo Relacional Localidade.) \\ \\ {{ :desenvolvimento:especificacoes:sipac:guia_de_implantacao:dicionário_de_dados_da_entidade_patromonio.local_bem.jpg?direct&1200 |}} (Quadro 5 - Dicionário de dados da entidade patrimônio.local_bem) == 4.12.1.1 Pré-requisitos == Entidade comum.registro_entrada; Entidade comum.unidade; === 4.12.1 Entidade patrimonio.local_bem === A entidade patrimonio.local_bem armazena os locais de bens, mantém um relacionamento não obrigatório com patrimonio.responsavel_local_bem e obrigatório com comum.unidade {{ :desenvolvimento:especificacoes:sipac:guia_de_implantacao:exemplo_de_preenchimento_da_entidade_patrimonio.local_bem.jpg?direct&1000 |}} (Figura 32: Exemplo de preenchimento da entidade patrimonio.local_bem) == 4.12.1.1 Pré-requisitos == Entidade patrimonio.local_bem; (Entidade que armazena os locais dos bens de patrimônio) Entidade comum.unidade (Entidade que armazena as unidades de uma instituição) === 4.12.2 Entidade patrimonio.responsavel_local_bem === A entidade patrimonio.responsavel_local_bem armazena o vínculo da localização do bem junto com o servidor (funcionário público) responsável pelo local. {{ :desenvolvimento:especificacoes:sipac:guia_de_implantacao:exemplo_de_preenchimento_da_tabela_patrimonio.responsavel_local_bem.jpg?direct&700 |}} (Figura 33: Exemplo de preenchimento da tabela patrimonio.responsavel_local_bem) == 4.12.2.1 Pré-requisitos == Entidade rh.servidor (Entidade que armazena os servidores (funcionário públicos) de uma instituição) == 4.12.2.2 Tabela de Movimentação de Bens == Desde o momento do tombamento de um bem, já é gerado um registro na entidade movimentacao_bem, dentre outras operações. É de grande importância que ao se migrar a entidade patrimonio.bem , também migrar a entidade movimentacao_bem. As operações que envolve criação de tuplas nessa entidade são representadas pela classe de constantes br.ufrn.sipac.patrimonio.movimentacao.dominio.TipoMovimentacao persistindo na coluna tipo_movimentacao: * **Devolução de Bens** \\ Quando determinado bem é emprestado de uma unidade/localidade para outra, é necessário devolvê-lo para a unidade de origem , tal movimentação é representado pelo valor da constante “1”. O bem deve estar previamente sob efeitos do tipo de movimentação EMPRESTIMO para se efetuar a devolução. Tal movimentação gera guia de movimentação ( numero_guia e ano_guia são populados) mas não gera termo de responsabilidade(campos relacionados a termo são nulos) * **Empréstimo de Bens** \\ Quando determinado bem é emprestado de uma unidade/localidade para outra , representado pelo valor da constante “2”. Tal movimentação não gera termo de responsabilidade (campos relacionados a termos são persistidos nulos), mas assim como devolução, gera-se guia de movimentação (campos numero_guia e ano_guia são populados). * **Recolhimento de Bens** \\ Quando há necessidade de recolher um bem para ser alienado ou para outra operação a critério do gestor, tal movimentação é representada pelo valor da constante “3”. O estado do bem (representado pela coluna patrimonio.bem.estado_bem) fica como RECOLHIDO. (Representado pela constante: br.ufrn.sipac.patrimonio.tombamento.dominio.TipoEstadoBem com o valor “4”). * **Transferência de Bens** \\ Quando há necessidade de se transferir um bem de uma unidade/localidade para outra, mudando sua responsabilidade, é gerado guia de movimentação(campos numero_guia e ano_guia são populados) , como também é gerado um novo termo de responsabilidade(campos relacionados a termo de são populados), esse tipo de movimentação é representada pelo valor da constante “4”. * **Alienação de Bens** \\ Quando se há uma alienação de bens, além de alterar o status do bem(patrimonio.bem.status) para ALIENADO, se gera uma movimentação do cujo valor da constante é “10”. * **Tombamento** \\ Sempre quando determinado bem é tombado, gera-se uma movimentação do tipo TOMBAMENTO, cujo valor do tipo de movimentação é “13”. Os campos referente a termo (somente id_termo_novo) é populado , e não é gerado guia de movimentação (campos ano_guia e numero_guia não são populados). O status do bem (patrimonio.bem.status) fica como da unidade responsável cujo valor é 1. * **Alteração de Local** \\ Utilizado para quando se muda a localidade de um bem para outra localidade, não há geração de termo de responsabilidade, ou guia de movimentação, se gera uma movimentação cujo valor é “14”. * **Anulação** \\ Movimentação que representa a anulação de um tombo de determinado bem, geralmente utilizado para cadastros errôneos. Não se gera termo , nem guia de movimentação, e tal movimentação é representado pelo valor “20”. Além de se criar uma movimentação, se altera também o atributo do bem “anulado” para true. * **Reativar Anulação** \\ Movimentação que representa a reativação de um tombo já anulado, para isso é necessário que no bem , já esteja presente a movimentação do tipo anulação. Não se gera guia ou termo de responsabilidade, e tal movimentação é representada pelo valor “21”. Além de se criar uma movimentação , se altera também o atributo do bem “anulado” para false. * **Alteração de Finalidade** \\ Movimentação que representa a alteração de finalidade de determinado bem. Não há guia de movimentação ou termo de responsabilidade gerados. E tal movimentação possui o valor “7”. Além de se alterar a coluna “id_finalidade_bem” da entidade patrimonio.bem. * **Agregação** \\ Movimentação que representa a agregação em cima do valor de um bem. Tal movimentação não gera guia , nem termo associado. Porém, o campo “valor” deve ser populado. Além de alterar também a coluna “valor” da entidade patrimonio.bem. Essa movimentação é representada pelo valor “8”. * **Supressão** \\ Movimentação que é responsável pela supressão em cima do valor de um bem. Tal movimentação não gera guia, nem termo associado. Porém, o campo “valor” deve ser populado. Além de alterar também a coluna “valor” da entidade patrimonio.bem. Essa movimentação é representada pelo valor “9”. * **Transferência de Unidade Reserva Técnica** \\ Quando há uma transferência de bens, caso a unidade de origem daquele bem (patrimonio.bem.id_unidade_resp_atual) seja uma unidade de reserva técnica, a movimentação ao invés de ser transferência será transferência de reserva técnica. Representado pelo valor “30”. Há geração de guia de movimentação e termo de responsabilidade. * **Alteração Valor do Bem** \\ Quando há alteração em alguma propriedade do bem, como denominação , especificação, ou até mesmo descritores, é gerado uma movimentação sem guia de movimentação ou termo associados. Representado pelo valor “ 31”. * **Movimentação Temporária** \\ Quando determinado bem sofre movimentação temporária, é gerado uma movimentação sem guia ou termo associado. Cujo valor é representado por “32”. * **Tombamento Bem de Terceiros** \\ Quando determinado bem é tombado por outros tipos de entrada, e caso esse tipo de entrada seja de bem de terceiro, é gerado uma movimentação não de TOMBAMENTO, mas de TOMBAMENTO DE BEM DE TERCEIROS. Representado pelo valor “33”. Além de se gerar a movimentação, as seguintes propriedades da entidade patrimonio.bem são alteradas: valor_bem_terceiros (ao invés da coluna valor) e bem_terceiro (para true). * **Depreciação** \\ Quando determinado grupo de material é escolhido como depreciável, todos os bens que estão associados aquele grupo de material sofrem movimentação, tal movimentação possui como valor “34”. Na entidade patrimônio.bem é preenchida a coluna “data_ultima_depreciacao”. ==== 4.13 Anexos ==== {{:desenvolvimento:especificacoes:sipac:guia_de_implantacao:guia_de_implantacao_patrimonio_anexo_a.pdf| Tipos de Dados nos SGBDR relacionados e Dicionário de Dados}} {{:desenvolvimento:especificacoes:sipac:guia_de_implantacao:guia_de_implantacao_patrimonio_anexo_b.pdf| Diagrama Modelo Relacional do SIPAC - Módulo de Patrimônio}}