# Central do Médico (Cockpit) — Definição (v4.26) **Documentos desta funcionalidade:** [01 - Definição](./01%20-%20Defini%C3%A7%C3%A3o%20v4.26.md) (v4.26) · [02 - Especificação](./02%20-%20Especifica%C3%A7%C3%A3o%20v4.25.md) (v4.25) · [03 - Protótipo](./03%20-%20Prot%C3%B3tipo%20v3.13.md) (v3.13, código executável em `03 - Protótipo v3.13.html`) · [04 - Mapeamento de Banco de Dados](./04%20-%20Mapeamento%20de%20Banco%20de%20Dados%20v4.28.md) (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 |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 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 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: 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ó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.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.