-
Notifications
You must be signed in to change notification settings - Fork 0
Requisitos Funcionais
Lucas Christian edited this page Jun 4, 2026
·
4 revisions
Este ator representa o usuário autenticado que utiliza o sistema para consultar especialidades e médicos, agendar consultas presenciais, acompanhar seus atendimentos e acessar informações relacionadas ao próprio histórico. No contexto do Medflow, o usuário comum exerce o papel de paciente, porém não é tratado como um perfil administrativo ou operacional específico no Keycloak.
- RF-USU-01: Autenticar-se no sistema por meio do Keycloak, desde que seu acesso tenha sido previamente cadastrado ou liberado pela organização.
- RF-USU-02: Visualizar as especialidades médicas disponíveis na organização.
- RF-USU-03: Consultar médicos disponíveis, podendo filtrar por especialidade, unidade e horários livres.
- RF-USU-04: Agendar consulta presencial com um médico disponível, selecionando unidade, consultório, data e horário.
- RF-USU-05: Consultar suas próximas consultas, visualizando data, horário, médico, especialidade, unidade, consultório e status do atendimento.
- RF-USU-06: Consultar o histórico de consultas anteriores realizadas no sistema.
- RF-USU-07: Cancelar ou solicitar reagendamento de uma consulta, respeitando as regras de antecedência mínima definidas pela organização.
- RF-USU-08: Visualizar o status atual de suas consultas, como agendada, confirmada, em espera, em atendimento, finalizada, cancelada ou não compareceu.
- RF-USU-09: Visualizar anexos vinculados às suas consultas, como documentos ou arquivos adicionados pela equipe da clínica.
- RF-USU-10: Consultar e manter atualizados seus dados cadastrais permitidos no Keycloak, conforme regras definidas pela organização.
Este ator representa o profissional responsável por acompanhar sua agenda, visualizar os usuários agendados e registrar as informações clínicas básicas do atendimento.
- RF-MED-01: Autenticar-se no sistema por meio do Keycloak.
- RF-MED-02: Visualizar sua agenda de consultas por dia, semana ou período definido.
- RF-MED-03: Visualizar a fila de atendimentos do dia, acompanhando o status das consultas em espera, em atendimento e finalizadas.
- RF-MED-04: Consultar os dados básicos da consulta antes do atendimento, incluindo usuário atendido, horário, consultório e motivo informado.
- RF-MED-05: Iniciar o atendimento de uma consulta atribuída a ele, alterando seu status para em atendimento.
- RF-MED-06: Registrar informações básicas do atendimento, incluindo queixa principal, anamnese, conduta e observações.
- RF-MED-07: Finalizar o atendimento, alterando o status da consulta para finalizada.
- RF-MED-08: Consultar o histórico de atendimentos do usuário dentro da organização, respeitando as regras de autorização funcional e contextual do sistema.
- RF-MED-09: Cadastrar, alterar ou remover bloqueios de sua agenda, como pausas, férias ou indisponibilidades, quando autorizado pela organização.
- RF-MED-10: Visualizar anexos vinculados às consultas relacionadas aos seus atendimentos, quando autorizado.
Este ator representa o usuário responsável pelo fluxo operacional da clínica, especialmente no cadastro de usuários comuns, acompanhamento da chegada dos pacientes e controle dos status das consultas.
- RF-REC-01: Autenticar-se no sistema por meio do Keycloak.
- RF-REC-02: Consultar a agenda de consultas da organização por data, unidade, consultório, médico ou status.
- RF-REC-03: Registrar a chegada do usuário comum, realizando o check-in da consulta e alterando seu status para em espera.
- RF-REC-04: Confirmar, cancelar ou marcar o não comparecimento de uma consulta.
- RF-REC-05: Reagendar consultas conforme disponibilidade de médico, consultório e horário.
- RF-REC-06: Cadastrar usuários comuns no sistema, criando ou vinculando seu acesso por meio da integração com o Keycloak.
- RF-REC-07: Atualizar dados cadastrais permitidos de usuários comuns, conforme regras da organização.
- RF-REC-08: Ativar ou desativar o acesso de usuários comuns à organização, quando necessário.
- RF-REC-09: Anexar arquivos relacionados à consulta, como documentos ou resultados apresentados pelo usuário.
- RF-REC-10: Visualizar a fila de atendimento do dia, acompanhando o fluxo de usuários aguardando atendimento.
Este ator representa o responsável pela configuração e gestão da organização no Medflow, incluindo unidades, consultórios, usuários, médicos, especialidades, alocações, agendas e permissões de acesso.
- RF-ADM-01: Autenticar-se no sistema por meio do Keycloak.
- RF-ADM-02: Gerenciar os dados da organização, incluindo nome, telefone, e-mail de contato, logotipo, cor principal e status de ativação.
- RF-ADM-03: Cadastrar, editar e desativar unidades da organização.
- RF-ADM-04: Cadastrar, editar e desativar consultórios vinculados às unidades.
- RF-ADM-05: Cadastrar, editar e desativar especialidades médicas.
- RF-ADM-06: Cadastrar e gerenciar usuários da organização, definindo papéis de acesso funcionais como administrador, recepcionista, médico ou usuário comum, em integração com o Keycloak.
- RF-ADM-07: Ativar, desativar ou alterar os papéis funcionais de qualquer usuário vinculado à organização, conforme regras de autorização.
- RF-ADM-08: Cadastrar e gerenciar médicos da organização, vinculando-os aos respectivos usuários do Keycloak e às suas especialidades.
- RF-ADM-09: Definir a alocação de médicos em consultórios, informando o período em que cada médico atende em determinado local.
- RF-ADM-10: Configurar a agenda médica, definindo dias da semana, horários de início e fim e duração padrão das consultas.
- RF-ADM-11: Cadastrar bloqueios de agenda para médicos ou consultórios, indicando pausas, férias, indisponibilidades ou outros impedimentos.
- RF-ADM-12: Gerenciar o status das consultas ao longo do fluxo operacional, quando necessário.
- RF-ADM-13: Consultar relatórios administrativos simples, como quantidade de consultas agendadas, finalizadas, canceladas e não comparecidas por período.
- RF-TR-01: O sistema deve integrar-se ao Keycloak para autenticação dos usuários.
- RF-TR-02: O sistema deve utilizar o Keycloak como fonte central de papéis e permissões funcionais.
- RF-TR-03: O sistema deve validar, no backend, as permissões funcionais emitidas pelo Keycloak antes da execução de operações protegidas.
- RF-TR-04: O sistema deve validar, no banco do Medflow, as regras contextuais relacionadas à organização, vínculo do usuário, status ativo, propriedade dos dados, agenda, consultas e atendimentos.
- RF-TR-05: O sistema deve impedir o auto-registro de usuários comuns, exigindo que o acesso seja criado ou liberado por um recepcionista ou administrador da organização.
- RF-TR-06: O sistema deve permitir que administradores gerenciem qualquer tipo de usuário da organização, enquanto recepcionistas podem gerenciar apenas usuários comuns.
- RF-TR-07: O sistema deve garantir que uma consulta somente seja agendada em horários compatíveis com a agenda médica configurada.
- RF-TR-08: O sistema deve impedir conflitos de horário para o mesmo médico ou consultório.
- RF-TR-09: O sistema deve manter o histórico de alterações das entidades auditáveis por meio do Hibernate Envers.
- RF-TR-10: O sistema deve registrar dados de criação e alteração das entidades, incluindo usuário responsável, data de criação, data da última alteração e versão do registro.
- RF-TR-11: O sistema deve garantir a persistência e a integridade dos dados relacionados a usuários, médicos, consultas, registros de atendimento e anexos.
- RF-TR-12: O sistema deve permitir o armazenamento de arquivos anexados diretamente no banco de dados, associados às respectivas consultas.
- RF-TR-13: O sistema deve garantir que médicos acessem apenas consultas, registros de atendimento e anexos relacionados à sua atuação na organização.
- RF-TR-14: O sistema deve garantir que usuários comuns acessem apenas suas próprias consultas, históricos e anexos.
- RF-TR-15: O sistema deve tratar exclusões físicas apenas em casos permitidos, como anexos ou bloqueios de agenda removíveis, utilizando desativação lógica para entidades estruturais e status de fluxo para consultas.