Central do Médico (Cockpit) — Definição (v4.26)

Documentos desta funcionalidade: 01 - Definição (v4.26) · 02 - Especificação (v4.25) · 03 - Protótipo (v3.13, código executável em 03 - Protótipo v3.13.html) · 04 - Mapeamento de Banco de Dados (v4.28)


SEÇÃO 1 — DEFINIÇÃO

Um dia na Central do Médico

Você chega à clínica para iniciar seu turno. Ao abrir o Gemed Onco, a primeira tela que surge é o seu Cockpit. No topo, quatro indicadores rápidos mostram que você tem 12 consultas hoje, 5 prescrições aguardando sua assinatura, 3 pacientes já em tratamento nas poltronas e 2 procedimentos em andamento na clínica.

Ao longo da manhã, você não precisa “caçar” informações. Se um paciente chega na recepção, o painel de Consultas atualiza sozinho, mostrando quem está com status Recepcionado (fez check-in, pronto para atendimento). Se surge uma dúvida da enfermagem, uma nova mensagem pisca no painel de Comunicação. Antes de chamar o próximo paciente, você bate o olho no painel de Procedimentos na Clínica e vê, por uma barra de progresso, que a infusão da Dona Maria está correndo dentro do tempo previsto. O painel mostra todos os pacientes em tratamento na clínica, não apenas os seus, permitindo uma visão global da operação da unidade. Quando sobra um minuto entre atendimentos, você acessa o painel de Prescrições Pendentes e, com um clique, assina e revisa as prescrições do dia, garantindo que a farmácia e a enfermagem sigam o fluxo sem interrupções. É o seu dia controlado em uma única visão, sem cliques desnecessários.

Objetivo

Prover ao médico oncologista uma interface centralizada que consolide todas as informações críticas para a gestão do seu turno de trabalho em tela única. O foco é eliminar a navegação excessiva entre menus, reduzir a carga cognitiva e aumentar a segurança do paciente através de alertas visuais de atrasos e pendências críticas.

Escopo

  • Incluído: Cabeçalho com busca inteligente (Nome, CPF, Prontuário); Indicadores de desempenho (KPIs); Painel de Consultas cronológico; Painel de Prescrições para assinatura rápida; Painel de conversas e alertas internos (não é chat em tempo real — ver RN-CM-015); Monitoramento de tempo de infusão dos pacientes; Atalhos para o Prontuário Eletrônico (PEP).
  • Excluído: Digitação de evoluções clínicas (feito no PEP); Criação de novos protocolos; Gestão de horários da agenda; Comunicação externa (E-mail/WhatsApp).

Personas

PersonaPapel no SistemaNecessidade Principal
Médico OncologistaUsuário PrincipalVisão 360º do dia, agilidade na assinatura e monitoramento de segurança.
RecepcionistaStakeholder operacionalMantém as agendas atualizadas (status Agendado e Recepcionado). Recebe resultados de exames dos pacientes para encaminhar aos médicos. O status “Aguardando Recepção” pode ser definido manualmente pela recepcionista ou via integração com totem de fila.
Enfermeira e FarmacêuticaStakeholders clínicos (não usam o Cockpit diretamente)Recebem prescrições assinadas para liberar o tratamento. A enfermagem só administra a prescrição depois que ela tiver uma assinatura válida como revisão recente — condição que o sistema verifica e, se necessário, exige automaticamente do médico a partir de 1 dia antes da aplicação agendada (regra completa em RN-CM-020). Enfermagem e Farmácia são tratadas como uma persona só nesta tabela porque nenhuma das duas interage com o Cockpit em si — aparecem aqui apenas como stakeholders impactados pelas decisões tomadas nele.

Workflows do Profissional

A Central do Médico é um hub que toca múltiplos workflows do profissional. Cada workflow é documentado abaixo com seu resumo e os touchpoints específicos da Central.

Workflow 1 — Atendimento de Consulta

Resumo: O paciente chega à clínica, pega número na fila de espera e aguarda ser chamado pela recepcionista, que faz o check-in. O paciente aguarda na sala de espera. O médico, antes de chamar o paciente, analisa o prontuário, verifica anotações e exames anteriores. Então chama o paciente, inicia o atendimento (perguntas, constatação do estado atual, análise de exames trazidos, solicitação de novos exames, prescrições). O médico pode registrar a evolução clínica durante ou após a consulta. Ao finalizar, fecha o atendimento e foca no próximo paciente. O paciente sai do consultório e vai embora ou passa na recepção para marcar retorno.

