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

Documentos desta funcionalidade: 01 - Definição (v1.7) · 02 - Especificação (v1.2) · 03 - Protótipo (v1.1, código executável em 03 - Protótipo v1.1.html) · Mapeamento de Banco de Dados (Seção 4): pendente.

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 na Central do Médico — permitindo também bloquear horários vagos (ex.: para reuniões, ausências, atividades não assistenciais). É a tela dedicada aberta a partir da Central do Médico, tanto pelo título do painel “Consultas” (RN-CM-003) quanto pelo indicador “Consultas Hoje”.

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, pular para o próximo/anterior dia com consulta — RN-AGM-003).
Busca de pacientes no cabeçalho da tela, a mesma já disponível na Central do Médico (RN-AGM-014).
Bloqueio de horários livres e futuros da própria agenda, dentro do seu horário de trabalho; desfazer um bloqueio que ainda não começou e encerrar antes do fim um bloqueio em andamento (RN-AGM-004, RN-AGM-012, RN-AGM-015).
Exibição dos horários livres do dia dentro do horário de trabalho do médico, como ponto de partida para bloquear um horário (RN-AGM-016).
Acesso à consulta a partir de um item da agenda: toque abre o Prontuário Eletrônico do Paciente (PEP) — mesmo comportamento já usado a partir do card de consulta na Central do Médico (RN-AGM-009).
Exibição, por consulta, dos mesmos elementos já usados na Central do Médico — paciente, horário, status, sinalizador de atraso, modo de atendimento, tag de primeira consulta e tags do paciente (RN-AGM-006, RN-AGM-009) — mais dois elementos novos desta funcionalidade: campo de complemento (RN-AGM-007) e tipo de consulta, quando configurado pela clínica (RN-AGM-008).
Agrupamento visual de consultas já realizadas e de consultas canceladas, em blocos separados, para manter as consultas pendentes sempre acessíveis sem rolagem excessiva (RN-AGM-010).
Atualização automática dos dados exibidos, sem o médico precisar recarregar a tela (RN-AGM-013).

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.
Definição do horário de trabalho do médico (rotina semanal, folgas, férias, exceções de trabalho extra), do horário de funcionamento da clínica e dos bloqueios no nível da clínica (ex.: feriados) — feitos pela Recepção e pela Administração, em outras funcionalidades; esta tela apenas os respeita e exibe (RN-AGM-015).

Personas envolvidas

