diff --git a/development/saas-docs/01-busca-global-melissa.json b/development/saas-docs/01-busca-global-melissa.json new file mode 100644 index 0000000..d7aa5fa --- /dev/null +++ b/development/saas-docs/01-busca-global-melissa.json @@ -0,0 +1,87 @@ +{ + "titulo": "Busca global e Acessados recentemente", + "conteudo": "

Busca global no Layout Melissa

\n\n

A busca global é o atalho mais rápido para encontrar pacientes, sessões, documentos e cadastros recebidos sem precisar navegar pelos menus. Você acessa pelo dock central do Layout Melissa ou usando o atalho de teclado Ctrl + K (em qualquer página do Melissa).

\n\n

1. Como abrir

\n

Localize o campo de busca no dock central do Melissa. Ele aparece como um botão com o ícone de lupa e o placeholder “Buscar paciente, agenda, atalho…”, com o atalho Ctrl K indicado no canto direito.

\n\n
\n \n Buscar paciente, agenda, atalho…\n Ctrl K\n
\n\n

Três jeitos de abrir:

\n\n\n

2. O Dialog Spotlight

\n

Ao abrir, o sistema mostra um diálogo centralizado com o input grande no topo e os resultados em colunas abaixo. Isso é o padrão Spotlight (igual ao usado em macOS, Linear, GitHub, Slack).

\n\n
\n
\n \n Buscar paciente, agenda, atalho…\n Esc\n
\n
\n
Acessados recentemente
\n
\n \n \n \n
\n
André Green
\n
andre@email.com
\n
\n \n
\n
\n
\n\n

3. Onde a busca procura

\n

Digitando pelo menos 2 caracteres, o sistema dispara uma busca completa em 5 categorias:

\n\n\n

Cada categoria aparece com um ícone colorido distinto para facilitar a leitura visual. Os resultados são limitados aos 6 mais relevantes por categoria.

\n\n

4. Como navegar nos resultados

\n

Você pode usar o mouse ou o teclado:

\n\n\n

5. Acessados recentemente

\n

Quando você abre a busca sem digitar nada, a primeira seção mostra “Acessados recentemente” — os últimos 5 pacientes que você visitou (em qualquer dispositivo deste navegador).

\n\n
\n 💡 Dica: Use Ctrl+K + Enter para reabrir o último paciente acessado em 2 segundos.\n
\n\n

Esses 5 pacientes ficam salvos no seu navegador (não no banco de dados), então:

\n\n\n

6. Clique nos resultados

\n

Ao clicar:

\n\n\n

7. Tema claro × escuro

\n

O Dialog adapta automaticamente as cores conforme o tema escolhido em Meu Perfil → Preferências. Texto, fundos e bordas seguem as configurações do sistema. Apenas os ícones por categoria (paciente rosa, sessão índigo, documento azul, cadastro laranja) mantêm a mesma cor para preservar a identificação visual rápida.

\n\n

⚠️ Notas pro desenvolvedor

\n

Atualmente o componente MelissaBusca.vue não tem atributos id em seus elementos. Para o sistema de highlight da ajuda funcionar (links data-highlight), sugere-se adicionar:

\n", + "categoria": "Navegação", + "exibir_no_faq": true, + "tipo_acesso": "usuario", + "pagina_path": "/melissa", + "ordem": 1, + "ativo": true, + "medias": [ + { "tipo": "imagem", "url": "" } + ], + "_faq_itens": [ + { + "pergunta": "Como abrir a busca rapidamente?", + "resposta": "Use o atalho Ctrl + K (Windows/Linux) ou ⌘ + K (Mac) em qualquer página do Melissa. Você também pode clicar diretamente no campo de busca no dock central.", + "ordem": 0, + "ativo": true + }, + { + "pergunta": "Posso buscar paciente por telefone ou CPF?", + "resposta": "Sim. A busca de pacientes encontra pelo nome completo, e-mail, telefone ou CPF. Digite pelo menos 2 caracteres e aguarde os resultados.", + "ordem": 1, + "ativo": true + }, + { + "pergunta": "O que aparece em \"Acessados recentemente\"?", + "resposta": "Os últimos 5 pacientes que você abriu pelo prontuário, em ordem do mais recente pro mais antigo. A lista aparece quando você abre a busca sem digitar nada.", + "ordem": 2, + "ativo": true + }, + { + "pergunta": "Outros usuários veem meus \"Acessados recentemente\"?", + "resposta": "Não. A lista é privada e local — fica salva apenas no seu navegador atual (localStorage). Se você logar em outro navegador ou computador, a lista começa vazia naquele dispositivo.", + "ordem": 3, + "ativo": true + }, + { + "pergunta": "Quantos caracteres preciso digitar pra começar a buscar?", + "resposta": "Pelo menos 2. Buscas de 1 caractere são muito amplas e não disparam pesquisa. A partir de 2 caracteres, o sistema aguarda 200ms (tempo de digitação) antes de consultar o banco — assim você não dispara dezenas de buscas digitando rápido.", + "ordem": 4, + "ativo": true + }, + { + "pergunta": "Por que minha busca não retorna nada?", + "resposta": "Verifique: (1) digitou pelo menos 2 caracteres; (2) o termo está sem erros graves de digitação (a busca tolera pequenas variações via similarity); (3) o paciente/sessão realmente existe no seu cadastro. Se persistir, faça uma busca mais ampla — ex: apenas o primeiro nome.", + "ordem": 5, + "ativo": true + }, + { + "pergunta": "O que cada cor de ícone significa?", + "resposta": "Cada categoria tem uma cor própria: Rosa = Paciente, Índigo = Sessão da agenda, Azul = Documento, Laranja = Cadastro recebido pendente. Atalhos vêm em cinza neutro.", + "ordem": 6, + "ativo": true + }, + { + "pergunta": "Como navegar pelos resultados sem usar o mouse?", + "resposta": "Use as setas do teclado ↑ e ↓ para navegar entre os itens e Enter para abrir o selecionado. Pra fechar sem selecionar, use Esc.", + "ordem": 7, + "ativo": true + }, + { + "pergunta": "Posso buscar documentos pelo nome do paciente?", + "resposta": "Sim. A busca de documentos cruza pelo nome do arquivo, descrição e nome do paciente vinculado. Ao clicar num resultado de documento, você é levado direto pra aba Documentos do prontuário daquele paciente.", + "ordem": 8, + "ativo": true + }, + { + "pergunta": "Como limpar a lista de \"Acessados recentemente\"?", + "resposta": "Hoje não há um botão na interface — a lista é gerenciada automaticamente (limite de 5, mais antigo cai quando você acessa um novo). Pra limpar manualmente, você pode apagar os dados do site no seu navegador (Configurações → Privacidade → Limpar dados de navegação → escopo \"localStorage\").", + "ordem": 9, + "ativo": true + }, + { + "pergunta": "A busca encontra sessões antigas ou só as de hoje?", + "resposta": "Encontra sessões de qualquer data — passadas e futuras. O grupo \"Agenda de hoje\" mostra apenas as do dia atual (preview rápido); o grupo \"Sessões\" inclui todas as outras encontradas no banco. Cada item mostra a data e horário da sessão.", + "ordem": 10, + "ativo": true + }, + { + "pergunta": "Os atalhos (Agenda, Financeiro, etc.) sempre aparecem?", + "resposta": "Sim. Quando o campo está vazio, mostramos 4 atalhos padrão. Conforme você digita, os atalhos que combinam com sua busca permanecem visíveis (junto com os resultados do banco).", + "ordem": 11, + "ativo": true + } + ] +}