Touchpoints da Central:

Momento do workflowNecessidade do profissionalO que a Central ofereceDecisão de design justificada
Antes de chamar o próximo pacienteSaber rapidamente quem está recepcionado e pronto para atendimentoPainel de Consultas com status “Recepcionado” em destaque (chip azul + borda lateral)Filtro padrão prioriza quem falta atender (RN-CM-021).
Antes de chamar o próximo pacienteIdentificar se o paciente está atrasado (horário passou e não iniciou)Badge vermelho pulsante “Atrasado · Xmin” no card de consultaPacientes atrasados provavelmente geram sobreposição de horários. Cabe ao médico decidir quem atender primeiro - o atrasado ou o pontual que já aguarda.
Entre atendimentosAcessar o prontuário do próximo paciente sem navegar por menusClique no card de consulta abre diretamente o PEPUm clique é o menor caminho entre identificar o paciente e o prontuário, que o médico precisa checar antes de chamá-lo.
Início do turnoTer um panorama geral do dia (quantas consultas, quantas pendentes, quantas atrasadas)KPI “Consultas Hoje” com número “finalizadas/total” e subtexto “pendentes · atrasadas”Panorama de carga de trabalho em um olhar, sem abrir o painel, logo ao logar.
Durante o turnoNão ser interrompido por informações irrelevantesConsultas finalizadas aparecem esmaecidas na sua posição original (RN-CM-021)Durante o turno, o médico foca nos próximos atendimentos - finalizadas saem do foco visual sem sumir da lista.

Workflow 2 — Tratamento Oncológico (Monitoramento)

Resumo: O paciente em tratamento oncológico tem um plano terapêutico com ciclos e sessões previstos. Em cada dia de tratamento, o paciente chega à clínica, faz check-in, é preparado pela enfermagem (acesso venoso, sinais vitais) e inicia a infusão do quimioterápico. A enfermagem monitora o paciente durante a infusão (checagens periódicas). O médico acompanha o progresso do tratamento, avalia resposta, ajusta protocolo quando necessário e prescreve a próxima sessão. O tratamento pode ser suspenso por intercorrências (febre neutropênica, reação alérgica). O paciente pode não aderir ao planejamento (descompasso de intervalos entre ciclos).

Touchpoints da Central:

Momento do workflowNecessidade do profissionalO que a Central ofereceDecisão de design justificada
Entre consultas / durante o turnoSaber quais pacientes estão em procedimento na clínica e em qual etapaPainel de Procedimentos na Clínica com status (Em Atendimento / Aguardando) e local na clínicaConsolida em um olhar onde cada paciente está no fluxo, sem o médico sair da sua tela.
Durante o monitoramentoSaber se uma infusão está dentro do tempo previsto ou atrasadaBarra de progresso inline (3px) na linha do nome, com porcentagemReforça o motivador de segurança de RN-CM-016 com monitoramento periférico; desenho discreto (3px) para não competir com nome/status.
Entre consultasDecidir se precisa intervir em um procedimento em andamentoClique no card abre a prescrição do procedimento; botão separado “PEP” abre o prontuárioA prescrição (o que está sendo infundido, dose, diluente) é a ação primária para decidir se intervir; o PEP é secundário, para contexto clínico completo.
Início do turnoSaber quantos pacientes estão em tratamento sob sua responsabilidade e quantos não estão aderentesKPI “Em Tratamento” com número principal (em tratamento) e subtexto “não aderentes” (critério: RN-CM-023)Identifica pacientes em risco de não adesão logo ao logar, sem abrir o painel.
Durante o turnoFiltrar apenas seus pacientes vs. ver todos os da clínicaBotão de alternância (toggle) “Meus / Todos” (default: Meus)Default prioriza os próprios pacientes (RN-CM-021); alternar para “Todos” cobre casos como cobrir plantão de outro médico, sem mudar de tela.

Workflow 3 — Prescrição e Dispensação

Resumo: O médico define o protocolo de tratamento e prescreve os medicamentos para cada ciclo/sessão. A prescrição fica pendente de assinatura. O médico assina (com ou sem certificado digital) na véspera ou no dia da aplicação. A farmácia recebe a prescrição assinada e manipula o medicamento. Como segunda barreira de segurança, o sistema marca automaticamente a prescrição como pendente de revisão a partir de 1 dia antes da aplicação agendada — um médico (preferencialmente o prescritor ou o médico assistente do paciente) precisa abrir a prescrição e confirmá-la como revisada antes que a enfermagem possa administrar o medicamento. A prioridade das prescrições não revisadas cresce da mesma forma que a das não assinadas, conforme a hora da aplicação se aproxima.

