Páginas filhas
  • ER_PCREQ-10316_PEP_Justificativa_de_Interação_Medicamentosa

 Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico.                                                             

Especificação

Produto

PEP

Módulo

Prontuário Eletrônico

Segmento Executor

Saúde

Projeto¹

S_SAU_HIS_20152016

IRM¹

PCREQ-10078

Requisito¹

PCREQ-10316

SubTarefa¹

SAU_DEV-4331

Chamado²

 

Release de Entrega Planejada

12.1.11.0

Réplica

 

País

(X) Brasil  (  ) Argentina  (  ) Mexico  (  ) Chile  (  ) Paraguai  (  ) Equador
(  ) USA  (  ) Colombia   (  ) Outro _____________.

Outros

 



Objetivo

Ajustar os campos no cadastro de Interação Medicamentosa do RM, apresentar alerta e justificativa para interação medicamentosa na Prescrição Médica.

Definição da Regra de Negócio


RN001 – Fazer as seguintes modificações no cadastro de Interação Medicamentosa do RM:

  • Alterar o label do RM de "Classificação de Risco" para "Classificação de Risco / Nível de Interação";
  • Alterar o label do RM de "Observação" para "Observação / Risco";
  • Acrescentar o campo "Ação" (campo texto).


As regras a seguir deverão ser consideradas para o PEP com o RM e com o HIS:


RN002 – Acrescentar no alerta de interação medicamentosa a informação do campo "Observação / Risco" (HIS > Estoque > Cadastros > Cadastro de Princípios Ativos > Interações Medicamentosas e RM > Cadastros > Cuidados com o Paciente > Prescrição Médica > Interações Medicamentosas). Caso o campo "Observação / Risco" esteja em branco no cadastro, o label "Observação / Risco" não deverá ser apresentado na mensagem.


RN003 – O alerta de interação medicamentosa é apresentado atualmente somente no painel de medicamentos. Além do painel de medicamentos, o mesmo deverá ser apresentado em:

  • Soros e Componentes;
  • Insulinas (Insulina Fixa e Variável: Hipoglicemia e Hiperglicemia);
  • Inalações.


RN004 – O alerta de interação medicamentosa deve ser apresentado, também, entre os painéis. Exemplo: se for prescrito um componente (no painel de Soros e Componentes) que interage com um medicamento já prescrito (no painel de medicamentos), o sistema deverá apresentar a mensagem de interação medicamentosa.


RN005 Criar configuração por unidade: "Obrigar a justificativa por interação medicamentosa na Prescrição Médica". A mesma deverá ficar disponível em Adm. do Sistema > Configurações > Configurações por Unidade.


RN006 Para os casos de Interação Medicamentosa, acrescentar o campo "Justificativa – Interação Medicamentosa" ao Prescrever um:

  • Soros e Componentes;
  • Medicamentos;
  • Insulinas (Insulina Fixa e Variável: Hipoglicemia e Hiperglicemia);
  • Inalações.

Assim, como o alerta, o campo de justificativa também deve ser apresentado entre painéis.

OBS: Se a opção "Obrigar a justificativa por interação medicamentosa na Prescrição Médica" estiver selecionada, o preenchimento do campo "Justificativa – Interação Medicamentosa" deve ser obrigatório. Atenção: Se o medicamento A interagir com o medicamento B e a justificativa for informada no medicamento B, o sistema não deverá obrigar o preenchimento da justificativa no medicamento A.


RN007 – As justificativas deverão ficar visíveis na frase da Prescrição Médica (para itens pendentes de liberação e itens já liberados), Planejamento Terapêutico - PLT (aprazamento e checagem) e Histórico Clinico em forma de Tooltip.

Se o medicamento A interagir com o medicamento B e a justificativa for informada no medicamento B, a informação do Tooltip do medicamento B deverá ter o seguinte formato: "Justificativa – Interação Medicamentosa – medicamento A com medicamento B:  Descrição da justificativa."

Já no medicamento A, será apresentado no ToolTip somente a interação sem a justificativa, visto que, o medicamento justificado foi o B. Exemplo: "Interação Medicamentosa – medicamento A com medicamento B".

 

RN008 – Quando utilizado o Modelo de Prescrição, o sistema deverá obedecer as mesmas regras já descritas acima tanto para o alerta de interação medicamentosa, quanto para a Justificativa de Interação Medicamentosa.

 

Rotinas Envolvidas

Rotina

Tipo de Operação

Opção de Menu

Cadastro de Interações Medicamentosas

Alteração

