Contexto Clínico

O Contexto Clínico da SauBit mantém ou processa as informações clínicas essenciais para a análise de segurança medicamentosa. Ele não substitui o prontuário eletrônico oficial da instituição — o sistema hospitalar continua sendo a fonte oficial.

Copia um prompt pronto com fluxo de integração, payload e exemplos.

O que é · O que não é

• É: um perfil clínico mínimo e opcional (medicamentos, alergias, condições, exames-chave, função renal/hepática, gestação) que melhora as análises futuras.
• Não é: PEP/HIS, evolução multidisciplinar, prescrição eletrônica, internação, faturamento hospitalar ou prontuário jurídico completo.

Dois modos de operação

A SauBit opera em dois modos, definidos por requisição em processing_options.context_mode (dentro dos limites da política da organização):

Modo	Comportamento
stateless	Recebe, normaliza e analisa o payload; não carrega nem atualiza o perfil longitudinal. Máxima minimização — ideal para hospitais com PEP próprio.
persistent_context	Carrega o perfil existente, opcionalmente o atualiza (update_clinical_context) e usa o contexto consolidado na análise.

Snapshot de auditoria (opção independente)

create_audit_snapshot: true registra, de forma imutável, o contexto exato usado naquela análise (com hash e versões de motor/regras/base). Funciona em qualquer modo. O snapshot não é editável nem sobrescrito; alterações posteriores no contexto não o afetam.

GET /api/v1/clinical-context/snapshots/{snapshot_id}
GET /api/v1/clinical-context/analyses/{analysis_id}/snapshot

Política por organização (autoridade)

A organização define a política (modo padrão, se permite contexto persistente/snapshots, persistência por domínio, retenção, zero_retention). A requisição nunca amplia permissões — só pode reduzir. Se zero_retention estiver ativo: sem contexto persistente, sem snapshots, apenas metadados técnicos mínimos.

A política é configurada por rotas administrativas (Swagger Admin): GET/PUT/DELETE /api/v1/admin/organizations/{org_id}/clinical-context-policy. A visão efetiva para o cliente: GET /api/v1/clinical-context/policies/current.

data_handling na resposta da análise

Toda análise informa como os dados foram tratados:

"data_handling": {
  "requested_mode": "persistent_context",
  "effective_mode": "stateless",
  "clinical_context_updated": false,
  "audit_snapshot_created": true,
  "policy_restrictions_applied": ["organization_disallows_persistent_context"]
}

Endpoints (cliente)

GET    /api/v1/clinical-context/patients/{patient_reference}
PUT    /api/v1/clinical-context/patients/{patient_reference}
PATCH  /api/v1/clinical-context/patients/{patient_reference}
DELETE /api/v1/clinical-context/patients/{patient_reference}   # ?purge=true = hard delete (LGPD)
GET    /api/v1/clinical-context/policies/current
GET    /api/v1/clinical-context/snapshots/{snapshot_id}
GET    /api/v1/clinical-context/analyses/{analysis_id}/snapshot

Escopos: clinical_context:read / clinical_context:write (intercambiáveis com os antigos prontuario:*).

Exemplos na análise

// stateless, sem snapshot
{ "medications": [], "patient_reference": "patient-token-123",
  "processing_options": { "context_mode": "stateless", "create_audit_snapshot": false } }

// contexto persistente + snapshot + atualização parcial
{ "medications": [], "patient_reference": "patient-token-123", "encounter_reference": "encounter-123",
  "clinical_context": {}, "processing_options": {
    "context_mode": "persistent_context", "update_clinical_context": true, "create_audit_snapshot": true,
    "persistence_overrides": { "medications": true, "observations": false } } }

Pseudonimização e LGPD

patient_reference normalmente é um pseudônimo (re-vinculável pelo controlador) — não é anonimização. Dados de saúde continuam sendo dados pessoais sensíveis. Veja LGPD.

Migração das rotas antigas (/prontuario)

As rotas /api/v1/prontuario/* continuam funcionando, mas estão depreciadas (respondem Deprecation: true + Sunset + Link para /clinical-context). Migre para /clinical-context.

Compatibilidade FHIR

O Contexto Clínico mapeia para Patient, Encounter, MedicationRequest/Statement, AllergyIntolerance, Condition, Observation, Provenance e Consent (ver FHIR R4). Identificadores/versões/procedência FHIR são preservados.

Erros de política

CLINICAL_CONTEXT_MODE_NOT_ALLOWED · PERSISTENT_CONTEXT_DISABLED · AUDIT_SNAPSHOT_DISABLED · ZERO_RETENTION_POLICY_ACTIVE (as restrições aplicadas aparecem em data_handling.policy_restrictions_applied).