Touchpoints da Central:

Momento do workflowNecessidade do profissionalO que a Central ofereceDecisão de design justificada
Início do turno / entre atendimentosAssinar prescrições pendentes antes que a farmácia possa manipularPainel de Prescrições Pendentes com botão “Assinar” no card que abre a tela de assinatura com a prescrição completaA assinatura é o gargalo que abre o resto do fluxo (a farmácia só manipula depois dela) — daí a prioridade de expô-la logo no painel.
Início do turnoPriorizar quais prescrições assinar primeiro (as mais urgentes)Chips de urgência: vermelho (<12h) e laranja (12-24h) com tempo restanteCor sinaliza, de longe, que a janela de ação está fechando (limiares em RN-CM-011).
A partir de 1 dia antes da aplicação agendadaConfirmar que a prescrição foi revisada por um médico antes da administração ao pacienteCard de prescrição tipo “Revisar”, gerado automaticamente pelo sistema (RN-CM-020). Botão “Revisar” abre a prescrição completa para o médico validar ou ajustar antes de confirmarReaproveita a mesma escalada visual (chip vermelho/laranja) das prescrições não assinadas (RN-CM-011) — o médico já reconhece o padrão.
Início do turnoSaber quantas prescrições urgentes (menos de 12h) precisam de sua atençãoKPI “Alertas de Prescrição” com número principal (urgentes) em vermelho e subtexto com duas contagens: total a revisar, e a assinar nos próximos 7 diasNúmero em vermelho chama atenção imediata ao logar; subtexto dá contexto sem competir com ele.
Ao assinar uma prescriçãoConfirmar que a assinatura foi processada e retornar à CentralToast de sucesso “Prescrição assinada com sucesso” + retorno automático à Central, focada no painel de Prescrições Pendentes + atualização do KPIToast + retorno automático + decremento do KPI fecham o loop de feedback sem o médico precisar navegar de volta manualmente.
Ao revisar prescriçõesFocar primeiro nas prescrições que é preferencialmente responsável por revisar (seus pacientes), mas poder ajudar a revisar as de colegas quando necessárioToggle pill “Meus / Todos” no painel de Prescrições Pendentes (RN-CM-021)O médico prioriza naturalmente seus próprios pacientes, mas pode ajudar a revisar as de colegas quando necessário — daí o toggle (comportamento exato: RN-CM-021).

Workflow 4 — Comunicação Interna

Resumo: Diferentes profissionais da clínica (organizados em equipes, como recepção, farmácia e enfermagem) precisam comunicar informações ao médico durante o turno: recados, solicitações, resultados de exames, dúvidas sobre prescrições, notificações de intercorrências. Módulos do sistema também podem gerar alertas automáticos (ex: prescrição urgente, atraso de infusão). O emissor — pessoa ou módulo — pode definir um prazo para resposta. O médico recebe essas conversas, precisa priorizá-las, pode responder diretamente pelo Cockpit, ou resolvê-las/descartá-las e arquivar as encerradas. Algumas são urgentes (intercorrência durante infusão), outras são informativas (confirmação de manipulação). Diferente de uma notificação avulsa, cada item é uma conversa (thread) que pode acumular respostas de ambos os lados.

Touchpoints da Central:

