Agenda do Médico — Definição (v1.5)

Documentos desta funcionalidade: 01 - Definição (v1.5) · Especificação (Seção 2): pendente · Protótipo (Seção 3): pendente · Mapeamento de Banco de Dados (Seção 4): pendente — já tem um item confirmado para a subseção “Seeds da Funcionalidade” (RN-AGM-004) quando a Seção 4 for escrita.

SEÇÃO 1 — DEFINIÇÃO

Objetivo

Dar ao médico uma visão ampla e navegável da própria agenda do dia — todas as suas consultas agendadas, com os mesmos elementos de identificação de paciente já usados no Cockpit — permitindo também bloquear horários vagos (ex.: para reuniões, ausências, atividades não assistenciais). É a tela dedicada aberta ao clicar no cabeçalho do painel “Consultas” do Cockpit (Central do Médico) — mesmo ponto de entrada já usado hoje (RN-CM-003).

Escopo

Dentro do escopo:

Visualização das consultas do médico logado para um dia específico (o dia atual, por padrão).
Navegação entre dias (avançar, retroceder, voltar para hoje).
Bloqueio de horários vagos da própria agenda.
Acesso à consulta a partir de um item da agenda: toque abre o Prontuário Eletrônico do Paciente (PEP) — mesmo comportamento já usado hoje a partir do card de consulta no Cockpit (RN-AGM-009).
Exibição, por consulta, dos mesmos elementos já usados no Cockpit — paciente, horário, status, modo de atendimento, indicador de primeira consulta e tags do paciente (RN-AGM-009) — mais dois elementos novos desta funcionalidade: campo de complemento (RN-AGM-007) e tipo de consulta, quando configurado pelo cliente (RN-AGM-008). As tags do paciente, nesta tela, mostram só o subconjunto habilitado para exibição em agenda (RN-AGM-006).
Agrupamento visual de consultas já finalizadas/canceladas, para manter as consultas pendentes sempre acessíveis sem rolagem excessiva (RN-AGM-010).
Atalho de navegação para o próximo/anterior dia com consulta agendada, sem precisar percorrer dia a dia os dias vazios (RN-AGM-003).

Fora do escopo:

Criar, editar, cancelar ou reagendar consultas. Essas ações continuam exclusivas do processo de Agendamento, conduzido pela Recepção.
Parametrização de agendas (dias/horários por especialidade e profissional — SBIS ECF.05.01) e de tipos de consulta (SBIS ECF.05.04, a parte de cadastro do domínio) — fora de escopo desta tela; ela apenas exibe o tipo de consulta já configurado (RN-AGM-008).
Check-in/chegada do paciente na clínica — fluxo de Recepção.
Execução do atendimento — fluxo do PEP.
Duração da consulta — já definida pela Recepção no momento do agendamento (RN-AGM-005); esta tela não a edita.

Personas envolvidas

Médico — único usuário desta tela, não necessariamente oncologista. Mesma persona de Central do Médico, ver Central do Médico, Seção 1, “Personas”.

Nenhuma outra persona usa esta tela. Telas equivalentes para outros profissionais (agenda da enfermagem, agenda da farmácia, agenda da recepção) são funcionalidades futuras e independentes.

Workflows do Profissional

Esta funcionalidade não introduz um workflow novo — ela é o destino de um touchpoint já documentado no Cockpit e o ponto de partida para o touchpoint “abrir o Prontuário Eletrônico do Paciente (PEP) a partir de uma consulta”, também já especificado lá. Resumo do encaixe, sem repetir o fluxo completo (documentado em Central do Médico):

