01 - Definição v4.29

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

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

---

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 Mensagens. 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

Persona	Papel no Sistema	Necessidade Principal
Médico Oncologista	Usuário Principal	Visão 360º do dia, agilidade na assinatura e monitoramento de segurança.
Recepcionista	Stakeholder operacional	Manté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êutica	Stakeholders 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 workflow	Necessidade do profissional	O que a Central oferece	Decisão de design justificada
Antes de chamar o próximo paciente	Saber rapidamente quem está recepcionado e pronto para atendimento	Painel 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 paciente	Identificar se o paciente está atrasado (horário passou e não iniciou)	Badge vermelho pulsante “Atrasado · Xmin” no card de consulta	Pacientes 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 atendimentos	Acessar o prontuário do próximo paciente sem navegar por menus	Clique no card de consulta abre diretamente o PEP	Um 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 turno	Ter 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 turno	Não ser interrompido por informações irrelevantes	Consultas 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 workflow	Necessidade do profissional	O que a Central oferece	Decisão de design justificada
Entre consultas / durante o turno	Saber quais pacientes estão em procedimento na clínica e em qual etapa	Painel de Procedimentos na Clínica com status (Em Atendimento / Aguardando) e local na clínica	Consolida em um olhar onde cada paciente está no fluxo, sem o médico sair da sua tela.
Durante o monitoramento	Saber se uma infusão está dentro do tempo previsto ou atrasada	Barra de progresso inline (3px) na linha do nome, com porcentagem	Reforç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 consultas	Decidir se precisa intervir em um procedimento em andamento	Clique no card abre a prescrição do procedimento; botão separado “PEP” abre o prontuário	A 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 turno	Saber quantos pacientes estão em tratamento sob sua responsabilidade e quantos não estão aderentes	KPI “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 turno	Filtrar apenas seus pacientes vs. ver todos os da clínica	Botã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 workflow	Necessidade do profissional	O que a Central oferece	Decisão de design justificada
Início do turno / entre atendimentos	Assinar prescrições pendentes antes que a farmácia possa manipular	Painel de Prescrições Pendentes com botão “Assinar” no card que abre a tela de assinatura com a prescrição completa	A 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 turno	Priorizar quais prescrições assinar primeiro (as mais urgentes)	Chips de urgência: vermelho (<12h) e laranja (12-24h) com tempo restante	Cor 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 agendada	Confirmar que a prescrição foi revisada por um médico antes da administração ao paciente	Card 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 confirmar	Reaproveita 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 turno	Saber quantas prescrições urgentes (menos de 12h) precisam de sua atenção	KPI “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 dias	Número em vermelho chama atenção imediata ao logar; subtexto dá contexto sem competir com ele.
Ao assinar uma prescrição	Confirmar que a assinatura foi processada e retornar à Central	Toast de sucesso “Prescrição assinada com sucesso” + retorno automático à Central, focada no painel de Prescrições Pendentes + atualização do KPI	Toast + retorno automático + decremento do KPI fecham o loop de feedback sem o médico precisar navegar de volta manualmente.
Ao revisar prescrições	Focar primeiro nas prescrições que é preferencialmente responsável por revisar (seus pacientes), mas poder ajudar a revisar as de colegas quando necessário	Toggle 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 workflow	Necessidade do profissional	O que a Central oferece	Decisão de design justificada
Durante todo o turno	Receber conversas e alertas da equipe sem sair da Central	Painel de Mensagens 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 nova	Identificar rapidamente que há conversa não lida	Conversas 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 conversas	Priorizar conversas com prazo de resposta	Prazo exibido no card (“Responder até 14:00”) + ordenação por prazo primeiro	Prazo é compromisso — visível no card, permite triagem sem abrir a conversa.
Ao precisar esclarecer algo rapidamente	Responder sem sair do Cockpit, sem precisar telefonar ou ir até a equipe	Campo 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ção	Arquivar a conversa com um clique	Botã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 resposta	Tirar a conversa do painel sem marcá-la como resolvida	Botã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 turno	Distinguir 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 equipe	Saber que quem respondeu falou pela equipe, não só por si mesmo	Nome 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 do scroll independente por painel: ainda não especificado na Seção 2 desta versão — a referência anterior a “Seção 2.8” estava incorreta, essa seção não cobre este comportamento.)
• 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 — Mensagens: 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: ainda não tokenizada na Seção 2.8 desta versão — a referência anterior apontava para lá, mas a tabela de componentes não lista este par de cores; a especificar.)
• 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.1). 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.