Momento do workflowNecessidade do profissionalO que a Central ofereceDecisão de design justificada
Durante todo o turnoReceber conversas e alertas da equipe sem sair da CentralPainel de Comunicação com conversas em aberto (RN-CM-015)Integra comunicação ao cockpit para resposta rápida entre atendimentos, sem alternar de tela.
Ao receber uma conversa novaIdentificar rapidamente que há conversa não lidaConversas não lidas com ícone colorido e borda lateral destacada (RN-CM-015)Identificação periférica de pendências sem precisar ler o conteúdo.
Ao revisar a lista de conversasPriorizar conversas com prazo de respostaPrazo exibido no card (“Responder até 14:00”) + ordenação por prazo primeiroPrazo é compromisso — visível no card, permite triagem sem abrir a conversa.
Ao precisar esclarecer algo rapidamenteResponder sem sair do Cockpit, sem precisar telefonar ou ir até a equipeCampo de resposta no modal da conversa — envia uma nova mensagem na thread e muda o status para “Respondida”Muitas dúvidas simples (confirmar uma dose, avisar que já viu o recado) cabem numa frase — uma tela separada de chat quebraria o fluxo entre atendimentos.
Ao resolver uma solicitaçãoArquivar a conversa com um cliqueBotão “Resolvido” no card (RN-CM-015)Resolver é ação frequente e repetitiva no dia — um clique é o menor caminho.
Ao receber algo puramente informativo, sem necessidade de respostaTirar a conversa do painel sem marcá-la como resolvidaBotão “Descartado” no card (RN-CM-015)Nem toda conversa pede uma resolução — descartar existe como saída separada para o que já cumpriu seu papel só por ter sido visto (ex: confirmação de manipulação da farmácia).
Durante todo o turnoDistinguir se a conversa é de uma pessoa ou um alerta automáticoÍcone identificador — pessoa ou sino, conforme a origem (RN-CM-022; ícone exato: Seção 2.8)Categorização visual instantânea da origem, sem ler o texto.
Ao ler a resposta de uma conversa endereçada a uma equipeSaber que quem respondeu falou pela equipe, não só por si mesmoNome da equipe exibido junto ao nome de quem escreveu, em toda mensagem dela (RN-CM-015, RN-CM-022)Sem essa informação o médico não sabe se está falando com a equipe como um todo ou só com uma pessoa específica — relevante para saber a quem cobrar depois.

Regras de Negócio Consolidadas

Cada regra abaixo tem um código (ex: RN-CM-020) que permite localizá-la e rastreá-la até sua implementação na Seção 2. A numeração tem saltos (ex: de RN-CM-006 para RN-CM-011) porque regras intermediárias foram consolidadas ou removidas ao longo de revisões anteriores deste documento — não é um sinal de conteúdo faltando.

Layout e Visualização

  • RN-CM-001 — Tela única, sem rolagem geral: A Central ocupa a tela inteira — o médico vê os 4 painéis sem precisar rolar a página principal. Cada painel rola de forma independente quando tem mais itens do que cabem no espaço disponível. (Detalhamento técnico de implementação: Seção 2.8.)
  • RN-CM-002 — Quatro painéis fixos: A interface é dividida em quatro quadrantes fixos, cada um com uma função específica:
    • Quadrante superior esquerdo — Consultas: Agenda de consultas do médico no dia, com status visual de cada paciente (Agendado, Aguardando Recepção, Recepcionado, Em Atendimento, Finalizado).
    • Quadrante superior direito — Prescrições Pendentes: Lista de prescrições que aguardam ação do médico, divididas em duas categorias: prescrições para assinar (aguardando assinatura digital) e prescrições para revisar (marcadas automaticamente pelo sistema quando a aplicação agendada está a 1 dia ou menos e a prescrição ainda não foi revisada por nenhum médico — RN-CM-020).
    • Quadrante inferior esquerdo — Comunicação: Conversas e alertas não lidos, de pessoas/equipes ou do sistema, com ação de responder, resolver ou descartar.
    • Quadrante inferior direito — Procedimentos na Clínica: Monitoramento de pacientes previstos e presentes na unidade para procedimentos e tratamentos (infusões, aplicações, checagens) — não inclui consultas médicas, apenas procedimentos terapêuticos e diagnósticos.
    • Diferenciação visual: O cabeçalho de cada painel possui um fundo cinza claro para se diferenciar do corpo do painel (fundo branco), orientando o olhar do usuário entre a área estrutural e a área de conteúdo. (Cor exata: Seção 2.8.)
  • RN-CM-003 — Títulos como links de navegação: Os títulos dos 4 painéis são clicáveis e funcionam como links para as telas dedicadas correspondentes. No estado normal, o título aparece em peso regular (sem negrito) com cor neutra; ao passar o mouse ou tocar (conforme o dispositivo), a cor muda para o azul secundário e uma seta (→) aparece discretamente ao lado do título. (Cor exata: Seção 2.8.) Esta abordagem substitui links separados (‘Ver agenda →’, ‘Ver todas →’, etc.), reduzindo ruído visual no cabeçalho. Motivador: o título é o elemento mais natural para clicar; a seta ao interagir garante descobribilidade sem poluir o estado normal.

