documents/generate: FloatLabel + map de origem nos inputs

Dois problemas reportados no dialog "Gerar documento":
1. Inputs usavam <label> + <InputText> simples, fora do padrao
   FloatLabel adotado no resto do app.
2. Quando o auto-preenchimento vinha vazio o user nao tinha onde
   ir cadastrar o dado.

Mudancas:
- TEMPLATE_VARIABLES ganha campo `source` em cada entrada com a
  descricao de onde o dado eh cadastrado (ex: "Perfil -> Registro
  Profissional"). Map canonico no DocumentTemplates.service.js.
- DocumentGenerateDialog refatorado:
  * FloatLabel variant="on" em todos os inputs
  * Banner no topo com contagem "X de Y preenchidos" (verde se 100%,
    amber se faltam dados)
  * Hint (`pi pi-link` + texto source) embaixo de cada campo vazio
    apontando onde cadastrar
  * Erro de carregamento renderizado dentro do step edit
  * Input ganha `invalid` quando vazio (borda destaque)
- useDocumentGenerate.loadVariables:
  * console.error em caso de excecao (era engolido em silencio)
  * mensagem amigavel quando loadAllVariables retorna tudo vazio
    (caso comum quando paciente/perfil/clinica estao incompletos)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

src/features/documents/components/DocumentGenerateDialog.vue

@@ -79,11 +79,19 @@ const editableVars = computed(() => {
             key,
             label: meta?.label || key,
             grupo: meta?.grupo || 'Outros',
+            source: meta?.source || '',
             value: variables.value[key] || ''
         }
     })
 })
 