Médico — único usuário desta tela, de qualquer especialidade. Na Central do Médico a persona é descrita como médico oncologista, foco atual do projeto (ver Central do Médico, Seção 1, “Personas”); esta tela não depende da especialidade — para um médico que não é oncologista, o diagnóstico oncológico simplesmente não aparece nos itens.

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 dois touchpoints já documentados na Central do Médico 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á na Central do Médico 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” ou no indicador “Consultas Hoje”.
A Agenda do Médico abre no dia atual, em formato de lista, já posicionada na primeira consulta que ainda exige ação.
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 livre que ainda não passou — tocando diretamente num horário livre da lista ou pelo menu de opções —, por exemplo para uma reunião administrativa ou uma ausência programada; ou encerrar mais cedo um bloqueio em andamento (ex.: a reunião acabou antes).
Ao tocar em uma consulta, o sistema abre o PEP do paciente — mesmo destino já usado a partir do card de consulta na Central do Médico. Se precisar de um paciente que não está na agenda do dia, usa a busca do cabeçalho, sem voltar à Central.
Não há retorno automático à Central do Médico; 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 na 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. Horários bloqueados (RN-AGM-011) e consultas canceladas não fazem um dia contar como “dia com consulta” para esse atalho.
RN-AGM-004	Bloqueio de horários. Um bloqueio reserva um intervalo da agenda de um profissional, dentro de um único dia (ex.: reunião, atividade não assistencial, ausência). Usa a mesma estrutura de agenda das consultas normais — o médico não precisa de nenhuma configuração própria para bloquear um horário; basta um registro reservado de bloqueio, criado uma única vez por clínica na implantação. Quem cria: o próprio médico cria bloqueios particulares na sua agenda, por esta tela; a Recepção também pode criar bloqueios para os profissionais (em outra funcionalidade). Quem desfaz: o médico pode desfazer (ou encerrar antes do fim, RN-AGM-012) qualquer bloqueio da sua própria agenda, tenha sido criado por ele ou pela Recepção para ele. Ficam fora da gestão do médico o horário de trabalho, as folgas, as férias e os bloqueios no nível da clínica (RN-AGM-015). Um bloqueio não pode ocupar o mesmo horário de uma consulta ativa nem de outro bloqueio; consultas canceladas (inclusive por falta do paciente) não ocupam o horário. Em sentido inverso, a Recepção não pode agendar consultas num horário bloqueado. Bloqueios de vários dias seguidos (ex.: férias) não são bloqueios desta tela — são ausências do horário de trabalho (RN-AGM-015).
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 na Central do Médico.
RN-AGM-006	Tags do paciente — mesmo critério da Central do Médico. As tags exibidas em cada consulta seguem exatamente a regra de exibição de tags do painel de Consultas da Central do Médico (RN-CM-025): apenas as tags habilitadas, na definição de cada tag, para exibição em agendas, respeitando o período de vigência da própria tag, com a tag VIP como exceção sempre exibida. A tag “1ª Consulta” também é exibida, pela regra própria dela (RN-CM-028).
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. É preenchido pela Recepção ao agendar e, nesta tela, só é exibido nas consultas; o médico só escreve o complemento dos bloqueios que ele mesmo cria.
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 da Central do Médico. Paciente (nome preferido/legal, foto, diagnóstico oncológico), horário, status do atendimento (com o mesmo destaque visual por status, e o status sempre exibido, inclusive “Agendado”, por consistência com a Central), modo de atendimento e tags do paciente (RN-AGM-006) — todos com a mesma origem e lógica já definidas na Central do Médico (RN-CM-005 e painel de Consultas), 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 na Central. Diferenças desta tela em relação à Central: (a) exibe também consultas canceladas (inclusive por falta do paciente), com status próprio “Cancelado” — ver RN-AGM-010; (b) o modo de atendimento só aparece quando não é o padrão (presencial): teleatendimento e atendimento customizado são sempre exibidos; (c) o sinalizador de atraso, que na Central é um só, aqui distingue duas situações, porque pedem reações diferentes do médico — “Esperando”, quando o horário já passou e o paciente já está na clínica aguardando (quem está atrasado é o atendimento), com destaque forte; e “Não chegou”, quando o horário já passou e o paciente ainda não chegou, com destaque neutro. Os dois mostram há quantos minutos o horário passou e só se aplicam ao dia de hoje. A distinção pode ser levada à Central do Médico depois de validada aqui.
RN-AGM-010	Consultas realizadas e canceladas agrupadas, não ocultas. O objetivo desta tela é a visão ampla do dia inteiro — diferente do painel compacto da Central do Médico, que oculta consultas já concluídas por padrão, esta tela nunca remove uma consulta da visão do dia. Ao mesmo tempo, consultas já realizadas 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 em dois blocos separados — um de consultas realizadas (finalizadas) e outro de consultas canceladas —, cada um compacto, recolhido por padrão, sempre com a contagem visível e expansível sob demanda (ex.: “4 consultas realizadas ▸”, “2 consultas canceladas ▸”). Horários bloqueados não entram nesses blocos, mesmo depois de ocorridos: continuam como itens individuais na lista, na sua posição de horário. Consultas ainda não finalizadas nem canceladas (inclusive em dias passados, se ficaram sem desfecho registrado) continuam como itens individuais, com o status real. Complementarmente, quando o dia exibido é hoje, a tela abre já rolada até a primeira consulta que ainda exige ação — inclusive uma consulta atrasada —, com uma marca do horário atual na lista; em outros dias, abre no início da lista.
RN-AGM-011	Bloqueio não é consulta nem paciente. Um horário bloqueado é uma reserva de tempo do médico, não um atendimento: não conta como agenda nem como paciente em nenhuma contagem, indicador ou relatório do sistema — inclusive no painel de Consultas e no indicador “Consultas Hoje” da Central do Médico (RN-CM-030), que não o exibem nem o contam. Nesta tela, o bloqueio aparece apenas como item visual próprio (sem dados de paciente), para o médico enxergar o próprio tempo reservado.
RN-AGM-012	Bloqueio só para horários futuros; encerrar antes do fim. Um bloqueio só pode ser criado para um horário que ainda não passou — nem em dias anteriores, nem, no dia de hoje, em horário já decorrido. Um bloqueio que ainda não começou pode ser desfeito (o horário volta inteiro a ficar livre). Um bloqueio em andamento não pode ser desfeito, mas pode ser encerrado antes do fim: termina no momento atual e o restante do intervalo volta a ficar livre (ex.: a reunião acabou mais cedo e o médico pode receber um encaixe). Um bloqueio já terminado permanece como está, visível na lista (RN-AGM-010), sem nenhuma ação. Motivador: um bloqueio retroativo não tem efeito prático (não libera nem ocupa nada que já aconteceu) e alteraria o registro do que de fato aconteceu no dia.
RN-AGM-013	Atualização automática. Os dados da tela são atualizados automaticamente em segundo plano, no mesmo intervalo do painel de Consultas da Central do Médico (RN-CM-017, grupo de 1 minuto) — o médico acompanha mudanças de status feitas pela Recepção (ex.: paciente recepcionado) sem recarregar a tela. Uma falha de conexão não apaga a agenda da tela: os últimos dados continuam visíveis, com um aviso discreto de que estão desatualizados — mesmo comportamento já adotado nos painéis da Central do Médico (Central do Médico, Especificação, estados consolidados).
RN-AGM-014	Busca de pacientes no cabeçalho. O cabeçalho desta tela oferece a mesma busca de pacientes da Central do Médico (RN-CM-004), com o mesmo comportamento e o mesmo destino (abrir o PEP do paciente escolhido) — o médico não precisa voltar à Central para acessar um paciente que não está na agenda do dia.
RN-AGM-015	Horário de trabalho do médico. Cada profissional tem um horário de trabalho definido no seu cadastro — uma rotina semanal (dias e faixas de horário) e exceções por data: ausências (folgas, férias) e horários extras de trabalho (trabalho fora da rotina). A clínica também tem seu horário de funcionamento e seus feriados, e cada consultório tem sua disponibilidade. Esses horários são definidos pela Recepção e pela Administração, em outras funcionalidades; o médico não os altera por esta tela. Nesta tela, o horário de trabalho do médico no dia exibido define: (a) onde um bloqueio pode ser criado — só dentro do horário de trabalho; fora dele não há o que bloquear, porque o profissional já não atende; (b) os horários livres exibidos (RN-AGM-016); e (c) o aviso de que o médico está ausente no dia (ex.: férias, folga), quando for o caso. Consultas encaixadas pela Recepção fora do horário de trabalho continuam aparecendo normalmente. [A DEFINIR] se o próprio médico poderá, no futuro, criar uma exceção de trabalho extra (abrir um horário fora da sua rotina) — por enquanto, só a Recepção e a Administração podem.
RN-AGM-016	Horários livres. Nos dias de hoje e futuros, os intervalos do horário de trabalho do médico que não estão ocupados por nenhuma consulta ativa nem por bloqueio aparecem na lista, na sua posição de horário, como horários livres (ex.: “Livre · 13:00–15:00”). No dia de hoje, só a parte ainda não decorrida de cada intervalo livre aparece. Consultas canceladas não ocupam o horário. Tocar num horário livre abre o bloqueio já preenchido com aquele intervalo. Motivador: o médico enxerga de relance onde há espaço no dia (para um encaixe ou para uma reserva de tempo) e bloqueia a partir dali, sem procurar o horário num formulário.

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.
Esta tela segue a diretriz mobile-first do projeto (funciona em celular, tablet e desktop). É uma tela de destino da Central do Médico — a própria Central tem o escopo desktop/tablet ainda em estudo, com a hipótese de que as telas de destino sejam mobile-first (ver Central do Médico, Seção 1, “Premissas”).