RM > Cadastros > Cuidados com o Paciente > Prescrição Médica > Interações Medicamentosas
HIS > Estoque > Cadastros > Cadastro de Princípios Ativos > Interações Medicamentosas

Configurações por Unidade

Alteração

HIS > Adm. do Sistema > Configurações > Configuração por Unidade

Prescrição Médica

Alteração

PEP > Seleção do Paciente > Aleta Prescrição Médica:

  • Soros e Componentes;
  • Medicamentos;
  • Insulinas (Insulina Fixa e Variável: Hipoglicemia e Hiperglicemia);
  • Inalações;
  • Modelo de Prescrição Médica.

Planejamento Terapêutico

Alteração

PEP > Seleção do Paciente > Aleta Planejamento Terapêutico > Frase prescrita no Aprazamento e Checagem

Histórico Clínico

Alteração

PEP > Seleção do Paciente > Aleta Histórico Clínico > Frase prescrita nos itens do prontuário: Prescrição Médica e Planejamento Terapêutico

 

Protótipo de Tela

As imagens de telas destacadas a seguir são consideradas apenas protótipos, as mesmas poderão sofrer alterações em função da atualização de componentes utilizados no sistema, devem ser utilizadas apenas para exemplificar a forma de iteração que os usuários possuirão ao acessar o PEP, o fluxo de negócio e a forma em que os dados e informações serão manipuladas.

Ajustar cadastro de Interação Medicamentosa do RM

Funcionalidade

Interação Medicamentosa

Objetivo

Ajustar cadastro de interação medicamentosa.

Módulo

Cadastros

Menu

Cuidados com o Paciente > Prescrição Médica > Interações Medicamentosas

Regras da Interface

RI-001

Alterar o label "Classificação de Risco" para "Classificação de Risco / Nível de Interação".

RI-002

Alterar o label "Observação" para "Observação / Risco".

RI-003

O campo "Ação" não é de preenchimento obrigatório.

 

Configuração de justificativa na interação medicamentosa

Funcionalidade

Configuração para obrigar a justificativa para interação medicamentosa.

Objetivo

Incluir checkbox "Obrigar a justificativa por interação medicamentosa na Prescrição Médica" em configurações por unidade.

Módulo

Administração do Sistema

Menu

Configurações > Configurações por Unidade

Regras da Interface

RI-001

O checkbox deverá estar desmarcado por padrão.

 

Justificativa – Interação Medicamentosa

Funcionalidade

Justificativa – Interação Medicamentosa

Objetivo

Justificar a prescrição de medicamentos com interação.

Módulo

Prontuário Eletrônico

Menu

PEP > Seleção do Paciente >

  • Aleta Prescrição Médica:
  • Soros e Componentes;
  • Medicamentos;
  • Insulinas (Insulina Fixa e Variável: Hipoglicemia e Hiperglicemia);
  • Inalações.
  • Aleta Planejamento Terapêutico > Frase prescrita no Aprazamento e Checagem
  • Aleta Histórico Clínico > Frase prescrita nos itens do prontuário: Prescrição Médica e Planejamento Terapêutico

 

 

Regras da Interface

RI-001

O campo "Justificativa – Interação Medicamentosa" deverá ser apresentado sempre que houver interação entre medicamentos e deverá ser de preenchimento obrigatório somente se a unidade em que o paciente se encontra estiver com a configurações "Obrigar a justificativa por interação medicamentosa na Prescrição Médica" selecionada.

Atenção: Se o medicamento A interagir com o medicamento B e a justificativa for informada no medicamento B, o sistema não deverá obrigar o preenchimento da justificativa no medicamento A.

RI-002

Na mensagem de alerta de Interação, caso o campo "Observação / Risco" esteja em branco no cadastro, o label "Observação / Risco" não deverá ser apresentado na mensagem.

RI-003

A justificativa deve ser apresentada na frase prescrita (antes e depois da liberação do exame), no Planejamento Terapêutico (aprazamento e checagem) e no Histórico Clínico em forma de Tooltip.

Se o medicamento A interagir com o medicamento B e a justificativa for informada no medicamento B, a informação do Tooltip do medicamento B deverá ter o seguinte formato: "Justificativa – Interação Medicamentosa – medicamento A com medicamento B:  Descrição da justificativa."

Já no medicamento A, será apresentado no ToolTip somente a interação sem a justificativa, visto que, o medicamento justificado foi o B. Exemplo: "Interação Medicamentosa – medicamento A com medicamento B".

Modelo de Prescrição Médica

Funcionalidade

Modelo de Prescrição Médica

Objetivo

Possibilitar a visualização do alerta da interação medicamentosa e do preenchimento da justificativa de Interação Medicamentosa no Modelo de Prescrição Médica.