Tags de Atenção

• RN-CM-025 — Tags de Atenção: Tags são marcadores visuais criados e administrados por cada clínica (não fixos no sistema), atribuídos a um paciente para sinalizar rapidamente uma característica que merece atenção do profissional (ex.: VIP, Primeira Consulta, em quimioterapia). Aparecem em pontos definidos da aplicação — nesta funcionalidade, nos cards dos painéis de Consultas e de Procedimentos na Clínica (Seção 2) — para que o médico reconheça a característica de bate-olho, sem precisar abrir o prontuário. O cadastro e a administração das tags em si (quais existem, cores, quem pode criar) pertencem a uma funcionalidade própria, fora do escopo deste documento — aqui só se documenta como elas aparecem no Cockpit.

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. Por enquanto, esses limiares (12h/24h) são valores fixos no sistema, iguais para todas as clínicas — não um parâmetro configurável (diferente dos limiares de tempo de RN-CM-020, que são parâmetro por clínica). 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. Essa janela de 7 dias também é um parâmetro configurável por clínica, com valor-padrão herdado da experiência do sistema legado — mapeamento completo do parâmetro de banco na Seção 4.6.
  • 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.
  • Retorno à camada de não lidas: se uma conversa que o médico já respondeu (selo “Respondida”) recebe uma nova mensagem depois dessa resposta, ela volta para a camada de não lidas do painel — destaque visual restaurado, prioridade de ordenação elevada de novo — mas mantém o selo indicando que já houve uma resposta anterior, para diferenciá-la de uma conversa nunca respondida.
  • (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 em qualquer uma de três situações (lógica “OU” — basta uma delas para contar como não aderente): a primeira sessão do tratamento (C1D1) foi realizada em data diferente da planejada, além de uma margem de tolerância — checagem que só se aplica quando existe um plano terapêutico formal cadastrado para o mesmo protocolo, e é ignorada quando não existe, já que nem todo médico chega a criar um; uma sessão já esperada para uma data passada não foi de fato realizada; ou a data real de uma sessão já realizada diverge da data esperada para ela, contada a partir do início do tratamento. Esse terceiro cálculo, diferente do primeiro, não depende de plano terapêutico — usa só as prescrições já realizadas do paciente — e aplica duas margens de tolerância diferentes: uma menor para desvios dentro do mesmo ciclo, e uma maior para desvios que atravessam um ciclo diferente. As margens de tolerância vêm do protocolo do paciente (critério e mapeamento de campos exatos: Seção 4.5).
• RN-CM-024 — Critério de Paciente em Tratamento: Um paciente conta para o número principal do KPI “Em Tratamento” quando teve agenda realizada ou prescrição registrada dentro de uma janela recente de atividade (padrão: 6 meses) — passado esse período sem nenhuma das duas, ele deixa de ser considerado em tratamento para fins deste indicador. Essa janela é um parâmetro configurável por clínica, não um valor fixo no sistema (mapeamento de banco: 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.9). 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 Mensagens, 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. Mensagens: O médico responde dúvidas rápidas da equipe via painel de Mensagens 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ódulo	Dependência	Impacto
Módulo de Agenda	Status da agenda	Sem isso, o painel de consultas não atualiza.
Módulo de Agenda	Data/hora da aplicação da prescrição	A 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 Assinatura	Integração com Certificadora	Necessário para a validade jurídica da assinatura (quando aplicável).
Recepcionista	Atualização de status na agenda	Define 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 SBIS	Descrição Acessível	Implementação no Cockpit
ECF.03.11	Busca multifatorial de pacientes	Implementado na busca do cabeçalho (Nome, CPF, Mãe).
ECF.16.01	Listagem de pendências do profissional	Implementado no Painel de Prescrições Pendentes.
ECF.17.04	Registro de eventos em ordem cronológica	Aplicado na ordenação de Consultas e Mensagens.

---

Histórico de Versões

• v4.29 (16/09/2026) — Terceiro ajuste de RN-CM-023, pedido do solicitante ao revisar a v4.28, em paralelo com a Seção 4.5 do Mapeamento (v4.32): (1) a condição do C1D1 só se aplica quando existe um plano terapêutico formal cadastrado para o mesmo protocolo — antes o texto não deixava essa dependência clara; quando não há plano, a condição é ignorada para aquele paciente. (2) A condição de sessão diverge da data esperada foi simplificada no texto (sem mudança de sentido de negócio) — mantém as duas margens de tolerância (mesma vs. outro ciclo), mas descrita agora sem a mecânica interna de cálculo, que pertence só ao Mapeamento.
• v4.28 (16/09/2026) — Pedido do solicitante ao revisar a RN-CM-023 (v4.27): o cálculo de não adesão não pode depender de plano terapêutico (muitos médicos não criam um no sistema) nem de vínculo garantido entre prescrição real e sessão projetada. RN-CM-023 reescrita em paralelo com a correção técnica feita na Seção 4.5 do Mapeamento de Banco de Dados (v4.31): o cálculo passa a partir das prescrições já realizadas do paciente, ancorado na primeira sessão do tratamento (C1D1), sem depender de plano formal; a condição de “sessão diverge da data estimada” passa a usar duas margens de tolerância diferentes (uma para desvio dentro do mesmo ciclo, outra para desvio que atravessa ciclo), em vez de uma única margem genérica. Texto mantido em linguagem de negócio, sem nomes de campo (mapeamento técnico completo: Seção 4.5 do Mapeamento).
• v4.27 (16/09/2026) — Rodada de correções após a primeira revisão de versão aprovada (Agentes de UI/UX e Técnico, ver Skill Designer). (1) RN-CM-011: os limiares de urgência (12h/24h) voltam a ser descritos como valores fixos “por enquanto” — a v4.26 anterior os tinha descrito como parâmetro configurável por engano, junto com o parâmetro de RN-CM-020; decisão do solicitante nesta versão. (2) RN-CM-020: a “janela de 7 dias” passa a apontar para a Seção 4.6, onde nasce nesta mesma rodada o parâmetro de banco IpParametro.PrescricaoValidadeAssinatura (Mapeamento de Banco de Dados v4.30). (3) RN-CM-023 reescrita de duas para três condições de não adesão, para bater com o Mapeamento de Banco de Dados (que já usava três) — a divergência vinha de a Definição não ter sido atualizada quando a regra evoluiu no documento técnico; a segunda condição também recebeu a correção de conceito registrada no Mapeamento v4.30 (comparação por sessão, não por intervalo entre ciclos). (4) Nova RN-CM-024, documentando o critério de “6 meses de atividade” para entrar no KPI “Em Tratamento” — regra que já existia implementada no Mapeamento de Banco de Dados desde antes da divisão em 4 arquivos, mas nunca tinha chegado à Definição. (5) Nova RN-CM-025 (“Tags de Atenção”), documentando o conceito de tags (criadas e administradas pela própria clínica, sinalizando características do paciente em pontos definidos da aplicação) que já aparecia na Especificação e no Mapeamento sem nunca ter sido definido na Seção 1 — cadastro/administração das tags continua fora do escopo deste documento. (6) RN-CM-015 ganhou um novo bullet (“Retorno à camada de não lidas”), documentando um comportamento que já existia na Especificação (§2.5) e no Protótipo, mas não na Definição: uma conversa já respondida que recebe atividade nova volta a aparecer como não lida, mantendo o selo “Respondida”. (7) Removida a expressão “confirmada com o solicitante” do corpo de RN-CM-023 (proveniência de decisão não deve aparecer fora do Histórico — Lições Aprendidas da Skill Designer); preservada nesta entrada. (8) Nome do painel “Comunicação” trocado para “Mensagens” em todas as 5 ocorrências deste documento (narrativa do dia, tabela de touchpoints, descrição do Quadrante inferior esquerdo, agrupamento de atualização de RN-CM-017, fluxo principal) — consolidando com o nome já usado no link de navegação da Especificação; a seção/workflow “Comunicação Interna” (rótulo de organização do documento, não nome de painel) não foi alterada. (9) Referências cruzadas corrigidas: RN-CM-004 apontava para “Seção 2.8” quando o intervalo de busca está na Seção 2.1; RN-CM-017 apontava para “Seção 2.8” quando o mecanismo de polling está na Seção 2.9. Verificação estendida (pedido do solicitante: “corrija as referências cruzadas”) encontrou mais duas referências a “Seção 2.8” sem destino correspondente — RN-CM-001 (detalhamento do scroll independente por painel) e RN-CM-002 (cor exata do cabeçalho do painel); nenhuma das duas está de fato descrita na Seção 2.8 da Especificação — convertidas em nota honesta de lacuna em vez de apontar para um lugar errado, já que o conteúdo em si ainda não existe em nenhuma seção.
• 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.