~~ODT~~ echo "
"; echo "Última atualização: "; ver('', false); echo "
"; ====== Histórico de Um Bem ====== O Gestor de Patrimônio, neste caso de uso, visualiza informações gerais e um histórico de movimentações entre unidades ou alterações no bem como, por exemplo, alteração da responsabilidade ou valor de um bem. ===== Descrição do Caso de Uso ===== Este caso de uso é acessado através do caminho: SIPAC -> Patrimônio -> Consultas -> Bens -> Histórico de um Bem ==== Passo 1==== Primeiramente, ao usuário é requerido que ele selecione um bem para consulta. São exibidos filtros para consulta do bem, conforme descrito no passo 1, da especificação [[desenvolvimento:especificacoes:sipac:patrimonio:casos_de_uso:consultas:bens:consulta_geral:suporte#passo_1|Consulta Geral de Bens]]. ====Passo 2==== Realizada a busca, o sistema exibe a lista dos bens encontrados conforme descrito no passo 2, da especificação [[desenvolvimento:especificacoes:sipac:patrimonio:casos_de_uso:consultas:bens:consulta_geral:suporte#passo_2|Consulta Geral de Bens]]. ====Passo 3==== Ao selecionar um bem, as seguintes informações sobre o bem são exibidas: * **__Bem Original__**: Tipo - NUMÉRICO. Formato: AAAA9999999. É permitido visualizar o [[desenvolvimento:especificacoes:sipac:patrimonio:casos_de_uso:consultas:bens:historico_de_um_bem|Histórico do Bem]] do bem original. ([[#Principais Regras de Negócio|RN05]]) * **__Tombamento__**: Formato - AAAA9999999, tipo - NUMÉRICO. * **__Data Tombamento__**: Tipo - DATA. * **__Data de Garantia__**: Tipo - DATA. * **__Data de Balanço__**: Tipo - DATA. * **__Data do Último Ajuste Contábil__**: Tipo - DATA. * **__Cod. Material__**: Tipo - NUMÉRICO. * **__Estado do Bem__**: Tipo - TEXTO. * **__Grupo de Material__**: Tipo - TEXTO. * **__Status do Bem__**: Tipo - TEXTO. * **__Motivo da Indisponibilidade__**: Tipo - TEXTO ([[#Principais Regras de Negócio|RN01]]). * **__Denominação__**: Tipo - TEXTO. * **__Especificação__**: Tipo - TEXTO. * **__Observações__**: Tipo - TEXTO. * **__Marca__**: Tipo - TEXTO. * **__Unidade Resp.__**: Formato: UNIDADE (CÓDIGO DA UNIDADE). Tipo - TEXTO. * **__Termo/Nota Atual__**: Formato: NÚMERO DO TERMO/ANO DO TERMO, tipo - NUMÉRICO. Permite visualizar as informações sobre o termo de responsabilidade, conforme especificado em [[desenvolvimento:especificacoes:sipac:patrimonio:desenvolvimento:especificacoes:sipac:patrimonio_movel:casos_de_uso:consultas:movimentacoes:termo_de_responsabilidade|Consultar Termo de Responsabilidade]]. * **__Termo de Desmembramento__**: Tipo TEXTO. Permite consultar o termo de desmembramento, conforme especificado no passo 4, da especificação [[desenvolvimento:especificacoes:sipac:patrimonio:casos_de_uso:bens:tombamento:desmembramento_de_bens:suporte#passo_4|Desmembramento de Bens]]. ([[#Principais Regras de Negócio|RN05]]). * **__Finalidade__**: Tipo - TEXTO. * **__Valor Atual do Bem__**: Tipo - NUMÉRICO. * **__Valor de Entrada__**: Tipo - NUMÉRICO. * **__Valor Acumulado__**:Tipo - NUMÉRICO. * **__Valor da Depreciação Acumulada__**:Tipo - NUMÉRICO. ([[#Principais Regras de Negócio|RN17]]) * **__Valor da Amortização Acumulada__**:Tipo - NUMÉRICO. ([[#Principais Regras de Negócio|RN18]]) * **__Valor da Residual__**:Tipo - NUMÉRICO. * **__Vida Útil__**: Tipo - NUMÉRICO. ([[#Principais Regras de Negócio|RN02]]). * **__Vida Útil Base para Depreciação__**: Tipo - NUMÉRICO. ([[#Principais Regras de Negócio|RN02, RN17]]). * **__Vida Útil Base para Amortização__**: Tipo - NUMÉRICO. ([[#Principais Regras de Negócio|RN18]]) * **__Vida Útil Anterior__**: Tipo - NUMÉRICO. ([[#Principais Regras de Negócio|RN02]]). * **__Cadastrado Por__**:Formato: NOME DO USUÁRIO (LOGIN DO USUÁRIO), tipo - TEXTO. * **__Data de Cadastro__**:Tipo - DATA. * **__Data Inicial de Uso__**:Tipo - DATA. * **__Depreciável__**:Tipo - TEXTO. ([[#Principais Regras de Negócio|RN17]]) * **__Amortizável__**: Tipo - TEXTO. ([[#Principais Regras de Negócio|RN18]]) * **__Anulado__**: Tipo - TEXTO. Caso hajam descritores cadastrados para o grupo e subgrupo relacionados a esse bem, o sistema exibirá estes descritores preenchidos. O sistema também traz informações sobre a aquisição do bem. Informações da Aquisição: * **Tipo de Aquisição**: Tipo - TEXTO ([[#Principais Regras de Negócio|RN03]]). * **Termo do Tombamento**: Formato - NÚMERO DO TERMO/ANO DO TERMO, tipo - NUMÉRICO. É permitido visualizar as informações conforme especificado em [[desenvolvimento:especificacoes:sipac:patrimonio:desenvolvimento:especificacoes:sipac:patrimonio_movel:casos_de_uso:consultas:movimentacoes:termo_de_responsabilidade|Consultar Termo de Responsabilidade]]. Informações da Nota: ([[#Principais Regras de Negócio|RN08]]) * **__Fornecedor__**: Tipo TEXTO. * **__Endereço__**: Tipo TEXTO. * **__Nota Fiscal__**: Tipo TEXTO. Formato: NÚMERO DA NOTA - SÉRIE. * **__Data__**: Tipo DATA. * **__Empenho(s)__**: Tipo NUMÉRICO. Formato: 999999/AAAA. Permite visualizar as informações sobre os empenhos da nota, conforme especificado no fluxo [[desenvolvimento:especificacoes:sipac:fluxos:fluxo_detalhe_empenho| detalhe do empenho]]. ([[#Principais Regras de Negócio|RN07]]) Informações sobre Acautelamento: ([[#Principais Regras de Negócio|RN16]]) * **__Número__**: Tipo NUMÉRICO. Formato: 999999/AAAA. Permite visualizar o termo de acautelamento, conforme especificado em [[desenvolvimento:especificacoes:sipac:patrimonio:desenvolvimento:especificacoes:sipac:patrimonio_movel:casos_de_uso:consultas:movimentacoes:termo_de_acautelamento|Consultar Termo de Acautelamento]]. * **__Detentor__**: Tipo TEXTO. * **__Data de Abertura__**: Tipo DATA. * **__Unidade de Acautelamento__**: Tipo TEXTO. * **__Situação__**: Tipo TEXTO. * **__Data Prevista para devolução__**: Tipo DATA. * **__Cadastrador__**: Tipo TEXTO. Tombamentos Gerados a partir de Desmembramento/Manutenção de Coleções: ([[#Principais Regras de Negócio|RN09]]) * **__Tombamento__**: Tipo NUMÉRICO. Formato: AAAA999999. É permitido visualizar o [[desenvolvimento:especificacoes:sipac:patrimonio:casos_de_uso:consultas:bens:historico_de_um_bem|Histórico do Bem]] dos bens originados. * **__Denominação__**: Tipo TEXTO. * **__Total de Bens__**: Tipo NUMÉRICO. O sistema exibe o histórico de alterações no bem, com os campos: ([[#Principais Regras de Negócio|RN10]]) * **__Tipo__**: Tipo - TEXTO. * **__Data__**: Tipo - DATA. * **__Unidade__**: Formato - UNIDADE (CÓDIGO DA UNIDADE), tipo - TEXTO. * **__Valor Alterado__**: Indica o novo valor do bem ou apresenta ícone para download de comprovante da alteração. * **__Justificativa Alteração__**: Tipo - TEXTO. O sistema exibe o histórico de movimentações entre Unidades com os campos ([[#Principais Regras de Negócio|RN04 e RN11]]): * **__Tipo__**: Tipo - TEXTO. * **__Data__**: Tipo - DATA. * **__Unidades__**: Formato - UNIDADE (CÓDIGO DA UNIDADE), tipo - TEXTO (O sistema exibe setas indicando a unidade de envio e a de recebimento). * **__Usuário__**: Formato - LOGIN DO USUÁRIO, tipo TEXTO. * Existe um campo em forma de legenda indicando tanto o nome quanto o ramal do usuário relacionado ao lado da informação do login. * **__Termo__**: Formato - NÚMERO DO TERMO/ANO DO TERMO, tipo - NUMÉRICO. Este campo é um link, caso o Gestor de Patrimônio deseje encontrar mais informações sobre o termo, verifique a especificação: [[desenvolvimento:especificacoes:sipac:patrimonio:desenvolvimento:especificacoes:sipac:patrimonio_movel:casos_de_uso:consultas:movimentacoes:termo_de_responsabilidade|Consultar Termo de Responsabilidade]]. * **__Guia Mov.__**: Formato - NÚMERO DO TERMO/ANO DO TERMO, tipo NUMÉRICO. Este campo é um link, caso o Gestor de Patrimônio deseje encontrar mais informações sobre a guia, verifique a especificação: [[desenvolvimento:especificacoes:sipac:patrimonio:desenvolvimento:especificacoes:sipac:patrimonio_movel:casos_de_uso:consultas:movimentacoes:guia_de_movimentacao_recolhimento|Consultar Guia de Movimentação/Recolhimento]]. O sistema também exibe as movimentações estornadas, com os campos: ([[#Principais Regras de Negócio|RN12]]) * **__Tipo__**: Tipo - TEXTO. //Transferência//, //Devolução//, //Empréstimo//, etc. * **__Unidades de Origem e Destino__**:Tipo - UNIDADE (CÓDIGO DA UNIDADE), tipo - TEXTO (O sistema exibe setas indicando a unidade de envio e a de recebimento). * **__Localidades de Origem e de Destino__**: Tipo - LOCALIDADE - TEXTO * **__Data de Estorno__**: Tipo - DATA. * **__Usuário de Estorno__**: Tipo - TEXTO. Nome do Usuário, com opção para ver o ramal dele. * **__Justificativa__**: Tipo - TEXTO. Justificativa do estorno da movimentação. Informações da Alienação: ([[#Principais Regras de Negócio|RN13]]) * **__Usuário de Cadastro__**: Formato - NOME DO USUÁRIO - CPF (login). Tipo - TEXTO. * **__Data da Alienação__**: Tipo - DATA. * **__Tipo de Alienação__**: Tipo - TEXTO. * **__Número/Ano__**: Formato: 9.../AAAA. Tipo - NUMÉRICO e DATA. * **__Status da Alienação__**: Tipo - TEXTO. * **__Destinatário__**: Tipo - TEXTO. * **__Unidade Gestora__**: Tipo - TEXTO. * **__Processo__**: Tipo - NUMÉRICO. * **__Observações da Alienação__**: Tipo - TEXTO. Também é exibido o conjunto de itens agregados ao bem com os seguintes dados: ([[#Principais Regras de Negócio|RN14]]) * **__Denominação__**: Tipo - TEXTO. * **__Cod. Material__**: Tipo - NUMÉRICO. * **__Quantidade__**: Tipo - NUMÉRICO. * **__Valor do Item__**: Tipo - NUMÉRICO. Caso hajam descritores cadastrados para o grupo e subgrupo relacionados a esse bem, o sistema exibirá estes descritores preenchidos. Ajuste de Valores Contábeis Associados: ([[#Principais Regras de Negócio|RN15]]) * **__Tipo__**: Tipo TEXTO. * **__Data Cadastro__**: Tipo DATA. * **__Unidade Gestora Patrimonial__**: Tipo TEXTO. Formato: SIGLA DA UNIDADE (CÓDIGO DA UNIDADE). * **__Valor do Ajuste__**: Tipo NUMÉRICO. * **__Usuário__**: Tipo TEXTO. Formato: LOGIN DO USUÁRIO. ===== Principais Regras de Negócio ===== ***RN01** - Somente exibido caso o estado do bem seja INDISPONÍVEL, indicando qual o motivo da indisponibilidade, podendo ser : EM AFERIÇÃO, EM PROCESSO e EM MANUTENÇÃO. ***RN02** - Se o bem exibido não tiver vida útil definida, será mostrado o valor Indefinido. ***RN03** - Dependendo do tipo de aquisição do bem, na seção de //Informações da Aquisição//, o sistema exibe os campos que sejam relacionados ao tipo. Exemplos: * **Tipo de Aquisição** = DOADOR. O sistema exibe os campos: **Doador** - nome da pessoa ou instituição que doou o bem, **Doc. de Doação** - número do documento oficializando a doação, **Tipo do Documento** - indica o tipo do documento utilizado para oficializar a doação. * **Tipo de Aquisição** = EMPENHO. O sistema exibe a seção //Informações da Nota// contendo os campos: **Fornecedor** - nome da pessoa física ou razão social da pessoa jurídica que forneceu o bem, **Endereço** - endereço do Fornecedor, **Nota Fiscal** - número e série da nota fiscal, **Data** - data de emissão da nota fiscal, **Empenho(s)** - número e ano do empenho, com link para mais detalhes sobre o empenho. ***RN04** - Somente são mostradas as movimentações temporárias das quais o bem faz parte quando o bem não foi removido dessa movimentação. ***RN05** - Caso o bem tenha sido DESMEMBRADO, os campos **Bem original** e **Termo de Desmembramento** são exibidos. ***RN06** - Caso o bem tenha sido DESMEMBRADO e antes disso DEPRECIADO, o Termo de Apuração de Valor Líquido é exibido. (Regra removida em 07/11/2011, referente a tarefa 74753) ***RN07** - As informações sobre o empenho são exibidas se a nota fiscais associadas forem do tipo orçamentária ou se forem associadas a um ou mais empenhos. (Regra adicionada em 07/11/2011, referente a tarefa 74753) ***RN08** - Os campos referentes a informações da nota são exibidas caso haja notas fiscais associadas a aquisição/tombamento do bem. (Regra adicionada em 07/11/2011, referente a tarefa 74753) ***RN09** - Os campos são exibidos caso o bem tenha sido desmembrado e, portanto, originado outros bens. (Regra adicionada em 07/11/2011, referente a tarefa 74753) ***RN10** - Os campos são exibidos caso o bem tenha sofrido alguma alteração. (Regra adicionada em 07/11/2011, referente a tarefa 74753) ***RN11** - Os campos referentes ao histórico de movimentações são exibidos caso o bem tenha sido movimentado. (Regra adicionada em 07/11/2011, referente a tarefa 74753) ***RN12** - Os campos são exibidos caso o bem tenha movimentações estornadas. (Regra adicionada em 07/11/2011, referente a tarefa 74753) ***RN13** - Caso o bem tenha sido alienado, serão exibidas as informações relacionadas a alienação. (Regra adicionada em 07/11/2011, referente a tarefa 74753) ***RN14** - As informações sobre os itens agregados são exibidas para bens que tiveram itens agregados. (Regra adicionada em 07/11/2011, referente a tarefa 74753) ***RN15** - Caso o bem tenha sofrido ajuste de valor contábil, essas informações são exibidas. (Regra adicionada em 07/11/2011, referente a tarefa 74753) ***RN16** - Somente exibido caso o status do bem seja ACAUTELADO, indicando que o bem está acautelado. ***RN17** - Esse campo não é exibido quando o bem é intangível. (Adicionado em 03/01/2017, referente à tarefa 189782) ***RN18** - Esse campo só é exibido quando o bem é intangível. (Adicionado em 03/01/2017, referente à tarefa 189782) ===== Classes Persistentes e Tabelas Envolvidas ===== ^ Classe ^ Tabela | | br.ufrn.sipac.patrimonio.tombamento.dominio.bem | admnistrativo.patrimonio.bem | ====== Plano de Teste ====== Sistema: SIPAC Módulo: Patrimônio Link(s): Consultas -> Bens -> Histórico de um Bem Usuário: * san(GESTOR_PATRIMONIO_GLOBAL) * adaildo(GESTOR_PATRIMONIO_UNIDADE_GESTORA) * zania(GESTOR_RELATORIO_PATRIMONIO) Papel que usuário deve ter: * SipacPapeis.GESTOR_PATRIMONIO_GLOBAL; * SipacPapeis.GESTOR_PATRIMONIO_UNIDADE_GESTORA; * SipacPapeis.GESTOR_TOMBAMENTO; * SipacPapeis.GESTOR_RELATORIO_PATRIMONIO. ===== Cenários de Teste ===== Checar comportamento da tela quando não encontra bens, quando falta campos a serem preenchidos, e quando seleciona um bem. É necessário [[desenvolvimento:especificacoes:sipac:patrimonio:casos_de_uso:gerencia:alteracoes:bem|alterar]] um bem com objetivo de confrontar seus dados no histórico. ===== Dados para o Teste ===== - Cadastrar movimentações utilizando [[desenvolvimento:especificacoes:sipac:patrimonio:casos_de_uso:gerencia:movimentacoes:enviar_bens|Enviar Bens]]. - Estorná-las usando [[desenvolvimento:especificacoes:sipac:patrimonio:casos_de_uso:gerencia:movimentacoes:estornar_movimentacao|Estornar Movimentação]]. **Observação**: O usuário não pode ser gestor de patrimônio global, senão a movimentação de bem será marcada como recebida automaticamente e não poderá ser estornada.