O médico está no Cockpit e quer ver o dia inteiro (não só os próximos atendimentos do painel compacto) ou bloquear um horário — clica no título “Consultas”.
A Agenda do Médico abre no dia atual, em formato de lista.
O médico pode navegar para outro dia — dia a dia, ou pulando direto para o próximo dia com consulta agendada — por exemplo, para checar a agenda de amanhã antes de sair.
Alternativamente, pode bloquear um horário vago — por exemplo, para uma reunião administrativa ou uma ausência programada.
Ao tocar em uma consulta, o sistema abre o PEP do paciente — mesmo destino já usado a partir do card de consulta no Cockpit.
Não há retorno automático ao Cockpit; o médico volta usando a navegação padrão do sistema (menu, botão de voltar), como em qualquer outra tela.

Regras de Negócio

ID	Regra
RN-AGM-001	Somente leitura de consultas. O médico pode visualizar e navegar pela agenda e bloquear horários vagos, mas não pode criar, editar, cancelar ou reagendar consultas nesta tela.
RN-AGM-002	Escopo do médico logado. A tela mostra exclusivamente a agenda do médico autenticado — mesmo critério de filtro já usado em Central do Médico. Não há alternância para ver a agenda de outro médico.
RN-AGM-003	Navegação por dia, sem limite de horizonte. Visualização diária (não semanal nem mensal). O médico pode avançar ou retroceder dia a dia e retornar diretamente ao dia atual — sem limite máximo de navegação para o passado ou o futuro. Além da navegação sequencial, o médico pode pular diretamente para o próximo (ou anterior) dia que tenha ao menos uma consulta agendada, evitando percorrer um a um os dias sem nenhum compromisso.
RN-AGM-004	Bloqueio de horários. O médico pode bloquear um horário vago da própria agenda (ex.: reunião, atividade não assistencial, ausência). O bloqueio usa a mesma estrutura de agenda das consultas normais — não é preciso nenhuma configuração nova de sistema para o médico bloquear um horário. Fica pendente de confirmação se esses registros de bloqueio devem ser excluídos de relatórios de faturamento e de contagem de pacientes, a esclarecer antes da Seção 4.
RN-AGM-005	Duração não editável aqui. A duração de cada consulta já é definida pela Recepção no momento do agendamento; esta tela apenas exibe o intervalo resultante — mesma origem já usada em Central do Médico.
RN-AGM-006	Tags do paciente restritas às habilitadas para agenda. Diferente do Cockpit (que exibe todas as tags do paciente), esta tela exibe apenas o subconjunto de tags que foi configurado, na definição de cada tag, como habilitado para exibição em agendas.
RN-AGM-007	Campo de complemento. Cada consulta pode ter um complemento textual livre, associado ao agendamento, para observações adicionais sobre o horário.
RN-AGM-008	Tipo de consulta (opcional por cliente). Quando a clínica configurou tipos de consulta, cada consulta exibe o seu; clínicas que não configuraram esse domínio simplesmente não exibem essa informação.
RN-AGM-009	Elementos e comportamentos herdados do Cockpit. Paciente (nome preferido/legal, foto, diagnóstico oncológico), horário, status do atendimento, modo de atendimento, indicador de primeira consulta e tags do paciente (aqui restritas ao subconjunto habilitado para agenda — RN-AGM-006) — todos com a mesma origem e lógica já definidas em Central do Médico, não redefinidos aqui, apenas reutilizados nesta tela. O mesmo vale para o comportamento de acesso à consulta: tocar em um item da agenda abre o Prontuário Eletrônico do Paciente (PEP), igual ao já usado no Cockpit.
RN-AGM-010	Consultas finalizadas ou canceladas agrupadas, não ocultas. O objetivo desta tela é a visão ampla do dia inteiro — diferente do painel compacto do Cockpit, que oculta consultas já concluídas por padrão, esta tela nunca esconde uma consulta. Ao mesmo tempo, consultas já concluídas ou canceladas não precisam ocupar o mesmo espaço visual que as pendentes, que são o foco do trabalho do médico: elas são agrupadas num bloco único, compacto e recolhido por padrão (ex.: “6 consultas já realizadas ▸”), expansível sob demanda. Complementarmente, a tela abre com a posição de rolagem já ancorada no horário atual, deixando a próxima consulta pendente visível sem necessidade de rolagem.