Dependências

Central do Médico (Cockpit) — pontos de entrada (título do painel “Consultas”, RN-CM-003, e indicador “Consultas Hoje”), origem dos elementos de card reutilizados, da regra de tags (RN-CM-025, RN-CM-028), da busca de pacientes (RN-CM-004) e da regra de atualização automática (RN-CM-017). Mudanças nesses elementos na Central do Médico devem se refletir aqui. Em sentido inverso, a Central depende desta funcionalidade para não exibir nem contar horários bloqueados (RN-AGM-011, RN-CM-030).
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; quando for, deve aplicar RN-AGM-011 (bloqueio não é consulta) às suas contagens e relatórios e não permitir agendar consultas (inclusive encaixes) em horário bloqueado (RN-AGM-004). A Recepção também cria bloqueios para os profissionais e exceções de trabalho extra (RN-AGM-015).
Cadastro de horários (Recepção/Administração) — horário de trabalho do profissional (rotina semanal, folgas, férias, exceções de trabalho extra), horário de funcionamento e feriados da clínica e disponibilidade dos consultórios; esta tela depende desse cadastro para saber onde o médico pode bloquear e onde há horários livres (RN-AGM-015, RN-AGM-016). Ainda não especificado como funcionalidade própria neste projeto.
PEP (Prontuário Eletrônico do Paciente) — destino ao tocar em uma consulta ou ao escolher um paciente na busca.

