A jornada por dentro.
Desenhe conversando
"Desenha a jornada de catarata da minha clínica." A IA lê o molde, explica fases e marcos e oferece propor prazos, em prévia.
Gravações do sistema numa clínica de demonstração, com dados fictícios.
Ferramentas MCP
Leitura, acompanhamento e edição com prévia. A IA não apaga jornada.
Acompanhar
Busca de jornadas, o detalhe com a fase derivada e a varredura do que está atrasado ou parado.
- jornada_find
- jornada_get_context
- jornada_pendencias_sla
Agir
Criar a jornada a partir do molde, editar, concluir ou cancelar, ligar a um atendimento e recalcular a fase. Tudo com prévia e confirmação.
- jornada_criar
- jornada_editar
- jornada_change_state
- jornada_vincular_atendimento
- jornada_recompute_fase
Desenhar o molde
Listar, ler, validar e gravar o tipo de jornada. A validação acusa coluna sem fase e marco sem etapa antes de gravar.
- jornada_tipo_list
- jornada_tipo_get
- jornada_tipo_validar
- jornada_tipo_upsert
Como funciona
O molde mora no cadastro da clínica; a jornada de cada paciente, no atendimento; os marcos, no quadro de tarefas.
Marcos são tarefas
Ao criar a jornada pelo molde, cada marco vira uma tarefa ligada a ela, com responsável e prazo.
- jornada_get_context
- tarefas_find
Fase derivada
A fase sai das tarefas: a coluna com marco obrigatório pendente decide onde o paciente está. Mudou, sai um evento.
Varredura em uma chamada
O serviço cruza jornadas e tarefas e devolve só as que têm marco vencido ou estão paradas, sem o título nem dado do paciente.
- jornada_pendencias_sla
token = post(AUTH, {"grant_type": "client_credentials",
"client_id": CLIENT_ID, "client_secret": CLIENT_SECRET})["access_token"]
r = get(f"{API}/atendimento/jornada/pendencias-sla", token,
params={"prazo_dias": 0, "parado_dias": 7})
for j in r["itens"]:
atrasos = [f'{m["titulo"]} (+{m["dias_atraso"]}d)' for m in j["requisitos_vencidos"]]
print(j["fase_atual"], j["dias_parado"], ", ".join(atrasos))Eventos e permissões
Cada passo vira evento
Jornada criada, fase recalculada (com a fase anterior e a nova), concluída e cancelada. Os avisos de "fase avançou" saem daí.
Sem dado clínico no evento
O evento leva referências e a fase, nunca conteúdo clínico.
Permissões separadas
jornada.read e write para a instância; estrutura_tipo_jornada para o molde, que só grava com a jornada ligada na clínica.
Peça à sua IA
Pela conexão MCP, a IA que a clínica preferir age com as permissões de quem pediu: só faz o que essa pessoa pode fazer na Central.
Segurança para médicos builders- "Desenha a jornada de catarata da minha clínica: fases, marcos e prazos."jornada_tipo_list · jornada_tipo_get
- "Cria um tipo de jornada para cirurgia refrativa e valida antes de gravar."jornada_tipo_validar · jornada_tipo_upsert
- "Quais jornadas estão paradas há mais de uma semana?"jornada_pendencias_sla