Módulo

Prontuário Eletrônico

Menu

PEP > Seleção do Paciente > Aleta Prescrição Médica > Clique aqui para prescrever por modelo

Regras da Interface

RI-001

Quando o usuário seleciona o "Modelo de Prescrição" a ser utilizado, o sistema marca todos os itens contidos no modelo. Neste momento, o sistema deverá validar as regras para apresentar o alerta e o campo de justificativa de interação medicamentosa. Ao "confirmar o uso do modelo", o sistema deverá fazer a validação de obrigatoriedade de preenchimento de campos conforme regras descritas para inclusão do item na Prescrição Médica.

Dicionário de Dados

Para contemplar a RN005, alterar a tabela MP2055_UNIT para incluir a coluna MP2055_REQUIRED_DRUG_INT.

Para contemplar a RN003, deverão ser realizadas as seguintes alterações e criações.

Criar as seguintes tabelas:

MP2XXX_DRUG_INTERACTION - Tabela responsável pelas interações medicamentosas.

MP2XXX_DRUG_INT_MEDICATION - Tabela que irá guardar os medicamentos que estão em uma interação.

MP2XXX_DRUG_INT_INHALATION -  Tabela que irá guardar as inalações que estão em uma interação.

MP2XXX_DRUG_INT_SOLUTION -  Tabela que irá guardar os soros e componentes que estão em uma interação.

Alterar a tabela MP2006_MEDICATION e incluir fk para a tabela MP2XXX_DRUG_INTERACTION.

Alterar a tabela MP2020_INHALATION_ITEM e incluir fk para a tabela MP2XXX_DRUG_INTERACTION.

Alterar a tabela MP2026_SOLUTION_ITEM e incluir fk para a tabela MP2XXX_DRUG_INTERACTION.

 

Criar as seguintes tabelas:

MP2XXX_DRUG_INT_HYPO - Tabela que irá guardar os itens de hipoglicemia que estão em uma interação. 

MP2XXX_DRUG_INT_INS_FIXED -  Tabela que irá guardar as insulinas fixas que estão em uma interação. 

MP2XXX_DRUG_INT_HYPER -  Tabela que irá guardar os itens de hyperglicemia que estão em uma interação. 

Alterar a tabela MP2093_HYPOGLYCEMIA e incluir fk para a tabela MP2XXX_DRUG_INTERACTION. 

Alterar a tabela MP2092_INSULIN_FIXED e incluir fk para a tabela MP2XXX_DRUG_INTERACTION. 

Alterar a tabela MP2094_HYPERGLYCEMIA e incluir fk para a tabela MP2XXX_DRUG_INTERACTION.


Para contemplar a RN006, deve se criar a tabela MP2XXX_JUST_DRUG_INT

Obs: Antes de iniciar está tarefa, deve-se ter sido finalizada a tarefa ER_PCREQ-10172_PEP_Alergia_Justificativa_de_uso_de_Principio_Ativo, pois existem dependências entre tabelas.

 

Alterações no projeto

Projeto TOTVS.PEP.DataAccessLayer

Criar classes DAL para tabelas MP2XXX_DRUG_INTERACTION, MP2XXX_DRUG_INT_MEDICATION, MP2XXX_DRUG_INT_INHALATION, MP2XXX_DRUG_INT_SOLUTION, MP2XXX_DRUG_INT_HYPO, MP2XXX_DRUG_INT_INS_FIXED, MP2XXX_DRUG_INT_HYPER, 

MP2XXX_JUST_DRUG_INT

 Alterar classes DAL MP2055_UNIT, MP2006_MEDICATION, MP2020_INHALATION_ITEM, MP2026_SOLUTION_ITEM, MP2093_HYPOGLYCEMIA, MP2092_INSULIN_FIXED, MP2094_HYPERGLYCEMIA.

Projeto TOTVS.PEP.Entities

alterar Unit para RN005

Para RN003 devem ser alteradas e criadas as seguintes classes:

Criar classes DrugInteractionPrescribed, DrugInteractionPrescribedMedication, DrugInteractionPrescribedInhalation, DrugInteractionPrescribedSolution, DrugInteractionPrescribedHypoglycemia, DrugInteractionPrescribedInsulinFixed, DrugInteractionPrescribedHyperglycemia.

Alterar classes PrescriptionMedication, PrescriptionInhalationItem, PrescriptionSolutionItem, PrescriptionInsulinFixed, Hyperglycemia, Hypoglycemia.

