CRM WhatsApp Grupo 3 completo + Marco A/B (Asaas) + admin SaaS + refactors polimórficos

Sessão 11+: fechamento do CRM de WhatsApp com dois providers (Evolution/Twilio), sistema de créditos com Asaas/PIX, polimorfismo de telefones/emails, e integração admin SaaS no /saas/addons existente. ═══════════════════════════════════════════════════════════════════════════ GRUPO 3 — WORKFLOW / CRM (completo) ═══════════════════════════════════════════════════════════════════════════ 3.1 Tags · migration conversation_tags + seed de 5 system tags · composable useConversationTags.js · popover + pills no drawer e nos cards do Kanban. 3.2 Atribuição de conversa a terapeuta · migration 20260421000012 com PK (tenant_id, thread_key), UPSERT, RLS que valida assignee como membro ativo do mesmo tenant · view conversation_threads expandida com assigned_to + assigned_at · composable useConversationAssignment.js · drawer com Select filtrável + botão "Assumir" · inbox com filtro aside (Todas/Minhas/Não atribuídas) e chip do responsável em cada card (destaca "Eu" em azul). 3.3 Notas internas · migration conversation_notes · composable + seção colapsável no drawer · apenas o criador pode editar/apagar (RLS). 3.5 Converter desconhecido em paciente · botão + dialog quick-cadastro · "Vincular existente" com Select filter de até 500 pacientes · cria telefone WhatsApp (vinculado) via upsertWhatsappForExisting. 3.6 Histórico de conversa no prontuário · nova aba "Conversas" em PatientProntuario.vue · PatientConversationsTab.vue com stats (total / recebidas / enviadas / primeira / última), SelectButton de filtro, timeline com bolhas por direção, mídia inline (imagem/áudio/vídeo/doc via signed URL), indicadores ✓ ✓✓ de delivery, botão "Abrir no CRM". ═══════════════════════════════════════════════════════════════════════════ MARCO A — UNIFICAÇÃO WHATSAPP (dois providers mutuamente exclusivos) ═══════════════════════════════════════════════════════════════════════════ - Página chooser ConfiguracoesWhatsappChooserPage.vue com 2 cards (Pessoal/ Oficial), deactivate via edge function deactivate-notification-channel - send-whatsapp-message refatorada com roteamento por provider; Twilio deduz 1 crédito antes do envio e refunda em falha - Paridade Twilio (novo): módulo compartilhado supabase/functions/_shared/ whatsapp-hooks.ts com lógica provider-agnóstica (opt-in, opt-out, auto- reply, schedule helpers em TZ São Paulo, makeTwilioCreditedSendFn que envolve envio em dedução atômica + rollback). Consumido por Evolution E Twilio inbound. Evolution refatorado (~290 linhas duplicadas removidas). - Bucket privado whatsapp-media · decrypt via Evolution getBase64From MediaMessage · upload com path tenant/yyyy/mm · signed URLs on-demand ═══════════════════════════════════════════════════════════════════════════ MARCO B — SISTEMA DE CRÉDITOS WHATSAPP + ASAAS ═══════════════════════════════════════════════════════════════════════════ Banco: - Migration 20260421000007_whatsapp_credits (4 tabelas: balance, transactions, packages, purchases) + RPCs add_whatsapp_credits e deduct_whatsapp_credits (atômicas com SELECT FOR UPDATE) - Migration 20260421000013_tenant_cpf_cnpj (coluna em tenants com CHECK de 11 ou 14 dígitos) Edge functions: - create-whatsapp-credit-charge · Asaas v3 (sandbox + prod) · PIX com QR code · getOrCreateAsaasCustomer patcha customer existente com CPF quando está faltando - asaas-webhook · recebe PAYMENT_RECEIVED/CONFIRMED e credita balance Frontend (tenant): - Página /configuracoes/creditos-whatsapp com saldo + loja + histórico - Dialog de confirmação com CPF/CNPJ (validação via isValidCPF/CNPJ de utils/validators, formatação on-blur, pré-fill de tenants.cpf_cnpj, persiste no primeiro uso) · fallback sandbox 24971563792 REMOVIDO - Composable useWhatsappCredits extrai erros amigáveis via error.context.json() Frontend (SaaS admin): - Em /saas/addons (reuso do pattern existente, não criou página paralela): - Aba 4 "Pacotes WhatsApp" — CRUD whatsapp_credit_packages com DataTable, toggle is_active inline, dialog de edição com validação - Aba 5 "Topup WhatsApp" — tenant Select com saldo ao vivo · RPC add_whatsapp_credits com p_admin_id = auth.uid() (auditoria) · histórico das últimas 20 transações topup/adjustment/refund ═══════════════════════════════════════════════════════════════════════════ GRUPO 2 — AUTOMAÇÃO ═══════════════════════════════════════════════════════════════════════════ 2.3 Auto-reply · conversation_autoreply_settings + conversation_autoreply_ log · 3 modos de schedule (agenda das regras semanais, business_hours custom, custom_window) · cooldown por thread · respeita opt-out · agora funciona em Evolution E Twilio (hooks compartilhados) 2.4 Lembretes de sessão · conversation_session_reminders_settings + _logs · edge send-session-reminders (cron) · janelas 24h e 2h antes · Twilio deduz crédito com rollback em falha ═══════════════════════════════════════════════════════════════════════════ GRUPO 5 — COMPLIANCE (LGPD Art. 18 §2) ═══════════════════════════════════════════════════════════════════════════ 5.2 Opt-out · conversation_optouts + conversation_optout_keywords (10 system seed + custom por tenant) · detecção por regex word-boundary e normalização (lowercase + strip acentos + pontuação) · ack automático (deduz crédito em Twilio) · opt-in via "voltar", "retornar", "reativar", "restart" · página /configuracoes/conversas-optouts com CRUD de keywords ═══════════════════════════════════════════════════════════════════════════ REFACTOR POLIMÓRFICO — TELEFONES + EMAILS ═══════════════════════════════════════════════════════════════════════════ - contact_types + contact_phones (entity_type + entity_id) — migration 20260421000008 · contact_email_types + contact_emails — 20260421000011 - Componentes ContactPhonesEditor.vue e ContactEmailsEditor.vue (add/edit/ remove com confirm, primary selector, WhatsApp linked badge) - Composables useContactPhones.js + useContactEmails.js com unsetOtherPrimaries() e validação - Trocado em PatientsCadastroPage.vue e MedicosPage.vue (removidos campos legados telefone/telefone_alternativo e email_principal/email_alternativo) - Migration retroativa v2 (20260421000010) detecta conversation_messages e cria/atualiza phone como WhatsApp vinculado ═══════════════════════════════════════════════════════════════════════════ POLIMENTO VISUAL + INFRA ═══════════════════════════════════════════════════════════════════════════ - Skeletons simplificados no dashboard do terapeuta - Animações fade-up com stagger via [--delay:Xms] (fix specificity sobre .dash-card box-shadow transition) - ConfirmDialog com group="conversation-drawer" (evita montagem duplicada) - Image preview PrimeVue com botão de download injetado via MutationObserver (fetch + blob para funcionar cross-origin) - Áudio/vídeo com preload="metadata" e controles de velocidade do browser - friendlySendError() mapeia códigos do edge pra mensagens pt-BR via error.context.json() - Teleport #cfg-page-actions para ações globais de Configurações - Brotli/Gzip + auto-import Vue/PrimeVue + bundle analyzer - AppLayout consolidado (removidas duplicatas por área) + RouterPassthrough - Removido console.trace debug que estava em watch de router e queries Supabase (degradava perf pra todos) - Realtime em conversation_messages via publication supabase_realtime - Notifier global flutuante com beep + toggle mute (4 camadas: badge + sino + popup + browser notification) ═══════════════════════════════════════════════════════════════════════════ MIGRATIONS NOVAS (13) ═══════════════════════════════════════════════════════════════════════════ 20260420000001_patient_intake_invite_info_rpc 20260420000002_audit_logs_lgpd 20260420000003_audit_logs_unified_view 20260420000004_lgpd_export_patient_rpc 20260420000005_conversation_messages 20260420000005_search_global_rpc 20260420000006_conv_messages_notifications 20260420000007_notif_channels_saas_admin_insert 20260420000008_conv_messages_realtime 20260420000009_conv_messages_delivery_status 20260421000001_whatsapp_media_bucket 20260421000002_conversation_notes 20260421000003_conversation_tags 20260421000004_conversation_autoreply 20260421000005_conversation_optouts 20260421000006_session_reminders 20260421000007_whatsapp_credits 20260421000008_contact_phones 20260421000009_retroactive_whatsapp_link 20260421000010_retroactive_whatsapp_link_v2 20260421000011_contact_emails 20260421000012_conversation_assignments 20260421000013_tenant_cpf_cnpj ═══════════════════════════════════════════════════════════════════════════ EDGE FUNCTIONS NOVAS / MODIFICADAS ═══════════════════════════════════════════════════════════════════════════ Novas: - _shared/whatsapp-hooks.ts (módulo compartilhado) - asaas-webhook - create-whatsapp-credit-charge - deactivate-notification-channel - evolution-webhook-provision - evolution-whatsapp-inbound - get-intake-invite-info - notification-webhook - send-session-reminders - send-whatsapp-message - submit-patient-intake - twilio-whatsapp-inbound ═══════════════════════════════════════════════════════════════════════════ FRONTEND — RESUMO ═══════════════════════════════════════════════════════════════════════════ Composables novos: useAddonExtrato, useAuditoria, useAutoReplySettings, useClinicKPIs, useContactEmails, useContactPhones, useConversationAssignment, useConversationNotes, useConversationOptouts, useConversationTags, useConversations, useLgpdExport, useSessionReminders, useWhatsappCredits Stores: conversationDrawerStore Componentes novos: ConversationDrawer, GlobalInboundNotifier, GlobalSearch, ContactEmailsEditor, ContactPhonesEditor Páginas novas: CRMConversasPage, PatientConversationsTab, AddonsExtratoPage, AuditoriaPage, NotificationsHistoryPage, ConfiguracoesWhatsappChooserPage, ConfiguracoesConversasAutoreplyPage, ConfiguracoesConversasOptoutsPage, ConfiguracoesConversasTagsPage, ConfiguracoesCreditosWhatsappPage, ConfiguracoesLembretesSessaoPage Utils novos: addonExtratoExport, auditoriaExport, excelExport, lgpdExportFormats Páginas existentes alteradas: ClinicDashboard, PatientsCadastroPage, PatientCadastroDialog, PatientsListPage, MedicosPage, PatientProntuario, ConfiguracoesWhatsappPage, SaasWhatsappPage, ConfiguracoesRecursosExtrasPage, ConfiguracoesPage, AgendaTerapeutaPage, AgendaClinicaPage, NotificationItem, NotificationDrawer, AppLayout, AppTopbar, useMenuBadges, patientsRepository, SaasAddonsPage (aba 4 + 5 WhatsApp) Routes: routes.clinic, routes.configs, routes.therapist atualizados Menus: clinic.menu, therapist.menu, saas.menu atualizados ═══════════════════════════════════════════════════════════════════════════ NOTAS - Após subir, rodar supabase functions serve --no-verify-jwt --env-file supabase/functions/.env pra carregar o módulo _shared - WHATSAPP_SETUP.md reescrito (~400 linhas) com setup completo dos 3 providers + troubleshooting + LGPD - HANDOFF.md atualizado com estado atual e próximos passos Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-23 07:05:24 -03:00
parent 037ba3721f
commit 2644e60bb6
191 changed files with 38629 additions and 3756 deletions
@@ -0,0 +1,115 @@
+/*
+|--------------------------------------------------------------------------
+| Agência PSI — pagesIndex.js
+|--------------------------------------------------------------------------
+| Índice curado das páginas navegáveis do app. Consumido pelo GlobalSearch
+| pra dar "ir pra tal página" como resultado da busca.
+|
+| Regras:
+|   • `roles` vazio ou ausente  → todos logados veem.
+|   • `roles` com valores       → apenas esses papéis veem.
+|   • Roles reconhecidos: 'therapist', 'clinic_admin', 'tenant_admin',
+|     'supervisor', 'saas_admin', 'portal_user'.
+|
+| Não duplique aqui o que já está nas STATIC_ACTIONS do GlobalSearch
+| (Agenda, Pacientes, Financeiro, Documentos, Configurações, etc.).
+| O foco aqui são *sub-páginas* e telas menos frequentes, que o usuário
+| raramente lembra onde ficam.
+|--------------------------------------------------------------------------
+*/
+
+// Helpers opcionais pra keywords mais ricas
+const kw = (...arr) => arr.flat().filter(Boolean);
+
+export const PAGES = [
+    // ═══════════════════ THERAPIST (/therapist/*) ═══════════════════
+    { id: 'p_t_dashboard',        label: 'Dashboard',                     icon: 'pi pi-home',         sublabel: 'Visão geral',                         path: '/therapist',                               roles: ['therapist'],                       keywords: kw('home','inicio','painel','dashboard') },
+    { id: 'p_t_conversas',        label: 'Conversas',                     icon: 'pi pi-comments',     sublabel: 'Mensagens com pacientes',             path: '/therapist/conversas',                     roles: ['therapist'],                       keywords: kw('conversas','chat','mensagens','whatsapp') },
+    { id: 'p_t_agenda_rec',       label: 'Recorrências da agenda',        icon: 'pi pi-refresh',      sublabel: 'Sessões recorrentes',                 path: '/therapist/agenda/recorrencias',           roles: ['therapist'],                       keywords: kw('recorrencia','repeticao','semanal','sessao fixa') },
+    { id: 'p_t_agenda_comp',      label: 'Compromissos determinados',     icon: 'pi pi-bookmark',     sublabel: 'Sessões fixas',                       path: '/therapist/agenda/compromissos',           roles: ['therapist'],                       keywords: kw('compromissos','determinado','fixo') },
+    { id: 'p_t_plano',            label: 'Meu plano',                     icon: 'pi pi-crown',        sublabel: 'Assinatura e billing',                path: '/therapist/meu-plano',                     roles: ['therapist'],                       keywords: kw('plano','assinatura','pagamento','mensalidade','billing') },
+    { id: 'p_t_upgrade',          label: 'Upgrade de plano',              icon: 'pi pi-arrow-up',     sublabel: 'Mudar de plano',                      path: '/therapist/upgrade',                       roles: ['therapist'],                       keywords: kw('upgrade','trocar','mudar plano') },
+    { id: 'p_t_grupos',           label: 'Grupos de pacientes',           icon: 'pi pi-users',        sublabel: 'Organizar pacientes em grupos',       path: '/therapist/patients/grupos',               roles: ['therapist'],                       keywords: kw('grupos','segmentacao','categorias') },
+    { id: 'p_t_tags',             label: 'Tags de pacientes',             icon: 'pi pi-tags',         sublabel: 'Etiquetas',                           path: '/therapist/patients/tags',                 roles: ['therapist'],                       keywords: kw('tags','etiquetas','marcadores','labels') },
+    { id: 'p_t_medicos',          label: 'Médicos referenciadores',       icon: 'pi pi-user-edit',    sublabel: 'Médicos que encaminham pacientes',    path: '/therapist/patients/medicos',              roles: ['therapist'],                       keywords: kw('medicos','encaminhadores','referenciadores','indicacao') },
+    { id: 'p_t_link_externo',     label: 'Link de cadastro externo',      icon: 'pi pi-link',         sublabel: 'Link público pra pacientes',          path: '/therapist/patients/link-externo',         roles: ['therapist'],                       keywords: kw('link','externo','publico','cadastro paciente','convite') },
+    { id: 'p_t_cad_recebidos',    label: 'Cadastros recebidos',           icon: 'pi pi-inbox',        sublabel: 'Pacientes aguardando aceite',         path: '/therapist/patients/cadastro/recebidos',   roles: ['therapist'],                       keywords: kw('recebidos','pendentes','aceitar','intake','novos') },
+    { id: 'p_t_doc_templates',    label: 'Templates de documentos',       icon: 'pi pi-file-edit',    sublabel: 'Modelos reutilizáveis',               path: '/therapist/documents/templates',           roles: ['therapist'],                       keywords: kw('templates','modelos','contratos','documentos') },
+    { id: 'p_t_online_sched',     label: 'Agendamento online',            icon: 'pi pi-globe',        sublabel: 'Página pública de agendamento',       path: '/therapist/online-scheduling',             roles: ['therapist'],                       keywords: kw('online','publico','agendar','landing','pagina','site') },
+    { id: 'p_t_ag_recebidos',     label: 'Agendamentos recebidos',        icon: 'pi pi-calendar-plus',sublabel: 'Solicitações da agenda pública',      path: '/therapist/agendamentos-recebidos',        roles: ['therapist'],                       keywords: kw('solicitacoes','recebidos','publico','pedidos') },
+    { id: 'p_t_fin_lanc',         label: 'Lançamentos financeiros',       icon: 'pi pi-list',         sublabel: 'Entradas e saídas',                   path: '/therapist/financeiro/lancamentos',        roles: ['therapist'],                       keywords: kw('lancamentos','entradas','saidas','fluxo de caixa','receitas','despesas') },
+    { id: 'p_t_relatorios',       label: 'Relatórios',                    icon: 'pi pi-chart-bar',    sublabel: 'Métricas e análises',                 path: '/therapist/relatorios',                    roles: ['therapist'],                       keywords: kw('relatorios','metricas','dashboards','analytics','indicadores') },
+    { id: 'p_t_security',         label: 'Segurança da conta',            icon: 'pi pi-shield',       sublabel: 'Senha, 2FA, sessões',                 path: '/therapist/settings/security',             roles: ['therapist'],                       keywords: kw('seguranca','senha','2fa','autenticacao','mfa') },
+    { id: 'p_t_notificacoes',     label: 'Notificações',                  icon: 'pi pi-bell',         sublabel: 'Histórico completo',                  path: '/therapist/notificacoes',                  roles: ['therapist'],                       keywords: kw('notificacoes','historico','alertas','avisos','inbox') },
+
+    // ═══════════════════ CLINIC ADMIN (/admin/*) ═══════════════════
+    { id: 'p_c_dashboard',        label: 'Dashboard (clínica)',           icon: 'pi pi-home',         sublabel: 'Visão geral da clínica',              path: '/admin',                                   roles: ['clinic_admin','tenant_admin'],     keywords: kw('dashboard','home','clinica') },
+    { id: 'p_c_features',         label: 'Features da clínica',           icon: 'pi pi-th-large',     sublabel: 'Recursos habilitados',                path: '/admin/clinic/features',                   roles: ['clinic_admin','tenant_admin'],     keywords: kw('features','recursos','modulos','addons') },
+    { id: 'p_c_professionals',    label: 'Profissionais',                 icon: 'pi pi-user',         sublabel: 'Terapeutas da clínica',               path: '/admin/clinic/professionals',              roles: ['clinic_admin','tenant_admin'],     keywords: kw('profissionais','terapeutas','equipe','time') },
+    { id: 'p_c_agenda_clinica',   label: 'Agenda da clínica',             icon: 'pi pi-calendar',     sublabel: 'Agenda consolidada',                  path: '/admin/agenda/clinica',                    roles: ['clinic_admin','tenant_admin'],     keywords: kw('agenda','clinica','global','consolidada') },
+    { id: 'p_c_plano',            label: 'Plano da clínica',              icon: 'pi pi-crown',        sublabel: 'Assinatura',                          path: '/admin/meu-plano',                         roles: ['clinic_admin','tenant_admin'],     keywords: kw('plano','assinatura','billing','clinica') },
+
+    // ═══════════════════ CONFIGURAÇÕES (/configuracoes/*) ═══════════════════
+    { id: 'p_cfg_agenda',         label: 'Config: Agenda',                icon: 'pi pi-calendar',     sublabel: 'Horário de atendimento, durações',    path: '/configuracoes/agenda',                                                                keywords: kw('config','agenda','horario','duracao','expediente') },
+    { id: 'p_cfg_bloqueios',      label: 'Config: Bloqueios',             icon: 'pi pi-ban',          sublabel: 'Feriados e indisponibilidades',       path: '/configuracoes/bloqueios',                                                             keywords: kw('bloqueios','feriados','ferias','indisponivel','folga') },
+    { id: 'p_cfg_agendador',      label: 'Config: Agendador público',     icon: 'pi pi-globe',        sublabel: 'Configurações da página pública',     path: '/configuracoes/agendador',                                                             keywords: kw('agendador','publico','online','booking','configurar') },
+    { id: 'p_cfg_pagamento',      label: 'Config: Formas de pagamento',   icon: 'pi pi-wallet',       sublabel: 'Métodos aceitos',                     path: '/configuracoes/pagamento',                                                             keywords: kw('pagamento','metodos','pix','cartao','boleto','dinheiro') },
+    { id: 'p_cfg_descontos',      label: 'Config: Descontos',             icon: 'pi pi-percentage',   sublabel: 'Regras de desconto',                  path: '/configuracoes/descontos',                                                             keywords: kw('descontos','promocao','reducao','abatimento') },
+    { id: 'p_cfg_excecoes',       label: 'Config: Exceções financeiras',  icon: 'pi pi-exclamation-triangle', sublabel: 'Casos especiais',             path: '/configuracoes/excecoes-financeiras',                                                  keywords: kw('excecoes','financeiras','casos especiais','ajustes','manuais') },
+    { id: 'p_cfg_convenios',      label: 'Config: Convênios',             icon: 'pi pi-id-card',      sublabel: 'Planos de saúde',                     path: '/configuracoes/convenios',                                                             keywords: kw('convenios','planos','saude','insurance','seguro') },
+    { id: 'p_cfg_email',          label: 'Config: Templates de e-mail',   icon: 'pi pi-envelope',     sublabel: 'Mensagens automáticas',               path: '/configuracoes/email-templates',                                                       keywords: kw('email','templates','modelos','notificacoes','mensagens') },
+    { id: 'p_cfg_empresa',        label: 'Config: Empresa',               icon: 'pi pi-building',     sublabel: 'Dados da sua empresa',                path: '/configuracoes/empresa',                                                               keywords: kw('empresa','dados','cnpj','razao social','fantasia','endereco') },
+    { id: 'p_cfg_conv_tags',      label: 'Config: Tags de Conversa',      icon: 'pi pi-tag',          sublabel: 'Etiquetas pro CRM de conversas',      path: '/configuracoes/conversas-tags',                                                        keywords: kw('tags','etiquetas','conversas','crm','whatsapp','kanban') },
+    { id: 'p_cfg_conv_autoreply', label: 'Config: Auto-reply WhatsApp',   icon: 'pi pi-reply',        sublabel: 'Resposta fora do horário',            path: '/configuracoes/conversas-autoreply',                                                   keywords: kw('auto-reply','autoresposta','fora do horario','whatsapp','automatico','bot') },
+    { id: 'p_cfg_conv_optouts',   label: 'Config: Opt-outs (LGPD)',       icon: 'pi pi-ban',          sublabel: 'Números bloqueados de envios auto',   path: '/configuracoes/conversas-optouts',                                                     keywords: kw('opt-out','optout','lgpd','parar','bloqueio','cancelar','compliance','anpd') },
+    { id: 'p_cfg_lembretes',      label: 'Config: Lembretes de Sessão',   icon: 'pi pi-bell',         sublabel: 'WhatsApp 24h e 2h antes',              path: '/configuracoes/lembretes-sessao',                                                      keywords: kw('lembretes','sessao','whatsapp','automatico','reduzir faltas','avisar') },
+    { id: 'p_cfg_creditos_wa',    label: 'Config: Créditos WhatsApp',      icon: 'pi pi-credit-card',  sublabel: 'Saldo, pacotes, extrato',              path: '/configuracoes/creditos-whatsapp',                                                     keywords: kw('creditos','whatsapp','saldo','pacote','pagamento','pix','comprar','asaas') },
+    { id: 'p_cfg_canais',         label: 'Config: Canais de notificação', icon: 'pi pi-bell',         sublabel: 'WhatsApp, SMS, e-mail',               path: '/configuracoes/canais',                                                                keywords: kw('canais','notificacoes','lembretes','whatsapp','sms','email') },
+    { id: 'p_cfg_whatsapp',       label: 'Config: WhatsApp',              icon: 'pi pi-whatsapp',     sublabel: 'Canal WhatsApp',                      path: '/configuracoes/whatsapp',                                                              keywords: kw('whatsapp','wa','mensageria') },
+    { id: 'p_cfg_whatsapp_ofc',   label: 'Config: WhatsApp Oficial AgenciaPSI', icon: 'pi pi-verified',  sublabel: 'Número oficial gerenciado',           path: '/configuracoes/whatsapp-oficial',                                                      keywords: kw('whatsapp','oficial','agenciapsi','business','api','meta','creditos') },
+    { id: 'p_cfg_whatsapp_pes',   label: 'Config: WhatsApp Pessoal',      icon: 'pi pi-mobile',       sublabel: 'Conectar via QR code',                path: '/configuracoes/whatsapp-pessoal',                                                      keywords: kw('whatsapp','pessoal','qr','gratis','evolution','baileys') },
+    { id: 'p_cfg_sms',            label: 'Config: SMS',                   icon: 'pi pi-mobile',       sublabel: 'Canal SMS',                           path: '/configuracoes/sms',                                                                   keywords: kw('sms','torpedo','texto') },
+    { id: 'p_cfg_sms_canal',      label: 'Config: Canal SMS',             icon: 'pi pi-mobile',       sublabel: 'Provedor e número',                   path: '/configuracoes/sms-canal',                                                             keywords: kw('sms','canal','provedor') },
+    { id: 'p_cfg_extras',         label: 'Config: Recursos extras',       icon: 'pi pi-plus-circle',  sublabel: 'Addons e créditos',                   path: '/configuracoes/recursos-extras',                                                       keywords: kw('recursos','extras','addons','creditos','saldo') },
+    { id: 'p_cfg_auditoria',      label: 'Config: Auditoria',             icon: 'pi pi-history',      sublabel: 'Log de ações',                        path: '/configuracoes/auditoria',                                                             keywords: kw('auditoria','log','historico','acoes') },
+
+    // ═══════════════════ CONTA (/account/*) ═══════════════════
+    { id: 'p_acc_profile',        label: 'Meu perfil',                    icon: 'pi pi-user',         sublabel: 'Dados pessoais',                      path: '/account/profile',                                                                     keywords: kw('perfil','profile','meus dados','nome','foto','bio') },
+    { id: 'p_acc_negocio',        label: 'Meu negócio',                   icon: 'pi pi-briefcase',    sublabel: 'Dados profissionais',                 path: '/account/negocio',                                                                     keywords: kw('negocio','profissional','crp','atuacao','especialidade') },
+    { id: 'p_acc_security',       label: 'Segurança (conta)',             icon: 'pi pi-shield',       sublabel: 'Senha e autenticação',                path: '/account/security',                                                                    keywords: kw('seguranca','senha','password','2fa') }
+];
+
+/**
+ * Filtra páginas pelo papel ativo do usuário.
+ * @param {string|null} role - 'therapist'|'clinic_admin'|'tenant_admin'|'supervisor'|'saas_admin'|'portal_user'
+ * @returns {Array}
+ */
+export function filterPagesForRole(role) {
+    if (!role) return PAGES.filter((p) => !p.roles || p.roles.length === 0);
+    return PAGES.filter((p) => !p.roles || p.roles.length === 0 || p.roles.includes(role));
+}
+
+/**
+ * Normaliza string pra busca fuzzy simples (remove acento, minúsculo, trim).
+ */
+function _norm(s) {
+    return String(s || '').normalize('NFD').replace(/[\u0300-\u036f]/g, '').toLowerCase().trim();
+}
+
+/**
+ * Busca fuzzy em páginas filtradas pelo papel.
+ * @param {string} q
+ * @param {string|null} role
+ * @param {number} limit
+ */
+export function searchPages(q, role, limit = 6) {
+    const query = _norm(q);
+    const pool = filterPagesForRole(role);
+    if (!query) return pool.slice(0, limit); // top N quando vazio
+    return pool
+        .filter((p) => {
+            const hay = _norm(p.label + ' ' + p.sublabel + ' ' + (p.keywords || []).join(' '));
+            return hay.includes(query);
+        })
+        .slice(0, limit);
+}