Premissas

O médico só usa esta tela para a própria agenda — não há necessidade de seletor de profissional.
A visualização diária é o formato de período (dia, não semana/mês). O formato visual dentro do dia é lista.
O bloqueio de horário reaproveita estrutura de agenda já existente (RN-AGM-004) — nenhuma tabela nova necessária para esta regra.

Dependências

Central do Médico (Cockpit) — ponto de entrada (RN-CM-003) e origem dos elementos de card reutilizados. Mudanças nesses elementos em Central do Médico devem se refletir aqui.
Agendamento (Recepção) — cria, edita, cancela e reagenda as consultas que esta tela exibe; também é responsável pela parametrização de agendas por especialidade/profissional (SBIS ECF.05.01) e pelo cadastro de tipos de consulta (SBIS ECF.05.04, parte de cadastro). Ainda não especificada como funcionalidade própria neste projeto.
PEP (Prontuário Eletrônico do Paciente) — destino ao tocar em uma consulta.

Requisitos SBIS Aplicáveis

Requisitos aplicáveis do grupo “ECF.05 - Agendamento” e, transversalmente, “Auditoria” (NGS1):

Requisito	Título	Estágio (clínica/ambulatório)	Aplicação nesta funcionalidade
ECF.05.02	Bloqueios na agenda	2 (recomendado)	Atendido pela funcionalidade de bloqueio de horários (RN-AGM-004).
ECF.05.04	Especificação do tipo de consulta	2 (recomendado)	Atendido pela exibição do tipo de consulta (RN-AGM-008), quando configurado pelo cliente. A parte de cadastro/parametrização do tipo de consulta é responsabilidade de outra funcionalidade (fora de escopo aqui).
ECF.05.01	Parametrização de agendas de consultas	2 (recomendado)	Fora de escopo desta tela — dependência (ver “Dependências”), não pendência.
ECF.05.03	Agendamento de consultas por profissionais	1 (obrigatório)	Fora de escopo desta tela (só visualização + bloqueio, ver “Escopo”) — atendido pelo fluxo de Agendamento da Recepção, ainda não especificado neste projeto. Registrado aqui para não passar despercebido: é estágio 1, então precisa ser coberto por alguma funcionalidade do projeto, mesmo que não seja esta.
NGS1.07.03 / NGS1.07.04	Eventos (e eventos avançados) registrados na trilha de auditoria	1 / 2	Acesso a dados de paciente e a ação de bloqueio de horário (RN-AGM-004) devem gerar evento de auditoria, mesmo padrão já usado em outras funcionalidades assistenciais deste projeto.

Próximos passos

Seção 2 (Especificação) — todas as regras de negócio estão fechadas; a Seção 1 pode ser considerada pronta para dar início à Seção 2.
Confirmar com o solicitante, antes da Seção 4: se os registros de bloqueio de horário (RN-AGM-004) devem ser excluídos de relatórios de faturamento e de contagem de pacientes.
Mapeamento de Banco de Dados (Seção 4) — quando escrita, detalhar tecnicamente RN-AGM-004, RN-AGM-006, RN-AGM-007 e RN-AGM-008, e incluir o registro de bloqueio (paciente/convênio reservados) como item pendente de criação por cliente no setup de um cliente novo.

Prioridade sugerida

Should Have — não é bloqueante para o fluxo assistencial do Cockpit (que já mostra ao médico, de forma resumida, os próximos atendimentos do turno), mas cobre um requisito SBIS estágio 1 relacionado (ECF.05.03, ainda que não implementado nesta tela) e dois recomendados (ECF.05.02, ECF.05.04) diretamente.

Complexidade estimada

Baixa — nenhuma tabela nova, reaproveita estrutura de agenda já existente; a única variação em relação a uma tela de listagem simples é a navegação para o próximo dia com consulta e o agrupamento de consultas já concluídas.

