feat(protese): Nota ScoreOdonto pública no marketplace de profissionais

GET /api/profissionais/marketplace passa a trazer a 'nota' dos protéticos (helper
notasScorePorProtetico, mesma fórmula da Fase 5 — só com volume mínimo). Card do protético
no marketplace exibe ★ nota. Ordem mantida por proximidade; a nota é comparação visível.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

backend/server.js

@@ -4146,6 +4146,29 @@ app.get('/api/protese/lab/indicadores', authGuard, async (req, res) => {
     } catch (err) { res.status(500).json({ error: err.message }); }
 });
 
+// Nota ScoreOdonto por protético (mapa id→nota), p/ ranking no dropdown e no marketplace.
+async function notasScorePorProtetico(ids) {
+    const notas = {};
+    if (!ids || !ids.length) return notas;
+    const { rows: ag } = await pool.query(
+        `SELECT protetico_id,
+                COUNT(*) FILTER (WHERE status='entregue')::int AS entregues,
+                COUNT(*) FILTER (WHERE status='entregue' AND tipo_os='garantia')::int AS garantia,
+                COUNT(*) FILTER (WHERE status='entregue' AND prazo_entrega IS NOT NULL AND updated_at::date > prazo_entrega)::int AS atrasados
+         FROM protese_os WHERE protetico_id = ANY($1) AND deleted_at IS NULL GROUP BY protetico_id`, [ids]);
+    const { rows: ocs } = await pool.query(
+        `SELECT o.protetico_id, COUNT(DISTINCT oc.os_id)::int AS n FROM protese_os_ocorrencia oc JOIN protese_os o ON o.id = oc.os_id WHERE oc.status='resolvida' AND o.protetico_id = ANY($1) GROUP BY o.protetico_id`, [ids]);
+    const ocMap = Object.fromEntries(ocs.map(o => [o.protetico_id, o.n]));
+    for (const g of ag) {
+        if (g.entregues >= SCORE_MIN_OS) {
+            const pct = n => g.entregues > 0 ? n / g.entregues * 100 : 0;
+            const nota = 10 - (pct(g.atrasados) / 100 * 3 + pct(g.garantia) / 100 * 4 + pct(ocMap[g.protetico_id] || 0) / 100 * 3);
+            notas[g.protetico_id] = Math.round(Math.max(0, Math.min(10, nota)) * 10) / 10;
+        }
+    }
+    return notas;
+}
+
 // MODO 1 — gerar/recuperar o link seguro de acompanhamento da OS (clínica ou lab).
 app.post('/api/protese/os/:id/link', authGuard, async (req, res) => {
     try {
@@ -4174,6 +4197,19 @@ app.post('/api/protese/os/:id/link/revogar', authGuard, async (req, res) => {
         res.json({ success: true });
     } catch (err) { res.status(500).json({ error: err.message }); }
 });
+// Status do link ativo (para a UI da clínica gerir: copiar/revogar, ver acessos/expiração).
+app.get('/api/protese/os/:id/link/status', authGuard, async (req, res) => {
+    try {
+        const uid = req.authUser.userId;
+        const acc = await carregaOSComAcesso(req.params.id, uid);
+        if (acc.error) return res.status(acc.status).json({ error: acc.error });
+        const { rows } = await pool.query(
+            "SELECT token, expires_at, last_access_at, acessos FROM protese_os_link WHERE os_id=$1 AND revoked_at IS NULL AND (expires_at IS NULL OR expires_at > NOW()) ORDER BY created_at DESC LIMIT 1", [acc.os.id]);
+        if (!rows.length) return res.json({ ativo: false });
+        const base = process.env.APP_PUBLIC_URL || 'https://scoreodonto.com';
+        res.json({ ativo: true, url: `${base}/p/${rows[0].token}`, expires_at: rows[0].expires_at, last_access_at: rows[0].last_access_at, acessos: rows[0].acessos });
+    } catch (err) { res.status(500).json({ error: err.message }); }
+});
 
 // MODO 1 — leitura PÚBLICA da OS pelo token (sem login). Blindagem: sem CPF, sem valor do paciente.
 app.get('/api/p/:token', async (req, res) => {
@@ -7173,7 +7209,10 @@ app.get('/api/profissionais/marketplace', authGuard, async (req, res) => {
         const { rows } = await pool.query(
             `SELECT id, nome, email, celular, role, estado, cidade, bairro, cep, especialidade_dir AS especialidade, raio_atuacao_km, bio_profissional, ${distSelect}
              FROM usuarios ${where} ${order} LIMIT 200`, params);
-        res.json(rows);
+        // Nota ScoreOdonto nos protéticos (score público no marketplace). Mantém a ordem por
+        // proximidade; a nota é exibida no card para a clínica comparar.
+        const notas = await notasScorePorProtetico(rows.filter(r => r.role === 'protetico').map(r => r.id));
+        res.json(rows.map(r => ({ ...r, nota: r.role === 'protetico' ? (notas[r.id] ?? null) : undefined })));
     } catch (err) { res.status(500).json({ error: err.message }); }
 });
 

doc/MODO1-LINK-SEGURO-PROTESE.md

@@ -94,7 +94,15 @@ marketplace/score (Fase 5) — quanto mais clínicas o usam, mais OS e melhor o
   `"<nome> (link)"`. Página pública ganha a seção "Atualizar status" (botões de custódia, etapa e foto)
   enquanto a OS não está finalizada. Validado em DEV: recebimento, avanço, foto, e `entregue` pelo link
   → 400 (bloqueado).
-- **1c (conversão):** herança de histórico ao criar conta + revogação/expiração na UI.
+- **✅ 1c (gestão) — IMPLEMENTADA 24/jun:** UI da clínica (aba Monitoramento) gere o link:
+  `GET /api/protese/os/:id/link/status` traz **link ativo, nº de acessos, último acesso e expiração**;
+  botões **Copiar / WhatsApp / Revogar**. Validado em DEV: acessos contados, expiração 60 dias,
+  revogação → status inativo + leitura pública 404.
+  > Conversão por herança: nativa — a OS já aponta para o `protetico_id` do destinatário, então ao
+  > entrar/criar conta ele já é dono do histórico. (Vincular um cadastro NOVO com e-mail diferente às
+  > OS é caso de borda — fica para evolução, evitando duplicar usuário.)
+
+**Modo 1 concluído (1a leitura + 1b ação + 1c gestão).**
 
 > Nenhuma refatoração: reusa OS/eventos/custódia/ocorrências/blindagem já existentes. Só adiciona a
 > camada de token público.

doc/PROVEDOR-PROTESE-DECISAO.md

@@ -106,6 +106,16 @@ Score/ranking/marketplace. Não codar indicador antes de existir dado.
 
 > Acoplamentos respeitados: PF/PJ veio com a equipe (Fase 4); Score só após a captura (Fases 2-4).
 
-### Fora de escopo (futuro)
-Marketplace **transacional** (propostas/contratação dentro da plataforma) e o Modo 1 (protético sem
-conta via link seguro `/p/TOKEN`) seguem como evolução — a base de dados/score já os suporta.
+### Pós-roadmap (entregue depois das Fases 1-5)
+- **✅ Modo 1** (protético sem conta via link `/p/TOKEN`) — completo (1a leitura, 1b ação, 1c gestão).
+  Ver `MODO1-LINK-SEGURO-PROTESE.md`.
+- **✅ Higiene** — menu legado do protético removido (Sidebar/App): o protético opera só no workspace
+  laboratório; fallback mínimo fora dele.
+- **✅ Score público no marketplace** — `GET /api/profissionais/marketplace` traz a `nota` ScoreOdonto
+  dos protéticos (helper `notasScorePorProtetico`, mesma fórmula da Fase 5), exibida como ★ no card.
+  Ordem mantida por proximidade; a nota é critério de comparação visível.
+
+### Ainda em aberto (futuro)
+Marketplace **transacional** (anúncio de serviços + solicitação/contratação/propostas dentro da
+plataforma); **agenda de produção/coleta**; **multi-unidade** do laboratório; envio automático do
+link (e-mail/WhatsApp API) e herança de cadastro novo com e-mail diferente.

doc/VERDADE-HOJE.md

@@ -9,7 +9,7 @@
 ### 1. Onde está o código?
 - **Fonte da verdade:** Gitea na **VPS3**, repo `ruicesar/scoreodonto.com`.
 - **Dev (trabalho):** VPS4 em `/home/deploy/stack/scoreodonto.com`.
-- **Produção:** VPS1 roda **imagens versionadas do registry** (não código-fonte). No ar: **v1.0.23 · commit `672c3b0`**.
+- **Produção:** VPS1 roda **imagens versionadas do registry** (não código-fonte). No ar: **v1.0.25 · commit `8040e70`**.
 - **Documentação:** centralizada em `scoreodonto.com/doc/` (pasta única).
 
 ### 2. Onde está o banco?
@@ -28,7 +28,7 @@
 - ✅ **Build Once → Promote (Passo 5, validado em produção):** push builda 1× e publica por **commit** (`:<sha>`); a **tag re-tagueia** esse artefato como `:vX.Y.Z` (sem rebuild — digest idêntico) e deploya. Provado em v1.0.16 (`:v1.0.16` == `:471c2c2`, mesmo digest).
 
 ### 5. Como versiona?
-- A versão exibida vem do **backend em runtime**: `GET /api/version` (de `process.env`), mostrada em **Configurações → "Sobre o sistema"** e nas telas públicas (o frontend consome via `useAppVersion()`, não embute mais a versão). No ar: **v1.0.23 · `672c3b0` · PROD**.
+- A versão exibida vem do **backend em runtime**: `GET /api/version` (de `process.env`), mostrada em **Configurações → "Sobre o sistema"** e nas telas públicas (o frontend consome via `useAppVersion()`, não embute mais a versão). No ar: **v1.0.25 · `8040e70` · PROD**.
 - A versão **nasce da tag git** e é **injetada no deploy em runtime** (`APP_VERSION`=tag, `APP_ENV=PROD`); `commit`/`build` vêm carimbados na imagem.
 - ✅ **`constants.ts`/`update-version.js` foram removidos** (Passo 5) — não há mais versão manual.
 
@@ -39,4 +39,4 @@
 ---
 
 ## Veredito de uma linha
-> O código vive no Gitea (VPS3); a **produção (VPS1) roda imagens versionadas do registry** (hoje **v1.0.23**), sem buildar; o **DEV está isolado no `pgdev`** (não toca o banco de produção). **CI/CD por tag ativo** no modelo **Build Once → Promote → Deploy** (push builda por commit; tag re-tagueia sem rebuild e deploya — validado em v1.0.16), com **versão visível em runtime** (`/api/version` → Configurações) nascendo da tag git.
+> O código vive no Gitea (VPS3); a **produção (VPS1) roda imagens versionadas do registry** (hoje **v1.0.25**), sem buildar; o **DEV está isolado no `pgdev`** (não toca o banco de produção). **CI/CD por tag ativo** no modelo **Build Once → Promote → Deploy** (push builda por commit; tag re-tagueia sem rebuild e deploya — validado em v1.0.16), com **versão visível em runtime** (`/api/version` → Configurações) nascendo da tag git.

frontend/App.tsx

@@ -329,7 +329,7 @@ const App: React.FC = () => {
       paciente: ['tratamentos', 'notificacoes', 'configuracoes'],
       dentista: ['dashboard', 'agenda', 'ortodontia', 'tratamentos', 'lancar-gto', 'proteses', 'notificacoes', 'clinicas', 'configuracoes', 'plugins', 'rx-radiografias', 'salas', 'marketplace-profissionais', 'candidatura-tutor', 'tutoria-painel', 'diretorio-profissionais'],
       biomedico: ['dashboard', 'agenda', 'tratamentos', 'lancar-gto', 'especialidades', 'procedimentos', 'notificacoes', 'clinicas', 'configuracoes', 'plugins', 'salas', 'marketplace-profissionais', 'diretorio-profissionais'],
-      protetico: ['dashboard', 'agenda', 'tratamentos', 'lancar-gto', 'proteses', 'lab-home', 'lab-bancada', 'lab-clientes', 'lab-financeiro', 'lab-equipe', 'lab-indicadores', 'notificacoes', 'clinicas', 'configuracoes', 'plugins', 'salas', 'marketplace-profissionais', 'diretorio-profissionais'],
+      protetico: ['lab-home', 'lab-bancada', 'lab-clientes', 'lab-financeiro', 'lab-equipe', 'lab-indicadores', 'notificacoes', 'clinicas', 'configuracoes', 'plugins', 'salas', 'marketplace-profissionais', 'diretorio-profissionais'],
       funcionario: ['dashboard', 'leads', 'pacientes', 'agenda', 'financeiro', 'tratamentos', 'lancar-gto', 'proteses', 'relatorios', 'notificacoes', 'clinicas', 'configuracoes', 'orcamentos', 'contratos', 'plugins', 'rx-radiografias', 'salas', 'marketplace-profissionais', 'candidatura-tutor', 'diretorio-profissionais'],
     };
 

frontend/components/Sidebar.tsx

@@ -149,7 +149,9 @@ export const Sidebar: React.FC<SidebarProps> = ({ activeTab, setActiveTab }) =>
     // SEM itens odontológicos (ortodontia, RX, tutoria orto).
     if (currentRole === 'biomedico') return ['dashboard', 'agenda', 'tratamentos', 'especialidades', 'procedimentos', 'notificacoes', 'clinicas', 'configuracoes', 'diretorio-profissionais'].includes(item.id);
     // Protético: laboratório — agenda própria + GTO; sem ortodontia/RX/pacientes clínicos.
-    if (currentRole === 'protetico') return ['dashboard', 'agenda', 'proteses', 'tratamentos', 'lancar-gto', 'notificacoes', 'clinicas', 'configuracoes', 'diretorio-profissionais'].includes(item.id);
+    // Protético: opera dentro do workspace 'laboratorio' (menu governado pelo branch tipo acima).
+    // Este é só o fallback fora desse contexto — sem telas clínicas (agenda/GTO/tratamentos).
+    if (currentRole === 'protetico') return ['notificacoes', 'clinicas', 'configuracoes', 'diretorio-profissionais'].includes(item.id);
     if (currentRole === 'funcionario') return ['dashboard', 'leads', 'pacientes', 'tratamentos', 'lancar-gto', 'proteses', 'agenda', 'financeiro', 'relatorios', 'glosas', 'notificacoes', 'clinicas', 'configuracoes', 'orcamentos', 'contratos', 'diretorio-profissionais'].includes(item.id);
     return false;
   });

frontend/services/backend.ts

@@ -1130,6 +1130,15 @@ export const HybridBackend = {
     if (!res.ok) throw new Error((await res.json().catch(() => ({}))).error || 'Erro ao gerar link');
     return await res.json();
   },
+  getProteseLinkStatus: async (osId: string) => {
+    const res = await apiFetch(`${API_URL}/protese/os/${osId}/link/status`);
+    return await res.json().catch(() => ({ ativo: false }));
+  },
+  revogarProteseLink: async (osId: string) => {
+    const res = await apiFetch(`${API_URL}/protese/os/${osId}/link/revogar`, { method: 'POST' });
+    if (!res.ok) throw new Error((await res.json().catch(() => ({}))).error || 'Erro ao revogar');
+    return await res.json();
+  },
   // Leitura PÚBLICA via token (sem login — não usa apiFetch/Authorization)
   getProtesePublic: async (token: string) => {
     const res = await fetch(`${API_URL}/p/${encodeURIComponent(token)}`);

frontend/views/ProteseView.tsx

@@ -558,31 +558,41 @@ const OcorrenciasSecao: React.FC<{ os: any; onChanged: () => void }> = ({ os, on
 // ── Seção: Compartilhar link de acompanhamento com o protético (Modo 1) ─────
 const CompartilharLinkSecao: React.FC<{ os: any }> = ({ os }) => {
     const toast = useToast();
-    const [url, setUrl] = useState('');
+    const confirm = useConfirm();
+    const [st, setSt] = useState<any>(null); // null=carregando | {ativo,...}
     const [busy, setBusy] = useState(false);
-    const gerar = async () => {
+    const carregar = useCallback(() => HybridBackend.getProteseLinkStatus(os.id).then(setSt).catch(() => setSt({ ativo: false })), [os.id]);
+    useEffect(() => { carregar(); }, [carregar]);
+    const acao = async (fn: () => Promise<any>, ok: string) => {
         setBusy(true);
-        try { const r = await HybridBackend.gerarProteseLink(os.id); setUrl(r.url); }
+        try { await fn(); await carregar(); toast.success(ok); }
         catch (e: any) { toast.error((e.message || 'ERRO').toUpperCase()); } finally { setBusy(false); }
     };
-    const copiar = async () => { try { await navigator.clipboard.writeText(url); toast.success('LINK COPIADO.'); } catch { toast.error('NÃO FOI POSSÍVEL COPIAR.'); } };
-    const waText = encodeURIComponent(`Acompanhe a prótese (${os.tipo}) do paciente ${os.paciente_nome || ''}: ${url}`);
+    const copiar = async () => { try { await navigator.clipboard.writeText(st.url); toast.success('LINK COPIADO.'); } catch { toast.error('NÃO FOI POSSÍVEL COPIAR.'); } };
+    const revogar = async () => { if (await confirm('REVOGAR O LINK? O PROTÉTICO PERDE O ACESSO.')) acao(() => HybridBackend.revogarProteseLink(os.id), 'LINK REVOGADO.'); };
+    const waText = st?.url ? encodeURIComponent(`Acompanhe a prótese (${os.tipo}) do paciente ${os.paciente_nome || ''}: ${st.url}`) : '';
     return (
         <div className="border-t border-gray-100 pt-4 space-y-2">
             <p className="text-[10px] font-black text-gray-400 uppercase flex items-center gap-1.5"><Share2 size={12} /> Acompanhamento do protético</p>
-            {!url ? (
+            {!st ? (
+                <p className="text-[11px] text-gray-300 uppercase font-bold">Carregando…</p>
+            ) : !st.ativo ? (
                 <>
                     <p className="text-[11px] text-gray-400">Gere um link para o protético acompanhar esta OS <b>sem precisar de conta</b>.</p>
-                    <button disabled={busy} onClick={gerar} className="px-3 py-2 rounded-lg bg-[#2d6a4f] text-white text-[11px] font-black uppercase disabled:opacity-50 flex items-center gap-1.5"><Share2 size={13} /> Gerar link de acompanhamento</button>
+                    <button disabled={busy} onClick={() => acao(() => HybridBackend.gerarProteseLink(os.id), 'LINK GERADO.')} className="px-3 py-2 rounded-lg bg-[#2d6a4f] text-white text-[11px] font-black uppercase disabled:opacity-50 flex items-center gap-1.5"><Share2 size={13} /> Gerar link de acompanhamento</button>
                 </>
             ) : (
                 <div className="space-y-2">
-                    <input readOnly value={url} onClick={e => e.currentTarget.select()} className="w-full p-2 bg-gray-50 border border-gray-100 rounded-lg text-[11px] text-gray-600 outline-none" />
+                    <input readOnly value={st.url} onClick={e => e.currentTarget.select()} className="w-full p-2 bg-gray-50 border border-gray-100 rounded-lg text-[11px] text-gray-600 outline-none" />
                     <div className="flex gap-2">
                         <a href={`https://wa.me/?text=${waText}`} target="_blank" rel="noreferrer" className="flex-1 py-2 rounded-lg bg-green-600 text-white text-[11px] font-black uppercase text-center">WhatsApp</a>
                         <button onClick={copiar} className="flex-1 py-2 rounded-lg border border-gray-200 text-gray-600 text-[11px] font-black uppercase">Copiar</button>
                     </div>
-                    <p className="text-[9px] text-gray-400 uppercase">Somente leitura · expira em 60 dias · sem CPF nem valores do paciente.</p>
+                    <div className="flex items-center justify-between text-[9px] font-bold text-gray-400 uppercase">
+                        <span>{st.acessos || 0} acesso(s){st.last_access_at ? ` · último ${dataBR(st.last_access_at)}` : ' · ainda não aberto'}</span>
+                        <button disabled={busy} onClick={revogar} className="text-red-500 hover:text-red-600 disabled:opacity-50">Revogar</button>
+                    </div>
+                    <p className="text-[9px] text-gray-400 uppercase">{st.expires_at ? `Expira em ${dataBR(st.expires_at)} · ` : ''}sem CPF nem valores do paciente.</p>
                 </div>
             )}
         </div>

frontend/views/plugins/ProfissionaisPlugin.tsx

@@ -44,6 +44,7 @@ interface Profissional {
   raio_atuacao_km?: number | null;
   bio_profissional?: string | null;
   dist_km?: number | string | null;
+  nota?: number | null; // Nota ScoreOdonto (só protéticos com volume mínimo)
 }
 
 interface Proposta {
@@ -699,6 +700,7 @@ export const ProfissionaisPlugin: React.FC = () => {
                         <div className="flex items-center gap-2 flex-wrap">
                           <span className="font-black text-gray-900 text-sm uppercase truncate">{p.nome}</span>
                           <span className={`text-[9px] font-black px-2 py-0.5 rounded-full uppercase ${meta.cls}`}>{meta.label}</span>
+                          {p.nota != null && <span className="text-[9px] font-black px-2 py-0.5 rounded-full bg-amber-100 text-amber-700 uppercase" title="Nota ScoreOdonto">★ {p.nota}</span>}
                         </div>
                         {p.especialidade && <p className="text-xs text-gray-500 font-medium mt-0.5 uppercase">{p.especialidade}</p>}
                       </div>