Requisitos SBIS Aplicáveis

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

Requisito	Título	Estágio (clínica/ambulatório)	Aplicação nesta funcionalidade
ECF.05.02	Bloqueios na agenda — “parametrização para indicar bloqueios de agendamentos em dias específicos, tais como finais de semana e feriados”	2 (recomendado)	Parcial. Esta tela cobre o bloqueio pontual de horários pelo próprio médico (RN-AGM-004, RN-AGM-011, RN-AGM-012). A parametrização de bloqueios da clínica em dias específicos (fins de semana, feriados), que é o núcleo do requisito, pertence à parametrização de agendas (Agendamento/Recepção, ECF.05.01), fora de escopo aqui.
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.
ECF.03.11 / ECF.03.14	Busca simples de pacientes / Dados da lista de pacientes para seleção de prontuários	1 (obrigatório) / 1 (obrigatório)	Atendidos pela busca do cabeçalho (RN-AGM-014), reutilizada da Central do Médico, onde a conformidade já está detalhada.
NGS1.07.03 / NGS1.07.04	Eventos (e eventos avançados) registrados na trilha de auditoria	1 / 2	Devem gerar evento de auditoria, mesmo padrão já usado em outras funcionalidades assistenciais deste projeto: a abertura da agenda de um dia (a lista exibe nome e diagnóstico de pacientes), a abertura do PEP a partir dela e as ações de criar e desfazer bloqueio de horário (RN-AGM-004).

Próximos passos

Mapeamento de Banco de Dados (Seção 4) — detalhar tecnicamente RN-AGM-004, RN-AGM-006, RN-AGM-007, RN-AGM-008, RN-AGM-011 e RN-AGM-012, e incluir o registro reservado de bloqueio como item obrigatório da implantação de cada clínica.
Agendamento (Recepção), quando especificado: aplicar RN-AGM-011 às contagens e relatórios daquela funcionalidade e impedir o agendamento em horário bloqueado (RN-AGM-004). Risco a acompanhar: todo relatório futuro que conte agendas precisa aplicar RN-AGM-011 — um relatório que esquecer o filtro contará bloqueios como consultas.

Prioridade sugerida

Should Have — não é bloqueante para o fluxo assistencial da Central do Médico (que já mostra ao médico, de forma resumida, os próximos atendimentos do turno), e cobre, total ou parcialmente, dois requisitos SBIS recomendados (ECF.05.02 parcial, ECF.05.04).