+// Estatística pro topo: quantos campos vieram do auto-fill vs vazios
+const varStats = computed(() => {
+    const total = editableVars.value.length
+    const filled = editableVars.value.filter(v => String(variables.value[v.key] || '').trim() !== '').length
+    return { total, filled, empty: total - filled }
+})
+
 const varGroups = computed(() => {
     const groups = {}
     for (const v of editableVars.value) {
@@ -192,17 +200,54 @@ function close() {
         </div>
 
         <!-- Step 2: Editar variaveis -->
-        <div v-else-if="step === 'edit'" class="flex flex-col gap-4">
+        <div v-else-if="step === 'edit'" class="flex flex-col gap-5">
+            <!-- Resumo do preenchimento automático -->
+            <div
+                v-if="varStats.total"
+                class="flex items-center gap-2 text-xs px-3 py-2 rounded-lg"
+                :class="varStats.empty === 0
+                    ? 'bg-green-500/10 text-green-700 dark:text-green-400'
+                    : 'bg-amber-500/10 text-amber-700 dark:text-amber-400'"
+            >
+                <i :class="varStats.empty === 0 ? 'pi pi-check-circle' : 'pi pi-info-circle'" />
+                <span v-if="varStats.empty === 0">
+                    Todos os {{ varStats.total }} campos foram preenchidos automaticamente.
+                </span>
+                <span v-else>
+                    {{ varStats.filled }} de {{ varStats.total }} preenchidos. Os campos vazios mostram onde cadastrar o dado.
+                </span>
+            </div>
+
+            <!-- Erro de carregamento de variáveis -->
+            <div
+                v-if="genError"
+                class="flex items-center gap-2 text-xs px-3 py-2 rounded-lg bg-red-500/10 text-red-600"
+            >
+                <i class="pi pi-exclamation-circle" />
+                <span>{{ genError }}</span>
+            </div>
+
             <div v-for="(vars, grupo) in varGroups" :key="grupo">
-                <div class="text-xs font-semibold uppercase tracking-wider text-[var(--text-color-secondary)] mb-2">{{ grupo }}</div>
+                <div class="text-xs font-semibold uppercase tracking-wider text-[var(--text-color-secondary)] mb-3">{{ grupo }}</div>
-                <div class="grid grid-cols-1 sm:grid-cols-2 gap-3">
+                <div class="grid grid-cols-1 sm:grid-cols-2 gap-4">
                     <div v-for="v in vars" :key="v.key" class="flex flex-col gap-1">
-                        <label class="text-xs text-[var(--text-color-secondary)]">{{ v.label }}</label>
+                        <FloatLabel variant="on">
                             <InputText
+                                :id="`docgen-var-${v.key}`"
                                 :modelValue="variables[v.key] || ''"
                                 @update:modelValue="onVarChange(v.key, $event)"
                                 class="w-full"
+                                :invalid="!String(variables[v.key] || '').trim()"
                             />
+                            <label :for="`docgen-var-${v.key}`">{{ v.label }}</label>
+                        </FloatLabel>
+                        <small
+                            v-if="!String(variables[v.key] || '').trim() && v.source"
+                            class="text-[0.65rem] text-[var(--text-color-secondary)] flex items-center gap-1 ml-1"
+                        >
+                            <i class="pi pi-link text-[0.55rem]" />
+                            {{ v.source }}
+                        </small>
                     </div>
                 </div>
             </div>

src/features/documents/composables/useDocumentGenerate.js

@@ -47,8 +47,15 @@ export function useDocumentGenerate() {
         error.value = null;
         try {
             variables.value = await loadAllVariables(patientId, agendaEventoId);
+            // Hint útil pra diagnostico: se vier objeto mas todos campos vazios,
+            // sinaliza que perfil/clínica/paciente provavelmente nao tem dados.
+            const filled = Object.values(variables.value).filter(v => String(v ?? '').trim() !== '').length;
+            if (filled === 0) {
+                error.value = 'Nenhum dado foi encontrado pra auto-preencher. Verifique o cadastro do paciente, perfil e clínica.';
+            }
         } catch (e) {
-            error.value = e?.message || 'Erro ao carregar dados do paciente.';
+            console.error('[useDocumentGenerate.loadVariables] falha:', e);
+            error.value = e?.message || 'Erro ao carregar dados pra preenchimento.';
             variables.value = {};
         } finally {
             loading.value = false;

src/services/DocumentTemplates.service.js

@@ -44,49 +44,56 @@ async function getActiveTenantId(uid) {
 
 /**
  * Variaveis que podem ser usadas nos templates.
- * Cada variavel tem: key, label (pt-BR), grupo.
+ * - key: chave usada em {{variavel}} no HTML do template
+ * - label: rótulo amigável (pt-BR)
+ * - grupo: agrupamento visual no editor
+ * - source: descrição de ONDE o dado é cadastrado (pra exibir como
+ *   hint no dialog "Gerar documento" quando o campo vier vazio).
+ *   É só texto explicativo — o map real de carregamento vive em
+ *   DocumentGenerate.service.js (loadPatientData / loadTherapistData /
+ *   loadClinicData / loadSessionData).
  */
 export const TEMPLATE_VARIABLES = [
-    // Paciente
+    // Paciente — fonte: tabela patients
-    { key: 'paciente_nome', label: 'Nome do paciente', grupo: 'Paciente' },
+    { key: 'paciente_nome',             label: 'Nome do paciente',            grupo: 'Paciente',  source: 'Paciente → nome completo' },
-    { key: 'paciente_nome_social', label: 'Nome social', grupo: 'Paciente' },
+    { key: 'paciente_nome_social',      label: 'Nome social',                 grupo: 'Paciente',  source: 'Paciente → nome social' },
-    { key: 'paciente_cpf', label: 'CPF do paciente', grupo: 'Paciente' },
+    { key: 'paciente_cpf',              label: 'CPF do paciente',             grupo: 'Paciente',  source: 'Paciente → CPF' },
-    { key: 'paciente_data_nascimento', label: 'Data de nascimento', grupo: 'Paciente' },
+    { key: 'paciente_data_nascimento',  label: 'Data de nascimento',          grupo: 'Paciente',  source: 'Paciente → data de nascimento' },
-    { key: 'paciente_telefone', label: 'Telefone do paciente', grupo: 'Paciente' },
+    { key: 'paciente_telefone',         label: 'Telefone do paciente',        grupo: 'Paciente',  source: 'Paciente → telefone' },
-    { key: 'paciente_email', label: 'E-mail do paciente', grupo: 'Paciente' },
+    { key: 'paciente_email',            label: 'E-mail do paciente',          grupo: 'Paciente',  source: 'Paciente → e-mail principal' },
-    { key: 'paciente_endereco', label: 'Endereço do paciente', grupo: 'Paciente' },
+    { key: 'paciente_endereco',         label: 'Endereço do paciente',        grupo: 'Paciente',  source: 'Paciente → endereço/número/bairro/cidade/UF' },
 
-    // Sessao
+    // Sessao — fonte: agenda_eventos (só preenche se houver sessao vinculada)
-    { key: 'data_sessao', label: 'Data da sessão', grupo: 'Sessão' },
+    { key: 'data_sessao',  label: 'Data da sessão',               grupo: 'Sessão',  source: 'Agenda → sessão selecionada (data de início)' },
-    { key: 'hora_inicio', label: 'Hora início', grupo: 'Sessão' },
+    { key: 'hora_inicio',  label: 'Hora início',                  grupo: 'Sessão',  source: 'Agenda → sessão selecionada (hora de início)' },
-    { key: 'hora_fim', label: 'Hora fim', grupo: 'Sessão' },
+    { key: 'hora_fim',     label: 'Hora fim',                     grupo: 'Sessão',  source: 'Agenda → sessão selecionada (hora de fim)' },
-    { key: 'modalidade', label: 'Modalidade (presencial/online)', grupo: 'Sessão' },
+    { key: 'modalidade',   label: 'Modalidade (presencial/online)', grupo: 'Sessão', source: 'Agenda → sessão selecionada (modalidade)' },
 
-    // Terapeuta
+    // Terapeuta — fonte: profiles (usuário logado) + auth.users
-    { key: 'terapeuta_nome', label: 'Nome do terapeuta', grupo: 'Terapeuta' },
+    { key: 'terapeuta_nome',            label: 'Nome do terapeuta',                        grupo: 'Terapeuta',  source: 'Perfil → nome completo' },
-    { key: 'terapeuta_registro', label: 'Registro profissional (ex: CRP 12345/SP)', grupo: 'Terapeuta' },
+    { key: 'terapeuta_registro',        label: 'Registro profissional (ex: CRP 12345/SP)', grupo: 'Terapeuta',  source: 'Perfil → Registro Profissional (tipo + número/UF)' },
-    { key: 'terapeuta_registro_tipo', label: 'Tipo do registro (CRP/CRM/CRFa…)', grupo: 'Terapeuta' },
+    { key: 'terapeuta_registro_tipo',   label: 'Tipo do registro (CRP/CRM/CRFa…)',         grupo: 'Terapeuta',  source: 'Perfil → Registro Profissional → tipo' },
-    { key: 'terapeuta_registro_numero', label: 'Número do registro', grupo: 'Terapeuta' },
+    { key: 'terapeuta_registro_numero', label: 'Número do registro',                       grupo: 'Terapeuta',  source: 'Perfil → Registro Profissional → número' },
-    { key: 'terapeuta_registro_uf', label: 'UF do registro', grupo: 'Terapeuta' },
+    { key: 'terapeuta_registro_uf',     label: 'UF do registro',                           grupo: 'Terapeuta',  source: 'Perfil → Registro Profissional → UF' },
-    { key: 'terapeuta_crp', label: 'CRP (legacy — prefira terapeuta_registro)', grupo: 'Terapeuta' },
+    { key: 'terapeuta_crp',             label: 'CRP (legacy — prefira terapeuta_registro)', grupo: 'Terapeuta', source: 'Perfil → só preenche se o tipo for "CRP"' },
-    { key: 'terapeuta_email', label: 'E-mail do terapeuta', grupo: 'Terapeuta' },
+    { key: 'terapeuta_email',           label: 'E-mail do terapeuta',                      grupo: 'Terapeuta',  source: 'Conta → e-mail de login' },
-    { key: 'terapeuta_telefone', label: 'Telefone do terapeuta', grupo: 'Terapeuta' },
+    { key: 'terapeuta_telefone',        label: 'Telefone do terapeuta',                    grupo: 'Terapeuta',  source: 'Perfil → telefone' },
 
-    // Clinica
+    // Clinica — fonte: tabela tenants (clinica ativa do usuário)
-    { key: 'clinica_nome', label: 'Nome da clínica', grupo: 'Clínica' },
+    { key: 'clinica_nome',     label: 'Nome da clínica',     grupo: 'Clínica',  source: 'Configurações → Clínica → nome' },
-    { key: 'clinica_endereco', label: 'Endereço da clínica', grupo: 'Clínica' },
+    { key: 'clinica_endereco', label: 'Endereço da clínica', grupo: 'Clínica',  source: 'Configurações → Clínica → logradouro/número/bairro/cidade/UF' },
-    { key: 'clinica_telefone', label: 'Telefone da clínica', grupo: 'Clínica' },
+    { key: 'clinica_telefone', label: 'Telefone da clínica', grupo: 'Clínica',  source: 'Configurações → Clínica → telefone' },
-    { key: 'clinica_cnpj', label: 'CNPJ da clínica', grupo: 'Clínica' },
+    { key: 'clinica_cnpj',     label: 'CNPJ da clínica',     grupo: 'Clínica',  source: 'Configurações → Clínica → CPF/CNPJ (preenche só se tiver 14 dígitos)' },
 
-    // Financeiro
+    // Financeiro — fonte: sessão OU extras (passados pelo chamador)
-    { key: 'valor', label: 'Valor (R$)', grupo: 'Financeiro' },
+    { key: 'valor',           label: 'Valor (R$)',          grupo: 'Financeiro',  source: 'Sessão (preço) ou informe manualmente' },
-    { key: 'valor_extenso', label: 'Valor por extenso', grupo: 'Financeiro' },
+    { key: 'valor_extenso',   label: 'Valor por extenso',   grupo: 'Financeiro',  source: 'Calculado a partir do valor' },
-    { key: 'forma_pagamento', label: 'Forma de pagamento', grupo: 'Financeiro' },
+    { key: 'forma_pagamento', label: 'Forma de pagamento',  grupo: 'Financeiro',  source: 'Informe manualmente (PIX, dinheiro, cartão, etc)' },
 
-    // Datas
+    // Datas — fonte: clock do sistema / endereço da clínica
-    { key: 'data_atual', label: 'Data atual', grupo: 'Datas' },
+    { key: 'data_atual',         label: 'Data atual',           grupo: 'Datas',  source: 'Hoje (preenchido automaticamente)' },
-    { key: 'data_atual_extenso', label: 'Data atual por extenso', grupo: 'Datas' },
+    { key: 'data_atual_extenso', label: 'Data atual por extenso', grupo: 'Datas', source: 'Hoje (preenchido automaticamente)' },
-    { key: 'cidade_estado', label: 'Cidade/UF', grupo: 'Datas' }
+    { key: 'cidade_estado',      label: 'Cidade/UF',            grupo: 'Datas',  source: 'Configurações → Clínica → cidade/UF (últimos 2 elementos do endereço)' }
 ];
 
 // ── List ────────────────────────────────────────────────────