Busca Inteligente

  • RN-CM-004 — Lógica de Busca: A busca começa a filtrar assim que o médico digita 2 caracteres e para por um instante — não a cada tecla, para não sobrecarregar o sistema com uma consulta a cada letra digitada (intervalo exato: Seção 2.8). Se a entrada começar com número, busca por CPF ou Data de Nascimento; se começar com letra, busca por Nome do Paciente ou Nome da Mãe. A busca é aproximada — usa o mecanismo de correspondência já existente no sistema (fora do escopo desta especificação), que tolera erros de digitação e nomes parecidos, sempre retornando a lista mais provável mesmo sem um resultado exato. Motivador: um médico buscando entre atendimentos não pode perder tempo digitando um nome ou CPF completo e correto — a tolerância a erro é o que torna a busca realmente rápida de usar.

Consultas e Atendimento

  • RN-CM-005 — Status de Atendimento: As consultas devem refletir o status real:
    • Agendado = consulta marcada, mas sem mais interações
    • Aguardando Recepção = paciente está presente na clínica, mas ainda não fez o check-in
    • Recepcionado = paciente fez o check-in com a recepção e está pronto para ser atendido
    • Em Atendimento = paciente está em atendimento com o profissional (médico)
    • Finalizado = paciente já realizou a consulta
  • RN-CM-006 — Ordenação: A lista de consultas é sempre cronológica, priorizando o próximo atendimento.

Prescrições e Assinatura

  • RN-CM-011 — Alertas de Urgência: Prescrições com menos de 12 horas para a aplicação ganham um alerta vermelho. Entre 12h e 24h, o alerta é laranja. Esses limiares (12h/24h) são parâmetros configuráveis por clínica — os valores-padrão vêm da experiência de uso do sistema legado, não são fixos no código. Esta regra vale tanto para prescrições pendentes de assinatura quanto para prescrições pendentes de revisão (RN-CM-020) — a urgência é sempre calculada em relação ao tempo restante até a aplicação agendada, independentemente do tipo de pendência.
  • RN-CM-012 — Assinatura Digital: A assinatura de prescrições pode ocorrer de 2 modos, definidos por parâmetro de configuração do cliente: (a) assinatura com certificado digital — exige que o médico possua certificado digital ativo vinculado ao seu perfil; (b) assinatura sem certificado — validada apenas pela sessão do usuário logado, sem exigência de certificado. O modo ativo é determinado pela configuração da clínica. Motivador: nem toda clínica tem infraestrutura ou exige assinatura com certificado digital (padrão ICP-Brasil, a infraestrutura de certificação usada no Brasil) para prescrições — por isso o modo é configurável por clínica, não fixo no sistema. Quando o modo exige certificado e o médico não tem um certificado ativo, ele não pode assinar digitalmente e segue o processo de assinatura física em papel (fora do escopo deste documento). Em ambos os modos, a ação de assinar sempre abre a prescrição completa para o médico revisar antes de confirmar — nunca é um clique direto a partir do card, porque é responsabilidade do médico saber o que está assinando.
  • RN-CM-020 — Revisão Automática Pré-Aplicação: Antes de a enfermagem poder administrar uma prescrição, ela precisa de uma assinatura recente de um médico — uma segunda barreira de segurança, independente e desvinculada de qualquer notificação de problema pela farmácia ou enfermagem. Em detalhe:
    • Quando dispara: quando a aplicação agendada está a 1 dia (24h, valor-padrão) ou menos da data/hora atual E não existe assinatura do médico (original ou de revisão) com menos de 7 dias — o sistema marca a prescrição como “a revisar”. Essa janela de antecedência (24h) é um parâmetro configurável por clínica, não um valor fixo no sistema — mapeamento completo do parâmetro de banco em RN-CM-020, Seção 4.6.
    • Janela de 7 dias: se a assinatura original do médico tiver menos de 7 dias quando essa janela se abre, ela já vale como revisão implícita, sem precisar de uma confirmação separada. Se tiver mais de 7 dias, é necessária uma confirmação explícita de revisão dentro dos últimos 7 dias. A janela de 7 dias é um parâmetro configurável por clínica, com valor-padrão herdado da experiência do sistema legado.
    • Quem revisa: qualquer médico pode revisar, mas o sistema sinaliza preferencialmente o médico prescritor e o médico assistente do paciente como revisores ideais.
    • O que “revisar” significa: o médico pode apenas confirmar a prescrição como revisada (“Marcar como Revisada”) ou, se identificar necessidade de ajuste, editá-la — o que gera uma nova versão da prescrição (novo registro, com a versão anterior cancelada) que precisa ser assinada novamente.
    • Prescrições “a revisar” seguem a mesma escala de urgência de prescrições não assinadas (RN-CM-011), conforme o tempo restante até a aplicação.