Complexidade estimada

Média — nenhuma tabela nova, reaproveita estrutura de agenda já existente; mas, além da listagem, envolve a navegação para o próximo dia com consulta, o agrupamento de consultas realizadas/canceladas, as regras de tempo do bloqueio e o impacto fora da tela: registro reservado por clínica, exclusão dos bloqueios nas contagens da Central do Médico (RN-CM-030) e de relatórios futuros (RN-AGM-011).

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).
v1.6 (29/09/2026) — Revisão de alinhamento com os documentos atuais da Central do Médico (Definição v4.41, Especificação v4.36, Mapeamento de BD v4.47), mais decisões do solicitante desta rodada. Decisões do solicitante: (1) busca de pacientes no cabeçalho, a mesma da Central do Médico — nova RN-AGM-014; (2) um bloqueio já ocorrido continua como item individual na lista, fora dos blocos recolhidos — fecha o [A DEFINIR] da Especificação v1.0, agora escrito em RN-AGM-010; (3) um bloqueio não pode ser criado no passado — confirma a [PROPOSTA] da Especificação v1.0; nova RN-AGM-012, que também estende a regra ao desfazer (um bloqueio só pode ser desfeito antes de começar — proposta do Designer aceita pelo solicitante); (4) bloqueios ficam fora das contagens de agendas e de pacientes — nova RN-AGM-011, que fecha a pendência aberta na v1.5 sobre relatórios de faturamento: o solicitante perguntou o que ela queria dizer, e foi esclarecido que ela tinha sido levantada pelo crítico de negócio da v1.5, como hipótese (o bloqueio fica gravado com um convênio especial, que um relatório de faturamento por convênio poderia listar), sem nenhum relatório concreto especificado no projeto; a regra geral “não conta como agenda nem paciente em nenhuma contagem, indicador ou relatório” cobre esse caso sem precisar citá-lo; (5) selo de atraso exibido como na Central do Médico — incorporado a RN-AGM-009 (só no dia de hoje, como na Central); (6) consultas realizadas e canceladas em blocos separados, não num bloco único — RN-AGM-010 reescrita; (7) mecanismo técnico do bloqueio: o registro recebe Agenda.TipoAgenda = 'C' (Consulta) como default — detalhe técnico registrado aqui como memória para a Seção 4, não no corpo; como o bloqueio é um registro de agenda de consulta, a exclusão das contagens (RN-AGM-011) depende de um filtro pelo paciente reservado (“B”), não pelo TipoAgenda. Achados de alinhamento com a Central do Médico, aplicados com aprovação do solicitante (“pode seguir com a proposta”): (a) RN-AGM-006 dizia que a Central “exibe todas as tags do paciente” — deixou de ser verdade (a Central passou a filtrar pelo mesmo bit de agendas, ProgramaApoio.MostrarEm & 32, e a aplicar vigência da tag e exceção VIP — RN-CM-025); RN-AGM-006 passa a apenas referenciar RN-CM-025 e RN-CM-028 (“1ª Consulta”, antes descrita só como “indicador de primeira consulta”); (b) RN-AGM-009 passa a citar o destaque visual por status e o status “Cancelado” (a Central não exibe canceladas e não tinha esse status na paleta; cor do chip definida na Especificação); (c) nova RN-AGM-013 — atualização automática no mesmo intervalo do painel de Consultas (RN-CM-017), com o comportamento offline da Central; (d) o indicador “Consultas Hoje” da Central também abre esta tela (a Central chamava o destino de “Agenda de Consultas”) — incluído no Objetivo, no Workflow e em Dependências, e corrigido do lado da Central (nova RN-CM-030 e Especificação v4.37); (e) RN-AGM-003 esclarece que bloqueios e canceladas não fazem um dia contar para o atalho “próximo dia com consulta” — o primeiro é consequência de RN-AGM-011; o segundo é proposta do Designer nesta versão (um dia só com canceladas não tem atendimento a checar), registrada aqui para confirmação; (f) RN-AGM-004 esclarece que consultas canceladas não ocupam horário para efeito de sobreposição com um bloqueio. Nova premissa mobile-first (tela de destino da Central, conforme a hipótese registrada nas Premissas da Central). Tabela SBIS: incluídos ECF.03.11/ECF.03.14 (busca do cabeçalho, por referência à Central). “Próximos passos” atualizado: Seção 3 (Protótipo v1.0) construída junto com esta versão; resta a Seção 4. Acompanha 02-Especificação v1.1 e 03-Protótipo v1.0.
v1.6 — Revisão por Dois Críticos (29/09/2026, mesma versão, antes da entrega ao solicitante) — Crítico de negócio (subagente independente) sobre o corpo desta versão; 25 achados, cada um verificado contra o texto e as fontes. Aplicados: (1) contradição entre “nenhuma configuração nova” (RN-AGM-004) e o seed por clínica em “Próximos passos” — reescrito como “registro reservado de bloqueio, criado uma única vez por clínica”, e o detalhe paciente/convênio saiu do corpo; (2) a âncora de rolagem no horário atual escondia consultas atrasadas ainda pendentes (achado também do crítico técnico, reproduzido no protótipo) — RN-AGM-010 passa a abrir na primeira consulta que ainda exige ação, com a marca do horário atual na lista; (3) RN-AGM-010 dizia “nunca esconde” e “recolhido por padrão” ao mesmo tempo — “nunca remove da visão do dia”, contagem sempre visível; “realizadas” ligada a “finalizadas”; comportamento de consultas sem desfecho em dias passados explicitado (continuam individuais, com o status real); (4) persona: “mesma persona da Central” contradizia “não necessariamente oncologista” — reescrito; (5) RN-AGM-007 não dizia quem preenche o complemento — Recepção, só leitura nas consultas; (6) RN-AGM-013 apontava o comportamento offline para a Definição da Central, onde ele não está (está na Especificação da Central, estados consolidados) — referência corrigida; (7) ECF.05.02 conferido na planilha RequisitosSBIS-v5.2_ambulatorial.xlsx: o requisito pede parametrização de bloqueios em dias específicos (fins de semana, feriados), não bloqueio pontual pelo médico — a tabela dizia “Atendido”, passa a “Parcial”, com o texto do requisito; ECF.03.11 é “Busca simples de pacientes” (não “multifatorial”, termo usado na Central) e ECF.03.11/03.14 são estágio 1, antes “ver Central”; (8) Prioridade usava um requisito obrigatório não atendido (ECF.05.03) como argumento — removido; Complexidade revista de Baixa para Média (impactos fora da tela), estimativa do Designer; (9) auditoria (NGS1.07.03) passa a dizer explicitamente o que gera evento — abertura da agenda de um dia, abertura do PEP e criar/desfazer bloqueio (achado também do crítico técnico); (10) RN-AGM-004 esclarece que o bloqueio é de um intervalo dentro de um dia — bloqueios de vários dias ficam fora; (11) premissa mobile-first reescrita como diretriz do projeto, sem a afirmação de frequência de uso que nenhum estudo sustenta; (12) risco de relatórios futuros sem o filtro de RN-AGM-011 registrado em “Próximos passos”; (13) novo [A DEFINIR] em “Dependências”: se a Recepção pode agendar sobre um horário bloqueado — pergunta ao solicitante. Levados ao solicitante como pergunta, sem mudança no texto: falta do paciente agrupada junto com canceladas (hoje assim porque a Central já classifica falta como cancelamento); quem cria bloqueios além do médico e se ele pode desfazer bloqueios criados por outros; encerrar antes um bloqueio em andamento. Não aplicados (verificados como não procedentes ou já cobertos): “indicador Consultas Hoje não documentado na Central” — documentado na Especificação da Central, 2.2, e agora também em RN-CM-030; cabeçalho de versões dos documentos irmãos e termos como “touchpoint”/“mobile-first”/IDs SBIS — padrão da Skill Designer e dos demais documentos; relatório de ocupação com tempo bloqueado — RN-AGM-011 é decisão explícita do solicitante; atalho sem próxima consulta e revalidação no momento de confirmar — já cobertos na Especificação. Observação lateral do crítico procedente e corrigida fora deste documento: RN-CM-025, na Definição da Central, ainda falava em tags habilitadas “para exibição na Central do Médico”, embora o filtro vigente seja o de agendas — corrigido na Central do Médico, Definição v4.42.
v1.7 (29/09/2026) — Decisões do solicitante após a revisão de layout (médico e especialista em UX, subagentes independentes) e respostas às perguntas deixadas na v1.6. Regras: (1) a Recepção não pode agendar consultas em horário bloqueado — fecha o [A DEFINIR] de “Dependências”, agora escrito em RN-AGM-004 e na dependência de Agendamento; (2) a falta do paciente continua agrupada com as canceladas (sem mudança de texto — já estava assim); (3) quem cria e quem desfaz bloqueios — o médico cria bloqueios particulares; a Recepção cria bloqueios para os profissionais e exceções de trabalho extra; a Administração cria bloqueios no nível da clínica e define horários de trabalho, férias e folgas; o médico desfaz qualquer bloqueio feito para ele (o critério é o bloqueio estar na agenda dele, Agenda.IdChRecurso, como numa consulta comum — o solicitante esclareceu que não é necessário saber quem o criou; quem criou está registrado no próprio registro de agenda), mas não tem gestão sobre faixas de trabalho, folgas e bloqueios no nível de rotina e clínica — RN-AGM-004 reescrita; (4) o médico pode encerrar antes do fim um bloqueio em andamento — RN-AGM-012 reescrita; o encerramento termina o bloqueio no momento atual (arredondamento não pedido pelo solicitante; minuto exato é escolha do Designer, ver Especificação v1.2); (5) horário de trabalho — novo conceito trazido pelo solicitante: cada profissional tem horários de trabalho e folga no cadastro, a clínica tem horário de funcionamento e o consultório (recurso) tem disponibilidade; o bloqueio só pode ser criado dentro do horário de trabalho do profissional; se o médico poderá criar exceções de trabalho extra fica para depois (por enquanto só Recepção e Administração) — nova RN-AGM-015, com [A DEFINIR] para a exceção criada pelo médico; (6) nova RN-AGM-016 — horários livres dentro do horário de trabalho, tocáveis para bloquear: proposta do médico-crítico da revisão de layout, escolhida pelo solicitante para ver no protótipo (a alternativa, um botão flutuante, foi proposta pelo crítico de UX); (7) sinalizador de atraso separado em “Esperando” e “Não chegou” só nesta tela — a Central do Médico está congelada para fechar a versão; se a distinção se provar boa, será levada à Central depois — RN-AGM-009 reescrita; (8) status “Agendado” continua sempre exibido, por consistência (o médico-crítico propôs escondê-lo, o solicitante manteve); o modo de atendimento presencial, padrão do campo, é omitido; os outros dois valores usados, customizado e teleatendimento, são sempre exibidos — RN-AGM-009. Memória técnica para a Seção 4 (conferida na Biblioteca de Schema — DDL, e confirmada pelo solicitante como as tabelas corretas): rotina semanal do profissional em RecursoHorario (IdChRecurso, DiaSemana, HoraIni, HoraFim, DataVigencia; histórico em RecursoHorarioHistorico) — o profissional é um recurso de agenda, mesma chave Agenda.IdChRecurso; exceções por data em RecursoExcecao (IdChRecurso, Data, HoraIni, HoraFIm, IndicaDI, Complemento) — leitura do Designer de que IndicaDI distingue disponível (trabalho extra) de indisponível (folga/férias), valores exatos do domínio a confirmar na Seção 4; horário de funcionamento da clínica em ClinicaHorario; feriados em ClinicaFeriado (com indicadores por tipo de agenda). Nenhuma estrutura nova. Nenhuma mudança na Central do Médico nesta versão (congelada). Acompanha 02-Especificação v1.2 e 03-Protótipo v1.1.

Gemed 2.1 — Documentação

Explorador

01 - Definição v1.7