Dependências (funcionalidades mapeadas)

Central do Médico (Cockpit) — DOC-004. Agendamento (Recepção) — ainda não mapeada neste projeto.

Histórico de Versões

v1.0 (31/08/2026) — Documento criado. Seção 1 (Definição) completa, a partir das respostas do solicitante sobre contexto (Assistencial), objetivo/escopo (visualização + navegação + bloqueio, sem CRUD de consulta), persona (médico, não necessariamente oncologista), visualização (diária; formato lista vs. grade em aberto) e regras de negócio (duração fixada pela Recepção; tags restritas às habilitadas para agenda; campo de complemento; tipo de consulta opcional por cliente). Estrutura real de banco consultada na Biblioteca de Schema (DDL) para Agenda.Complemento, Agenda.TipoConsulta, AgendaClassificacao/AgendaSubClassificacao, ProgramaApoio.MostrarEm e o padrão de filtro por médico logado (Agenda.IdChRecurso) já usado em Central do Médico — nenhuma estrutura inventada; itens sem decodificação disponível marcados [A DEFINIR]. Seções 2, 3 e 4 pendentes.
v1.1 (31/08/2026, mesmo dia) — Três respostas do solicitante incorporadas. (1) RN-AGM-006 resolvida: ProgramaApoio.MostrarEm é mapa de bits (prontuário=1, cadastro do paciente=2, Central do Médico=4, confirmação de quimio=8, agendas=32), confirmado por três exemplos numéricos consistentes do solicitante; condição de filtro (MostrarEm & 32) = 32; registrada como nota não-bloqueante uma inconsistência aritmética no quarto exemplo dado (63=“todas as telas” exige um bit 16 não descrito entre as 5 telas nomeadas). (2) RN-AGM-004 (mecanismo de bloqueio) mantida [A DEFINIR] por decisão do solicitante — leitura candidata anterior (TipoAgenda='S' + AgendaSalaPacienteEspecial) retirada da regra por ora; solicitante consultando o time do sistema legado. (3) Criada RN-AGM-010 [PROPOSTA] — resposta a uma pergunta do solicitante sobre como tratar consultas finalizadas/canceladas sem comprometer a objetividade da tela: agrupamento compacto e recolhido (não ocultação, diferente do padrão do painel compacto de Central do Médico) + rolagem ancorada no horário atual ao abrir a tela; nota sobre como a proposta se traduziria em cada formato de visualização (lista vs. grade), alimentando a decisão de formato ainda pendente.
v1.2 (31/08/2026, mesmo dia) — Duas pendências de dados resolvidas pelo solicitante. (1) RN-AGM-004 (bloqueio de horário) resolvida: mecanismo real confirmado — paciente especial Paciente.Paciente = 'B' como Agenda.IdPaciente + convênio especial Convenio.Convenio = 'B' como Agenda.IdChConvenio; ambos os campos (Paciente.Paciente, Convenio.Convenio) confirmados na Biblioteca de Schema (DDL) antes de escrever a regra — não invenção. Resta apenas confirmar se as linhas “Bloqueio” já existem em produção ou precisam entrar como seed (Seção 4). (2) RN-AGM-006 corrigida: o solicitante notou o bit faltante apontado na v1.1 — domínio revisado para 6 telas (prontuário=1, cadastro do paciente=2, recepção=4, Central do Médico=8, confirmação de quimio=16, agendas=32), soma agora bate exatamente com o exemplo “63 = todas as telas”; o bit de “agendas” usado no filtro desta funcionalidade permanece 32, sem mudança na condição de filtro. Também produzida (fora da numeração de Seção 3) uma demonstração visual de RN-AGM-010, a pedido do solicitante — ver Comparação de Formato — Lista vs Grade (exploração).html, atualizado.
v1.3 (31/08/2026, mesmo dia) — Resolvida a última pendência de RN-AGM-004: o solicitante decidiu que o paciente/convênio “Bloqueio” entram como seed desta funcionalidade (uma linha de cada por cliente, criada no setup/deploy), não apenas verificados se já existem — motivo dado: também servem como item de conferência do setup de um cliente novo. A criação da linha propriamente dita na subseção “Seeds da Funcionalidade” fica para quando a Seção 4 for escrita (a Seção 4 desta funcionalidade ainda não foi iniciada — Seções 2 e 3 seguem pendentes, aguardando a decisão de formato); RN-AGM-004 e a tabela SBIS (ECF.05.02) atualizadas para refletir a decisão, sem pendência restante.
v1.4 (31/08/2026, mesmo dia) — Decisão de formato de visualização: o solicitante escolheu lista (após comparar com grade na demonstração exploratória). Objetivo, Escopo, Workflow do Profissional, Premissas, RN-AGM-010 e “Próximos passos” atualizados para refletir a decisão — nenhuma regra de negócio nova criada, apenas texto ajustado para não descrever mais dois formatos em aberto. Resta confirmar RN-AGM-010 (agrupamento) e RN-AGM-003 (horizonte de navegação) antes de iniciar a Seção 2 (Especificação); nenhum outro item pendente.
v1.5 (31/08/2026, mesmo dia) — Duas decisões do solicitante incorporadas: RN-AGM-010 (agrupamento de consultas finalizadas/canceladas + rolagem ancorada em “agora”) confirmada, sem mudança de texto; RN-AGM-003 revisada — sem limite de horizonte de navegação (nem passado, nem futuro) e adicionado o atalho para pular diretamente ao próximo/anterior dia com consulta agendada. Nesta versão o documento também passou, pela primeira vez, pela revisão de crítico de negócio prevista na Skill Designer (“Revisão por Dois Críticos”) — etapa que vinha sendo pulada para este documento, apontado pelo solicitante. O crítico (rodado como subagente independente, sem contexto da conversa) encontrou uma lista de achados; após verificar cada um contra a fonte, foram aplicados: (1) limpeza geral do corpo — removidas expressões de proveniência de decisão (“decisão do solicitante”, “confirmado pelo solicitante”, menções a número de versão e a Lições da metodologia) e detalhe técnico de banco de dados (nomes de campo, tipos, aritmética do mapa de bits) que haviam se infiltrado nas regras de negócio e no Objetivo/Escopo/Premissas — esse conteúdo passa a viver só no Histórico de Versões (proveniência de decisão, como nas entradas anteriores desta seção) ou fica reservado para a Seção 4, quando escrita (detalhe técnico); (2) corrigida uma contradição entre “Próximos passos” (que já dizia a Seção 1 fechada) e a última linha do Histórico da v1.4 (que ainda listava RN-AGM-003/010 como pendentes) — resolvida por esta própria versão confirmar as duas regras; (3) corrigida uma inconsistência no Escopo, que listava “tags do paciente” ao mesmo tempo como elemento herdado do Cockpit e como um dos “elementos novos” desta tela — esclarecido que é um elemento herdado, com um filtro novo (RN-AGM-006); RN-AGM-009 (antes só “elementos herdados”) passou a também cobrir o comportamento herdado de abrir o PEP ao tocar numa consulta, que estava descrito no Escopo e no Workflow sem estar formalizado em nenhuma regra de negócio; (4) decodificada a sigla PEP já na primeira ocorrência, no Escopo; (5) registrada, como nova pendência a esclarecer antes da Seção 4, se os registros de bloqueio de horário (RN-AGM-004) devem ser excluídos de relatórios de faturamento e de contagem de pacientes — pergunta levantada pelo crítico, ainda sem resposta do solicitante. Nenhuma regra de negócio teve seu comportamento alterado por este passo de limpeza/crítica, exceto o esclarecimento de fato descrito em (3).

Gemed 2.1 — Documentação

Explorador

01 - Definição v1.5