Comunicação Interna

  • RN-CM-015 — Conversas, Alertas e Priorização: Toda comunicação no Cockpit (mensagens entre profissionais e alertas automáticos do sistema) é tratada como uma conversa, que pode acumular várias mensagens — como uma thread. Em detalhe:
    • Não lida: uma conversa fica marcada como “não lida” até que o médico a abra; abrir não a remove do painel, só tira o destaque visual e a empurra para depois das ainda não vistas na ordenação (ver “Ordenação” na Seção 2.5).
    • O que aparece no painel: o painel compacto do Cockpit (Seção 2.5) mostra todas as conversas em aberto do médico logado — lidas e não lidas. Uma conversa só desaparece dali quando é marcada como Resolvida ou Descartada; essa ação é definitiva (não pode ser desfeita) e fica registrada no histórico para auditoria. O histórico completo (incluindo as já resolvidas/descartadas) fica reservado a uma tela dedicada, fora do escopo desta versão.
    • Prazo: quem inicia a conversa — uma pessoa ou um módulo automático do sistema — pode definir um prazo para resposta ou resolução.
    • Resposta: o médico pode responder diretamente pelo Cockpit, sem precisar telefonar ou ir até quem enviou; responder também marca a conversa como lida.
    • Equipe (destinatário coletivo): uma conversa pode ser endereçada a uma equipe (recepção, farmácia, enfermagem) em vez de a uma pessoa específica — todos os membros da equipe recebem a conversa como destinatários. Quando um membro da equipe responde, a resposta é a mesma para todos: o médico e os demais membros da equipe veem a mesma thread, não cópias separadas. Toda mensagem escrita por um membro de uma equipe dentro de uma conversa endereçada a ela mostra o nome da equipe junto ao nome de quem escreveu (RN-CM-022) — a pessoa está respondendo como representante da equipe, não só em nome próprio.
    • Alerta recorrente: se o mesmo tipo de alerta automático acontecer de novo depois de uma conversa já encerrada, o sistema abre uma conversa nova (não reabre a antiga), mas mantém o vínculo com a anterior para quem for consultar o histórico depois.
    • (Detalhamento técnico — nomes de campo, fórmula de “não lida”, modelo de dados: Seção 2.5 e Seção 4.8.)
  • RN-CM-022 — Identificação da origem: Cada conversa exibe um ícone que distingue apenas se a origem é uma pessoa ou um alerta automático do sistema — o ícone continua binário (pessoa vs. sistema), sem uma variação por equipe (recepção, farmácia, enfermagem). Quando a mensagem foi escrita por um membro de uma equipe respondendo em nome dela (conversa endereçada à equipe — RN-CM-015), o nome da equipe aparece como texto ao lado do nome da pessoa (ex.: “Sandra (Farmácia)”), em vez de uma variação de ícone. Motivador: um ícone por equipe seria redundante com o nome por extenso já exibido em cada mensagem; a identificação da equipe fica a cargo do texto, não do ícone.

Procedimentos na Clínica (Monitoramento)

  • RN-CM-016 — Barra de Progresso: Exibe o tempo decorrido da infusão versus o tempo estimado pelo protocolo. Se ultrapassar 100%, a barra torna-se vermelha. Motivador: o tempo de infusão é um parâmetro de segurança — uma infusão que ultrapassa o tempo previsto pode indicar problema no acesso venoso, na bomba de infusão ou reação do paciente; a barra vermelha chama a atenção do médico sem que ele precise abrir o prontuário para checar.
  • RN-CM-023 — Critério de Não Adesão: Um paciente em tratamento conta como “não aderente” (KPI “Em Tratamento”, subtexto) quando o tratamento se desvia do planejado no protocolo — data real do início do ciclo divergindo da data prevista além de uma margem de tolerância, ou intervalo real entre sessões divergindo do intervalo previsto além dessa mesma margem; qualquer uma das duas condições já conta (lógica “OU”, confirmada com o solicitante — basta um desvio para contar como não aderente). A margem de tolerância vem do protocolo do paciente (critério e mapeamento de campos exatos: Seção 4.5).