Criar classes view para todas as filhas de PrescriptionItem, exemplo: PrescriptionMedication necessita de uma lista de DrugInteractionPrescribedMedication, essa lista é uma view com as propriedades da DrugInteractionPrescribedMedication e a propriedade message da DrugInteractionPrescribed.

Para RN006 deve ser criada a classe JustificationDrugInteraction herdando de Justification.

Projeto TOTVS.PEP.BusinessLayer

alterar UnitService para RN005

Para RN003 criar classe para cada tabela nova criada, MP2XXX_DRUG_INTERACTION, MP2XXX_DRUG_INT_MEDICATION, MP2XXX_DRUG_INT_INHALATION, MP2XXX_DRUG_INT_SOLUTION, MP2XXX_DRUG_INT_HYPO, 

 MP2XXX_DRUG_INT_INS_FIXED,MP2XXX_DRUG_INT_HYPER.

alterar classes PrescriptionMedicationService, PrescriptionInhalationItemService, PrescriptionSolutionItemService, PrescriptionInsulinFixedService, HyperglycemiaService, HypoglycemiaService.

Para RN006 criar a classe JustificationDrugInteractionService.

Projeto TOTVS.PEP.Wrappers

alterar UnitWrapper para RN005

Para RN003, devem ser alteradas e criadas as seguintes classes:

Criar wrapper para cada tabela nova criada, MP2XXX_DRUG_INTERACTION, MP2XXX_DRUG_INT_MEDICATION, MP2XXX_DRUG_INT_INHALATION, MP2XXX_DRUG_INT_SOLUTION, MP2XXX_DRUG_INT_HYPO,  

 MP2XXX_DRUG_INT_INS_FIXED,MP2XXX_DRUG_INT_HYPER

Para RN006 devem ser alteradas e criadas as seguintes classes:

Criar classe JustificationDrugInteractionWrapper.

Projeto TOTVS.PEP.Integration

Para RN006 alterar classe EnumTypes JustificationType, adicionar novo tipo "Interação medicamentosa" 

Projeto TOTVS.PEP.Adapters 

Para RN003, RN006 alterar classe PrescriptionAdapter

Necessário atualizar a referência para os serviços WCF do PEP Server.

Projeto TOTVS.PEP.Client 

Para RN002,  RN003 e RN004 alterar as seguintes classes:

Criar uma classe especialista em interações, e usa-la nas telas a seguir

PEP.UserControls.MedicationPrescriptionUserControl.xaml

PEP.UserControls.MedicationPrescriptionUserControl.xaml.cs

PEP.UserControls.ComponentPrescriptionUserControl.xaml

PEP.UserControls.ComponentPrescriptionUserControl.xaml.cs

PEP.UserControls.Insulins.FixedOrVariableInsulinUserControl.xaml

PEP.UserControls.Insulins.FixedOrVariableInsulinUserControl.xaml.cs

PEP.UserControls.InalationPrescriptionUserControl.xaml

PEP.UserControls.InalationPrescriptionUserControl.xaml.cs

Para RN005 alterar as seguintes classes:

PEP.Tabs.Entries.UnitConfigurationPage.xaml

PEP.Tabs.Entries.UnitConfigurationPage.xaml.cs

Para RN006 alterar as seguintes classes:

PEP.Tabs.MedicalPrescription.cs

PEP.UserControls.MedicationPrescriptionUserControl.xaml

PEP.UserControls.MedicationPrescriptionUserControl.xaml.cs

PEP.UserControls.ComponentPrescriptionUserControl.xaml

PEP.UserControls.ComponentPrescriptionUserControl.xaml.cs

PEP.UserControls.Insulins.FixedOrVariableInsulinUserControl.xaml

PEP.UserControls.Insulins.FixedOrVariableInsulinUserControl.xaml.cs

PEP.UserControls.InalationPrescriptionUserControl.xaml

PEP.UserControls.InalationPrescriptionUserControl.xaml.cs

Para RN007 alterar as seguintes classes:

TOTVS.PEP.Client.Helpers.JustificationDescriptionFactory.cs

PEP.UserControls.InalationPrescriptionUserControl.xaml.cs

PEP.UserControls.MedicationPrescriptionUserControl.xaml.cs

PEP.UserControls.ComponentPrescriptionUserControl.xaml.cs

PEP.UserControls.Insulins.FixedOrVariableInsulinUserControl.xaml.cs

PEP.UserControls.InsulinPrescriptionUserControl.xaml.cs

PEP.CustomControls.AppointmentChart.AppointmentChart.xaml.cs

PEP.UserControls.PrescriptionItemsGrid.xaml.cs

PEP.BindEntities.BindingPrescriptionItemClinicalHistory