Fluxos operacionais

Passo a passo de cada tela operacional, do expurgo à liberação.

Visão geral do ciclo

SUJO                                  LIMPO                              ESTÉRIL
+----------+   +---------+   +----------+   +------------+   +-----------+   +----------+
| Expurgo  |-->| Lavagem |-->| Preparo  |-->| Esteriliz. |-->| Liberação |-->| Arsenal  |
+----------+   +---------+   +----------+   +------------+   +-----------+   +----------+
                                                                                  |
                                                                                  v
                                                                          +-----------------+
                                                                          | Point-of-Care   |
                                                                          | kit -> paciente |
                                                                          +-----------------+

1. Expurgo — Conferência cega

  1. Operador bipa o código do kit que voltou da sala cirúrgica.
  2. Sistema abre a contagem do kit, mas não mostra a lista esperada — conferência cega.
  3. Operador bipa cada item recebido.
  4. Ao bipar "Finalizar", sistema reconcilia: itens faltantes em vermelho com pulse + beep; itens estranhos também sinalizados.
  5. Se houver OPME, abre modal de balanço (enviado / consumido / retornado).
  6. Submissão grava ict_lifecycle_events com fase EXPURGO.

2. Lavagem

  1. Operador bipa o kit.
  2. Sistema sugere equipamentos compatíveis (termodesinfectora vs. ultrassônica).
  3. Operador seleciona equipamento; sistema bloqueia incompatíveis.
  4. Operador escolhe programa do ciclo.
  5. Ao finalizar o ciclo físico, operador confirma na tela; sistema grava lifecycle event.

3. Preparo — Montagem assistida

  1. Operador bipa o kit.
  2. Sistema mostra receita: nome, foto e quantidade de cada peça.
  3. Operador bipa cada peça; check verde quando bate, vermelho quando não.
  4. Sistema impede troca de peça entre matrizes diferentes.
  5. Valida peso vs. limite do programa selecionado para esterilização.
  6. Ao "Finalizar", emite etiqueta ZPL ao Zebra ZD220 (QR + Code128 + dados legíveis).

4. Esterilização

  1. Operador escolhe o equipamento (autoclave vapor / plasma).
  2. Se for autoclave vapor com bowie_dick_pending = 1, tela bloqueia com CTA para RT liberar.
  3. RT executa o teste Bowie-Dick físico, lê o resultado, marca OK ou FALHA. Se OK, equipamento volta a AVAILABLE.
  4. Operador escolhe o programa; bipa kits para a carga; sistema soma peso em tempo real.
  5. Inicia ciclo (cria ict_batches com status RUNNING).
  6. Ao final, operador insere parâmetros observados (T°, P, duração); batch vai para PENDING_PARAM_RELEASE.
  7. Se ciclo crítico, registra BI com início de incubação.

5. Liberação paramétrica

  1. Lista batches em PENDING_PARAM_RELEASE.
  2. Liberador (NURSE_RT / SUPERVISOR / ADMIN) confere parâmetros vs. programa.
  3. Se houver BI vinculado, aguarda leitura; bipa BI e marca resultado.
  4. Aprovar → batch vai para APPROVED e kits ficam disponíveis no arsenal.
  5. Rejeitar → batch REJECTED; todos os kits voltam para expurgo automaticamente.

6. Arsenal — FIFO por validade

  1. Lista ordenada por sterile_expires_at ASC.
  2. Destaque amarelo se faltam < 48 h para vencer; vermelho se vencido.
  3. Retirada: operador bipa kit; sistema grava saída para a sala/setor destino.

7. Point-of-Care — vínculo paciente

  1. Circulante de sala abre PWA no tablet.
  2. Bipa o kit, informa prontuário do paciente (ou recebe via integração ERP).
  3. Cria ict_surgery_links ligando kit_instance ↔ prontuario_id.
  4. Esse vínculo é a chave para o recall biológico em cascata.

8. Quarentena

  1. Itens / kits quarentenados aparecem na lista da tela.
  2. Para liberar, supervisor seleciona, escreve justificativa.
  3. Sistema pede re-autenticação (senha do supervisor no momento).
  4. Liberação grava em ict_quarantine_events + audit log.

9. Recall biológico

  1. Supervisor identifica BI positivo ou contaminação confirmada.
  2. Abre tela Recall, escolhe batch afetado, escreve motivo.
  3. Confirma 2x ("Tem certeza?" + "Confirme digitando RECALL").
  4. Sistema cria ict_recall_events (OPEN) e enfileira job.
  5. Job expande cascata, quarentena kits, dispara webhook ao ERP/CCIH.
  6. Tela mostra progresso em tempo real.

10. Manutenção preventiva

  1. Equipamentos com manutenção vencida são interditados automaticamente pelo cron.
  2. Tela mostra cronograma + última manutenção realizada.
  3. Técnico registra manutenção concluída; equipamento volta para AVAILABLE.
  4. Itens com ciclos esgotados entram em passivação obrigatória (rota separada de tratamento físico-químico).

Troca de organização (matriz ↔ filial)

  1. Usuário ADMIN da matriz clica no seletor de organização (topo direito).
  2. Lista mostra matriz + filiais acessíveis.
  3. Clica em "Acessar"; sistema chama POST /v1/auth/switch-org.
  4. JWT é re-emitido com novo org_id; PWA recarrega dados (TanStack Query invalidate).
  5. Para retornar à matriz, mesmo seletor.