Filtros e Estados Padrão dos Painéis

  • RN-CM-021 — Filtro padrão restrito ao que exige ação agora: Os três painéis com botão de alternância (toggle) de filtro abrem, por padrão, mostrando só o que precisa de ação do médico agora — o panorama completo fica a um clique de distância, nunca escondido de vez:
    • Painel de Consultas: toggle “Pendentes/Todas”, default “Pendentes”. Consultas finalizadas não somem da lista ao alternar para “Todas” — aparecem esmaecidas, na posição cronológica original.
    • Painel de Procedimentos na Clínica: toggle “Meus/Todos”, default “Meus” (pacientes do médico logado).
    • Painel de Prescrições Pendentes: toggle “Meus/Todos”, default “Meus”. Este toggle filtra somente as prescrições a revisar em que o médico logado é o prescritor ou o médico assistente do paciente — as prescrições a assinar são sempre do médico logado (RN-CM-012) e nunca ficam escondidas atrás do toggle, já que “Todos” soma as prescrições a revisar de qualquer médico (RN-CM-020) às prescrições a assinar do médico logado.

Atualização de Dados

  • RN-CM-017 — Atualização Frequente: A Central deve ser um espelho confiável da realidade da clínica, sem que o médico precise recarregar a página manualmente. Os dados são atualizados automaticamente em segundo plano, em intervalos fixos (não é uma atualização instantânea a cada mudança — ver mecanismo técnico exato na Seção 2.8). O intervalo varia por painel, dividido em dois grupos conforme o quanto a próxima ação do médico depende da mudança de estado daquele painel:
    • Grupo de 1 minuto (esquerda): painel de Consultas e painel de Comunicação, e o KPI “Consultas Hoje”. Nestes, o estado muda com frequência e a ação seguinte do médico (chamar o próximo paciente, responder uma mensagem) depende diretamente dessa mudança — uma defasagem tem custo operacional imediato.
    • Grupo de 5 minutos (direita): painel de Prescrições Pendentes, painel de Procedimentos na Clínica, e os KPIs “Alertas de Prescrição” e “Procedimentos Hoje”. Nestes, o estado muda com frequência menor e depende mais de uma atualização de terceiros (farmácia, enfermagem) ou do próprio médico (assinar, revisar) do que de uma mudança contínua externa — alguns minutos de defasagem não comprometem a decisão do médico.
    • O KPI “Em Tratamento” não tem painel correspondente no grid (abre a tela “Pacientes do Médico”); por seguir o mesmo raciocínio do Grupo de 5 minutos — adesão ao protocolo muda em escala de dias/sessões, não de minuto a minuto — fica agrupado com ele. (Classificação proposta pelo Designer para este KPI especificamente, já que não há um painel correspondente para herdar a frequência — a confirmar com o solicitante.)
  • RN-CM-019 — Hierarquia visual sem negrito: A Central não utiliza negrito em nenhum elemento estrutural. A hierarquia visual é construída exclusivamente através de tamanho tipográfico, cor e espaçamento. Destaques importantes são feitos por contraste cromático (chips coloridos, borda lateral dos KPIs, número vermelho de alertas) e por tamanho de fonte. Motivador: o negrito deve ser economizado para destaques verdadeiramente importantes; informações estruturais devem orientar o olhar discretamente, não competindo com as informações clínicas que importam. (Valores exatos de peso e tamanho de fonte: Seção 2.8.)

Fluxo Principal (O Ciclo do Dia)

  1. Início do Turno: O médico faz login e visualiza o panorama geral nos KPIs.
  2. Triagem de Pendências: Antes do primeiro paciente, o médico assina as prescrições pendentes de assinatura e confirma a revisão das prescrições marcadas automaticamente como “a revisar” (aplicação agendada em até 1 dia), priorizando as mais urgentes.
  3. Atendimento: Ao identificar um paciente “Recepcionado” no painel de Consultas, o médico clica no nome para abrir o PEP e iniciar o atendimento.
  4. Monitoramento: Entre consultas, o médico observa o painel de Procedimentos na Clínica para verificar se algum tratamento está atrasado ou finalizado.
  5. Comunicação: O médico responde dúvidas rápidas da equipe via painel de Comunicação sem sair da tela principal.

Premissas

  • A assinatura de prescrições pode exigir certificado digital ou não, dependendo da configuração do cliente. Se a clínica está configurada para assinatura com certificado digital, o médico que possuir certificado assina digitalmente; o médico que não possuir certificado deve imprimir e assinar fisicamente. Se a clínica não está configurada para certificado digital, a assinatura é validada apenas pela sessão do usuário logado.
  • A resolução mínima de tela recomendada é de 1920x1080 (Full HD).
  • [A DEFINIR — escopo desktop/mobile, estudo de uso pendente] RN-CM-001/002 (grid fixo de 4 quadrantes sem rolagem geral) e RN-CM-003 (dependente de toque/hover) presumem uso em desktop ou tablet, reforçado pela premissa acima de resolução mínima recomendada — mas não há, até esta versão, uma decisão de produto explícita de que a Central é desktop/tablet-only, o que tensiona com o mandato mobile-first do projeto. Discutido com o solicitante em 28/08/2026: a necessidade de ver os 4 painéis sem rolar parece importante mesmo em telas menores, mas o uso em celular provavelmente seria pontual (tirar uma dúvida, consultar um paciente específico), não para gerenciar o turno inteiro. Hipótese do Designer para validar num estudo futuro, não uma decisão tomada: a Central (este cockpit) fica desktop/tablet-only, enquanto as telas de destino de cada painel (Agenda, Prontuário, Prescrições, Procedimentos) seguem mobile-first, já que são acessadas para consultas pontuais. Fica pendente de um estudo de uso mobile dedicado antes de confirmar como regra de negócio.

Dependências

Sistema/MóduloDependênciaImpacto
Módulo de AgendaStatus da agendaSem isso, o painel de consultas não atualiza.
Módulo de AgendaData/hora da aplicação da prescriçãoA marcação automática de “a revisar” (RN-CM-020) depende da data/hora de aplicação agendada na prescrição — sem essa informação, o sistema não consegue calcular a janela de 1 dia e disparar o estado de revisão.
Serviço de AssinaturaIntegração com CertificadoraNecessário para a validade jurídica da assinatura (quando aplicável).
RecepcionistaAtualização de status na agendaDefine os status “Agendado” e “Recepcionado” no painel de Consultas.

Requisitos SBIS Aplicáveis

SBIS (Sociedade Brasileira de Informática em Saúde) certifica prontuários eletrônicos no Brasil; “ECF” é o prefixo de código usado pela planilha de requisitos dessa certificação (RequisitosSBIS-v5.2) para esta categoria de requisito. Requisitos aplicáveis a esta funcionalidade:

ID SBISDescrição AcessívelImplementação no Cockpit
ECF.03.11Busca multifatorial de pacientesImplementado na busca do cabeçalho (Nome, CPF, Mãe).
ECF.16.01Listagem de pendências do profissionalImplementado no Painel de Prescrições Pendentes.
ECF.17.04Registro de eventos em ordem cronológicaAplicado na ordenação de Consultas e Mensagens.

Histórico de Versões

  • v4.25 (29/08/2026) — Arquivo criado pela divisão do documento único CM_CockPit_do_medico_v4_25.md em 4 arquivos por seção (ver Skill Designer, “Organização Física: Pasta por Funcionalidade”, Lição #18). Conteúdo desta seção sem alteração de substância em relação à v4.25 do documento original — apenas reorganização física. O histórico de revisões anterior a esta divisão (v4.0 a v4.25, incluindo o racional de cada mudança) está preservado integralmente no documento original, arquivado em Histórico/CM_CockPit_do_medico_v4_25 (documento único, antes da divisão em 4 arquivos).md.
  • v4.26 (30/08/2026) — Duas correções pedidas pelo solicitante, focadas em compreensão humana (Workflow 1, “Antes de chamar o próximo paciente” e “Durante o atendimento”): (1) a justificativa de design do badge de atraso foi reescrita para linguagem mais direta — “Pacientes atrasados provavelmente geram sobreposição de horários. Cabe ao médico decidir quem atender primeiro” — sem alterar o comportamento descrito (continua sendo decisão do médico, badge não sugere prioridade). (2) o touchpoint “Durante o atendimento” foi renomeado para “Durante o turno” — “atendimento” é um termo já usado neste documento para o momento em que o profissional está fisicamente com o paciente (consulta em andamento), o que não é o que este touchpoint descreve (o médico navegando entre pacientes ao longo do turno); justificativa de design reescrita no mesmo sentido: “Durante o turno, o médico foca nos próximos atendimentos - finalizadas saem do foco visual sem sumir da lista.” RN-CM-020 (revisão automática pré-aplicação) também ajustada: a janela de “1 dia (24h)” deixa de ser descrita como valor fixo — passa a ser explicitamente um parâmetro configurável por clínica (mesmo padrão já usado para os limiares de urgência de RN-CM-011 e para a janela de 7 dias), com o mapeamento de banco completo do novo parâmetro (IpParametro.PrescricaoTempoRevisao) na Seção 4.6 — pedido do solicitante.