feat(protese): marketplace transacional fatia 4 — avaliação, satisfação na nota e selo verificado

- A clínica avalia o laboratório (1-5★ + comentário) após a entrega (protese_avaliacao, 1 por OS,
  reavaliável). POST /protese/os/:id/avaliar; avaliação volta no GET detalhe.
- Nota ScoreOdonto passa a combinar 0.6·operacional + 0.4·satisfação (estrelas) quando há avaliações.
  Selo "Verificado" (≥5 entregas). Exposto no marketplace (★nota · nº avaliações · Verificado) e nos
  indicadores do lab (KPI Satisfação). Helper notasScorePorProtetico unificado (dropdown + marketplace).
- UI: seção "Avaliar o laboratório" na OS entregue (lado clínica); selo/avaliações no card do marketplace.
- Correção de passagem: FileText/Star importados em ProteseView (FileText faltava desde a fatia 3).

Validado em DEV: 6 entregas + 5★/3★ → nota 9.2, satisfação 4★, verificado (marketplace e indicadores).

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

.gitea/workflows/build.yml

@@ -40,6 +40,9 @@ jobs:
           GIT_COMMIT: ${{ steps.vars.outputs.commit }}
           BUILD_TIME: ${{ steps.vars.outputs.build_time }}
           APP_ENV: PROD
+          # SCOREO_DB_PASS tem fail-fast `:?` no compose (runtime). No build é só interpolado,
+          # nunca entra na imagem (é `environment:`, não build-arg) — placeholder satisfaz o compose.
+          SCOREO_DB_PASS: build-placeholder
         run: docker compose build scoreodonto-backend scoreodonto-frontend
 
       - name: Publicar por COMMIT (:<sha> + :latest), com retry p/ 499

.gitignore

@@ -12,11 +12,21 @@ backend/test-db-users.js
 backend/test-db-users.cjs
 backend/pg-convert.js
 
-# Override local de ambiente DEV (aponta o banco p/ pgdev) — NÃO versionar
+# Segredos de ambiente — NÃO versionar (qualquer nível)
 .env
+**/.env
+backend/.env
+.secrets
+**/.secrets
+*.dump
+backend/server.js.bak
 
 # Dependências e caches locais
 node_modules/
 frontend/node_modules/
 backend/node_modules/
 .claude/
+
+# backups de env (segredos) — nunca versionar
+*.env.bak*
+backend/.env.bak*

LEIA.md

@@ -0,0 +1,15 @@
+# LEIA
+
+A documentação deste projeto **NÃO fica aqui**. Fonte única (em português):
+**`git.clube67.com/ruicesar/Documentos-Unicos`**  ·  local: `/home/deploy/stack/documentos-unicos/`
+Comece pelo `LEIA-PRIMEIRO.md`.
+
+- Universal (vale para todos): `deploy/` e `infra/`
+- Específico deste projeto, **só se diferir** do universal: `projetos/scoreodonto.com/`
+
+## Regras-chave
+- **Sempre testar em `https://dev.<dominio>`** antes de qualquer coisa.
+- **Pedir aprovação** do administrador antes de **produção** ou de **novas melhorias/implementações**.
+- **Em dúvida, consultar `desuso/`** (só consulta/histórico) — instrução nova vai **sempre** na doc oficial.
+- **Não duplicar**: se o tema já existe, não recriar. Preferir doc **universal**; o que diferir vai em `projetos/scoreodonto.com/` (citando o que difere).
+- **Nunca** criar documentação solta no projeto. **Tudo em português.**

ScoreOdonto_Skills_Enterprise/00_LEIA_PRIMEIRO.md

@@ -0,0 +1,35 @@
+# SCOREODONTO ENTERPRISE SKILLS
+
+## REGRA Nº 1 — NÃO QUEBRAR O QUE JÁ FUNCIONA
+
+Antes de qualquer alteração:
+
+- Auditar impacto.
+- Identificar dependências.
+- Identificar telas afetadas.
+- Identificar APIs afetadas.
+- Identificar tabelas afetadas.
+- Identificar permissões afetadas.
+- Identificar integrações afetadas.
+
+PROIBIDO:
+
+- Refatorar sem auditoria.
+- Remover funcionalidades existentes sem validação.
+- Alterar identidade visual aprovada.
+- Alterar fluxo financeiro sem mapeamento.
+- Alterar entidades centrais sem documentação.
+
+Toda implementação deve seguir:
+
+Auditoria → Planejamento → Aprovação → Implementação → Validação.
+
+Arquitetura oficial:
+
+Pessoa → Vínculo → Workspace
+
+Workspaces:
+- Clínica
+- Consultório
+- Laboratório
+- Sala

ScoreOdonto_Skills_Enterprise/FASE_01_ARQUITETURA/SKILL_ModelagemMestra.md

@@ -0,0 +1,69 @@
+# SKILL — Modelagem Mestra
+
+> **Skill raiz.** Todas as demais skills herdam destas regras. Baseado em evidências reais do
+> `backend/server.js` e do schema. Antes de qualquer alteração: **Auditoria → Planejamento → Aprovação → Implementação → Validação.**
+
+## Conceito de negócio
+O ScoreOdonto **não é um sistema de clínica**; é uma **plataforma de pessoas** que atuam dentro de
+workspaces. A clínica é apenas **um tipo de workspace**. A arquitetura oficial é:
+
+```
+Pessoa → Vínculo → Workspace → Serviços → Marketplace → Financeiro
+```
+
+## Objetivo da skill
+Fixar o modelo mental único do sistema, para que nenhum módulo volte ao paradigma legado
+"Clínica → tudo". Toda entidade nova deve se posicionar nessa cadeia.
+
+## Entidades centrais (fonte da verdade)
+| Camada | Tabela real | Papel |
+|---|---|---|
+| Pessoa | `usuarios` | Identidade única (login). Âncora de tudo. |
+| Vínculo | `vinculos` | Liga pessoa↔workspace com papel e RBAC. |
+| Workspace | `clinicas` (`tipo` ∈ pessoal/consultorio/clinica) + `salas` | Contexto operacional. |
+| Capacidades | `usuario_plugins`, `usuario_areas` | Atributos da pessoa (não do workspace). |
+
+## Relacionamentos
+- `usuarios (1) → (N) vinculos (N) → (1) clinicas` — uma pessoa, vários workspaces, papel por workspace.
+- `clinicas.owner_id → usuarios.id` — todo workspace tem dono.
+- Ao registrar, cria-se automaticamente um **workspace pessoal** (`clinicas.tipo='pessoal'`).
+
+## Regras obrigatórias
+1. **A pessoa (`usuarios`) é a âncora.** Capacidades (áreas, plugins, tutor) pertencem à pessoa.
+2. **Clínica/Consultório/Sala/Laboratório são `tipo` de workspace**, nunca entidades de topo.
+3. **Todo dado operacional é escopado por workspace** (`clinica_id`) via `tenantGuard`.
+4. **Nunca duplicar a pessoa** para representá-la em outro workspace — use `vinculos`.
+5. **Migração aditiva**: colunas novas via `ALTER TABLE ... ADD COLUMN IF NOT EXISTS` (padrão atual).
+
+## Casos de uso
+- Dentista atende em 3 clínicas → 1 `usuarios` + 3 `vinculos`.
+- Profissional autônomo sem clínica → `usuarios` + workspace `tipo='pessoal'`.
+- Locador de sala → `usuarios` + `salas` (workspace `tipo='sala'`).
+
+## Anti-padrões (PROIBIDO)
+- ❌ Criar tabela-entidade nova "espelhando" a pessoa por workspace (vide débito de `dentistas`).
+- ❌ Tratar `clinica` como raiz hierárquica do sistema.
+- ❌ Guardar identidade/capacidade no workspace em vez de na pessoa.
+- ❌ Escrever dado operacional sem `clinica_id`.
+
+## Impactos em outros módulos
+Esta skill governa **todas**: Pessoa, Workspace, Vínculos, Multiempresa, RBAC e todos os módulos
+de negócio. Qualquer conflito com ela é defeito de modelagem (gravidade ALTA).
+
+## Débitos conhecidos (legado clínica-cêntrico ainda vivo)
+- `pacientes` (sem `usuario_id`, preso à clínica) e `dentistas` (tabela paralela a `usuarios`).
+- Workspace dividido em 2 tabelas (`clinicas` + `salas`).
+> Ver `../FASE_08_AUDITORIA/SKILL_Entidades.md`.
+
+```mermaid
+flowchart TD
+  P[Pessoa · usuarios] --> V[Vínculo · vinculos]
+  V --> W{Workspace}
+  W -->|tipo=clinica| C[Clínica]
+  W -->|tipo=consultorio| K[Consultório]
+  W -->|tipo=sala| S[Sala]
+  W -->|tipo=pessoal| PP[Workspace Pessoal]
+  P --> CAP[Capacidades · areas/plugins]
+  W --> OP[Operação · pacientes/agenda/financeiro]
+```
+</content>

ScoreOdonto_Skills_Enterprise/FASE_01_ARQUITETURA/SKILL_Multiempresa.md

@@ -0,0 +1,48 @@
+# SKILL — Multiempresa (Tenancy)
+
+> Herda de `SKILL_ModelagemMestra.md`. Regra de isolamento de dados entre workspaces.
+
+## Conceito de negócio
+Cada workspace é um inquilino (tenant). Dados de uma clínica **nunca** podem vazar para outra.
+A mesma pessoa pode transitar entre tenants via vínculos, mas os **dados ficam no tenant**.
+
+## Objetivo
+Garantir isolamento por `clinica_id` em 100% da operação e impedir queries sem escopo.
+
+## Entidades envolvidas
+- Toda tabela operacional tem `clinica_id` (`pacientes`, `agendamentos`, `financeiro`,
+  `procedimentos_realizados`, `orcamentos`, `contratos`, `repasses`, `glosas`, `protese_os`…).
+- `audit_log` por `clinica_id`.
+
+## Relacionamentos / mecanismo real
+- **`tenantGuard`** (middleware) injeta `req.clinicaId` e é exigido na maioria das 277 rotas.
+- **`authGuard`** é o plano de identidade (rotas `me/*`) — sem tenant.
+- O cliente envia o workspace ativo; o backend valida o vínculo antes de servir dados.
+
+## Regras obrigatórias
+1. **Toda query operacional filtra `clinica_id = $req.clinicaId`.** Sem exceção.
+2. Rota que toca dado de clínica usa `tenantGuard`; rota de identidade usa `authGuard`.
+3. `superadmin` é o único plano transversal (gestão global) — auditar com cuidado.
+4. Marketplace cross-tenant (salas/propostas) é **acoplamento intencional** e explícito.
+
+## Casos de uso
+- Listar pacientes → sempre do `clinica_id` ativo.
+- Trocar workspace → recomputar tudo no novo `clinica_id`.
+
+## Anti-padrões
+- ❌ `SELECT ... FROM pacientes` sem `clinica_id`.
+- ❌ Confiar em `clinica_id` vindo do corpo do request sem validar o vínculo.
+- ❌ Agregar entre clínicas fora dos fluxos de marketplace/superadmin.
+
+## Impactos
+Base de segurança de TODOS os módulos. Falha aqui = vazamento de dados (gravidade ALTA) + risco LGPD.
+
+```mermaid
+flowchart TD
+  REQ[Request] --> AG{Guard}
+  AG -->|authGuard| ID[Identidade · me/*]
+  AG -->|tenantGuard| TEN[req.clinicaId]
+  TEN --> Q[Query SEMPRE com clinica_id]
+  Q --> DB[(Postgres)]
+```
+</content>

ScoreOdonto_Skills_Enterprise/FASE_01_ARQUITETURA/SKILL_Pessoa.md

@@ -0,0 +1,48 @@
+# SKILL — Pessoa
+
+> Herda de `SKILL_ModelagemMestra.md`. A Pessoa é a **âncora única** do sistema.
+
+## Conceito de negócio
+Toda interação no ScoreOdonto parte de uma **pessoa** (humano com login). Papéis (dentista,
+biomédico, protético, paciente, tutor, dono) são **facetas** da mesma pessoa, não entidades separadas.
+
+## Objetivo
+Garantir que identidade, capacidades e histórico fiquem na pessoa — nunca duplicados por workspace.
+
+## Entidades envolvidas
+- `usuarios` — identidade (login, `role` global, `is_tutor`).
+- `usuario_areas` — áreas de atuação (multi-área; ref. `areas`).
+- `usuario_plugins` — capacidades/add-ons por pessoa (`me/plugins`).
+- `vinculos` — onde a pessoa atua e com qual papel.
+
+## Relacionamentos
+- `usuarios (1) → (N) vinculos` — pessoa em vários workspaces.
+- `usuarios (1) → (N) usuario_areas` e `(N) usuario_plugins`.
+- Marketplace de profissionais: `propostas_profissional.profissional_id → usuarios.id`.
+
+## Regras obrigatórias
+1. **Uma pessoa = um `usuarios`** (idealmente deduplicado por CPF/e-mail).
+2. **Capacidades vivem na pessoa**, não no workspace.
+3. `role` global em `usuarios` só para `superadmin`; os demais papéis vêm de `vinculos.role`.
+4. Toda rota de identidade usa `authGuard` (não `tenantGuard`).
+
+## Casos de uso
+- Pessoa é dentista numa clínica e dono de sala em outra → 2 vínculos, papéis distintos.
+- Pessoa ativa o plugin de Salas → grava em `usuario_plugins` (vale em qualquer dispositivo).
+
+## Anti-padrões
+- ❌ Criar `dentistas`/`proteticos` como tabela de identidade paralela (débito atual de `dentistas`).
+- ❌ Persistir capacidade só no `localStorage` sem refletir em `usuario_plugins` (risco de divergência).
+
+## Impactos em outros módulos
+Base de Vínculos, RBAC, Marketplace, Tutoria, Pessoas (Fase 3). Mudou a pessoa → reflete em todos.
+
+```mermaid
+flowchart LR
+  U[usuarios] --> A[usuario_areas]
+  U --> PL[usuario_plugins]
+  U --> V[vinculos]
+  U --> PR[propostas_profissional]
+  V --> WS[Workspaces]
+```
+</content>

ScoreOdonto_Skills_Enterprise/FASE_01_ARQUITETURA/SKILL_RBAC.md

@@ -0,0 +1,47 @@
+# SKILL — RBAC (Controle de Acesso)
+
+> Herda de `SKILL_Vinculos.md`. Define quem vê e faz o quê, por papel e função, no workspace ativo.
+
+## Conceito de negócio
+Acesso é decidido pelo **papel da pessoa no workspace ativo** + permissões finas da `funcao`.
+O frontend espelha o backend: menu e telas seguem a mesma matriz de papéis.
+
+## Objetivo
+Padronizar a decisão de acesso e manter front/back coerentes (sem permissão hardcoded).
+
+## Entidades / mecanismo real
+- **Backend:** `tenantGuard`/`authGuard`; `vinculos.role` + `funcoes` (permissões); `usuarios.role` só p/ `superadmin`.
+- **Frontend:** `App.tsx → isViewAllowed(view, role)` e o filtro de menu em `components/Sidebar.tsx`.
+- Papéis: `superadmin` (global), `admin`/`donoclinica`/`donoconsultorio` (amplo), `funcionario`,
+  `dentista`, `biomedico`, `protetico`, `paciente`, `donosala`.
+
+## Regras obrigatórias
+1. **Decisão por papel/função**, nunca por identidade individual.
+2. Quando a `funcao` define permissões explícitas (`permissoes[]`), elas **prevalecem** sobre o default do papel.
+3. Telas `superadmin*` e o catálogo de `plugins` são **exclusivos do superadmin**.
+4. Workspace `tipo='sala'` restringe o menu a painel da sala/conta/notificações.
+5. **Mudou regra de acesso no backend → atualizar `isViewAllowed` e `Sidebar` no mesmo PR.**
+
+## Casos de uso
+- Biomédico não vê Ortodontia/RX (não-odonto) — regra explícita no menu.
+- Cargo customizado com `permissoes:['agenda','financeiro']` → menu reduzido a isso.
+
+## Anti-padrões
+- ❌ Liberar tela no front sem proteger a rota no back (e vice-versa).
+- ❌ Checar `if (email === 'x')`.
+- ❌ Esquecer de espelhar a permissão nos dois lados (front/back divergentes).
+
+## Impactos
+Governa todo o menu, todas as rotas e a experiência por papel. Ver `../FASE_08_AUDITORIA/SKILL_Rotas.md`.
+
+```mermaid
+flowchart TD
+  P[Pessoa] --> V[vinculo.role no workspace ativo]
+  V --> F{tem funcao com permissoes?}
+  F -->|sim| PERM[usa permissoes da funcao]
+  F -->|não| DEF[usa default do papel]
+  PERM --> UI[Sidebar + isViewAllowed]
+  DEF --> UI
+  UI --> API[rota protegida por guard]
+```
+</content>

ScoreOdonto_Skills_Enterprise/FASE_01_ARQUITETURA/SKILL_Vinculos.md

@@ -0,0 +1,46 @@
+# SKILL — Vínculos
+
+> Herda de `SKILL_ModelagemMestra.md`. O vínculo é a **ponte** pessoa↔workspace e o lugar do papel.
+
+## Conceito de negócio
+Uma pessoa não "é" dentista no sistema — ela **tem um vínculo de papel dentista** num workspace.
+Mudou de workspace, muda o papel. É o que permite multi-clínica sem duplicar a pessoa.
+
+## Objetivo
+Centralizar papel + RBAC na relação, nunca na identidade nem no workspace.
+
+## Entidades envolvidas
+- `vinculos(id, usuario_id, clinica_id, role, setor_id, funcao_id)`.
+- `funcoes` (cargos com permissões) e `setores` — por workspace.
+- Constraint real de papéis (`vinculos_role_check`):
+  `paciente, dentista, biomedico, protetico, funcionario, donoclinica, donoconsultorio, donosala, admin`.
+
+## Relacionamentos
+- `vinculos.usuario_id → usuarios.id`; `vinculos.clinica_id → clinicas.id`.
+- `vinculos.funcao_id → funcoes.id` (permissões finas); `vinculos.setor_id → setores.id`.
+
+## Regras obrigatórias
+1. **Papel operacional vem do vínculo** (`vinculos.role`), não de `usuarios` (exceto `superadmin`).
+2. **N vínculos por pessoa** — multi-workspace é nativo. Nunca duplicar a pessoa.
+3. A permissão efetiva = papel do vínculo **+** permissões da `funcao` (quando houver).
+4. Remover acesso = remover/alterar o vínculo, jamais apagar a pessoa.
+
+## Casos de uso
+- Convidar membro: cria `vinculos` com `role` + `funcao_id`.
+- Profissional sai da clínica: deleta o vínculo; histórico e identidade permanecem.
+
+## Anti-padrões
+- ❌ Guardar papel em tabela-recurso (débito de `dentistas`).
+- ❌ Permissão hardcoded por e-mail/nome em vez de papel/função.
+
+## Impactos
+Base direta de RBAC, Multiempresa, Gestão de Equipe e do menu/`isViewAllowed` do frontend.
+
+```mermaid
+flowchart LR
+  U[usuarios] --> VN[vinculos: role, setor, funcao]
+  VN --> CL[clinicas/workspace]
+  VN --> FU[funcoes: permissões]
+  VN --> SE[setores]
+```
+</content>

ScoreOdonto_Skills_Enterprise/FASE_01_ARQUITETURA/SKILL_Workspace.md

@@ -0,0 +1,50 @@
+# SKILL — Workspace
+
+> Herda de `SKILL_ModelagemMestra.md`. Workspace é o **contexto operacional** onde a pessoa atua.
+
+## Conceito de negócio
+Todo dado operacional (pacientes, agenda, financeiro) pertence a um **workspace**, nunca diretamente
+à pessoa. A clínica é o workspace mais comum, mas é só um `tipo`.
+
+## Objetivo
+Padronizar o conceito de workspace e impedir o retorno ao modelo clínica-cêntrico.
+
+## Entidades envolvidas
+- `clinicas` — tabela de workspace. Colunas-chave: `tipo` (`pessoal`|`consultorio`|`clinica`),
+  `owner_id`, `cor`, `geo` (PostGIS). **Hoje "clinicas" É a tabela de workspaces.**
+- `salas` — workspace `tipo='sala'` (tabela separada — débito de unificação).
+- `vinculos` — quem pertence ao workspace e com qual papel.
+
+## Relacionamentos
+- `clinicas.owner_id → usuarios.id`.
+- Operação: `pacientes.clinica_id`, `agendamentos.clinica_id`, `financeiro.clinica_id`, etc.
+- Agregação no app: `GET /api/me/workspaces` → `listarWorkspaces()` reúne clínicas (via vínculo) + salas.
+
+## Regras obrigatórias
+1. **Tudo que é operacional carrega `clinica_id`** e passa por `tenantGuard`.
+2. O **workspace ativo** (cacheado no cliente) governa menu, permissões e dados visíveis.
+3. `tipo='sala'` **isola o contexto** (menu reduzido: painel da sala/conta/notificações).
+4. Workspace pessoal (`tipo='pessoal'`) é criado automaticamente no registro.
+
+## Casos de uso
+- Trocar de workspace no seletor → recarrega contexto (cor de marca, menu, dados).
+- Sala como workspace → usuário cai em `sala-home`, sem acesso à operação clínica.
+
+## Anti-padrões
+- ❌ Ler/gravar operação sem `clinica_id`.
+- ❌ Tratar `salas` e `clinicas` como conceitos distintos na lógica de negócio (são ambos workspace).
+- ❌ Vazar dados entre workspaces (sempre filtrar por `req.clinicaId`).
+
+## Impactos
+Governa Multiempresa, RBAC e todos os módulos de Workspace (Fase 2) e operação.
+
+```mermaid
+flowchart TD
+  WS[Workspace] -->|clinicas.tipo| T1[clinica]
+  WS --> T2[consultorio]
+  WS --> T3[pessoal]
+  WS -->|salas| T4[sala]
+  WS --> OP[pacientes / agenda / financeiro · clinica_id]
+  WS --> VN[vinculos · membros + papéis]
+```
+</content>

ScoreOdonto_Skills_Enterprise/FASE_02_NEGOCIO/SKILL_Clinicas.md

@@ -0,0 +1,42 @@
+# SKILL — Clínicas (Workspace)
+
+> Herda de `SKILL_Workspace.md`. Tipo de workspace mais completo do sistema.
+
+## O que é?
+Workspace `clinicas.tipo='clinica'` — a empresa odontológica com equipe, pacientes e operação plena.
+
+## Quem usa?
+Donos (`donoclinica`/`admin`), funcionários, dentistas, biomédicos, protéticos vinculados.
+
+## Quais módulos possui?
+Dashboard, Agenda, Pacientes, Ortodontia, Próteses/GTO, Financeiro, Comissões, Repasses, Glosas,
+Orçamentos, Contratos, Relatórios, Leads, Equipe/RBAC, Planos/Procedimentos/Especialidades,
+RX (plugin), Configurações. (Menu completo — ver `../FASE_08_AUDITORIA/SKILL_Rotas.md`.)
+
+## Quais receitas gera?
+Produção de procedimentos (RECEITA), contratos/cobrança, recuperação de glosas. Paga repasses (DESPESA).
+> Detalhe do dinheiro em `../FASE_04_FINANCEIRO/`.
+
+## Quais permissões possui?
+Donos/admin: acesso amplo (menos telas `superadmin`). Demais papéis: subconjunto por papel/função (RBAC).
+
+## Entidades envolvidas
+`clinicas` + toda a operação por `clinica_id` + `vinculos`/`funcoes`/`setores`.
+
+## Regras obrigatórias
+1. Operação sempre escopada por `clinica_id` (`tenantGuard`).
+2. A clínica é **um tipo de workspace**, não a raiz do sistema.
+3. Equipe entra por vínculo; permissões por papel/função.
+
+## Anti-padrões
+- ❌ Assumir "uma clínica por usuário" (a pessoa pode ter várias).
+- ❌ Tratar clínica como dona da pessoa.
+
+```mermaid
+flowchart LR
+  CL[Clínica] --> EQ[Equipe via vinculos]
+  CL --> PAC[Pacientes]
+  CL --> AG[Agenda]
+  CL --> FIN[Financeiro → Comissão → Repasse]
+```
+</content>

ScoreOdonto_Skills_Enterprise/FASE_02_NEGOCIO/SKILL_Consultorios.md

@@ -0,0 +1,37 @@
+# SKILL — Consultórios (Workspace)
+
+> Herda de `SKILL_Workspace.md`. Variante enxuta da clínica.
+
+## O que é?
+Workspace `clinicas.tipo='consultorio'` — operação individual/pequena de um profissional-dono.
+Mesma tabela e mecânica da clínica; muda o `tipo` e o papel do dono (`donoconsultorio`).
+
+## Quem usa?
+`donoconsultorio` (profissional que opera por conta própria) e eventuais membros.
+
+## Quais módulos possui?
+Os mesmos da clínica (herda a operação), normalmente com equipe menor. O `tipo` distingue rótulo/UX,
+não um conjunto de tabelas separado.
+
+## Quais receitas gera?
+Iguais às da clínica (produção, contratos), em escala individual.
+
+## Quais permissões possui?
+`donoconsultorio` tem acesso amplo (não-`superadmin`), idêntico ao dono de clínica.
+
+## Regras obrigatórias
+1. **Consultório = `tipo` de workspace**, não um módulo nem uma entidade separada.
+2. `donoconsultorio` é o **papel do dono**; o `tipo='consultorio'` é o **workspace**.
+3. Não criar tabelas próprias de "consultório" — reutilizar a operação por `clinica_id`.
+
+## Anti-padrões / Débito conhecido
+- ⚠️ Acoplamento **role↔tipo** (`donoconsultorio`⇄`tipo='consultorio'`): decisão duplicada.
+  Ao ramificar lógica, prefira o `tipo` do workspace, não a role.
+- ❌ Duplicar telas/tabelas só para "consultório".
+
+```mermaid
+flowchart LR
+  K[Consultório · tipo=consultorio] --> OWN[Dono · donoconsultorio]
+  K --> OP[Operação reutilizada por clinica_id]
+```
+</content>

ScoreOdonto_Skills_Enterprise/FASE_02_NEGOCIO/SKILL_Delivery.md

@@ -0,0 +1,43 @@
+# SKILL — Delivery (Profissionais temporários) — ALVO / ROADMAP
+
+> Herda de `SKILL_Marketplace.md`. **ATENÇÃO: não existe no código hoje.** Esta skill descreve o conceito-alvo
+> e as **sementes reais** sobre as quais ele se apoiaria — sem inventar funcionalidade.
+
+## O que NÃO existe hoje (estado real)
+Não há nenhuma implementação de "delivery"/plantão/diária de profissional: sem contratação temporária,
+sem vínculo por período, sem pagamento de profissional avulso. Buscas por `delivery/temporario/plantao/
+freela/substituto` no `server.js` **não retornam feature** — apenas os fragmentos abaixo.
+
+## Sementes reais já existentes (base para o alvo)
+1. **Marketplace de Profissionais**: `profissionais-disponiveis`, `profissionais/marketplace`, `propostas`
+   (clínica→profissional). Hoje só **mensagem/conexão**, status `pendente`.
+2. **Modelos de período** (vindos das Salas): `RESERVA_MODELOS = ['hora','turno','diaria','semanal','mensal']`
+   e `valor_diaria`/`diaria_consulta` — o conceito de **diária** já está modelado para salas.
+3. **Vínculos temporários**: `vinculos` já suporta papel por workspace — a base para um vínculo com prazo.
+
+## Conceito-alvo (Delivery)
+Profissional aceita uma **escala temporária** numa clínica (ex.: diária/turno), com início/fim, valor e
+pagamento — unindo a proposta de profissional ao modelo de período e a um vínculo com prazo.
+
+## O que faltaria (lacunas — descrever, NÃO implementar)
+- Evoluir `propostas_profissional` de mensagem → **acordo com período + valor + aceite**.
+- Vínculo temporário (`vinculos` com janela de validade) e seu encerramento automático.
+- Captura de pagamento (mesma lacuna de Salas) e repasse ao profissional avulso.
+
+## Regras obrigatórias (se um dia evoluir)
+1. Construir **sobre as sementes** (propostas + modelos de período + vínculos), sem entidade paralela nova.
+2. Manter Pessoa→Vínculo→Workspace: delivery é **vínculo temporário**, não nova classe de pessoa.
+3. Seguir Auditoria → Planejamento → **Aprovação** antes de qualquer implementação.
+
+## Anti-padrões
+- ❌ Documentar/assumir Delivery como se existisse.
+- ❌ Criar tabela/role nova "delivery" em vez de reusar `vinculos` + `propostas`.
+
+```mermaid
+flowchart LR
+  PROF[Profissional · perfil] --> PROP[Proposta hoje: mensagem]
+  PROP -. alvo .-> ACORDO[Acordo: período + valor + aceite]
+  ACORDO -. alvo .-> VT[vinculo temporário]
+  VT -. alvo .-> PAY[(pagamento + repasse)]
+```
+</content>

ScoreOdonto_Skills_Enterprise/FASE_02_NEGOCIO/SKILL_Laboratorios.md

@@ -0,0 +1,46 @@
+# SKILL — Laboratórios (Workspace-alvo)
+
+> Herda de `SKILL_Workspace.md`. **Atenção:** o estado ATUAL difere da arquitetura-alvo.
+
+## O que é? (estado real hoje)
+Hoje o laboratório é um **cadastro interno por clínica** (`protese_laboratorios`), usado nas Ordens de
+Serviço de prótese e no **custo lab** que abate comissão. **Não** tem identidade própria nem login,
+**não** cruza clínicas. (Modelo "A — cadastro auxiliar".)
+
+## Arquitetura-alvo (declarada no LEIA-PRIMEIRO)
+O laboratório é listado como **tipo de workspace** (Clínica/Consultório/Laboratório/Sala). Ou seja,
+a visão oficial é elevá-lo a **participante/operador do ecossistema**, não apenas lookup.
+
+## Quem usa?
+Protéticos/laboratórios e as clínicas que enviam OS. (O protético-pessoa é tratado em
+`../FASE_03_PESSOAS/SKILL_Proteticos.md` — não confundir pessoa com laboratório.)
+
+## Quais módulos possui? (hoje)
+Cadastro de laboratório + produtos (`protese_produtos`) + OS (`protese_os`, `protese_os_evento`,
+`protese_os_foto`). Integra com Comissões via custo lab.
+
+## Quais receitas gera?
+Indireta hoje (operacional: custo lab compõe a margem). Como workspace, poderia faturar produção própria.
+
+## Quais permissões possui?
+Hoje: dentro do RBAC da clínica que cadastra. Como workspace: teria papéis/vínculos próprios.
+
+## Regras obrigatórias
+1. **Não confundir** laboratório (fornecedor/operador) com protético (pessoa).
+2. Enquanto for cadastro, manter `clinica_id` e custo lab consistentes com Comissões.
+3. Qualquer evolução para workspace é decisão arquitetural → seguir Auditoria→Aprovação (não implementar aqui).
+
+## Anti-padrões
+- ❌ Tratar o laboratório como pessoa (login) sendo cadastro, ou vice-versa.
+- ❌ Recadastrar o mesmo laboratório em cada clínica como se fossem distintos (limitação atual a registrar).
+
+```mermaid
+flowchart LR
+  subgraph Hoje
+    LAB[protese_laboratorios · cadastro por clínica] --> OS[protese_os] --> COM[custo lab → Comissão]
+  end
+  subgraph Alvo
+    LABW[Laboratório · workspace] --> OPR[Opera no ecossistema]
+  end
+```
+</content>

ScoreOdonto_Skills_Enterprise/FASE_02_NEGOCIO/SKILL_Marketplace.md

@@ -0,0 +1,44 @@
+# SKILL — Marketplace
+
+> Herda de `../FASE_01_ARQUITETURA/SKILL_Workspace.md` e `SKILL_Pessoa.md`. O marketplace só existe
+> porque a base é **Pessoa → Vínculo → Workspace** (atores cruzam fronteiras de clínica).
+
+## Conceito
+O marketplace conecta **pessoas/workspaces** entre si, cross-tenant. São **três frentes** reais hoje,
+em maturidades diferentes:
+
+| Frente | O que existe | Receita |
+|---|---|---|
+| **Salas (locação)** | CRUD + `salas/marketplace` + reservas (`sala_reservas`), modelos `hora/turno/diaria/semanal/mensal` com `valor_*` | `valor` registrado, **sem gateway** |
+| **Profissionais** | `profissionais/perfil`, `profissionais/marketplace`, `profissionais-disponiveis`, `propostas` (clínica→profissional) | **Só mensagem**, sem cobrança |
+| **Tutoria orto** | candidatura paga (MercadoPago) + solicitações | ✅ **única automatizada** (`comissao_pct`) |
+
+## Entidades / rotas reais
+- Salas: `salas`, `sala_reservas` · `GET/POST/PUT /api/salas*`, `/api/sala-reservas*`.
+- Profissionais: `propostas_profissional` (`status='pendente'`, dup-check por clínica+profissional) ·
+  `/api/profissionais/*`, `/api/propostas*`. Perfil = `usuarios` (nível pessoa, `authGuard`).
+- Tutoria: ver `../FASE_03_PESSOAS/SKILL_Tutores.md`.
+
+## Permissões
+- Salas: plugin `locacao-salas` (sempre ON), todos menos `superadmin`.
+- Profissionais: plugin `profissionais-marketplace`, clínicos exceto `paciente`.
+- O catálogo de plugins é exclusivo do `superadmin`.
+
+## Regras obrigatórias
+1. Marketplace é **cross-tenant intencional** — mas cada lado continua isolado por `clinica_id`/workspace.
+2. **Sinalizar lacunas de pagamento** (salas/profissionais), nunca presumir transação concluída.
+3. Proposta de profissional hoje é **conexão (mensagem)**, não contratação — não inventar fluxo inexistente.
+
+## Anti-padrões
+- ❌ Acoplar marketplace à clínica (Modelo A) — ele depende da pessoa/workspace (Modelo B).
+- ❌ Tratar reserva/proposta como paga.
+
+```mermaid
+flowchart LR
+  P[Pessoa/Workspace] --> S[Salas: reserva valor/modelo]
+  P --> PR[Profissionais: perfil + proposta]
+  P --> T[Tutoria: MercadoPago]
+  S -. falta .-> PAY[(gateway)]
+  PR -. falta .-> CONTR[(contratação/cobrança)]
+```
+</content>

ScoreOdonto_Skills_Enterprise/FASE_02_NEGOCIO/SKILL_Salas.md

@@ -0,0 +1,43 @@
+# SKILL — Salas (Workspace + Marketplace)
+
+> Herda de `SKILL_Workspace.md`. Único workspace que já nasce no modelo novo + marketplace.
+
+## O que é?
+Workspace `tipo='sala'` (tabela `salas`) que pode ser **locado** a terceiros. Plugin `locacao-salas`
+é **sempre ativo** (capability de plataforma).
+
+## Quem usa?
+- **Locador** (`donosala` ou qualquer conta): cadastra e administra salas ("Minhas Salas").
+- **Locatário** (qualquer profissional): busca e reserva ("Alugar Salas").
+
+## Quais módulos possui?
+Painel da sala (`sala-home`), marketplace de salas, reservas (`sala_reservas`), geolocalização (PostGIS `geo`).
+
+## Quais receitas gera?
+**Potencial.** `sala_reservas` já tem `valor`, `modelo` e workflow de status (`pendente`→`aceita`),
+mas **não há captura de pagamento** (gateway) — o fluxo financeiro **não fecha** hoje.
+> É a alavanca de receita mais próxima de destravar. Ver `../FASE_04_FINANCEIRO/SKILL_Faturamento.md`.
+
+## Quais permissões possui?
+Workspace `tipo='sala'` **isola** o contexto: menu só painel da sala/conta/notificações.
+Os itens "Minhas Salas"/"Alugar Salas" são de plugin (todos menos `superadmin`).
+
+## Entidades envolvidas
+`salas`, `sala_reservas` (cross-tenant: locação entre workspaces distintos).
+
+## Regras obrigatórias
+1. Reserva é **cross-tenant intencional** — validar disponibilidade (anti-overbooking de sala).
+2. Contexto de sala isola da clínica (não misturar operação clínica no workspace de sala).
+3. `valor` da reserva é registrado; **pagamento real é externo** (lacuna a sinalizar, não assumir).
+
+## Anti-padrões
+- ❌ Assumir que a reserva foi paga (não há gateway).
+- ❌ Vazar dados da clínica para o contexto de sala.
+
+```mermaid
+flowchart LR
+  SAL[Sala · workspace] --> MKT[Marketplace de salas]
+  MKT --> RES[sala_reservas: valor, status]
+  RES -. falta .-> PAY[(Pagamento/gateway)]
+```
+</content>

ScoreOdonto_Skills_Enterprise/FASE_03_PESSOAS/SKILL_Biomedicos.md

@@ -0,0 +1,39 @@
+# SKILL — Biomédicos (Pessoa)
+
+> Herda de `../FASE_01_ARQUITETURA/SKILL_Pessoa.md`. Profissional de **biomedicina estética**, não-odonto.
+
+## Perfil
+Pessoa (`usuarios`) com vínculo `biomedico`. Tem **catálogo próprio** (especialidades/procedimentos de
+biomedicina) — semeável via `POST /api/me/seed-biomedicina`. Multi-área pelo perfil (`usuario_areas`/`areas`).
+
+## Fluxos
+- Agenda própria + Tratamentos + lançamento de procedimentos do seu catálogo.
+- **Sem** itens odontológicos (Ortodontia, RX, tutoria orto) — separação explícita no menu.
+
+## Permissões (RBAC)
+Menu: `dashboard, agenda, tratamentos, especialidades, procedimentos, clinicas, notificacoes,
+configuracoes, diretorio-profissionais`. Não vê Ortodontia/RX/tutoria.
+
+## Marketplace
+Publica perfil no diretório de Profissionais; recebe propostas; pode locar/alugar salas.
+
+## Financeiro
+Produção gera RECEITA/Comissão no workspace onde atua (mesma mecânica de `comissao_regras`/Repasse).
+
+## Regras obrigatórias
+1. Catálogo de biomedicina é **da área**, não misturar com catálogo odonto.
+2. Identidade/áreas na pessoa; papel no vínculo.
+3. Não expor telas odonto ao papel `biomedico` (regra de menu já existente).
+
+## Anti-padrões
+- ❌ Vazar Ortodontia/RX para o menu do biomédico.
+- ❌ Duplicar a pessoa por local de atuação.
+
+```mermaid
+flowchart LR
+  B[Biomédico · usuarios] --> V[vinculo role=biomedico]
+  B --> AR[usuario_areas: biomedicina]
+  V --> AG[Agenda] --> PR[Procedimento área] --> COM[Comissão→Repasse]
+  B --> MKT[Diretório/Propostas]
+```
+</content>

ScoreOdonto_Skills_Enterprise/FASE_03_PESSOAS/SKILL_Dentistas.md

@@ -0,0 +1,45 @@
+# SKILL — Dentistas (Pessoa)
+
+> Herda de `../FASE_01_ARQUITETURA/SKILL_Pessoa.md` e `SKILL_Vinculos.md`.
+
+## Perfil
+Pessoa (`usuarios`) com vínculo de papel `dentista` num workspace. É o clínico odontológico completo.
+**Débito conhecido:** existe também a tabela `dentistas` (recurso de agenda por clínica, com `usuario_id`
+opcional) — a MESMA pessoa pode aparecer como `usuarios` + `dentistas`. Tratar `dentistas` como
+**projeção de agenda**, não como identidade. Ver `../FASE_08_AUDITORIA/SKILL_Entidades.md`.
+
+## Fluxos
+- Atende na Agenda → registra Procedimento Realizado → gera RECEITA/Comissão.
+- Ortodontia completa (triagem, plano, evoluções, fotos, contenção).
+- Pode pedir tutoria de orto e/ou ser tutor (ver `SKILL_Tutores.md`).
+
+## Permissões (RBAC)
+Menu odonto: `dashboard, agenda, ortodontia, proteses, tratamentos, clinicas, configuracoes,
+candidatura-tutor, diretorio-profissionais` (+ RX e tutoria-painel conforme plugin/aprovação).
+**NÃO** vê telas administrativas globais nem `superadmin`.
+
+## Marketplace
+- Publica perfil no diretório de Profissionais (`profissionais/perfil`, nível pessoa via `authGuard`).
+- Recebe propostas de clínicas (`propostas_profissional`).
+- Pode locar/alugar salas (plugin `locacao-salas`).
+
+## Financeiro
+Gera comissão sobre procedimentos realizados (regra `comissao_regras`); recebe via Repasse.
+Ver `../FASE_04_FINANCEIRO/SKILL_Comissoes.md` e `SKILL_Repasses.md`.
+
+## Regras obrigatórias
+1. Identidade e capacidades na pessoa; papel no vínculo (multi-clínica nativo).
+2. Não duplicar a pessoa para representá-la em outra clínica — novo `vinculo`.
+3. `dentistas` é recurso de agenda, não fonte de identidade.
+
+## Anti-padrões
+- ❌ Hardcodar permissão por e-mail. ❌ Criar identidade do dentista fora de `usuarios`.
+
+```mermaid
+flowchart LR
+  D[Dentista · usuarios] --> V[vinculo role=dentista]
+  V --> AG[Agenda] --> PR[Procedimento] --> COM[Comissão→Repasse]
+  D --> MKT[Diretório/Propostas] 
+  D --> TUT[Tutoria orto]
+```
+</content>

ScoreOdonto_Skills_Enterprise/FASE_03_PESSOAS/SKILL_Pacientes.md

@@ -0,0 +1,41 @@
+# SKILL — Pacientes (Pessoa — com débito de modelagem)
+
+> Herda de `../FASE_01_ARQUITETURA/SKILL_Pessoa.md`. **Atenção:** estado atual contraria a arquitetura-alvo.
+
+## Perfil (estado real hoje)
+O paciente é registrado em `pacientes` com `clinica_id` e **sem `usuario_id`** — ou seja, **pertence à
+clínica**, não ao ecossistema. O mesmo CPF em 2 clínicas vira **2 registros** (sem prontuário único).
+Há resíduo legado: existem INSERTs com e sem `clinica_id`. Ver `../FASE_08_AUDITORIA/SKILL_Entidades.md`.
+
+## Fluxos
+- Origem: cadastro direto **ou** conversão de Lead (`leads/:id/converter` cria paciente + agendamento).
+- Agenda, Orçamento, Procedimentos, Ortodontia, RX, Receita/Exame, Score, Faltas, Família.
+
+## Permissões (RBAC)
+- Operadores (funcionário/donos) gerenciam pacientes da clínica ativa.
+- O **paciente-usuário** (papel `paciente`, quando existe login) vê só: `tratamentos, notificacoes, configuracoes`.
+
+## Privacidade / LGPD
+O modelo atual (paciente preso à clínica) **favorece isolamento** — cada clínica é controladora dos
+seus dados. Compartilhar histórico entre clínicas exigiria base legal/consentimento. **Não** presumir
+"paciente do ecossistema" sem decisão arquitetural + jurídica.
+
+## Marketplace / Financeiro
+Não participa de marketplace. É **origem de RECEITA** (procedimentos, contratos), nunca recebe repasse.
+
+## Regras obrigatórias
+1. Paciente sempre escopado por `clinica_id` (tenancy).
+2. **Não** unificar pacientes entre clínicas sem aprovação (impacto LGPD direto).
+3. Conversão de lead é anti-overbooking — preservar a checagem.
+
+## Anti-padrões / Débito
+- ⚠️ Falta de identidade de pessoa no paciente é o maior atrito com o modelo Pessoa→Workspace (gravidade ALTA).
+- ❌ Deduplicar/“mesclar” pacientes entre clínicas sem base legal.
+
+```mermaid
+flowchart LR
+  L[Lead] -->|converter| PAC[Paciente · clinica_id]
+  PAC --> AG[Agenda] --> PR[Procedimento] --> FIN[RECEITA]
+  PAC --> ORC[Orçamento] --> CON[Contrato]
+```
+</content>

ScoreOdonto_Skills_Enterprise/FASE_03_PESSOAS/SKILL_Proteticos.md

@@ -0,0 +1,42 @@
+# SKILL — Protéticos (Pessoa)
+
+> Herda de `../FASE_01_ARQUITETURA/SKILL_Pessoa.md`. **Não confundir** com o Laboratório (entidade/fornecedor):
+> ver `../FASE_02_NEGOCIO/SKILL_Laboratorios.md`.
+
+## Perfil
+Pessoa (`usuarios`) com vínculo `protetico` — profissional do laboratório. É **profissional do
+ecossistema** (modelo B da auditoria), não um "fornecedor" abstrato. O fornecedor é o **laboratório**.
+
+## Fluxos
+- Agenda própria + Próteses (OS de laboratório: `protese_os`, produtos, materiais, custo lab, entrega).
+- Lança GTO (guia de tratamento) quando aplicável.
+
+## Permissões (RBAC)
+Menu: `dashboard, agenda, proteses, tratamentos, lancar-gto, clinicas, notificacoes, configuracoes,
+diretorio-profissionais`. Sem Ortodontia/RX/pacientes clínicos.
+
+## Marketplace
+Perfil no diretório de Profissionais; propostas; salas (plugin).
+
+## Financeiro
+O **custo lab** das próteses **abate a base de comissão** do procedimento (entra em `computeComissoes`).
+Ver `../FASE_04_FINANCEIRO/SKILL_Comissoes.md`.
+
+## Conflito conceitual a vigiar (gravidade baixa)
+A faceta "fornecedor" pertence ao **laboratório** (cadastro `protese_laboratorios`), não à pessoa.
+Manter pessoa (protético) e laboratório (entidade) **separados e bem ligados**.
+
+## Regras obrigatórias
+1. Protético = pessoa/profissional; Laboratório = entidade/fornecedor. Não fundir.
+2. Custo lab consistente com Comissões.
+
+## Anti-padrões
+- ❌ Tratar o protético como cadastro de fornecedor (ou o laboratório como login).
+
+```mermaid
+flowchart LR
+  PT[Protético · usuarios] --> V[vinculo role=protetico]
+  V --> OS[Próteses/OS] --> CL[custo lab → Comissão]
+  PT -. usa .-> LAB[Laboratório · fornecedor]
+```
+</content>

ScoreOdonto_Skills_Enterprise/FASE_03_PESSOAS/SKILL_Secretarias.md

@@ -0,0 +1,34 @@
+# SKILL — Secretárias / Recepção (Pessoa)
+
+> Herda de `../FASE_01_ARQUITETURA/SKILL_Pessoa.md` e `SKILL_RBAC.md`.
+> **Importante:** no código **não existe role `secretaria`** — a secretária é o papel `funcionario`
+> (eventualmente com `funcao` customizada para refinar permissões).
+
+## Perfil
+Pessoa (`usuarios`) com vínculo `funcionario`. Opera o front-office da clínica (não-clínico).
+
+## Fluxos
+- Leads (captar/converter), Pacientes, Agenda, Financeiro, Orçamentos, Contratos, Relatórios, Glosas.
+
+## Permissões (RBAC)
+Menu padrão do `funcionario`: `dashboard, leads, pacientes, agenda, financeiro, tratamentos,
+lancar-gto, proteses, relatorios, glosas, orcamentos, contratos, clinicas, notificacoes, configuracoes,
+diretorio-profissionais`. Permissões podem ser **estreitadas por `funcao`** (RBAC fino) no workspace.
+
+## Marketplace / Financeiro
+Não participa de marketplace como profissional. Opera o financeiro da clínica, mas **não recebe comissão/repasse**.
+
+## Regras obrigatórias
+1. "Secretária" = papel `funcionario` + `funcao` opcional. Não criar role nova sem decisão arquitetural.
+2. Para restringir acesso, use **`funcao` com `permissoes[]`** (prevalece sobre o default do papel).
+
+## Anti-padrões
+- ❌ Inventar role `secretaria` no código (quebra a constraint `vinculos_role_check`).
+- ❌ Dar a funcionário telas de superadmin/admin global.
+
+```mermaid
+flowchart LR
+  S[Secretária · usuarios] --> V[vinculo role=funcionario + funcao]
+  V --> FO[Leads/Agenda/Pacientes/Financeiro]
+```
+</content>

ScoreOdonto_Skills_Enterprise/FASE_03_PESSOAS/SKILL_Tutores.md

@@ -0,0 +1,42 @@
+# SKILL — Tutores de Ortodontia (Pessoa)
+
+> Herda de `../FASE_01_ARQUITETURA/SKILL_Pessoa.md`. Única faceta com **receita de plataforma automatizada**.
+
+## Perfil
+Pessoa (`usuarios`) com flag `is_tutor=true` após **candidatura paga** (MercadoPago). Não é uma role de
+vínculo — é uma **capacidade da pessoa** (atributo), liberada pelo painel de tutoria.
+
+## Fluxos
+- Candidatura (`tutoria/candidaturas`) → pagamento (`preferences` MercadoPago) → `mp-webhook` ativa o tutor.
+- Tutor resolve solicitações de orto (`ortho_tutoring_request`), troca mensagens/pacotes de fotos.
+- Gestão pelo superadmin (`admin/candidaturas`, `admin/repasses`, `admin/tutor-config`).
+
+## Permissões (RBAC)
+- `candidatura-tutor`: disponível a dentistas.
+- `tutoria-painel`: **só para tutores aprovados** (`is_tutor`).
+- `admin-gestao-tutores`: **só superadmin**.
+
+## Marketplace / Financeiro (modelo de receita)
+- Configuração global em `ortho_tutor_config` (`comissao_pct`, default **20%**, `taxa_inscricao`, chave PIX,
+  credenciais MercadoPago).
+- Cada consultoria registra `valor_consultoria`, `comissao_pct`, `valor_tutor`, `status_repasse`.
+- **A plataforma fica com a comissão (`comissao_pct`)**; o tutor recebe `valor_tutor` (repasse próprio,
+  distinto do repasse de clínica em `../FASE_04_FINANCEIRO/SKILL_Repasses.md`).
+
+## Regras obrigatórias
+1. `is_tutor` é capacidade da pessoa — não criar role de vínculo "tutor".
+2. Pagamento via MercadoPago é idempotente (webhook). Não duplicar ativação.
+3. Repasse de tutoria é fluxo próprio (não confundir com repasse de comissão de clínica).
+
+## Anti-padrões
+- ❌ Ativar tutor sem confirmar pagamento (webhook/`confirmar-pagamento`).
+- ❌ Misturar `comissao_pct` da tutoria com `comissao_regras` da clínica.
+
+```mermaid
+flowchart LR
+  D[Dentista] --> CAND[Candidatura]
+  CAND -->|MercadoPago| WH[mp-webhook] --> T[is_tutor=true]
+  T --> REQ[Solicitações orto]
+  REQ --> $[valor_tutor + comissão plataforma]
+```
+</content>

ScoreOdonto_Skills_Enterprise/FASE_04_FINANCEIRO/SKILL_Assinaturas.md

@@ -0,0 +1,34 @@
+# SKILL — Assinaturas (da plataforma / SaaS)
+
+> Herda de `SKILL_Financeiro.md`. **Receita da PLATAFORMA** (não da clínica). Hoje é manual.
+
+## Conceito
+Assinatura é a relação de **cobrança da plataforma com a pessoa/conta** — a monetização do SaaS.
+**Distinta** de `contrato_assinaturas` (aceite de contratos da clínica). Não confundir.
+
+## Entidades / mecanismo real
+- `assinaturas(id, usuario_id, status, valor, validade, created_at)`.
+- Gestão pelo **superadmin**: `PUT /api/superadmin/assinaturas/:userId` (define status/valor/validade) e
+  `GET|PUT /api/superadmin/pricing` (tabela de preços).
+- **Estado atual: cobrança MANUAL** (superadmin define) — **não há gateway/recorrência automática**.
+
+## Receita
+É a alavanca de **receita recorrente da plataforma** mais direta (base multiempresa + pricing já existem),
+porém ainda não automatizada. Ver auditoria estratégica (`documentação/AUDITORIA-ESTRATEGICA-MODELAGEM.md`).
+
+## Regras obrigatórias
+1. Assinatura é **da pessoa/conta** (`usuario_id`), coerente com Pessoa→Workspace.
+2. Só `superadmin` gerencia (`superadminGuard`).
+3. Não confundir com assinatura de contrato nem com repasse.
+
+## Anti-padrões
+- ❌ Tratar `assinaturas` como assinatura de documento.
+- ❌ Assumir recorrência/gateway que não existe (cobrança é manual hoje).
+
+```mermaid
+flowchart LR
+  SA[superadmin] --> PRC[pricing]
+  SA --> ASS[assinaturas: usuario_id, status, valor, validade]
+  ASS -. falta .-> GW[(gateway/recorrência)]
+```
+</content>

ScoreOdonto_Skills_Enterprise/FASE_04_FINANCEIRO/SKILL_Comissoes.md

@@ -0,0 +1,38 @@
+# SKILL — Comissões
+
+> Herda de `SKILL_Financeiro.md`. Cálculo da remuneração do profissional sobre a produção.
+
+## Conceito
+Comissão = **(base − custo_lab) × percentual**. A base é a produção do profissional no período; o custo
+lab (próteses) é abatido antes do percentual.
+
+## Entidades / mecanismo real
+- `comissao_regras(id, clinica_id, procedimento_id, profissional_id, percentual, custo_lab)`.
+- Função `computeComissoes(pool, clinicaId, {inicio, fim, base, profissionalId})` agrega a produção.
+- Três níveis de regra (precedência): **override por profissional** > **por procedimento** > **padrão da clínica**.
+
+## Regras obrigatórias
+1. Custo lab **sempre abatido** antes do percentual.
+2. Lançamentos com `sem_comissao=true` (garantia/reabertura do mesmo profissional, despesa de repasse) **não entram**.
+3. Base configurável (produção × recebido) — respeitar o parâmetro `base`.
+4. Mudou regra de comissão → auditar impacto em Repasses (não recalcular repasses já fechados).
+
+## Fluxos
+Produção (`procedimentos_realizados` → `financeiro` RECEITA) → `computeComissoes` → **Repasse** (fechar).
+
+## Anti-padrões
+- ❌ Ignorar `custo_lab` no cálculo. ❌ Comissionar lançamento `sem_comissao`.
+- ❌ Alterar percentual e recalcular retroativamente repasses fechados (snapshot é imutável).
+
+## Permissões
+Definição de regras: donos/admin. Ver `../FASE_01_ARQUITETURA/SKILL_RBAC.md`.
+
+```mermaid
+flowchart LR
+  PROD[Produção do período] --> BASE[base]
+  LAB[custo_lab próteses] --> CALC
+  BASE --> CALC[(base − custo_lab) × %]
+  REG[comissao_regras: prof > proc > clínica] --> CALC
+  CALC --> REP[Repasse]
+```
+</content>

ScoreOdonto_Skills_Enterprise/FASE_04_FINANCEIRO/SKILL_Contratos.md

@@ -0,0 +1,36 @@
+# SKILL — Contratos
+
+> Herda de `SKILL_Financeiro.md`. Formalização de acordos (paciente/profissional ↔ clínica) e cobrança.
+
+## Conceito
+Contrato transforma um acordo (orçamento, remuneração, prestação) em documento com **modelo + variáveis +
+partes + assinaturas**, podendo **gerar cobrança** no financeiro.
+
+## Entidades / fluxo real
+- `contrato_modelos` (modelos com variáveis `{{...}}`, categorias: remuneração, prestação, etc.).
+- `contratos` / instâncias (`status`: rascunho → aguardando_assinatura → assinado → vigente → encerrado/cancelado).
+- `contrato_partes` (as partes do contrato) e `contrato_assinaturas` (aceite por parte: assinado_em, ip,
+  user_agent, hash) — **assinatura eletrônica de contrato** (≠ assinatura de plataforma, ver `SKILL_Assinaturas.md`).
+- Ações: `enviar` (cria assinaturas pendentes), `assinar`, `gerar-cobranca` (→ `financeiro`), `cancelar`, `duplicar`.
+
+## Variáveis de remuneração (já modeladas)
+`{{PERCENTUAL}}`, `{{PERCENTUAL_REPASSE}}`, `{{VALOR}}`, `{{BASE_REPASSE}}`, `{{PRAZO_REPASSE}}` — contratos
+de comissão/percentual referenciam o mesmo conceito de Repasse.
+
+## Regras obrigatórias
+1. Respeitar a máquina de estados (não pular rascunho→vigente sem assinatura).
+2. `gerar-cobranca` cria lançamento em `financeiro` (`origem='contrato'`, `contrato_id`).
+3. Assinatura grava trilha (ip/user_agent/hash) — não remover (valor probatório).
+
+## Anti-padrões
+- ❌ Confundir `contrato_assinaturas` (assinatura do documento) com `assinaturas` (mensalidade da plataforma).
+- ❌ Encerrar/cancelar sem auditoria.
+
+```mermaid
+flowchart LR
+  M[contrato_modelos] --> I[contratos: rascunho]
+  I --> E[enviar → assinaturas pendentes]
+  E --> A[assinar → assinado/vigente]
+  A --> COB[gerar-cobranca → financeiro]
+```
+</content>

ScoreOdonto_Skills_Enterprise/FASE_04_FINANCEIRO/SKILL_Faturamento.md

@@ -0,0 +1,49 @@
+# SKILL — Faturamento (visão consolidada do dinheiro)
+
+> Herda de `SKILL_Financeiro.md`. Mapa de **onde o dinheiro nasce, para onde vai e quem é o responsável.**
+
+## As três camadas de receita (estado real)
+1. **Receita da clínica** (operacional): produção de procedimentos, contratos/cobrança, recuperação de glosas.
+   Responsável: a clínica. Tabela: `financeiro` (RECEITA).
+2. **Receita do profissional** (repasse): comissão sobre a produção. Responsável: clínica paga; profissional recebe.
+   Tabelas: `comissao_regras` → `repasses` → `financeiro` (DESPESA).
+3. **Receita da plataforma**: (a) **Tutoria** — `comissao_pct` via MercadoPago (**automatizada**);
+   (b) **Assinaturas** — SaaS por conta (**manual**, sem gateway); (c) **Locação de salas** — `valor` na
+   reserva, **sem captura de pagamento** (lacuna).
+
+## Mapa origem → destino → responsável
+| Origem | Tabela | Destino | Responsável |
+|---|---|---|---|
+| Procedimento (RECEITA) | `financeiro` | caixa da clínica | Clínica |
+| Contrato (cobrança) | `financeiro` | caixa da clínica | Clínica |
+| Convênio − Glosa | `glosas`/`financeiro` | recupera receita | Clínica |
+| Comissão → Repasse pago | `repasses`→`financeiro` DESPESA | profissional | Clínica paga |
+| Tutoria | `ortho_tutoring_request` + MercadoPago | plataforma (`comissao_pct`) + tutor (`valor_tutor`) | Plataforma |
+| Assinatura SaaS | `assinaturas` | plataforma | Plataforma (manual) |
+| Locação de sala | `sala_reservas.valor` | locador | — (sem gateway) |
+
+## Regras obrigatórias
+1. Não misturar as três camadas: clínica ≠ profissional ≠ plataforma.
+2. Toda lacuna de captura (salas, assinaturas) deve ser **sinalizada, não presumida como paga**.
+3. Mudança em qualquer camada → mapear efeito nas demais antes (ver `../FASE_08_AUDITORIA/SKILL_Fluxos.md`).
+
+## Oportunidades (já mapeadas, não implementar aqui)
+- Gateway na **Locação de Salas** (receita mais próxima) e **recorrência das Assinaturas**.
+
+```mermaid
+flowchart TD
+  subgraph Clínica
+    PR[Procedimento] --> R[financeiro RECEITA]
+    CON[Contrato] --> R
+    R --> GL[Glosas]
+  end
+  subgraph Profissional
+    R --> COM[Comissão] --> REP[Repasse] --> D[financeiro DESPESA]
+  end
+  subgraph Plataforma
+    TUT[Tutoria · MercadoPago] --> PLT[comissao_pct + valor_tutor]
+    ASS[Assinaturas · manual] --> PLT
+    SAL[Salas · valor] -. falta gateway .-> PLT
+  end
+```
+</content>

ScoreOdonto_Skills_Enterprise/FASE_04_FINANCEIRO/SKILL_Financeiro.md

@@ -0,0 +1,41 @@
+# SKILL — Financeiro (núcleo do caixa)
+
+> Herda de `../FASE_01_ARQUITETURA/SKILL_Multiempresa.md`. Tabela central do dinheiro: `financeiro`.
+
+## Conceito
+`financeiro` registra **RECEITA** e **DESPESA** da clínica (escopo `clinica_id`). É o caixa unificado de
+onde derivam comissões, repasses e glosas.
+
+## Entidades / colunas-chave (reais)
+`financeiro(id, clinica_id, descricao, valor, tipo['RECEITA'|'DESPESA'], status['Pago'|'Pendente'|...],
+formapagamento, datavencimento, data_competencia, pago_em, paciente_id, profissional_id, procedimento_id,
+agendamento_id, realizado_id, contrato_id, origem, centro_custo, fornecedor, sem_comissao, deleted_at)`.
+
+## Origens (origem=...)
+- `procedimento` — gerado ao lançar Procedimento Realizado (RECEITA, se `valor>0`).
+- `contrato` — cobrança de contrato (`gerar-cobranca`).
+- `repasse` — DESPESA ao pagar repasse (`centro_custo='COMISSÕES'`, `sem_comissao=true`).
+- Lançamento manual (avulso) — RECEITA/DESPESA direto na tela.
+
+## Regras obrigatórias
+1. Todo lançamento carrega `clinica_id` e `tipo`.
+2. **`sem_comissao`** marca o que NÃO deve gerar repasse (garantia, despesa de repasse).
+3. **`deleted_at`** = soft-delete (estorno reversível). Nunca DELETE físico de lançamento conciliado.
+4. RECEITA de procedimento é **opcional** (`valor>0` e `gerarLancamento!==false`) — alterar muda o caixa.
+
+## Fluxos a jusante
+RECEITA → base de **Comissão**; DESPESA de repasse fecha o ciclo. Recebíveis de convênio → **Glosas**.
+
+## Anti-padrões
+- ❌ Apagar lançamento fisicamente. ❌ Lançar sem `clinica_id`/`tipo`.
+- ❌ Recriar comissão a partir de despesa de repasse (use `sem_comissao`).
+
+```mermaid
+flowchart LR
+  PR[Procedimento] -->|origem=procedimento| R[financeiro RECEITA]
+  CON[Contrato] -->|gerar-cobranca| R
+  RP[Repasse pago] -->|origem=repasse| D[financeiro DESPESA]
+  R --> COM[Comissão]
+  R --> GL[Glosas]
+```
+</content>

ScoreOdonto_Skills_Enterprise/FASE_04_FINANCEIRO/SKILL_Repasses.md

@@ -0,0 +1,35 @@
+# SKILL — Repasses
+
+> Herda de `SKILL_Comissoes.md`. Fechamento e pagamento da comissão ao profissional.
+
+## Conceito
+Repasse é o **snapshot imutável** da comissão de um profissional num período, que vira **DESPESA** quando pago.
+
+## Entidades / fluxo real
+- `repasses(id, clinica_id, profissional_id, inicio, fim, base, base_valor, custo_lab_total,
+  comissao_valor, qtd_lancamentos, detalhes(JSON), status['fechado'|'pago'|'cancelado'], pago_em,
+  financeiro_id, comprovante_*)`.
+- `POST /repasses/fechar` → calcula via `computeComissoes` e grava `status='fechado'` (snapshot em `detalhes`).
+- `POST /repasses/:id/pagar` → cria `financeiro` DESPESA (`origem='repasse'`, `centro_custo='COMISSÕES'`,
+  `sem_comissao=true`) e marca `status='pago'` + `financeiro_id`.
+- `POST /repasses/:id/cancelar` → se estava pago, **estorna** a DESPESA (soft-delete) e zera `financeiro_id`.
+- Comprovante: `POST /repasses/:id/comprovante`.
+
+## Regras obrigatórias
+1. Só paga repasse **fechado**. O snapshot (`detalhes`) é **imutável** após fechar.
+2. DESPESA de repasse nasce com `sem_comissao=true` (não recomissionar).
+3. Cancelamento é **reversível** (estorno por soft-delete) — preservar.
+4. Toda transição registra `audit_log` (`registrarAudit`). Manter.
+
+## Anti-padrões
+- ❌ Editar valores de um repasse fechado (refazer = cancelar + novo fechamento).
+- ❌ Pagar sem gerar a DESPESA correspondente (quebra a conciliação).
+
+```mermaid
+flowchart LR
+  COM[Comissão do período] --> F[fechar → repasses status=fechado]
+  F --> P[pagar → financeiro DESPESA]
+  P --> C{cancelar?}
+  C -->|sim| EST[estorna DESPESA soft-delete]
+```
+</content>

ScoreOdonto_Skills_Enterprise/FASE_05_UIUX/SKILL_Acessibilidade.md

@@ -0,0 +1,25 @@
+# SKILL — Acessibilidade
+
+> Base mínima de a11y, sem regredir a identidade visual. Pragmático para o estado atual.
+
+## Estado atual (honesto)
+O app prioriza densidade/visual; a11y é **básica**. Esta skill fixa o mínimo a manter/melhorar sem
+quebrar o design.
+
+## Regras obrigatórias
+1. **Contraste**: texto sobre a cor de marca deve ser legível (a marca é escura → texto branco). Evitar
+   cinza-claro sobre branco em informação essencial.
+2. **Alvos de toque** no mobile ≥ ~40px (os botões do bottom nav/menu já respeitam).
+3. **Foco**: usar `focus:ring-brand` (já existe) em controles interativos; não remover outline sem substituto.
+4. **Semântica**: `<button>` para ação, `<a>` para navegação; ícone-só precisa de `aria-label`/título.
+5. **Estados**: feedback de loading/disabled (`disabled:opacity-60`) e toasts para resultado de ação.
+
+## Como auditar
+```bash
+grep -rnE "onClick" frontend/views/<View>.tsx | grep -ivE "aria-label|title|>.*<"   # ícones-botão sem rótulo
+```
+
+## Anti-padrões
+- ❌ Remover outline de foco sem alternativa. ❌ Ícone clicável sem rótulo acessível.
+- ❌ Texto essencial com contraste insuficiente. ❌ Sacrificar a identidade visual aprovada por a11y (equilibrar).
+</content>

ScoreOdonto_Skills_Enterprise/FASE_05_UIUX/SKILL_Containers.md

@@ -0,0 +1,39 @@
+# SKILL — Containers & Identidade Visual (REGRA RÍGIDA)
+
+> Herda de `SKILL_DesktopWidth.md`. Preservar a identidade visual aprovada. **Não inventar design.**
+
+## Padrão real de container (não regredir)
+- **Wrapper de página:** `max-w-7xl mx-auto` + `p-4 md:p-8` (definido em `App.tsx`).
+- **Cards:** fundo branco, bordas suaves (`border-gray-200`), cantos arredondados (`rounded-xl`/`2xl`),
+  sombra leve. Tipografia de rótulo em caixa-alta, peso forte (`font-bold/black uppercase` em labels/menus).
+- **Sidebar:** `w-64`, branca, item ativo pintado com a **cor de marca**.
+
+## Cor de marca (token oficial — NÃO hardcodar)
+- Variável CSS `--brand-color`, vinda de `activeWorkspace.cor` (default `#2563eb`; superadmin `#dc2626`).
+- Classes utilitárias existentes: `bg-brand`, `text-brand`, `border-brand`, `hover:bg-brand`, `focus:ring-brand`.
+- **Sempre** usar o token/classe de marca para realce — nunca cravar um hex novo.
+
+## Regras obrigatórias
+1. **Preservar cores, estilos e identidade visual** aprovados — alterações visuais exigem aprovação.
+2. Realce/seleção usa **a cor do workspace** (`--brand-color`), não cor fixa.
+3. Reutilizar componentes existentes (`PageHeader`, `Toast`, `StackModal`, `EmptyState`, `Header`) — não recriar.
+4. Espaçamento e raio consistentes com o resto do app (não introduzir novo sistema de spacing).
+
+## Anti-padrões
+- ❌ Hardcodar `#2563eb` (ou qualquer hex) em vez de `var(--brand-color)`/classes `*-brand`.
+- ❌ Criar um novo "design system" paralelo ou trocar a tipografia/raio/sombra padrão.
+- ❌ Container de página fora do `max-w-7xl mx-auto`.
+- ❌ Recriar modal/toast/header quando já existe componente.
+
+## Validação
+- A tela nova é **indistinguível em estilo** das telas existentes? Se não, parar.
+- Trocar de workspace muda o realce conforme a cor da clínica? (token funcionando)
+
+```mermaid
+flowchart TD
+  WS[workspace.cor] --> VAR[--brand-color]
+  VAR --> BR[classes *-brand / realces]
+  COMP[Componentes existentes] --> UI[Tela consistente]
+  WRAP[max-w-7xl mx-auto] --> UI
+```
+</content>

ScoreOdonto_Skills_Enterprise/FASE_05_UIUX/SKILL_Dashboard.md

@@ -0,0 +1,22 @@
+# SKILL — Dashboard
+
+> Tela inicial por papel. Herda de `SKILL_GridSystem.md` + `SKILL_DesktopWidth.md`.
+
+## O que é
+Visão consolidada (KPIs) de entrada. Dados via `GET /api/dashboard/stats`. View: `views/Dashboard.tsx`.
+Cada papel tem seu ponto de entrada (`getDefaultViewForRole`): superadmin → overview; sala → painel da sala;
+paciente → tratamentos; demais → dashboard.
+
+## Padrão de layout (real)
+- KPIs em grid `grid-cols-2 md:grid-cols-4` (cards compactos), dentro do wrapper `max-w-7xl mx-auto`.
+- Realce com a cor do workspace; números grandes + rótulo caixa-alta.
+
+## Regras obrigatórias
+1. KPIs vêm do backend (`/api/dashboard/stats`) — não recalcular no cliente de forma divergente.
+2. Respeitar o teto de largura (`max-w-7xl`) e o grid mobile-first (ver GridSystem).
+3. Conteúdo do dashboard segue o papel/permissões (não mostrar KPI que o papel não pode ver).
+
+## Anti-padrões
+- ❌ Dashboard full-width esticado. ❌ KPI financeiro para papel sem acesso a financeiro.
+- ❌ Recriar cards fora do padrão visual.
+</content>

ScoreOdonto_Skills_Enterprise/FASE_05_UIUX/SKILL_DesignSystem.md

@@ -0,0 +1,29 @@
+# SKILL — Design System (REGRA RÍGIDA)
+
+> Tokens e padrões visuais REAIS do app. **Preservar a identidade aprovada. Não inventar.**
+> Herda de `SKILL_Containers.md`.
+
+## Stack
+React 19 + **Tailwind 4** + lucide-react (ícones). Sem biblioteca de componentes externa.
+
+## Cor de marca (token oficial)
+- `--brand-color` ← `activeWorkspace.cor` (default `#2563eb`; superadmin `#dc2626`).
+- Classes utilitárias: `bg-brand`, `text-brand`, `border-brand`, `hover:bg-brand`, `focus:ring-brand`.
+- **Sempre** o token/classe — nunca um hex novo cravado.
+
+## Tipografia & forma (observado)
+- Rótulos/menus/badges: **caixa-alta**, peso forte (`font-bold`/`font-black uppercase`, `tracking`).
+- Cantos arredondados (`rounded-xl`/`2xl`), bordas suaves (`border-gray-200`), sombra leve.
+- Ícones lucide-react com tamanho consistente (`size={16..22}`).
+
+## Componentes a reutilizar (não recriar)
+`PageHeader`, `Header`, `Sidebar`, `Toast`/`ToastContainer`, `StackModal`, `EmptyState`, `ConfirmContext`(`useConfirm`), `ToothIcon`.
+
+## Regras obrigatórias
+1. Realce/seleção usa a cor do workspace (`--brand-color`).
+2. Reutilizar os componentes acima; modal/toast/confirm já existem.
+3. Manter spacing/raio/sombra consistentes — não introduzir novo sistema.
+
+## Anti-padrões
+- ❌ Hex hardcoded. ❌ Novo design system paralelo. ❌ Recriar modal/toast/header. ❌ Trocar tipografia/raio padrão.
+</content>

ScoreOdonto_Skills_Enterprise/FASE_05_UIUX/SKILL_DesktopWidth.md

@@ -0,0 +1,44 @@
+# SKILL — Desktop Width (REGRA RÍGIDA)
+
+> Objetivo desta skill: **impedir que qualquer agente estique divs, quebre o desktop ou invente layout.**
+> Tudo abaixo reflete a convenção REAL do código (`frontend/App.tsx`, Tailwind 4). Não inventar valores.
+
+## Regra de ouro
+**O conteúdo de toda página vive dentro do wrapper canônico:**
+```
+<div className="max-w-7xl mx-auto"> ... </div>
+```
+Esse wrapper já existe globalmente em `App.tsx` (a área de conteúdo é `max-w-7xl mx-auto` com `p-4 md:p-8`).
+`max-w-7xl` = **1280px** centralizado. **NUNCA** remover, sobrepor ou furar esse limite.
+
+## Regras obrigatórias
+1. **PROIBIDO `w-screen`, `100vw`, `max-w-none` ou `max-w-full`** em containers de página no desktop.
+2. **PROIBIDO full-width**: nada de conteúdo encostando nas bordas da viewport em telas largas.
+3. **Largura máxima de conteúdo = `max-w-7xl` (1280px)**, centralizado com `mx-auto`. É o padrão do app.
+4. Subseções podem ser mais estreitas (`max-w-2xl`, `max-w-3xl`, `max-w-md` para formulários) — **nunca mais largas** que o wrapper.
+5. **Sidebar fixa `w-64` (256px)** — não alterar sem auditoria de UX.
+6. Em ultrawide (>1280px) a sobra vira **margem lateral** (centralização), nunca esticão de conteúdo.
+
+## Padrão real observado (não regredir)
+- Wrapper de página: `max-w-7xl mx-auto` + `p-4 md:p-8`.
+- Larguras de cards/formulários: `max-w-md / 2xl / 3xl` conforme densidade.
+- Breakpoints usados: `sm:` `md:` `lg:` (o `xl:` é raro — **não** introduzir layouts dependentes de `xl/2xl` sem necessidade).
+
+## Anti-padrões (o que QUEBRA o desktop)
+- ❌ Trocar `max-w-7xl` por `max-w-full`/`w-full` no nível da página.
+- ❌ Criar grids que se expandem indefinidamente em telas largas.
+- ❌ Remover o `mx-auto` (conteúdo cola à esquerda).
+- ❌ Inventar nova paleta/identidade (ver Containers/DesignSystem).
+
+## Validação obrigatória antes de entregar
+- Conferir em **desktop largo** (≥1920px): conteúdo centralizado, margens laterais, sem esticão.
+- Conferir em **mobile**: `p-4`, coluna única, sem overflow horizontal.
+
+```mermaid
+flowchart LR
+  V[Viewport larga] --> M1[margem]
+  V --> C[max-w-7xl · 1280px · mx-auto]
+  V --> M2[margem]
+  C --> CONT[Conteúdo da página]
+```
+</content>

ScoreOdonto_Skills_Enterprise/FASE_05_UIUX/SKILL_GridSystem.md

@@ -0,0 +1,40 @@
+# SKILL — Grid System (REGRA RÍGIDA)
+
+> Herda de `SKILL_DesktopWidth.md`. Layout responsivo **mobile-first**, como já feito no app.
+
+## Padrão real (não regredir)
+O app é **mobile-first**: começa em coluna única e cresce por breakpoint. Convenção observada:
+```
+grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3   (cards/listas)
+grid grid-cols-2 md:grid-cols-4                   (KPIs/contadores)
+```
+Breakpoints em uso: `sm:` `md:` `lg:` (predominantes); `xl:` é raro — **não** depender dele.
+
+## Regras obrigatórias
+1. **Mobile-first sempre:** definir o estado base (1 coluna) e escalar com `md:`/`lg:`.
+2. **Teto de colunas em `lg:`** (até `lg:grid-cols-4`). Não criar grids que multiplicam colunas em ultrawide.
+3. Usar `gap-*` consistente com o app; não misturar grid com float/posicionamento absoluto para layout.
+4. Tabelas largas: scroll interno (`overflow-x-auto`), **nunca** estourar o `max-w-7xl`.
+5. Formulários: largura contida (`max-w-md/2xl`) e centralizada, não full-width.
+
+## Casos de uso
+- Dashboard de KPIs: `grid-cols-2 md:grid-cols-4`.
+- Lista de cards: `grid-cols-1 md:grid-cols-2 lg:grid-cols-3`.
+- Form de cadastro: `max-w-2xl mx-auto`.
+
+## Anti-padrões
+- ❌ `grid-cols-6`/`grid-cols-12` que esticam em telas largas sem teto.
+- ❌ Layout que só foi testado em desktop (quebra no mobile).
+- ❌ Conteúdo de grid ultrapassando o wrapper `max-w-7xl`.
+- ❌ Introduzir dependência de `xl:`/`2xl:` para o layout funcionar.
+
+## Validação
+- Mobile (1 coluna, sem overflow), tablet (`md:`), desktop (`lg:`), ultrawide (centralizado, sem esticão).
+
+```mermaid
+flowchart LR
+  B[grid-cols-1 · base/mobile] --> M[md:grid-cols-2/3]
+  M --> L[lg:grid-cols-3/4 · TETO]
+  L --> X[ultrawide: centraliza, não estica]
+```
+</content>

ScoreOdonto_Skills_Enterprise/FASE_05_UIUX/SKILL_Responsividade.md

@@ -0,0 +1,23 @@
+# SKILL — Responsividade (REGRA RÍGIDA)
+
+> Mobile-first, como o app já é. Herda de `SKILL_GridSystem.md`.
+
+## Padrão real (não regredir)
+- **Mobile-first**: estado base = mobile; cresce com `sm:`/`md:`/`lg:` (uso: `sm:`≈238, `md:`≈186, `lg:`≈100; `xl:` raro≈8).
+- **Sidebar**: `w-64` fixa no desktop; off-canvas no mobile (drawer com overlay `bg-black/50 md:hidden`).
+- **Bottom nav mobile** por papel (`BOTTOM_TABS` em `App.tsx`) com `+ Mais`.
+- Padding de página `p-4 md:p-8`; safe-area no bottom nav (`env(safe-area-inset-bottom)`).
+
+## Regras obrigatórias
+1. Toda tela nova **funciona no mobile** (coluna única, sem overflow horizontal) E no desktop.
+2. Não depender de `xl:`/`2xl:` para o layout funcionar.
+3. Sidebar drawer no mobile; conteúdo dentro de `max-w-7xl mx-auto`.
+4. Tabelas largas → `overflow-x-auto` (scroll interno), nunca estourar o container.
+
+## Validação (obrigatória antes de entregar)
+- Mobile (≤640): 1 coluna, sem scroll horizontal, bottom nav ok.
+- Tablet (`md`), Desktop (`lg`), Ultrawide (centraliza, sem esticar).
+
+## Anti-padrões
+- ❌ Testar só no desktop. ❌ Overflow horizontal no mobile. ❌ Layout que quebra sem `xl:`.
+</content>

ScoreOdonto_Skills_Enterprise/FASE_06_MODULOS/SKILL_Agenda.md

@@ -0,0 +1,28 @@
+# SKILL — Módulo Agenda
+
+> Coração operacional. RBAC: capability `'agenda'` (staff clínico, bloqueia paciente).
+
+## O que é
+Agendar/confirmar/remarcar consultas, controle de presença, anti-overbooking e pendências de reagendamento.
+
+## Entidades
+`agendamentos`, `agenda_presenca`, `agenda_pendencias`, `interesses_agenda`, `dentistas`+`dentistas_horarios`.
+
+## Rotas principais
+- `GET/POST /api/agendamentos`, `PUT/DELETE /api/agendamentos/:id`
+- Ações `/:id`: `confirmar`, `falta`, `remarcar`, `restaurar`, `reencaminhar`, `solicitar-avaliacao`
+- `GET/POST /api/agenda/presenca`, `GET /api/agenda/{pendencias,atividade}`, `POST /api/agenda/pendencias/:id/resolver`
+- `POST /api/agenda/importar-google`, horários: `GET /api/dentistas/:id/horarios`, `POST/DELETE /api/dentistas/horarios`
+
+## Regras de negócio (reais)
+- **Anti-overbooking**: checa conflito ANTES de criar (ex.: conversão de lead não cria paciente se o slot está ocupado).
+- **Falta** abre pendência e impacta o **score** do paciente.
+- **Presença/confirmação** libera o lançamento financeiro a jusante.
+- Tempo real via WebSocket (`wsBroadcast('agenda', ...)`) → refetch instantâneo na clínica.
+
+## Impactos a jusante
+Procedimento realizado → Financeiro → Comissão. Integra Google Calendar (importar).
+
+## Anti-padrões
+- ❌ Remover a checagem de overbooking. ❌ Mutação de agenda sem `registrarAudit`. ❌ Expor agenda ao paciente.
+</content>

ScoreOdonto_Skills_Enterprise/FASE_06_MODULOS/SKILL_CRM.md

@@ -0,0 +1,28 @@
+# SKILL — Módulo CRM (Leads)
+
+> Topo do funil comercial. RBAC: capability `'leads'` (funcionário + dono).
+
+## O que é
+Captar interessados e **converter** em paciente + agendamento (início do ciclo clínico).
+
+## Entidades
+`leads` (status: Novo|Convertido|Arquivado), `interesses_agenda`, gera `pacientes` + `agendamentos`.
+
+## Rotas
+`GET/POST /api/leads`, `POST /api/leads/:id/converter`. Origem pública: `PublicContactForm`/`/api/interesses`.
+
+## Regra de negócio central (verificada)
+`POST /api/leads/:id/converter`:
+1. valida que o lead não foi convertido (409 se já foi);
+2. checa **anti-overbooking** do slot ANTES de criar (evita paciente órfão);
+3. cria o **paciente**; 4) cria o **agendamento** inicial (se slot válido e livre).
+
+## Impactos a jusante
+Paciente → Agenda → atendimento → Financeiro.
+
+## Oportunidade (do mapa funcional)
+CRM é a entrada; integrar com WhatsApp/origem de marketing é alavanca de crescimento (hoje básico).
+
+## Anti-padrões
+- ❌ Converter sem anti-overbooking. ❌ Duplicar paciente na reconversão. ❌ Expor leads a papel clínico/paciente.
+</content>

ScoreOdonto_Skills_Enterprise/FASE_06_MODULOS/SKILL_Documentos.md

@@ -0,0 +1,25 @@
+# SKILL — Módulo Documentos (Receitas, Exames, Contratos, Mídia)
+
+> Geração e guarda de documentos clínicos/jurídicos e mídia. Cruza Prontuário e Contratos.
+
+## O que é
+Receitas, pedidos de exame, contratos (com assinatura eletrônica) e arquivos (fotos, comprovantes, PDFs).
+
+## Entidades
+`modelos_receita`/`items_receita`, `pedidos_exame`/`items_pedido_exame`,
+`contratos`/`contrato_modelos`/`contrato_partes`/`contrato_assinaturas`, e fotos por entidade
+(`*_foto`). PDFs no frontend via `jspdf`.
+
+## Acesso à mídia (padrão real)
+Arquivos são servidos por **URL assinada**: `/api/.../raw?t=signMedia(id)` — sem token de sessão.
+A URL só é entregue a quem já passou pelo guard da listagem. **Não** gatear o `/raw` por capability
+(quebraria a imagem); a proteção é o token assinado + a lista gateada.
+
+## Contratos (assinatura)
+`contrato_assinaturas` grava trilha probatória (ip, user_agent, hash do corpo). É **registro de aceite** —
+não remover. Capability `'contratos'` (funcionário+dono). Ver `../FASE_04_FINANCEIRO/SKILL_Contratos.md`.
+
+## Anti-padrões
+- ❌ Servir mídia sem URL assinada. ❌ Gatear `/raw` por capability. ❌ Apagar trilha de assinatura.
+- ❌ Confundir assinatura de contrato (`contrato_assinaturas`) com assinatura de plataforma (`assinaturas`).
+</content>

ScoreOdonto_Skills_Enterprise/FASE_06_MODULOS/SKILL_Prontuario.md

@@ -0,0 +1,28 @@
+# SKILL — Módulo Prontuário (Paciente + Ortodontia)
+
+> O histórico clínico do paciente. Detalhes acessíveis a staff clínico (capability `'agenda'`).
+
+## O que é
+Prontuário do paciente: dados, família, score, faltas, procedimentos realizados, receitas, pedidos de exame,
+e o tratamento **ortodôntico** completo.
+
+## Entidades
+`pacientes`, `procedimentos_realizados`(+foto), `modelos_receita`/`items_receita`, `pedidos_exame`/`items_pedido_exame`,
+`avaliacoes`/`avaliacao_foto`; **orto**: `ortho_tratamento`, `ortho_evolucao`, `ortho_photo`(+session/annotation).
+
+## Rotas
+`GET/POST/PUT /api/pacientes[...]`, `GET /api/pacientes/:id/{score,faltas,familia}`,
+`GET/POST /api/orto/tratamentos[/:id/{evolucoes,finalizar}]`, `/api/orto/{sessoes,fotos}`, `/api/avaliacoes`.
+
+## Regras de negócio
+- **Ortodontia** tem triagem, diagnóstico, plano, evoluções, fotos e contenção (vide `frontend/types.ts`).
+- `procedimentos_realizados` gera RECEITA (opcional por valor) e alimenta comissão.
+- **`OrthoView` (dentista) cria/edita paciente** → por isso o cap de mutação de paciente é `'agenda'` (clínico), não `'pacientes'`.
+
+## Privacidade/LGPD
+Paciente é **da clínica** (escopo `clinica_id`), não do ecossistema. Não compartilhar histórico entre clínicas
+sem base legal — ver `../FASE_03_PESSOAS/SKILL_Pacientes.md`.
+
+## Anti-padrões
+- ❌ Vazar prontuário entre clínicas. ❌ Gatear mutação de paciente a `'pacientes'` (bloquearia o dentista do Ortho).
+</content>

ScoreOdonto_Skills_Enterprise/FASE_06_MODULOS/SKILL_Proteses.md

@@ -0,0 +1,25 @@
+# SKILL — Módulo Próteses / GTO
+
+> Controle de laboratório. Liga-se à Comissão pelo **custo lab**. Ver `../FASE_03_PESSOAS/SKILL_Proteticos.md`.
+
+## O que é
+Ordens de Serviço de prótese (produto, dentes, material, custo lab, prazo, entrega) e GTO (guia de tratamento).
+
+## Entidades
+`protese_os`, `protese_os_evento`, `protese_os_foto`, `protese_produtos`, `protese_laboratorios`;
+GTO legado: `gto_builders`/`gto_items`, `guias_odontologicas`.
+
+## Rotas
+`GET/POST /api/protese/os`, `GET /api/protese/os/:id`, `POST /api/protese/os/:id/{status,foto}`,
+`GET/POST/PUT/DELETE /api/protese/produtos`, `GET /api/protese/laboratorios[/:id/produtos]`, `GET /api/protese/bancada`.
+
+## Regra de negócio central
+O **custo lab** da prótese **abate a base de comissão** do procedimento (`computeComissoes` =
+`(base − custo_lab) × %`). Mexer aqui afeta o repasse — ver `../FASE_04_FINANCEIRO/SKILL_Comissoes.md`.
+
+## Papéis
+Protético (pessoa, profissional do ecossistema) opera; laboratório = fornecedor (cadastro hoje).
+
+## Anti-padrões
+- ❌ Alterar custo lab sem considerar o efeito na comissão. ❌ Confundir protético (pessoa) com laboratório (fornecedor).
+</content>

ScoreOdonto_Skills_Enterprise/FASE_06_MODULOS/SKILL_Radiologia.md

@@ -0,0 +1,24 @@
+# SKILL — Módulo Radiologia (RX)
+
+> Plugin `rx-scoreodonto`. Radiografias são ODONTOLÓGICAS (papéis odonto, não bio/protético).
+
+## O que é
+Captura/gestão de radiografias e dos dispositivos (PCs/sensores) por clínica. Integra com o produto externo
+**rx.scoreodonto.com** (server + client.exe) — ver `documentos-unicos/projetos/rx.scoreodonto.com*`.
+
+## Rotas
+`GET /api/rx/{config,devices,images,patients,health}`, `PUT /api/rx/config`, `POST /api/rx/devices`.
+Views: `plugins/RXPlugin.tsx` (RX/Radiografias), `RxConfigView` (Dispositivos RX).
+
+## Permissões (do Sidebar real)
+- **RX/Radiografias**: dentista + donos/funcionário (papéis odonto). **Biomédico e protético NÃO veem RX.**
+- **Dispositivos RX**: admin/donos + superadmin.
+- Requer o plugin `rx-scoreodonto` ativo na conta.
+
+## Integração
+O RX é um sistema próprio (auto-update do client via `/updates/latest.yml`) — **não quebrar** esse mecanismo.
+Aqui é só a ponte (config/devices/images) dentro do ScoreOdonto.
+
+## Anti-padrões
+- ❌ Expor RX a biomédico/protético. ❌ Acoplar a lógica do client.exe aqui. ❌ Mexer no `/updates/` do RX por engano.
+</content>

ScoreOdonto_Skills_Enterprise/FASE_06_MODULOS/SKILL_Tutoria.md

@@ -0,0 +1,26 @@
+# SKILL — Módulo Tutoria de Ortodontia
+
+> **Única receita de plataforma automatizada hoje** (MercadoPago). Ver `../FASE_03_PESSOAS/SKILL_Tutores.md`.
+
+## O que é
+Dentista vira **tutor** (pagando inscrição) e atende solicitações de orto de outros dentistas; a plataforma
+fica com uma comissão sobre a consultoria.
+
+## Entidades
+`ortho_tutor_config` (`comissao_pct` default 20, `taxa_inscricao`, chave PIX, credenciais MP),
+`ortho_tutor_profile`, `ortho_tutor_candidatura`, `ortho_tutoring_request`/`message`/`photo_package`.
+
+## Rotas
+`POST /api/tutoria/candidaturas[/:id/pagamento]`, `POST /api/tutoria/mp-webhook` (público),
+`GET/POST /api/tutoria/solicitacoes[...]`, admin: `/api/admin/{candidaturas,repasses,tutor-config}`.
+
+## Fluxo de receita (verificado)
+Candidatura → **MercadoPago** (`checkout/preferences`) → `mp-webhook` (idempotente) ativa `is_tutor` →
+solicitações registram `valor_consultoria`, `comissao_pct`, `valor_tutor`, `status_repasse`.
+
+## Permissões
+`candidatura-tutor` (dentistas), `tutoria-painel` (só tutores aprovados, `is_tutor`), `admin-gestao-tutores` (superadmin).
+
+## Anti-padrões
+- ❌ Ativar tutor sem confirmar pagamento. ❌ Misturar `comissao_pct` da tutoria com a comissão de clínica.
+</content>

ScoreOdonto_Skills_Enterprise/FASE_07_INFRA/SKILL_BuildOnce.md

@@ -0,0 +1,33 @@
+# SKILL — Build Once → Promote → Deploy
+
+> Orientação de infra oficial. Fonte: `documentos-unicos/deploy/`. Implementação de referência: scoreodonto.com.
+
+## Conceito
+**Push** na `main` builda a imagem **uma vez** e publica por **commit** (`:<sha>` + `:latest`) — **sem deploy**.
+A **tag `vX.Y.Z`** **re-tagueia** essa MESMA imagem (mesmo digest, sem rebuild) e deploya. **Produção nunca builda.**
+
+## Garantia central
+A imagem em produção é **byte-idêntica** à que foi buildada e testada. A tag é só um rótulo de release
+sobre um artefato imutável. Validado em scoreodonto (`:v1.0.16` == `:471c2c2`, mesmo digest).
+
+## Fluxo real
+```
+PUSH main (commit C) → CI build 1x → publica :C + :latest        (NÃO deploya)
+TAG vX.Y.Z (em C)    → CI re-tag :C → :vX.Y.Z (sem rebuild) + deploy (up --no-build)
+```
+
+## Regras obrigatórias
+1. **Produção só executa imagem pronta** (`pull` + `up -d --no-build`). Nunca `build` na VPS1.
+2. **Tag exige commit já publicado** (push antes). Sem isso o CI **falha de propósito** (não builda na tag).
+3. Versão nasce da **tag git**, injetada em runtime (`APP_VERSION`), não escrita à mão.
+4. Push e tag exigem **autorização explícita do administrador**.
+
+## Anti-padrões
+- ❌ Buildar em produção. ❌ Tag sem push. ❌ Versão hardcoded em arquivo.
+
+```mermaid
+flowchart LR
+  PUSH[push main · commit C] --> B[CI build 1x] --> REG[registry :C + :latest]
+  TAG[tag vX.Y.Z] --> PROM[CI re-tag :C→:vX.Y.Z] --> DEP[VPS1 up --no-build]
+```
+</content>

ScoreOdonto_Skills_Enterprise/FASE_07_INFRA/SKILL_CICD.md

@@ -0,0 +1,32 @@
+# SKILL — CI/CD (Gitea Actions)
+
+> Herda de `SKILL_BuildOnce.md`. Automação de build/promote/deploy por evento git.
+
+## Conceito
+O pipeline roda no **Gitea Actions**, runner `vps4-builder` (VPS4, rootless, **instance-scoped** — atende
+todos os repos). Workflow: `.gitea/workflows/build.yml`.
+
+## Gatilhos reais
+- **Push na `main`** → job build: builda `scoreodonto-*:<sha>` e **publica no registry** (não deploya).
+- **Tag `v*`** → job promote/deploy: re-tag (digest idêntico) → `deploy-prod.sh` na VPS1.
+
+## Regras obrigatórias
+1. O runner builda; **produção só consome**. Não mover build para a VPS1.
+2. Segredos do CI vêm de **secrets do Gitea**, nunca commitados no repo. (Ver `⚠️ SKILL_PostgreSQL`/Registry.)
+3. Tag só promove se o commit já está no registry (senão falha proposital).
+4. Manter o pipeline idempotente e auditável (logs do run).
+
+## Pré-requisitos
+- Gitea Actions habilitado no repo; runner `vps4-builder` online; `docker login` no registry.
+- SSH VPS4→VPS1 para o passo de deploy (rsync/`deploy-prod.sh`).
+
+## Anti-padrões
+- ❌ Credencial em texto no `build.yml`. ❌ Deploy manual fora do pipeline sem registrar.
+- ❌ Pipeline que builda na tag (quebra o Build-Once).
+
+```mermaid
+flowchart LR
+  PUSH[push main] --> RUN[vps4-builder] --> REG[(registry)]
+  TAG[tag v*] --> RUN2[vps4-builder promote] --> SSH[VPS1 deploy-prod.sh]
+```
+</content>

ScoreOdonto_Skills_Enterprise/FASE_07_INFRA/SKILL_DeployImutavel.md

@@ -0,0 +1,33 @@
+# SKILL — Deploy Imutável & Rollback
+
+> Herda de `SKILL_BuildOnce.md`. Como promover e reverter sem rebuild.
+
+## Conceito
+O deploy troca **qual imagem** roda, não o código no servidor. Reverter = apontar para outra imagem.
+
+## Fluxo real
+- Promover: `deploy-prod.sh <tag>` na VPS1 → `pull` + `docker compose -f docker-compose.prod.yml up -d --no-build`.
+- `docker-compose.prod.yml` usa `image:` do registry, `APP_VERSION`/`GIT_COMMIT` em runtime.
+- Rollback: `deploy-prod.sh <ref-anterior>` (segundos/minutos, só troca imagem).
+
+## Regras obrigatórias
+1. **Referência confiável = commit (`:<sha>`)**. Tags antigas (pré-Build-Once) podem ter sido republicadas.
+2. **Migrações são aditivas** (`ADD COLUMN IF NOT EXISTS`) → voltar o código é seguro (schema extra fica inerte).
+3. **Backup do banco antes de release sensível** (container `pg_dump -Fc` → `/home/deploy/backups/`).
+4. Validar `/api/version` e `/api/health` após deploy.
+
+## Pré-requisitos de PROD (uma vez, por projeto)
+- Arquivo de segredos presente na VPS1 (env_file do compose) — **copiado manualmente, fora do git** (chmod 600).
+- `docker login git.clube67.com` na VPS1 (para o `pull`).
+
+## Anti-padrões
+- ❌ Reverter via rebuild. ❌ Migração destrutiva (DROP/ALTER que apaga) — quebra rollback.
+- ❌ Confiar em tag `:vX.Y.Z` como imutável se for anterior ao Build-Once.
+
+```mermaid
+flowchart LR
+  REG[(registry)] --> PULL[VPS1 pull :ref] --> UP[up -d --no-build]
+  UP --> CHK[/api/version + /api/health/]
+  CHK -->|quebrou| RB[deploy-prod.sh ref-anterior]
+```
+</content>

ScoreOdonto_Skills_Enterprise/FASE_07_INFRA/SKILL_DockerRootless.md

@@ -0,0 +1,34 @@
+# SKILL — Docker Rootless & Roteamento
+
+> Herda de `SKILL_DeployImutavel.md`. Como os containers rodam e são expostos.
+
+## Topologia real
+- **Rede privada WireGuard** `10.99.0.0/24`.
+- **VPS1 (produção):** Docker **rootless** — comandos usam `DOCKER_HOST=unix:///run/user/1000/docker.sock`.
+  Roda Traefik (borda TLS) + apps (scoreodonto, rx, newwhats, subdomínio, mercado).
+- **VPS4 (dev+builder):** Docker rootless; roda `dev.<projeto>` (imagem buildada, **não** HMR) + runner.
+- **Roteamento (Traefik na VPS1):** termina TLS e roteia por host:
+  `scoreodonto.com` → containers de produção locais; `dev.scoreodonto.com` → `10.99.0.4:8020` (VPS4) via WireGuard.
+
+## Regras obrigatórias
+1. Na VPS1, sempre exportar `DOCKER_HOST` rootless antes de comandos `docker`.
+2. Exposição pública **só via Traefik** (TLS `certresolver=le`); apps não publicam porta na internet.
+3. `dev.<projeto>` é descartável (VPS4); produção é a real (VPS1) — **confirmar DEV ou PROD antes de agir**.
+4. Editar dev exige **rebuild + recreate** (não há hot-reload no container atual).
+
+## ⚠️ Para abrir produção
+- Garantir que apenas Traefik exponha portas; conferir labels de roteador/host por app.
+- Rede WireGuard fechada; serviços de dados (VPS3) **nunca** expostos à internet.
+
+## Anti-padrões
+- ❌ `docker` na VPS1 sem `DOCKER_HOST` rootless. ❌ Publicar porta de app direto na internet.
+- ❌ Confundir `dev.` (VPS4) com produção (VPS1).
+
+```mermaid
+flowchart LR
+  NET[Internet] -->|TLS| TR[Traefik VPS1]
+  TR -->|host scoreodonto.com| APP[containers prod]
+  TR -->|host dev.*| WG[WireGuard → VPS4:8020]
+  APP --> DADOS[(VPS3 dados · só rede privada)]
+```
+</content>

ScoreOdonto_Skills_Enterprise/FASE_07_INFRA/SKILL_Gitea.md

@@ -0,0 +1,30 @@
+# SKILL — Gitea (código + registry + CI)
+
+> Herda de `SKILL_CICD.md`. A VPS3 concentra a "fonte da verdade" do código.
+
+## Papel real
+- **Código:** Gitea na **VPS3** é a fonte da verdade (repo `ruicesar/scoreodonto.com`).
+- **Registry:** Container Registry embutido do Gitea (ver `SKILL_Registry.md`).
+- **CI:** Gitea Actions + runner `vps4-builder` (ver `SKILL_CICD.md`).
+- Doc oficial da stack: repo `ruicesar/Documentos-Unicos` (local `documentos-unicos/`).
+
+## Regras obrigatórias
+1. **Nunca `git push --force` na `main`.** Push/tag exigem autorização do administrador.
+2. **Segredos via Gitea Secrets / webhooks**, nunca commitados.
+3. Idioma português em commits/docs (regra da stack).
+4. Webhooks/Actions antigos desligados não devem ser reativados sem auditoria.
+
+## ⚠️ Higiene de repositório (para abrir produção)
+- **Não versionar `.env`/segredos.** Hoje `backend/.env` está rastreado — corrigir e **rotacionar** as
+  credenciais expostas (ver `SKILL_PostgreSQL`). Confirmar `.gitignore` cobrindo `**/.env` e `.secrets`.
+
+## Anti-padrões
+- ❌ `push --force` na main. ❌ Commitar segredo. ❌ Reativar webhook legado sem auditoria.
+
+```mermaid
+flowchart LR
+  DEV[VPS4 dev] -->|push| GITEA[Gitea VPS3]
+  GITEA --> ACT[Actions · vps4-builder]
+  GITEA --> REG[(Registry)]
+```
+</content>

ScoreOdonto_Skills_Enterprise/FASE_07_INFRA/SKILL_PostGIS.md

@@ -0,0 +1,25 @@
+# SKILL — PostGIS (geolocalização)
+
+> Herda de `SKILL_PostgreSQL.md`. Extensão geoespacial usada por busca por proximidade.
+
+## Onde é usado (real)
+- Coluna `geo geography(Point,4326)` em `clinicas` e `salas` (e `cep_geo` para CEP→coordenada).
+- Suporta o **marketplace de salas** (achar salas próximas) e geocódigo de endereço.
+- O container `pgdev` é uma imagem **PostGIS** (dev espelha a capacidade da produção).
+
+## Regras obrigatórias
+1. Usar `geography(Point,4326)` (lat/long padrão) — não inventar SRID.
+2. Índice espacial (GIST) quando houver busca por distância em volume.
+3. Geocódigo (`cep_geo`) é cache — tratar ausência com fallback, não quebrar o cadastro.
+
+## Anti-padrões
+- ❌ Guardar lat/long como texto solto em vez de tipo geográfico.
+- ❌ Busca por proximidade sem índice (varredura completa).
+
+```mermaid
+flowchart LR
+  END[Endereço/CEP] --> GEO[cep_geo → ponto]
+  GEO --> SAL[salas.geo]
+  SAL --> PROX[busca por proximidade · marketplace]
+```
+</content>

ScoreOdonto_Skills_Enterprise/FASE_07_INFRA/SKILL_PostgreSQL.md

@@ -0,0 +1,32 @@
+# SKILL — PostgreSQL (dados)
+
+> Herda de `../FASE_01_ARQUITETURA/SKILL_Multiempresa.md`. Banco de produção e isolamento de dev.
+
+## Topologia real
+- **Produção:** PostgreSQL no host da **VPS3** (`10.99.0.3:5432`), banco `scoreodonto`, user `scoreodonto_user`.
+- **DEV isolado:** container **`pgdev`** (PostGIS) na VPS4, banco `scoreodonto_dev`, user `devadmin` —
+  **não toca produção**. `pg-dev-refresh.sh` / `pg-dev-reset.sh` para repuxar/limpar.
+- Acesso via WireGuard (`10.99.0.0/24`). Sem shell na VPS3 → operar por container (`pg_dump`/`pg_restore`).
+
+## Regras obrigatórias
+1. **Toda query operacional filtra `clinica_id`** (tenancy — ver Multiempresa).
+2. **Migrações aditivas** no boot (`CREATE TABLE/ADD COLUMN IF NOT EXISTS`). Nunca DROP/ALTER destrutivo.
+3. **Backup antes de release sensível**: `pg_dump -Fc` → `/home/deploy/backups/`.
+4. Testar migração arriscada **sempre em `pgdev`** antes da produção.
+
+## ⚠️ SEGREDOS (crítico para abrir produção)
+- **A senha do banco NÃO pode ficar em arquivo versionado nem como default em `docker-compose.yml`.**
+  Hoje há default hardcoded no compose (`SCOREO_DB_PASS:-...`) e `backend/.env` está **rastreado no git** —
+  isso vaza credenciais. Segredos devem vir de **env_file fora do git** (chmod 600) ou secrets do CI.
+- Rotacionar qualquer credencial que tenha entrado no histórico do git.
+
+## Anti-padrões
+- ❌ Query sem `clinica_id`. ❌ Migração destrutiva. ❌ Senha no compose/`.env` versionado.
+
+```mermaid
+flowchart LR
+  APP[Backend VPS1] -->|WireGuard| PG[(Postgres VPS3 · scoreodonto)]
+  DEVAPP[Backend DEV VPS4] --> PGDEV[(pgdev · scoreodonto_dev)]
+  PG --> BKP[/home/deploy/backups · pg_dump -Fc/]
+```
+</content>

ScoreOdonto_Skills_Enterprise/FASE_07_INFRA/SKILL_Registry.md

@@ -0,0 +1,25 @@
+# SKILL — Registry de Imagens
+
+> Herda de `SKILL_BuildOnce.md`. Onde os artefatos imutáveis vivem.
+
+## Conceito
+Registry = **Container Registry embutido do Gitea** (`git.clube67.com`, namespace `ruicesar/`).
+Não há `registry:2` separado. Imagens: `git.clube67.com/ruicesar/scoreodonto-{backend,frontend}:<tag>`.
+
+## Regras obrigatórias
+1. Imagem por **commit** (`:<sha>`) é a fonte; `:vX.Y.Z` é alias imutável do mesmo digest.
+2. `docker login git.clube67.com` na VPS1 (pull) e no runner (push) — credenciais via secrets, não no git.
+3. **Imagem enxuta**: `.dockerignore` deve excluir `node_modules`, `data/`, dumps, mídia pesada.
+   (Lição do RX: camadas grandes davam PUT 500/499 no registry.)
+4. Não sobrescrever uma tag de release com código diferente (quebra a imutabilidade).
+
+## Anti-padrões
+- ❌ Republicar `:vX.Y.Z` apontando para outro código. ❌ Empurrar imagem gigante (sem `.dockerignore`).
+- ❌ Guardar credencial do registry em arquivo versionado.
+
+```mermaid
+flowchart LR
+  RUN[runner build] -->|push :sha| REG[(Gitea Registry · ruicesar/)]
+  REG -->|pull :ref| VPS1[Produção]
+```
+</content>

ScoreOdonto_Skills_Enterprise/FASE_08_AUDITORIA/SKILL_APIs.md

@@ -0,0 +1,28 @@
+# SKILL — Auditoria de APIs
+
+> Como mapear e evoluir a API sem quebrar consumidores. Complementa `SKILL_Rotas.md`.
+
+## Realidade
+- **~277 rotas** REST `/api/*` num único `backend/server.js` (Express monolítico, ~516 KB). Sem camada de
+  controllers/services separada.
+- Guards: `authGuard` (identidade), `tenantGuard` (tenant), `requireCapability*` (cargo), `superadminGuard`.
+- Endpoints transversais: `GET /api/version`, `GET /api/health` (ver FASE_09); mídia por **URL assinada**
+  (`/raw?t=signMedia(...)`).
+- Frontend consome via `services/backend.ts` (`HybridBackend`/`apiFetch`).
+
+## Como auditar
+```bash
+grep -oE "app\.(get|post|put|delete|patch)\('[^']+" backend/server.js | sort -u   # todas as rotas
+grep -rn "API_URL}/<recurso>" frontend/services/backend.ts                         # consumidores
+```
+
+## Regras obrigatórias
+1. **Nunca** mudar o caminho/contrato de uma rota sem achar TODOS os consumidores (`services/backend.ts` + views).
+2. Toda rota nova: definir guard correto (identidade vs tenant vs cargo) — ver `SKILL_Permissoes.md`.
+3. Erros consistentes (`{ error }` / `{ success:false, message }` conforme o padrão vizinho).
+4. Rota que toca dado de clínica → `clinica_id` + `tenantGuard`.
+
+## Anti-padrões
+- ❌ Quebrar contrato sem mapear consumidores. ❌ Rota sensível sem guard de cargo.
+- ❌ Mídia sem token assinado. ❌ Inventar convenção de resposta diferente da do arquivo.
+</content>

ScoreOdonto_Skills_Enterprise/FASE_08_AUDITORIA/SKILL_Banco.md

@@ -0,0 +1,27 @@
+# SKILL — Auditoria de Banco
+
+> Como inspecionar e mexer no banco sem quebrar. Herda de `../FASE_07_INFRA/SKILL_PostgreSQL.md`.
+
+## Realidade
+- **PostgreSQL** (PostGIS) na VPS3 (`10.99.0.3`), banco `scoreodonto`. ~70 tabelas acessadas por **SQL direto**
+  (`pg`), via helpers `buildInsert`/`buildUpdate`. **Prisma é vestigial** (4 modelos GTO legados).
+- DEV isolado: container `pgdev` (banco `scoreodonto_dev`). Mexer aqui tem zero impacto em produção.
+- **Migrações aditivas no boot**: blocos `CREATE TABLE IF NOT EXISTS` / `ALTER TABLE ... ADD COLUMN IF NOT EXISTS`.
+
+## Regras obrigatórias
+1. **Só aditivo** (add tabela/coluna). Nunca DROP/ALTER destrutivo → quebra rollback (ver Deploy Imutável).
+2. **Toda query operacional filtra `clinica_id`** (tenancy).
+3. Validar migração arriscada **no `pgdev`** antes; **backup `pg_dump -Fc`** antes de release sensível.
+4. Sem shell na VPS3 → operar por container (`pg_dump`/`pg_restore`/`psql`).
+
+## Como auditar (via container, com creds do `.env`)
+```bash
+# tabelas e colunas
+grep -niE "CREATE TABLE IF NOT EXISTS|ADD COLUMN IF NOT EXISTS" backend/server.js
+# índices declarados
+grep -niE "CREATE INDEX" backend/server.js
+```
+
+## Anti-padrões
+- ❌ Migração destrutiva. ❌ Query sem `clinica_id`. ❌ Mexer direto na produção sem testar no `pgdev`/backup.
+</content>

ScoreOdonto_Skills_Enterprise/FASE_08_AUDITORIA/SKILL_Botoes.md

@@ -0,0 +1,28 @@
+# SKILL — Auditoria de Botões
+
+> Como rastrear o que cada botão faz (rota → tabela → fluxo) antes de mexer. Base:
+> `documentação/MAPA-FUNCIONAL-COMPLETO.md` (Etapa 3).
+
+## Método
+Para cada botão: **rótulo → handler no front → método HTTP/rota → tabela impactada → fluxo a jusante**.
+
+## Exemplos reais (verificados)
+| Botão (tela) | Rota | Tabela | Próximo fluxo |
+|---|---|---|---|
+| Novo Agendamento (Agenda) | `POST /api/agendamentos` | `agendamentos` | Procedimento → Financeiro |
+| Confirmar Presença (Agenda) | `POST /api/agenda/presenca` | `agenda_presenca` | libera lançamento |
+| Lançar Procedimento (Pacientes) | `POST /api/procedimentos-realizados` | `procedimentos_realizados` (+`financeiro`) | Comissão → Repasse |
+| Fechar Repasse (Comissões) | `POST /api/repasses/fechar` | `repasses` | Pagar → DESPESA |
+| Gerar Contrato (Contratos) | `POST /api/contratos/instancias` | `contratos` | gerar-cobrança → Financeiro |
+| Converter (Leads) | `POST /api/leads/:id/converter` | `pacientes` + `agendamentos` | atendimento |
+
+## Como auditar
+```bash
+grep -oE ">[A-ZÀ-Ú][a-zà-úA-ZÀ-Ú /]{3,28}<" frontend/views/<View>.tsx   # rótulos
+# depois localize o onClick → método do HybridBackend → rota em services/backend.ts
+```
+
+## Anti-padrões
+- ❌ Alterar a ação de um botão sem mapear a tabela e o fluxo a jusante (sobretudo financeiro).
+- ❌ Botão que muta sem confirmação onde o padrão da tela usa `useConfirm`.
+</content>

ScoreOdonto_Skills_Enterprise/FASE_08_AUDITORIA/SKILL_Entidades.md

@@ -0,0 +1,29 @@
+# SKILL — Auditoria de Entidades
+
+> Como verificar se as entidades estão bem classificadas. Herda de
+> `../FASE_01_ARQUITETURA/SKILL_ModelagemMestra.md`. Detalhe em `documentação/AUDITORIA-ESTRATEGICA-MODELAGEM.md`.
+
+## Entidades-âncora (corretas)
+- `usuarios` (Pessoa) · `vinculos(usuario_id, clinica_id, role, setor_id, funcao_id)` (Vínculo+RBAC)
+- `clinicas(tipo: pessoal|consultorio|clinica, owner_id)` + `salas(tipo='sala')` (Workspaces)
+- `usuario_areas`, `usuario_plugins`, `funcoes` (capacidades/cargo)
+
+## Débitos de modelagem (gravidade ALTA — vigiar)
+- **`dentistas`**: tabela paralela a `usuarios` (mesma pessoa duplicada por clínica, `usuario_id` opcional)
+  → tratar como **projeção de agenda**, não identidade.
+- **`pacientes`**: tem `clinica_id` e **não** `usuario_id` (preso à clínica, não-portável); há 2 variantes de
+  INSERT (com/sem `clinica_id`) — resíduo legado.
+- **MÉDIA**: workspace dividido em 2 tabelas (`clinicas` + `salas`); acoplamento role↔tipo (`donoconsultorio`).
+
+## Como auditar
+```bash
+grep -niE "CREATE TABLE" backend/server.js | sort           # tabelas reais (banco é SQL puro, Prisma vestigial)
+grep -oiE "(FROM|JOIN|INTO|UPDATE) [a-z_]+" backend/server.js | awk '{print $2}' | sort | uniq -c | sort -rn
+```
+Para cada entidade, pergunte: é **Pessoa**, **Vínculo**, **Workspace**, **capacidade** ou **dado operacional**?
+Se não encaixa, é candidata a má-classificação.
+
+## Anti-padrões
+- ❌ Criar tabela-entidade que espelha a pessoa por workspace (repetir o erro de `dentistas`).
+- ❌ Dado operacional sem `clinica_id`. ❌ Identidade fora de `usuarios`.
+</content>

ScoreOdonto_Skills_Enterprise/FASE_08_AUDITORIA/SKILL_Fluxos.md

@@ -0,0 +1,47 @@
+# SKILL — Auditoria de Fluxos
+
+> Objetivo: ensinar a **mapear o fluxo de negócio ponta a ponta antes de alterar** — sobretudo o do dinheiro.
+> Regra Nº1: não quebrar o que funciona. Toda mudança em fluxo financeiro exige mapeamento prévio.
+
+## Fluxo principal (núcleo — verificado no código)
+```
+Lead ─converter→ Paciente + Agendamento ─presença→ Procedimento Realizado
+   → Financeiro RECEITA (origem='procedimento', flag sem_comissao)
+   → Comissão = (base − custo_lab) × %   [comissao_regras + computeComissoes]
+   → Repasse FECHADO → pagar → Financeiro DESPESA (origem='repasse', centro_custo='COMISSÕES')
+```
+Ramos: Orçamento → Contrato → `gerar-cobranca` → Financeiro; Glosas sobre recebíveis de convênio.
+
+## Pontos sensíveis (não quebrar)
+1. **RECEITA é opcional** no procedimento (`valor>0` e `gerarLancamento!==false`) — alterar isso muda o caixa.
+2. **`sem_comissao`** propaga garantia/reabertura e o repasse pago (evita recomissionar). Manter.
+3. **Repasse cancelado estorna** a despesa (soft-delete). Preservar a reversibilidade.
+4. **Anti-overbooking** na conversão de lead e na agenda — não remover a checagem.
+5. **Marketplace**: só Tutoria captura pagamento (MercadoPago); Salas tem `valor` sem gateway.
+
+## Como auditar um fluxo (comandos)
+```bash
+# Achar o handler de uma etapa
+grep -n "repasses/fechar\|procedimentos-realizados\|leads/:id/converter" backend/server.js
+# Ver o que cada etapa INSERE/ATUALIZA
+grep -nE "INSERT INTO (financeiro|repasses|procedimentos_realizados)" backend/server.js
+# Conferir auditoria
+grep -n "registrarAudit" backend/server.js | head
+```
+
+## Checklist antes de alterar um fluxo
+1. Onde começa, onde termina, o que cada etapa grava (tabela + colunas)?
+2. Há `audit_log` (`registrarAudit`) na etapa? Manter.
+3. A mudança afeta comissão/repasse/caixa? Mapear o impacto a jusante.
+4. Existe reversão (estorno/soft-delete)? Não quebrá-la.
+5. Validar em `dev.scoreodonto.com` com banco `pgdev` antes de qualquer promoção.
+
+## Anti-padrões
+- ❌ Alterar geração de RECEITA/DESPESA sem mapear o efeito em Comissões/Repasses.
+- ❌ Remover flags `sem_comissao`/`deleted_at` (quebram não-duplicação e estorno).
+- ❌ Mexer no fluxo sem reproduzir ponta a ponta em DEV.
+
+## Entregável
+Diagrama Mermaid do fluxo + tabela etapa→tabela→efeito + riscos. (Modelo:
+`documentação/MAPA-FUNCIONAL-COMPLETO.md`, Etapas 4 e 8.)
+</content>

ScoreOdonto_Skills_Enterprise/FASE_08_AUDITORIA/SKILL_Performance.md

@@ -0,0 +1,28 @@
+# SKILL — Auditoria de Performance
+
+> Onde olhar antes de otimizar. Sem micro-otimização cega — medir primeiro.
+
+## Pontos de atenção reais
+- **`server.js` monolítico** (~516 KB): carga cognitiva alta, mas não é gargalo de runtime por si.
+- **Guards fazem queries por request**: `tenantGuard` (1 SELECT em `vinculos`) + `requireCapability` (1–2
+  SELECTs em `usuarios`/`vinculos`/`funcoes`). Aceitável; se virar gargalo, considerar cache curto do papel.
+- **Catálogos/listas**: `GET /api/{procedimentos,especialidades,planos,dentistas,pacientes,agendamentos}` —
+  garantir índices em `clinica_id` e filtros corretos.
+- **PostGIS**: busca por proximidade (salas) precisa de índice GIST em `geo`.
+- **Cache DragonflyDB** (`/1`): usado para acelerar; `/api/health` reporta latência de banco e cache.
+
+## Como auditar
+```bash
+grep -niE "CREATE INDEX" backend/server.js                 # índices existentes
+grep -niE "SELECT .* FROM (pacientes|agendamentos)" backend/server.js | head   # queries quentes
+curl -s https://<projeto>/api/health   # latency_ms de database/cache
+```
+
+## Regras obrigatórias
+1. **Medir** (latências do `/api/health`, EXPLAIN) antes de otimizar.
+2. Índice em toda coluna usada em filtro frequente (`clinica_id`, FKs, status).
+3. Não introduzir N+1 em loop de query; preferir `IN`/JOIN.
+
+## Anti-padrões
+- ❌ Otimizar sem medir. ❌ Remover guard "para acelerar" (quebra segurança). ❌ Lista sem filtro por `clinica_id`.
+</content>

ScoreOdonto_Skills_Enterprise/FASE_08_AUDITORIA/SKILL_Permissoes.md

@@ -0,0 +1,36 @@
+# SKILL — Auditoria de Permissões (RBAC)
+
+> Como o controle de acesso REAL funciona hoje e como auditá-lo. Herda de
+> `../FASE_01_ARQUITETURA/SKILL_RBAC.md`. Implementado no backend nesta stack.
+
+## Três planos de autorização (backend)
+1. **Identidade** — `authGuard`: valida o JWT (assinado com `JWT_SECRET`), popula `req.authUser.userId`.
+2. **Tenant** — `tenantGuard`: valida que o usuário tem **vínculo** com a `clinica_id` pedida (ou é dono da
+   sala); seta `req.clinicaId`. Sem vínculo → 403 `[TENANT VIOLATION]`.
+3. **Cargo (capability)** — `requireCapability(cap)` / `requireCapabilityRow(cap, tabela)` /
+   `requireCapabilityFromOrders(cap, tabela)`: exige a capability no workspace ativo. **Superadmin** → `superadminGuard` (checa `usuarios.role` no banco).
+
+## `capabilityCore` (espelha o `isViewAllowed` do frontend)
+- superadmin global → ok;
+- dono (`donoclinica`/`donoconsultorio`/`admin`, `CAP_OWNER_ROLES`) → ok;
+- cargo com `funcoes.permissoes` (JSONB) explícitas → ok se inclui a capability;
+- senão, **mapa padrão por papel** (`CAP_DEFAULTS`, cópia fiel do frontend).
+
+## Cobertura (99 rotas gateadas)
+financeiro (`'financeiro'`/`'comissoes'`/`'glosas'`), equipe (`'gestao-equipe'`), cadastros
+(`'dentistas'`/`'especialidades'`/`'procedimentos'`/`'planos'`, incl. `/reorder`), operação clínica
+(`'agenda'`/`'leads'`), orçamentos/contratos. Marketplace (salas/propostas) = autorização por **posse** no handler.
+
+## Como auditar
+```bash
+grep -nE "tenantGuard|authGuard|requireCapability|superadminGuard" backend/server.js   # guards por rota
+grep -nE "CAP_DEFAULTS|CAP_OWNER_ROLES" backend/server.js                              # matriz de papéis
+```
+Regra de ouro: **a capability do backend tem que casar com o `isViewAllowed`/Sidebar do frontend**.
+
+## Anti-padrões
+- ❌ Rota sensível só com `tenantGuard` (membersia ≠ cargo).
+- ❌ `authGuard` puro em rota que toca dado de clínica (falta tenant).
+- ❌ Capability no backend divergente do menu do frontend.
+- ❌ Confiar em estado do cliente (`localStorage`/preview) para autorizar.
+</content>

ScoreOdonto_Skills_Enterprise/FASE_08_AUDITORIA/SKILL_Rotas.md

@@ -0,0 +1,43 @@
+# SKILL — Auditoria de Rotas
+
+> Objetivo: ensinar qualquer agente a **mapear e entender as rotas antes de alterar** — front e back.
+> Regra Nº1: não quebrar o que funciona. Sempre Auditoria → Planejamento → Aprovação.
+
+## Onde a verdade está
+- **Frontend (navegação):** `frontend/App.tsx` — `ROUTE_MAP` (URL→view), `VIEW_TO_ROUTE` (view→URL),
+  `renderView()` (view→componente), `isViewAllowed()` (RBAC), e o filtro de menu em `components/Sidebar.tsx`.
+  Não há `react-router` — o roteamento é próprio.
+- **Backend (API):** `backend/server.js` — **277 rotas** `app.<método>('/api/...')`, quase todas com `tenantGuard`.
+
+## Como mapear (comandos de auditoria)
+```bash
+# Rotas de API (método + caminho)
+grep -oE "app\.(get|post|put|delete|patch)\('[^']+" backend/server.js | sort -u
+# Rotas do frontend (URL → view)
+sed -n '/ROUTE_MAP/,/};/p' frontend/App.tsx
+# Permissões por papel
+sed -n '/isViewAllowed/,/^  };/p' frontend/App.tsx
+sed -n '/menuItems/,/];/p' frontend/components/Sidebar.tsx
+```
+
+## Checklist antes de mexer numa rota
+1. A URL existe em **ambos** `ROUTE_MAP` e `VIEW_TO_ROUTE`? (senão deep-link quebra)
+2. Qual `isViewAllowed`/menu libera essa view e para quais papéis?
+3. Qual rota de API ela consome? Tem `tenantGuard` (escopo de clínica)?
+4. Quais tabelas a rota toca? (ver `SKILL_Banco.md`/`SKILL_Entidades.md`)
+5. Alterou acesso no back? **Espelhe** em `isViewAllowed` + `Sidebar` no mesmo PR.
+
+## Débitos conhecidos a vigiar (já auditados)
+- `/comissoes`, `/glosas`, `/cadastro-dentista`: existem em `VIEW_TO_ROUTE` mas **faltam em `ROUTE_MAP`**
+  → deep-link/refresh cai em `dashboard`. (Documentado em `MAPA-FUNCIONAL-COMPLETO.md`.)
+- `/admin/sync`: rota existe, mas `isViewAllowed` retorna `false` sempre (tela inacessível).
+
+## Anti-padrões
+- ❌ Adicionar view sem registrar nas DUAS direções (`ROUTE_MAP` + `VIEW_TO_ROUTE`).
+- ❌ Liberar tela no menu sem proteger a rota de API correspondente.
+- ❌ Alterar caminho de API sem buscar todos os consumidores no frontend (`services/backend.ts`).
+
+## Entregável da auditoria
+Tabela URL → view → componente → papéis → rota(s) de API → tabelas, + riscos. (Modelo:
+`documentação/MAPA-FUNCIONAL-COMPLETO.md`, Etapa 1.)
+</content>

ScoreOdonto_Skills_Enterprise/FASE_09_OBSERVABILIDADE/SKILL_Diagnosticos.md

@@ -0,0 +1,28 @@
+# SKILL — Diagnósticos (runbook de incidente)
+
+> Passo a passo quando algo quebra. Combina Health, Logs, Deploy Imutável.
+
+## Triagem rápida
+1. `GET /api/health` — `database down` (503)? `cache degraded`? `version` esperada?
+2. `GET /api/version` — bate com a tag que deveria estar no ar?
+3. `docker ps` (rootless) — container `Up`? reiniciando (`RestartCount`)?
+4. `docker logs --tail 80 <container>` — erro no boot? `[PG]`/`[DRAGONFLY]` conectaram?
+
+## Causas comuns (reais nesta stack)
+- **`env file .secrets/.env not found`** → falta o env_file no host (VPS1). Copiar manualmente (fora do git).
+- **`database down`** → Postgres VPS3 inacessível (WireGuard) ou credencial errada.
+- **`cache down`** → Dragonfly/`ping()` (degradável; não derruba).
+- **Migração** falhou no boot → ver log `[MIGRATION]`.
+
+## Recuperação
+- App quebrado pós-deploy → **rollback por imagem** (segundos): `deploy-prod.sh <ref-anterior>` (ver Deploy Imutável).
+- Dado corrompido → restaurar `pg_dump` de `/home/deploy/backups/` (caso extremo).
+
+## Regras obrigatórias
+1. Diagnosticar com `/api/health` + logs **antes** de mexer.
+2. Preferir **rollback de imagem** a "consertar em produção no quente".
+3. Reproduzir/testar a correção no `dev` (`pgdev`) antes de promover.
+
+## Anti-padrões
+- ❌ Editar código direto na VPS1. ❌ Mexer no banco de produção sem backup. ❌ Deploy às cegas sem health.
+</content>

ScoreOdonto_Skills_Enterprise/FASE_09_OBSERVABILIDADE/SKILL_HealthChecks.md

@@ -0,0 +1,26 @@
+# SKILL — Health Checks
+
+> Como saber se o app está vivo e saudável, sem SSH. Fonte: `documentos-unicos/deploy/versionamento.md`.
+
+## Endpoint real
+`GET /api/health` → `{ status, version, commit, environment, uptime_s, checks }`:
+- **`database`** é crítico: se cair → `status: down` + **HTTP 503**.
+- **`cache`** (DragonflyDB) é opcional: se cair → `status: degraded` (HTTP 200); `disabled` se desligado.
+- Cada check traz `latency_ms` — útil para perceber lentidão de banco/cache.
+
+## Como usar
+```bash
+curl -s https://<projeto>/api/health        # produção
+curl -s https://dev.<projeto>/api/health    # dev
+```
+
+## Regras obrigatórias
+1. **Validar `/api/health` após todo deploy** (e na rotina de monitoramento).
+2. `database down` (503) é incidente → investigar conexão VPS1→VPS3 / Postgres.
+3. `cache down/degraded` não derruba o app, mas registre (ex.: pré-existente no RX — `redis.ping()`).
+4. Não remover/alterar o contrato do `/api/health` (monitor externo depende dele).
+
+## Anti-padrões
+- ❌ Deploy sem checar health. ❌ Tornar o cache crítico (deve ser degradável).
+- ❌ Vazar segredo/detalhe interno no payload do health.
+</content>

ScoreOdonto_Skills_Enterprise/FASE_09_OBSERVABILIDADE/SKILL_Logs.md

@@ -0,0 +1,28 @@
+# SKILL — Logs & Auditoria
+
+> Onde está o rastro do que aconteceu. Dois níveis: log de aplicação e trilha de auditoria persistida.
+
+## Auditoria de negócio (persistida)
+- Tabela **`audit_log`** (`clinica_id, entidade, entidade_id, acao, actor_id, actor_nome, detalhes, at`),
+  gravada por `registrarAudit(...)` em mutações sensíveis (procedimento, repasse, comissão, contrato, equipe…).
+- **Imutável** — é o rastro de quem fez o quê. Mutações financeiras/RBAC devem registrar.
+- `login_log` registra acessos (visível em SuperAdmin → Acessos).
+
+## Log de aplicação (runtime)
+- `console.*` no `server.js` (boot, `[PG] Connected`, `[DRAGONFLY] Connected`, `[WS] broadcast`,
+  `[TENANT VIOLATION]`, `[CLINICA] Created`…). Visível em `docker logs <container>` (rootless).
+
+## Como usar
+```bash
+DOCKER_HOST=unix:///run/user/1000/docker.sock docker logs --tail 50 <container>
+grep -n "registrarAudit" backend/server.js   # pontos auditados
+```
+
+## Regras obrigatórias
+1. Toda mutação sensível (dinheiro, cargo, contrato) chama `registrarAudit`. **Não** remover.
+2. **Nunca** logar segredo/credencial/token.
+3. `[TENANT VIOLATION]` no log = tentativa de acesso cross-tenant → investigar.
+
+## Anti-padrões
+- ❌ Mutação sensível sem auditoria. ❌ Logar dado pessoal/segredo. ❌ Apagar `audit_log`.
+</content>

ScoreOdonto_Skills_Enterprise/FASE_09_OBSERVABILIDADE/SKILL_VersionamentoRuntime.md

@@ -0,0 +1,26 @@
+# SKILL — Versionamento em Runtime
+
+> De onde vem a versão exibida e por que ela é confiável. Herda de `../FASE_07_INFRA/SKILL_BuildOnce.md`.
+
+## Como funciona (real)
+- A versão **nasce da tag git** (`vX.Y.Z`) e é **injetada no deploy em runtime** (`APP_VERSION`), não escrita à
+  mão (não existe mais `constants.ts`/`update-version.js`).
+- `commit` e `build` são **carimbados na imagem** (imutáveis, propriedade do artefato).
+- Em **DEV** aparece `dev`; o número só existe em produção.
+- Exposição: `GET /api/version` → `{ name, version, commit, build, environment }`. O frontend **não embute**
+  versão — lê de `/api/version` (fonte única = backend). Mostrada no rodapé (canto inf. direito) e em
+  Configurações → "Sobre o sistema".
+
+## Como verificar
+```bash
+curl -s https://<projeto>/api/version   # → vX.Y.Z · <commit> · PROD
+```
+
+## Regras obrigatórias
+1. **Não** hardcodar versão em arquivo — só a tag define.
+2. A MESMA imagem promovida sob a tag = `commit`/`build` imutáveis + `version`/`environment` em runtime.
+3. Conferir `/api/version` após deploy (bate com a tag promovida?).
+
+## Anti-padrões
+- ❌ Escrever versão manualmente. ❌ Frontend embutir versão. ❌ Rebuild na tag (quebra o build-once).
+</content>

ScoreOdonto_Skills_Enterprise/FASE_10_ROADMAP/SKILL_Backlog.md

@@ -0,0 +1,26 @@
+# SKILL — Backlog (Roadmap)
+
+> Itens reais levantados nas auditorias e na sessão de hardening. Não inventar; manter atualizado.
+
+## Segurança / produção (parcialmente feito em DEV)
+- ✅ JWT rotacionado (dev+prod); `.env` fora do git; `.dockerignore`; senhas fora do compose; RBAC por cargo (99 rotas).
+- ⬜ Provisionar `SCOREO_DB_PASS` na VPS1; push imagem limpa `v1.0.19`; rotacionar DB/cache/API keys.
+
+## Correções (do MAPA-FUNCIONAL)
+- ⬜ Deep-links residuais já tratados (`/comissoes`, `/glosas`); revisar outros se surgirem.
+- ⬜ RECEITA de procedimento opcional → decidir se vira padrão (risco de caixa).
+- ⬜ Estado de plugins divergente cliente/servidor (`localStorage` vs `usuario_plugins`).
+
+## Modelagem (do AUDITORIA-ESTRATEGICA)
+- ⬜ `dentistas` como projeção da pessoa; `pacientes` com identidade (LGPD/jurídico antes).
+- ⬜ Unificar workspace (`clinicas`+`salas`); entidade "rede" acima da clínica.
+
+## Receita (do SKILL_Monetizacao)
+- ⬜ Gateway na Locação de Salas; recorrência das Assinaturas; marketplace premium.
+
+## Limpeza
+- ⬜ Órfã `OrthoReports.tsx`; `SyncView` desativada; `server.js.bak`/scripts legados.
+
+## Regra
+Backlog reflete a **realidade**; ao concluir, marcar ✅ com referência ao commit/PR.
+</content>

ScoreOdonto_Skills_Enterprise/FASE_10_ROADMAP/SKILL_Escalabilidade.md

@@ -0,0 +1,24 @@
+# SKILL — Escalabilidade (Roadmap)
+
+> O que o modelo suporta em 5 anos e onde estão os gargalos. Base: `AUDITORIA-ESTRATEGICA-MODELAGEM.md`.
+
+## O que JÁ escala (base Pessoa→Vínculo→Workspace)
+- Pessoa em **múltiplos workspaces** (N `vinculos`), workspace pessoal automático, salas/tutoria/marketplace.
+
+## Gargalos conhecidos
+| Cenário | Suporta? | Gargalo |
+|---|---|---|
+| Dentista em várias clínicas | parcial | `dentistas` **duplica a pessoa** por clínica (agenda/horários presos ao `dentistas.id`) |
+| Paciente entre clínicas | não | `pacientes` preso à clínica, sem identidade de pessoa (não-portável) |
+| Redes de clínicas | não | **não existe entidade "rede/grupo"** acima da clínica (workspaces são planos) |
+| Visão consolidada da pessoa | não | tenancy de `clinica_id` único impede agregar cross-clínica |
+| Profissionais temporários (delivery) | não | sem contrato/pagamento/vínculo temporário (ver `../FASE_02_NEGOCIO/SKILL_Delivery.md`) |
+| Locação/Tutoria/Marketplace | sim/parcial | falta captura de pagamento (salas) |
+
+## Direção (sem propor implementação)
+Consolidar a **Pessoa** como âncora única (unificar `dentistas`→projeção; paciente→identidade) destrava
+multi-clínica, redes e portabilidade. Coexistir os 2 modelos é o que gera as contradições de gravidade ALTA.
+
+## Anti-padrões
+- ❌ Duplicar a pessoa por workspace. ❌ Tratar clínica como raiz. ❌ Operação sem `clinica_id`.
+</content>

ScoreOdonto_Skills_Enterprise/FASE_10_ROADMAP/SKILL_Monetizacao.md

@@ -0,0 +1,25 @@
+# SKILL — Monetização (Roadmap)
+
+> O que gera (ou pode gerar) receita. Base: `documentação/MAPA-FUNCIONAL-COMPLETO.md` + `AUDITORIA-ESTRATEGICA-MODELAGEM.md`.
+
+## Três camadas de receita (estado real)
+1. **Receita da clínica** (operacional): produção, contratos/cobrança, recuperação de glosas.
+2. **Receita do profissional** (repasse de comissão).
+3. **Receita da PLATAFORMA**:
+   - **Tutoria** — MercadoPago + `comissao_pct`: **única automatizada hoje**. ✅
+   - **Assinaturas SaaS** (`assinaturas`/`superadmin/pricing`): existe, mas **manual** (sem gateway/recorrência).
+   - **Locação de salas** (`sala_reservas.valor`): registra valor, **sem captura de pagamento**.
+
+## Alavancas (ordem de retorno mais rápido)
+1. **Gateway na Locação de Salas** — reserva + `valor` já existem; falta cobrança + taxa da plataforma.
+2. **Recorrência das Assinaturas SaaS** — base multiempresa + pricing prontos; falta gateway/automação.
+3. **Marketplace de Profissionais premium** — taxa de match/destaque (hoje só mensagem).
+4. **Escalar Tutoria** (já fatura).
+
+## Regras
+- Toda lacuna de captura deve ser **sinalizada, não presumida como paga**.
+- Não misturar as 3 camadas (clínica ≠ profissional ≠ plataforma).
+
+## Anti-padrões
+- ❌ Assumir que reserva/assinatura foi paga. ❌ Construir cobrança fora do modelo Pessoa→Workspace.
+</content>

ScoreOdonto_Skills_Enterprise/FASE_10_ROADMAP/SKILL_Priorizacao.md

@@ -0,0 +1,22 @@
+# SKILL — Priorização (Roadmap)
+
+> Como decidir a ordem. Critérios concretos para esta stack.
+
+## Critérios (em ordem)
+1. **Não quebrar o que funciona** (REGRA Nº 1) — auditar impacto antes.
+2. **Segurança / pré-produção** primeiro (abrir a usuários reais exige base segura) — ver `SKILL_Backlog`.
+3. **Receita mais rápida com menor esforço** — alavanca onde a infra já existe (ex.: gateway de salas).
+4. **Destravar arquitetura** (unificar Pessoa) — alto valor, maior esforço/risco → deliberado, não no susto.
+5. **Esforço × risco × reversibilidade** — preferir mudanças aditivas e reversíveis (build-once/rollback).
+
+## Fluxo obrigatório por item
+`Auditoria → Planejamento → Aprovação → Implementação (em DEV/`pgdev`) → Validação → Promoção`.
+
+## Recomendação estratégica única (da auditoria)
+Assumir a **Pessoa como âncora** e **parar de manter o legado clínica-cêntrico em paralelo** — é a coexistência
+dos dois modelos que gera as contradições graves. Mas: só após segurança/produção estável e com aprovação.
+
+## Anti-padrões
+- ❌ Implementar sem auditoria/aprovação. ❌ Priorizar features novas sobre segurança pré-lançamento.
+- ❌ Refator arquitetural grande sem janela e rollback.
+</content>

backend/.dockerignore

@@ -0,0 +1,28 @@
+# Segredos e ambiente — NUNCA entram na imagem
+.env
+.env.*
+*.secret
+.secrets
+
+# Dependências e caches (reinstalados no build)
+node_modules
+npm-debug.log
+
+# Artefatos locais / backups / dados que não pertencem à imagem
+*.bak
+server.js.bak
+sessions/
+media/
+data/
+bkp/
+*.dump
+
+# Diagnóstico temporário
+test-db-users.js
+test-db-users.cjs
+pg-convert.js
+
+# Diversos
+.git
+.DS_Store
+*.log

backend/.env

@@ -1,45 +0,0 @@
-# ─────────────────────────────────────────────
-# Server
-# ─────────────────────────────────────────────
-PORT=8018
-NODE_ENV=development
-JWT_SECRET=scoreodonto_jwt_secret_forte_2026
-
-# ─────────────────────────────────────────────
-# PostgreSQL (Prisma)
-# ─────────────────────────────────────────────
-DATABASE_URL="postgresql://scoreodonto_user:clube67_scoreodonto_pass_9903@10.99.0.3:5432/scoreodonto?schema=public"
-
-# ─────────────────────────────────────────────
-# DragonflyDB (compatível com Redis)
-# ─────────────────────────────────────────────
-DRAGONFLY_URL=redis://:clube67_dragonfly_pass_9903@10.99.0.3:6379/1
-DRAGONFLY_TTL_SECONDS=86400
-
-# ─────────────────────────────────────────────
-# NATS JetStream
-# ─────────────────────────────────────────────
-NATS_URL=nats://10.99.0.3:4222
-
-# ─────────────────────────────────────────────
-# Temporal.io
-# ─────────────────────────────────────────────
-TEMPORAL_ADDRESS=10.99.0.3:7233
-TEMPORAL_NAMESPACE=default
-TEMPORAL_TASK_QUEUE=scoreodonto-queue
-
-# ─────────────────────────────────────────────
-# IA (OpenAI + Google Gemini)
-# ─────────────────────────────────────────────
-OPENAI_API_KEY=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
-GEMINI_API_KEY=AIza...
-
-# ─────────────────────────────────────────────
-# WhatsApp / Baileys
-# ─────────────────────────────────────────────
-BAILEYS_SESSIONS_PATH=/home/deploy/scoreodonto-sessions
-
-# ─────────────────────────────────────────────
-# Frontend (CORS)
-# ─────────────────────────────────────────────
-FRONTEND_URL=http://localhost:3013

backend/.env.example

@@ -0,0 +1,26 @@
+# Modelo de variáveis de ambiente do backend (SEM segredos).
+# Copie para .env e preencha com valores REAIS. O .env NÃO é versionado.
+PORT=8018
+NODE_ENV=production
+
+# Segredo de assinatura dos tokens JWT — gerar com: openssl rand -hex 48
+JWT_SECRET=
+
+# Banco e cache (não versionar valores reais)
+DATABASE_URL=postgresql://USER:SENHA@HOST:5432/BANCO?schema=public
+DRAGONFLY_URL=redis://:SENHA@HOST:6379/1
+DRAGONFLY_TTL_SECONDS=3600
+
+# Mensageria / workflows
+NATS_URL=nats://HOST:4222
+TEMPORAL_ADDRESS=HOST:7233
+TEMPORAL_NAMESPACE=default
+TEMPORAL_TASK_QUEUE=scoreodonto
+
+# Chaves de IA (rotacionáveis apenas nos painéis dos provedores)
+OPENAI_API_KEY=
+GEMINI_API_KEY=
+
+# Caminhos / front
+BAILEYS_SESSIONS_PATH=/app/sessions
+FRONTEND_URL=https://scoreodonto.com

dev-build.sh

@@ -0,0 +1,40 @@
+#!/usr/bin/env bash
+# =============================================================================
+# Build + sobe o ambiente de DEV (porta 8020 / dev.scoreodonto.com) carimbando
+# a VERSÃO a partir do git — para que /api/version (e o rótulo no app) deixe de
+# mostrar apenas "dev".
+#
+#   Uso (NA VPS):   ./dev-build.sh
+#
+# Diferença p/ produção: a prod consome imagem versionada e injeta a tag em
+# runtime (deploy-prod.sh). Em DEV buildamos local, então derivamos a versão do
+# git AQUI (no host, onde o .git existe) e passamos como build-args do compose.
+# =============================================================================
+set -euo pipefail
+cd "$(dirname "$0")"
+
+export DOCKER_HOST=unix:///run/user/1000/docker.sock
+
+# Versão semântica + commit + carimbo de build, derivados do git.
+#   APP_VERSION -> ex.: v1.0.18-16-g6adf353 (tag mais próxima + distância + sha)
+#   GIT_COMMIT  -> sha curto
+export APP_VERSION="$(git describe --tags --always --dirty 2>/dev/null || echo dev)"
+export GIT_COMMIT="$(git rev-parse --short HEAD 2>/dev/null || echo dev)"
+export BUILD_TIME="$(date -u +%Y-%m-%dT%H:%M:%SZ)"
+export APP_ENV="DEV"
+
+echo "──────────────────────────────────────────────────────────────"
+echo " Build ScoreOdonto → DEV (porta 8020)"
+echo "   APP_VERSION = $APP_VERSION"
+echo "   GIT_COMMIT  = $GIT_COMMIT"
+echo "   BUILD_TIME  = $BUILD_TIME"
+echo "──────────────────────────────────────────────────────────────"
+
+docker compose up -d --build scoreodonto-backend scoreodonto-frontend nginx
+
+echo
+echo -n "  versão no ar (DEV): "
+sleep 8
+curl -s --max-time 10 http://localhost:8020/api/version || echo "(ainda subindo — confira em alguns segundos)"
+echo
+echo "✅ DEV buildado com versão carimbada."

doc/ANALISE-AREA-RECEPCAO-TC.md

@@ -0,0 +1,158 @@
+# Análise — Área da Recepção / Coordenação de Tratamentos (Treatment Coordinator)
+
+> Gatilho (23/jun/2026): `recep.consulttclinic@gmail.com` lançou uma prótese mas **não tinha
+> a aba para acompanhá-la**. Análise do gap + recomendação fundamentada em modelos validados
+> de software odontológico. Conecta com `FASE2-PROTETICO-AREA.md` (o outro lado do fluxo).
+
+---
+
+## 1. Diagnóstico (DEV `scoreodonto_dev`)
+
+| Entidade | Achado |
+|---|---|
+| Dono | `consulttclinic@gmail.com` → *Rui Cesar*, `donoclinica` |
+| Funcionária | `recep.consulttclinic@gmail.com` (`u_1780962424310_cqsxn`), role `funcionario`, vínculo na **CONSULTT CLINIC LTDA** (`c_1780871001549_koqa3o`) |
+| Cargo | função "Recepcionista" (`fnc_1780962382528_m28go`) |
+| Permissões (antes) | `["agenda","ortodontia","contratos","tratamentos","pacientes","lancar-gto"]` |
+| Prótese lançada | OS `pos_1782228267898_zgfzn` — Prótese Total, paciente ABIGAIR, R$600, protético "Zeca Andrade Fake", status `solicitado`, **via GTO** (`gto_item_id=QOJWR6D`) |
+
+**Gap exato:** o cargo tinha `lancar-gto` (lançar) mas **não** `proteses` (acompanhar). O RBAC da
+`Sidebar.tsx` é literal (`return wsPerms.includes(item.id)`), então a OS criada por ela ficava
+**invisível** para ela própria. A Fase 1 (GTO→OS) funcionou; o problema era de **configuração de
+cargo**, não de arquitetura.
+
+---
+
+## 2. Modelos validados (referência externa)
+
+- **Papel = "Treatment Coordinator" + Front Desk.** É a ponte entre paciente e equipe clínica:
+  sequencia planos multi-etapa, conduz o aceite do caso (case acceptance), arranjo financeiro e
+  follow-up até a conclusão — exatamente "gerir tratamentos" de ponta a ponta.
+- **RBAC por papel é o padrão.** Permissões mapeadas a papéis, não a indivíduos; o front desk
+  recebe agenda/cadastro/cobrança, tipicamente **sem notas clínicas**. O ScoreOdonto já faz isso
+  via `funcoes.permissoes[]`.
+- **Prótese = "Lab Case", acompanhada pelo front desk.** No Dentrix Lab Case Manager: clínico cria
+  a prescrição → status *Sent* → **o front desk muda para *Received* quando volta do lab** →
+  *Finished* ao assentar. Ou seja: acompanhar a OS de prótese é, por modelo consagrado, **atribuição
+  da recepção** — o acesso que faltava.
+
+Fontes:
+- The Role of a Treatment Coordinator — https://www.dentalmanagers.com/blog/role-of-treatment-coordinator-in-dental-practice/
+- What Does a Treatment Plan Coordinator Do? — https://www.teero.com/blog/treatment-plan-coordinator
+- Dental Software User Permissions (Curve) — https://www.curvedental.com/blog/dental-software-user-permissions
+- RBAC in Healthcare — https://www.accountablehq.com/post/role-based-access-control-rbac-in-healthcare-benefits-examples-and-best-practices
+- Manage Your Lab Cases in Dentrix — https://magazine.dentrix.com/manage-your-lab-cases-in-dentrix/
+- Open Dental — Lab Cases — https://www.opendental.com/manual/labcasemanage.html
+
+---
+
+## 3. Ação aplicada — Nível 1 (configuração, sem código)
+
+✅ **Aplicado no DEV em 23/jun/2026.** Função "Recepcionista" da CONSULTT CLINIC LTDA atualizada:
+
+```sql
+UPDATE funcoes
+   SET permissoes = '["agenda","pacientes","tratamentos","ortodontia","proteses","lancar-gto","orcamentos","contratos"]'
+ WHERE id = 'fnc_1780962382528_m28go';   -- UPDATE 1
+```
+
+Acréscimos: **`proteses`** (acompanhar a OS que ela lança) e **`orcamentos`** (case acceptance —
+coração do papel TC). Efeito imediato: a OS `pos_1782228267898_zgfzn` passa a aparecer para ela.
+
+> Escopo: alteração **só no DEV**. Não há mudança de código nem migração — é dado de configuração.
+> Para refletir em outras clínicas, ajustar o cargo equivalente de cada uma (ou rever o template
+> de cargos padrão, se existir).
+
+---
+
+## 3b. Causa raiz (investigação 23/jun) — `proteses` não é concedível pela UI
+
+A correção de dado acima trata o sintoma. A **causa raiz** é um bug de configuração de RBAC:
+
+- Cargos **não** têm seed no backend (signup não cria funções). São criados manualmente pelo
+  dono em Gestão de Equipe (`POST → INSERT INTO funcoes`, `server.js:806`), partindo de 4
+  templates do frontend (`GestaoEquipeView.tsx:96`).
+- **Nenhum** template inclui `proteses`: RECEPÇÃO (`dashboard,agenda,pacientes,leads,orcamentos`),
+  AUXILIAR (`...,ortodontia,tratamentos`), FINANCEIRO (`...,financeiro,relatorios,lancar-gto`),
+  GERENTE (`[...TODAS_PAGINAS]`).
+- **Raiz:** `proteses` **não está em `PAGINAS_RBAC`** (`GestaoEquipeView.tsx:57`), a lista mestre
+  de páginas atribuíveis. Como `TODAS_PAGINAS = PAGINAS_RBAC.flatMap(...)`, **nem o GERENTE /
+  "MARCAR TODAS"** concede prótese. ⇒ **É impossível um dono dar `proteses` a um funcionário
+  pela interface** — só via UPDATE direto no banco (o que foi feito na §3).
+- Também ausentes da lista atribuível, embora em uso: **`contratos`** (a função tinha — legado),
+  `comissoes`, `glosas`.
+
+**Resposta à pergunta "o cargo Recepcionista padrão nasce sem proteses?":** Sim — e mais,
+*nenhum* cargo consegue tê-la pela UI hoje.
+
+### Fix de raiz (código) — ✅ aplicado e validado no DEV (23/jun)
+Em `frontend/views/GestaoEquipeView.tsx`:
+- `PAGINAS_RBAC`, grupo `ATENDIMENTO`: + `{ key: 'proteses', label: 'PRÓTESES' }` e
+  `{ key: 'contratos', label: 'CONTRATOS' }` → agora concedíveis pela UI (e entram em
+  `TODAS_PAGINAS`/GERENTE/"MARCAR TODAS").
+- Templates: RECEPÇÃO ganhou `contratos, lancar-gto, proteses`; AUXILIAR ganhou `proteses`
+  (alinhado ao papel TC).
+
+**Validação:** `vite build` transformou 2382 módulos OK; container DEV rebuildado e no ar; o
+bundle servido pelo nginx DEV (`index-*.js`, alvo de `dev.scoreodonto.com`) contém
+`key:"proteses",label:"PRÓTESES"` e a string `proteses` nos 3 pontos editados. Cargos padrão
+passam a nascer coerentes — sem UPDATE manual por clínica.
+
+> ⚠️ Pendente de commit + deploy à produção (a mudança está só no DEV). Os fixes de **dado**
+> (§3, função da CONSULTT CLINIC) continuam sendo só-DEV e não se propagam por este fix de código.
+
+## 4. Recomendação — Nível 2 (estrutural, "Fase 3")
+
+Em vez de abas soltas (`tratamentos`, `proteses`, `ortodontia`), um **hub de Coordenação de
+Tratamentos por paciente**: pipeline único com o status de cada frente (clínico / prótese-lab /
+orto), espelhando o "lab case visível para toda a equipe" do Dentrix. View nova que **agrega o que
+já existe** (`tratamentos` + `protese_os` + ortodontia por paciente) — sem dado novo.
+
+## 5. Conexão com a Fase 2
+Dois lados do mesmo fluxo, unidos pela mesma `protese_os`:
+- **Fase 2** → casa do **protético** (quem produz; avança status na Bancada).
+- **Esta análise** → **recepção/TC** (quem encomenda e acompanha; lê o status no hub).
+O status que o lab avança é o mesmo que a recepção lê — o "Lab Case Manager" repartido entre os papéis.
+
+---
+
+## 6. Salas: acesso do funcionário corrigido + bloqueio de manutenção (23/jun)
+
+Gatilho: a mesma recepcionista aparecia com **MINHAS SALAS** e **ALUGAR SALAS** (gestão de
+locação, de titular) e deveria ter apenas a **agenda da sala** e o **bloqueio para manutenção**.
+
+### 6a. Bug — vazamento dos menus de locação ✅ corrigido (`Sidebar.tsx`)
+`MINHAS SALAS` (locador) e `ALUGAR SALAS` (locatário) eram empurrados a "todos menos
+superadmin" (`Sidebar.tsx:42`), vazando para **funcionário e paciente** — papéis que não são
+titulares de sala. Passaram a exibir apenas a `PAPEIS_LOCACAO`
+(`donosala/donoclinica/donoconsultorio/admin/dentista/biomedico/protetico`). O backend já era
+seguro por ownership; era vazamento só de UI.
+
+### 6b. Feature — acesso operacional + manutenção ✅ implementada e validada no DEV
+Não existia caminho para "funcionário vê só a agenda" nem "bloqueio para manutenção" — foram
+criados (modelos de mercado: *Dentrix/Open Dental Lab... não; aqui é gestão de espaço* — o
+padrão é **front desk opera a agenda da sala sem tocar no financeiro do locador**).
+
+- **Acesso operacional** (`server.js` `listarWorkspaces`): sala cuja `clinica_id` é uma clínica
+  onde o usuário tem vínculo (e ele **não** é o dono) entra como workspace `tipo='sala'` com
+  `papel_sala='operador'`. O `SalaHomeView` detecta o modo operador e **esconde recebíveis,
+  relatório e baixa** — mostra só a **agenda** + botão de bloqueio.
+- **Bloqueio de manutenção** (`POST /api/salas/:id/manutencao`): reserva `tipo='manutencao'`
+  (coluna nova, default `'locacao'`), `valor=0`, nasce `'confirmada'` (sem aprovação) e **não
+  gera recebível**. Acesso: dono **ou** membro com vínculo na clínica da sala. Reaproveita o
+  anti-conflito de horário (409) e o cancelamento por solicitante/unidade. A agenda renderiza
+  o bloqueio em **cinza** (legenda "Manutenção").
+
+**Validação ponta a ponta (DEV, JWT real da recepcionista, sala de teste vinculada à clínica):**
+| Caso | Resultado |
+|---|---|
+| Sala da clínica vira workspace operador dela | ✅ query retorna a sala |
+| POST bloqueio | ✅ `status:confirmada, tipo:manutencao` |
+| GET agenda mostra bloqueio + motivo | ✅ `valor:0, motivo:"Conserto do equipo"` |
+| Conflito de horário | ✅ HTTP 409 |
+| Não gera financeiro | ✅ 0 lançamentos |
+
+Commits: `fix(salas)` (menu) + `feat(salas)` (operador + manutenção). Backend e frontend no ar
+no DEV; dados de teste limpos.
+
+> ⚠️ Pendente de push + deploy (produção segue em v1.0.19).

doc/DEPLOY-PRODUCAO.md

@@ -1,117 +0,0 @@
-# Deploy & Versionamento — Runbook ScoreOdonto
-
-> Auditado contra o sistema em **17/jun/2026**. Cada item carrega seu **status real**.
->
-> **Legenda:** ✅ EM PRODUÇÃO · 🧪 EM DEV (não promovido) · 🎯 ALVO (não implementado).
->
-> **Produção AGORA:** `v1.0.16 · commit 471c2c2 · 2026-06-17` (`curl https://scoreodonto.com/api/version`).
-> Modelo **Build Once → Promote → Deploy** completo — Passo 5 validado em v1.0.16. Tudo abaixo ✅.
-
----
-
-## 1. O modelo  ✅
-
-> **Push** na `main` builda **uma vez** e publica por **commit**; a **tag `vX.Y.Z`** **re-tagueia** esse mesmo artefato (sem rebuild) e deploya. **Produção nunca builda — só executa imagens.**
-
-```
- PUSH main (commit C)                 TAG vX.Y.Z (no commit C)
-        │                                     │
-        ▼                                     ▼
-   CI: build (1x)                       CI: promote (SEM build) ✅
-   publica :C + :latest                 re-tag :C → :vX.Y.Z (MESMO digest) + deploy
-        ▼                                     ▼
-   registry                             VPS1: pull :vX.Y.Z + up --no-build
-                                        APP_VERSION=tag injetada em runtime
-```
-Prova (v1.0.16): `:v1.0.16` tem **digest idêntico** a `:471c2c2` — a tag é só um rótulo sobre a imagem já testada.
-
----
-
-## 2. Estado por componente (verificado)
-
-| Componente | Status | Detalhe |
-|---|---|---|
-| Infra VPS1/3/4 + Docker rootless | ✅ | Mapa na §3 |
-| Registry (`git.clube67.com/ruicesar/...`) | ✅ | Ver `REGISTRY.md` |
-| CI: job `build` publica por **commit** em push (sem `APP_VERSION`) | ✅ | `.gitea/workflows/build.yml` (runner `vps4-builder`) |
-| Job `promote` por tag: re-tag `:<commit>→:vX.Y.Z` (sem rebuild) + deploy | ✅ | validado em v1.0.16 (`:v1.0.16` == `:471c2c2`) |
-| Validação de integridade no promote (commit existe? digest igual? front+back mesmo commit) | ✅ | falha se o commit não foi pushado |
-| Produção não builda (`image:` + `pull` + `up --no-build`) | ✅ | `docker-compose.prod.yml` |
-| Banco DEV isolado em `pgdev`; prod no Postgres da VPS3 | ✅ | Ver `BANCO-DEV-ESTRATEGIA.md` |
-| Versão em runtime (`/api/version`) → Configurações + telas públicas | ✅ | `useAppVersion()`; sem `APP_VERSION` manual |
-| `APP_VERSION`/`APP_ENV` injetados no deploy em runtime | ✅ | `compose.prod` `environment` |
-| Versão **nasce da tag git** (`constants.ts`/`update-version.js` removidos) | ✅ | Passo 5 |
-
----
-
-## 3. Mapa de máquinas ✅
-
-| Onde | Host | Papel | Docker |
-|---|---|---|---|
-| VPS1 | `10.99.0.1` | **Produção** (Traefik + apps) | rootless |
-| VPS3 | `10.99.0.3` | Postgres (prod) + Gitea + registry | — |
-| VPS4 | `10.99.0.4` | **Dev + Builder** (código; runner CI; `pgdev`) | rootless |
-
-- Repo: `ssh://git@10.99.0.3/ruicesar/scoreodonto.com.git`. Project Compose: `scoreodontocom`.
-
----
-
-## 4. De onde vem a versão (`/api/version`)
-
-```json
-{ "name": "ScoreOdonto API", "version": "v1.0.16", "commit": "471c2c2",
-  "build": "2026-06-17 10:35 UTC", "environment": "PROD" }
-```
-- **commit / build** = carimbados no **build** (imutáveis — identidade do artefato).
-- **version / environment** = **injetados no deploy em runtime** (a partir da tag). A mesma imagem é promovida sob qualquer tag, sem rebuild.
-- **Frontend** lê tudo de `/api/version` (`useAppVersion()`); não embute versão. Fonte única = backend.
-
----
-
-## 5. Runbook — subir um release ✅
-
-> ⚠️ **Regra de ouro:** confirme **DEV ou PRODUÇÃO**. `dev.scoreodonto.com` = VPS4 (banco `pgdev`). `scoreodonto.com` = VPS1 (real). **Nunca** `git push --force` na `main`. Push/tag exigem autorização explícita.
-
-```bash
-# 1) VPS4: validar em DEV
-cd /home/deploy/stack/scoreodonto.com
-node --check backend/server.js
-docker compose build scoreodonto-backend scoreodonto-frontend
-docker compose up -d --force-recreate scoreodonto-backend scoreodonto-frontend   # https://dev.scoreodonto.com
-
-# 2) commit + push → CI builda 1x e publica :<commit> + :latest (NÃO deploya)
-git add -A && git commit -m "feat: <descrição>"
-git push origin main
-
-# 3) tag = "aprovado p/ produção" → job PROMOTE re-tagueia :<commit>→:vX.Y.Z (SEM rebuild) + deploya
-#    (o número da versão é livre — não precisa casar com nenhum arquivo)
-git tag -a vX.Y.Z -m "release vX.Y.Z" && git push origin vX.Y.Z
-
-# 4) verificar (sem SSH)
-curl -s https://scoreodonto.com/api/version     # → vX.Y.Z · <commit> · PROD
-```
-
-**Backup do banco de PRODUÇÃO antes de releases sensíveis** (via container, pois não há shell na VPS3):
-```bash
-docker run --rm -e PGPASSWORD=<senha> -v /home/deploy/backups:/b postgres:18 \
-  pg_dump -h 10.99.0.3 -U scoreodonto_user -d scoreodonto -Fc -f /b/scoreodonto_$(date +%Y%m%d_%H%M).dump
-```
-
----
-
-## 6. Rollback ✅
-
-Por imagem, **sem rebuild** — na VPS1:
-```bash
-/home/deploy/stack/scoreodonto.com/deploy-prod.sh <tag-ou-commit-anterior>   # pull + up --no-build
-```
-⚠️ A referência confiável é o **commit** (`:<sha>`). Tags `:vX.Y.Z` antigas (pré-Passo 5) podem ter sido republicadas com código diferente — a partir do Passo 5, `:vX.Y.Z` é sempre um alias imutável do commit. Migrações são aditivas (voltar o código é seguro). Dump em `/home/deploy/backups/` só em extremo.
-
----
-
-## 7. Follow-ups (não bloqueiam)  🎯
-- `GET /api/health` (monitoramento/diagnóstico).
-- **Política de retenção** do registry (uma imagem `:<commit>` por push acumula).
-- Reconciliar o repo na VPS1 (working tree sujo, não afeta o deploy por imagem).
-
-Racional do modelo em `deploy.md`; histórico em `project-cicd-tag-promove-nao-rebuilda` (memória).

doc/FASE2-IMPL-2.0-2.1.md

@@ -0,0 +1,217 @@
+# Fase 2 — Detalhamento de implementação: passos 2.0 e 2.1
+
+> ✅ **IMPLEMENTADO e validado em DEV (23/jun/2026).** Commits `feat(protese): Fase 2 backend`
+> + `frontend`. Validações: registro de protético nasce `laboratorio`; backfill preenche
+> `laboratorio_id`; bancada roteia por lab (fallback por pessoa); entrega gera **par espelhado**
+> DESPESA(clínica)+RECEITA(lab) R$600, idempotente (409 na re-entrega); menu do lab no bundle.
+>
+> ⚠️ **Bug pré-existente achado e corrigido junto:** o INSERT da DESPESA de prótese (Fase 1, já
+> em produção v1.0.20) usava `paciente_nome` — coluna inexistente em `financeiro` (é
+> `pacientenome`). A entrega de OS com `custo>0` **abortava** em produção. Corrigido no mesmo
+> commit de backend. **Recomenda-se priorizar o deploy** por causa disso.
+
+
+> Companheiro de `FASE2-PROTETICO-AREA.md` (o modelo). Aqui está o **como**, a nível de
+> arquivo/função, fiel ao código atual de `backend/server.js` e `frontend/`.
+> Decisões aplicadas: **1 lab por protético**, **só terceirizado**, **receita espelhada na 2.1**.
+> Disciplina herdada da Fase 1: migrações aditivas/idempotentes; blocos novos em `try/catch`
+> que nunca derrubam o fluxo principal; `protetico_id` sempre preservado (fallback).
+
+---
+
+# PASSO 2.0 — Dados invisíveis (backfill `laboratorio_id`)
+
+Nenhuma mudança de UI. Objetivo: todo protético tem um workspace `tipo='laboratorio'` e toda
+OS/produto carrega `laboratorio_id`. Validar 100% em DEV (`pgdev`) antes de seguir.
+
+## 2.0.a — Migrações (em `runMigrations()`, junto às da Fase 1, ~linha 5663)
+
+```js
+// ── FASE 2.0: Laboratório como workspace de 1ª classe ──────────────────────
+`ALTER TABLE protese_os       ADD COLUMN IF NOT EXISTS financeiro_lab_id TEXT`, // RECEITA espelhada (2.1)
+`ALTER TABLE protese_produtos ADD COLUMN IF NOT EXISTS laboratorio_id TEXT`,
+// laboratorio_id em protese_os JÁ EXISTE (coluna reservada na criação da tabela) — não recriar.
+
+// re-tag: o workspace pessoal do protético passa a ser 'laboratorio'
+`UPDATE clinicas SET tipo='laboratorio'
+   WHERE tipo='pessoal'
+     AND owner_id IN (SELECT id FROM usuarios WHERE role='protetico')`,
+
+// backfill: cada OS herda o laboratorio do workspace do seu protético
+`UPDATE protese_os o SET laboratorio_id = c.id
+   FROM clinicas c
+  WHERE o.laboratorio_id IS NULL AND c.tipo='laboratorio' AND c.owner_id = o.protetico_id`,
+
+// backfill: catálogo passa a ser do laboratório (mantém protetico_id p/ compat)
+`UPDATE protese_produtos p SET laboratorio_id = c.id
+   FROM clinicas c
+  WHERE p.laboratorio_id IS NULL AND c.tipo='laboratorio' AND c.owner_id = p.protetico_id`,
+
+// índice por lab (o de protetico_id já existe; adiciona o do lab)
+`CREATE INDEX IF NOT EXISTS idx_protese_os_labid ON protese_os (laboratorio_id, status)`,
+```
+> O `UPDATE especialidades … area='protese'` da Fase 1 já está logo acima — não duplicar.
+
+## 2.0.b — Helper: resolver o laboratório de um protético
+
+Novo helper perto de `proteseOsAccesso` (~linha 3772). 1 lab por protético ⇒ `LIMIT 1`.
+
+```js
+// O workspace 'laboratorio' do protético (1 por protético nesta fase).
+async function labDoProtetico(proteticoId) {
+    if (!proteticoId) return null;
+    const { rows } = await pool.query(
+        "SELECT id FROM clinicas WHERE owner_id=$1 AND tipo='laboratorio' AND COALESCE(deleted_at IS NULL, true) LIMIT 1",
+        [proteticoId]);
+    return rows[0]?.id || null;
+}
+```
+> Se `clinicas` não tiver `deleted_at`, usar só `WHERE owner_id=$1 AND tipo='laboratorio'`.
+
+## 2.0.c — Gravar `laboratorio_id` na CRIAÇÃO da OS (2 pontos)
+
+**(i) `POST /api/protese/os`** (~linha 3893): resolver o lab e incluí-lo no INSERT.
+```js
+const labId = await labDoProtetico(b.protetico_id);   // antes do INSERT
+// no INSERT: acrescentar a coluna laboratorio_id e o valor labId
+//   ... protetico_id, laboratorio_id, protetico_nome, ...
+//   VALUES ($1,$2,$3,$LAB,$4,...)
+```
+
+**(ii) Bloco GTO→protese_os (Fase 1)** em `PUT /api/gto-builder/:id/finalizar`
+(o INSERT em `protese_os` que você acabou de escrever): mesma adição.
+```js
+const labId = await labDoProtetico(it.protetico_id);  // dentro do for, antes do INSERT
+// incluir laboratorio_id = labId no INSERT da OS gerada por GTO
+```
+> Assim, OS novas já nascem com `laboratorio_id`; as antigas foram cobertas pelo backfill.
+
+## 2.0.d — Bancada roteia por laboratório (com fallback por pessoa)
+
+`GET /api/protese/bancada` (~linha 3926). Hoje: `WHERE protetico_id=$1`. Passa a aceitar OS
+do(s) laboratório(s) do usuário, mantendo fallback para OS ainda sem `laboratorio_id`:
+
+```js
+const uid = req.authUser.userId;
+const labId = await labDoProtetico(uid);              // o lab do protético logado
+const vals = [uid, labId];
+let where = `( (laboratorio_id IS NOT NULL AND laboratorio_id=$2)
+            OR (laboratorio_id IS NULL AND protetico_id=$1) ) AND deleted_at IS NULL`;
+if (req.query.status && PROTESE_STATUS.includes(req.query.status)) {
+    vals.push(req.query.status); where += ` AND status=$${vals.length}`;
+}
+// resto idêntico (ORDER BY / LIMIT / map)
+```
+> `proteseOsAccesso` **não muda na 2.0** (1 lab por protético ⇒ `protetico_id===uid` ainda
+> identifica o lab). O `OR por vínculo no lab` entra só na 2.3 (equipe/`tecnico_protese`).
+
+## 2.0.e — Novos protéticos já nascem com `tipo='laboratorio'`
+
+No `POST /api/register` (~linha 625), o INSERT do workspace usa `tipo='pessoal'` para todos.
+Diferenciar o protético:
+```js
+const wsTipo = userRole === 'protetico' ? 'laboratorio' : 'pessoal';
+`INSERT INTO clinicas (id, nome_fantasia, tipo, owner_id) VALUES ($1,$2,$3,$4)` // $3 = wsTipo
+```
+> O seed de catálogo (`seedProteseProdutos(userId)`) continua por `protetico_id` (owner) —
+> sem mudança. (O `laboratorio_id` do catálogo é resolvido pelo backfill / por leitura.)
+
+## ✅ Critérios de aceite 2.0 (validar em DEV)
+- `SELECT count(*) FROM protese_os WHERE laboratorio_id IS NULL` → **0** (após backfill).
+- Toda `clinicas` de protético tem `tipo='laboratorio'`.
+- Criar OS nova (via Nova OS **e** via finalizar GTO) → `laboratorio_id` preenchido.
+- Bancada continua mostrando exatamente as mesmas OS de antes (fallback cobre o legado).
+- **Zero** mudança visível na UI.
+
+---
+
+# PASSO 2.1 — Casa própria + receita espelhada
+
+Agora o protético entra numa **área de Laboratório** (menu próprio) e a entrega passa a
+lançar a receita no workspace do lab.
+
+## 2.1.a — BACKEND: receita espelhada na entrega
+
+Em `POST /api/protese/os/:id/status`, dentro do `if (novo === 'entregue') { ... }`, logo após
+o bloco que cria a **DESPESA** (`finId`). Mesma condição (`custo>0 && tipo_os≠'garantia'`):
+
+```js
+// Espelho: RECEITA no workspace do laboratório (clinica_id = laboratorio_id). Idempotente.
+let finLabId = os.financeiro_lab_id || null;
+try {
+    const labId = os.laboratorio_id || await labDoProtetico(os.protetico_id);
+    if (!finLabId && labId && Number(os.custo) > 0 && os.tipo_os !== 'garantia') {
+        finLabId = `fin_lab_${Date.now()}_${Math.random().toString(36).slice(2, 6)}`;
+        await pool.query(
+            `INSERT INTO financeiro (id, clinica_id, descricao, valor, tipo, status, datavencimento, data_competencia, paciente_id, paciente_nome, origem, centro_custo, sem_comissao)
+             VALUES ($1,$2,$3,$4,'RECEITA','Pendente',CURRENT_DATE,CURRENT_DATE,$5,$6,'protese','PRÓTESE',true)`,
+            [finLabId, labId, `PRÓTESE: ${os.tipo} (cliente ${clinicaNome || ''})`.trim(), Number(os.custo),
+             os.paciente_id || null, os.paciente_nome || null]);
+    }
+} catch (e) { console.error('[protese entrega→receita lab]', e.message); }
+```
+E no `UPDATE protese_os` da entrega, persistir o id:
+```js
+// ...financeiro_id=COALESCE($3,financeiro_id), financeiro_lab_id=COALESCE($N,financeiro_lab_id)...
+```
+> `clinicaNome` = nome da clínica de origem (1 query opcional, ou usar `os.clinica_id`).
+> **Estorno** (cancelar entrega) é tarefa à parte: reverter os dois `financeiro` — fica para
+> a sub-fase de cancelamento; por ora a entrega é terminal (já é hoje: 409 se `entregue`).
+
+## 2.1.b — FRONTEND: menu da área de Laboratório (`Sidebar.tsx`)
+
+**(i)** Acrescentar os itens ao array `menuItems` (~linha 53):
+```js
+{ id: 'lab-home',      label: 'PAINEL DO LAB', icon: LayoutDashboard },
+{ id: 'lab-bancada',   label: 'BANCADA',       icon: FlaskConical },
+```
+(catálogo/clientes/agenda/financeiro entram na 2.2/2.3 — não criar itens mortos agora.)
+
+**(ii)** Isolar o menu quando o workspace ativo é laboratório — **espelhar** o bloco que já
+existe para `tipo==='sala'` (~linha 98). Inserir antes dele:
+```js
+// Contexto de LABORATÓRIO: área própria do protético (não é clínica).
+if ((activeWorkspace as any)?.tipo === 'laboratorio')
+    return ['lab-home', 'lab-bancada', 'notificacoes', 'configuracoes'].includes(item.id);
+```
+> Como o protético tem **1** workspace e ele é `tipo='laboratorio'`, esse branch governa o
+> menu dele. O antigo filtro `currentRole==='protetico'` (linha ~131) deixa de ser alcançado
+> para o caso comum, mas **mantê-lo** como rede de segurança (protético sem workspace lab).
+
+## 2.1.c — FRONTEND: roteamento das telas novas (`App.tsx`)
+
+No switch/router de `view` do `App.tsx`, mapear:
+```jsx
+case 'lab-bancada': return <ProteseView />;   // já renderiza modo 'bancada' p/ role protetico
+case 'lab-home':    return <LabHomeView />;    // novo painel (abaixo)
+```
+> `ProteseView` já decide `modo='bancada'` por `getCurrentRole()==='protetico'` — reaproveita
+> 100%. Só muda o **id de menu** que a abre.
+
+## 2.1.d — FRONTEND: `LabHomeView` (painel mínimo)
+
+Nova view `frontend/views/LabHomeView.tsx`. Cards a partir de dados que já existem:
+- **Fila por status** e **atrasadas**: derivar de `getProteseBancada()` (já retorna `atrasada`).
+- **Faturamento do mês**: somar `financeiro` RECEITA `origem='protese'` do workspace lab
+  (rota de financeiro existente, escopada por `clinicaId` = id do lab).
+- **Prazo médio / entregues no mês**: agregação simples sobre a bancada.
+
+Sem rota nova obrigatória na 2.1 (reusa `bancada` + `financeiro`); se quiser um resumo de 1
+chamada, criar `GET /api/protese/lab/resumo` depois.
+
+## ✅ Critérios de aceite 2.1
+- Logado como protético, a Sidebar mostra **PAINEL DO LAB** + **BANCADA** (+ notificações/config).
+- A clínica continua com a tela PRÓTESES (modo `clinica`) **intacta**.
+- Entregar uma OS com `custo>0` (não-garantia) cria **2** lançamentos: DESPESA na clínica e
+  RECEITA no lab (mesmo valor `custo`); reentregar/reprocessar **não** duplica (`COALESCE`).
+- OS de garantia entregue → **nenhum** lançamento (nos dois lados).
+- `LabHomeView` mostra fila + faturamento do mês do laboratório.
+
+---
+
+# Ordem de execução e deploy
+1. Branch a partir da `main` (que já tem a Fase 1 não-commitada — **commitar a Fase 1 antes**).
+2. 2.0 (backend só) → subir em DEV (`dev.scoreodonto.com`/`pgdev`), rodar os SELECTs de aceite.
+3. 2.1 (backend receita + front) → validar aceite em DEV.
+4. Commit por sub-fase; push → CI builda por commit; `git tag vX.Y.Z` promove à produção.
+> Migrações aditivas ⇒ rollback de código é seguro (padrão já validado no projeto).

doc/FASE2-PROTETICO-AREA.md

@@ -0,0 +1,220 @@
+# Fase 2 — Área do Protético (Laboratório como workspace de 1ª classe)
+
+> Desenho de modelo. Continuação da **Fase 1 (GTO → Prótese)**, onde finalizar uma GTO
+> abre automaticamente uma OS na Bancada (`protese_os.gto_item_id`).
+> **Objetivo da Fase 2:** o protético deixa de ser "um papel que só vê a Bancada" e passa
+> a ter uma **área de gestão própria** — o Laboratório — equivalente ao que a Clínica é para
+> o dentista. Ele gere catálogo, equipe, clientes (clínicas), financeiro e agenda de entregas.
+
+---
+
+## 1. Onde estamos hoje (não reinventar)
+
+O alicerce já existe — a Fase 2 **promove**, não cria do zero:
+
+| Já existe | Onde |
+|---|---|
+| Role `protetico` (válido em `usuarios` e `vinculos`) | `server.js` VALID_ROLES / constraints |
+| Workspace pessoal "LABORATÓRIO DE …" criado no signup | `clinicas (tipo='pessoal')` + `vinculos (role='protetico')` |
+| Catálogo de produtos (preço fixo + garantia) | `protese_produtos (protetico_id)` |
+| Bancada (fila de OS do protético) | `GET /api/protese/bancada` (roteia por `protetico_id`) |
+| OS com eventos, fotos, status, garantia, financeiro | `protese_os`, `protese_os_evento`, `protese_os_foto` |
+| `ProteseView` com `modo: 'bancada' | 'clinica'` por role | `frontend/views/ProteseView.tsx` |
+| **`protese_os.laboratorio_id`** — reservado, hoje `null` | comentário: "workspace destino (futuro)" |
+| Menu filtrado por role (protético = subset) | `Sidebar.tsx` linha ~131 |
+
+**Lacuna que a Fase 2 fecha:** o Laboratório não é uma *entidade gerenciável*. O protético
+roteia OS por `protetico_id` (a pessoa), não por um laboratório (a empresa). Não há painel,
+equipe, visão de clientes, nem financeiro do lado do laboratório. A OS conhece a *pessoa*,
+não a *bancada/empresa*.
+
+---
+
+## 2. Decisão de modelo: Laboratório = workspace `tipo='laboratorio'`
+
+O sistema já trata **workspace** de forma polimórfica: `clinicas` é a tabela-base e `tipo`
+distingue (`clinica` | `pessoal` | `sala`). A Fase 2 introduz **`tipo='laboratorio'`** em vez
+de criar uma tabela nova. Isso reaproveita: vínculos, troca de workspace, RBAC por cargo,
+financeiro, notificações e o seletor de workspace da Sidebar.
+
+```
+            usuarios (role='protetico')
+                  │  vinculos (role='protetico' | 'tecnico_protese')
+                  ▼
+        clinicas  (tipo='laboratorio')   ◄── "LABORATÓRIO DE X" deixa de ser 'pessoal'
+                  │
+      ┌───────────┼─────────────────────────────┐
+      ▼           ▼                             ▼
+ protese_produtos  protese_os (laboratorio_id)   equipe (vinculos do lab)
+   (catálogo)        ▲  roteamento por LAB,
+                     │  não mais só por pessoa
+        clínicas-cliente enviam OS ──┘
+```
+
+### Migração do dado existente (aditiva, idempotente)
+```sql
+-- 1) re-tag do workspace pessoal do protético → laboratorio
+UPDATE clinicas SET tipo='laboratorio'
+ WHERE tipo='pessoal'
+   AND owner_id IN (SELECT id FROM usuarios WHERE role='protetico');
+
+-- 2) backfill: toda OS legada ganha o laboratorio_id do workspace do seu protetico
+UPDATE protese_os o SET laboratorio_id = c.id
+  FROM clinicas c
+ WHERE o.laboratorio_id IS NULL
+   AND c.tipo='laboratorio'
+   AND c.owner_id = o.protetico_id;
+
+-- 3) o catálogo passa a ser do laboratório (mantém protetico_id p/ compat)
+ALTER TABLE protese_produtos ADD COLUMN IF NOT EXISTS laboratorio_id TEXT;
+UPDATE protese_produtos p SET laboratorio_id = c.id
+  FROM clinicas c
+ WHERE p.laboratorio_id IS NULL AND c.tipo='laboratorio' AND c.owner_id = p.protetico_id;
+```
+> `protetico_id` **continua** populado em todas as tabelas (compatibilidade da Fase 1 e do
+> roteamento por pessoa). `laboratorio_id` passa a ser a **chave de escopo** da área.
+
+---
+
+## 3. A Área do Laboratório (navegação)
+
+Quando o `activeWorkspace.tipo === 'laboratorio'`, a Sidebar troca para um menu próprio
+(análogo ao `tipo==='sala'` que já isola o menu). Itens:
+
+| Item | Conteúdo | Reaproveita |
+|---|---|---|
+| `lab-home` | **Painel** do laboratório: OS por status, atrasadas, faturamento do mês, prazo médio | novo dashboard + agregações de `protese_os` |
+| `lab-bancada` | **Bancada** (fila de produção, kanban por status) | `ProteseView` modo bancada (já existe) |
+| `lab-catalogo` | **Catálogo** de produtos (preço/garantia) — vira tela, não modal | `ProdutosModal` → view |
+| `lab-clientes` | **Clínicas-cliente**: quem envia OS, volume, ticket, pendências | distinct de `protese_os.clinica_id` |
+| `lab-agenda` | **Agenda de entregas** por `prazo_entrega` | AgendaView adaptada / nova |
+| `lab-financeiro` | **A receber** das clínicas (a OS gera DESPESA na clínica = RECEITA no lab) | `protese_os.financeiro_id` (elo) |
+| `lab-equipe` | **Técnicos** do laboratório (RBAC por cargo já existe) | `vinculos` + permissões de workspace |
+| `notificacoes` / `configuracoes` | base | já existe |
+
+A tela "PRÓTESES" da **clínica** (modo `clinica`) não muda — ela continua **enviando** OS.
+O que muda é o **lado de quem recebe**, que ganha uma casa própria.
+
+### Roteamento de OS: pessoa → laboratório
+- Hoje: `bancada` filtra `WHERE protetico_id = me`.
+- Fase 2: `bancada` filtra `WHERE laboratorio_id = activeWorkspace.id` (com fallback
+  `OR (laboratorio_id IS NULL AND protetico_id = me)` durante a transição).
+- Ganho imediato: **mais de um técnico** pode atender a mesma bancada (equipe), e o protético
+  dono pode ter **mais de um laboratório**.
+
+---
+
+## 4. Modelo de dados — deltas da Fase 2
+
+Tudo aditivo (migrações no padrão `ALTER TABLE … IF NOT EXISTS`, como a Fase 1):
+
+```sql
+-- workspace
+clinicas.tipo                         -- novo valor possível: 'laboratorio'
+
+-- escopo por laboratório (a empresa), além de protetico_id (a pessoa)
+protese_os        ADD laboratorio_id TEXT    -- (já reservado; passa a ser populado/backfill)
+protese_os        ADD financeiro_lab_id TEXT -- RECEITA espelhada no lab (§9; idempotência)
+protese_produtos  ADD laboratorio_id TEXT
+
+-- equipe do laboratório: novo role de vínculo (técnico não-dono)
+vinculos.role  -- incluir 'tecnico_protese' no CHECK constraint
+
+-- relação clínica↔laboratório (opcional, p/ "meus laboratórios favoritos"/preços negociados)
+CREATE TABLE IF NOT EXISTS lab_clientes (
+    id TEXT PRIMARY KEY,
+    laboratorio_id TEXT NOT NULL,
+    clinica_id TEXT NOT NULL,
+    apelido TEXT,
+    desconto_pct NUMERIC DEFAULT 0,     -- preço negociado (futuro)
+    created_at TIMESTAMPTZ DEFAULT NOW(),
+    UNIQUE (laboratorio_id, clinica_id)
+);
+```
+
+Índices: `idx_protese_os_lab` passa a ser `(laboratorio_id, status)`.
+
+---
+
+## 5. Permissões (RBAC)
+
+Reaproveita o RBAC por cargo que já existe na Sidebar (`wsRole`/`wsPerms`):
+
+| Papel no laboratório | Pode |
+|---|---|
+| `protetico` (dono do lab) | tudo: catálogo, equipe, financeiro, status de qualquer OS |
+| `tecnico_protese` (membro) | bancada + avançar status + fotos; **sem** financeiro/equipe/catálogo |
+| clínica-cliente (`isClinic` em `proteseOsAccesso`) | criar OS, ver suas OS, entregar/cancelar, **sem** ver custo/bancada de outros |
+
+`proteseOsAccesso(os, userId)` ganha o caso "membro do laboratório dono da OS"
+(`vinculo em laboratorio_id`), além do dono atual.
+
+---
+
+## 6. Plano de implementação incremental
+
+Cada passo é deployável e reversível (migrações aditivas → rollback de código é seguro).
+
+- **2.0 — Dados (invisível):** migrações + backfill `laboratorio_id`; `bancada` lê por lab com
+  fallback por pessoa. Nada muda na UI. *Risco mínimo, valida o backfill em DEV (`pgdev`).*
+- **2.1 — Casa própria + receita espelhada:** `tipo='laboratorio'` re-tagueado; Sidebar com
+  menu do laboratório; `lab-home` (painel) + `lab-bancada`; **espelho de RECEITA na entrega**
+  (§9) — o financeiro mínimo do lab já nesta fase, conforme decisão 3.
+- **2.2 — Catálogo e clientes:** `ProdutosModal` vira `lab-catalogo`; tela `lab-clientes`.
+- **2.3 — Financeiro completo e equipe:** `lab-financeiro` (extrato/a-receber por cliente,
+  sobre as receitas já lançadas na 2.1) + `tecnico_protese` (convite de membro reusando o
+  fluxo de equipe existente).
+- **2.4 — Agenda de entregas + multi-laboratório** (expansão; modelo já suporta, sem migração).
+
+---
+
+## 7. O que **não** muda (contrato preservado)
+- O lado **clínica** de `ProteseView` (modo `clinica`) e o envio de OS.
+- A **Fase 1**: GTO finalizada continua abrindo OS (`gto_item_id`), agora já com
+  `laboratorio_id` preenchido na criação.
+- `protetico_id` permanece em todas as tabelas — roteamento por pessoa segue funcionando
+  como fallback; nenhuma OS legada fica órfã.
+
+---
+
+## 8. Decisões de produto (fechadas em 23/jun/2026)
+1. **Um laboratório por protético.** A UI assume 1 lab. O modelo de dados já suporta N
+   (`laboratorio_id` por OS/produto), então multi-lab é expansão futura **sem migração**.
+2. **Laboratório terceirizado** (empresa separada que cobra da clínica). A flag `interno`
+   de `getProteseLaboratorios` fica como gancho futuro, mas **não** é tratada agora —
+   todo lab gera receita/despesa cruzada entre tenants.
+3. **Financeiro espelhado já na 2.1.** A OS entregue, que hoje lança **DESPESA na clínica**
+   (`protese_os.financeiro_id`), passa a lançar simultaneamente uma **RECEITA no workspace
+   do laboratório**. Ver §9.
+
+---
+
+## 9. Financeiro espelhado (decisão 3) — DESPESA na clínica ↔ RECEITA no lab
+
+Hoje a entrega da OS gera um lançamento de **DESPESA** na clínica de origem
+(`protese_os.financeiro_id`), no valor de **`os.custo`** (o preço de catálogo do lab — o que a
+clínica paga ao laboratório; `os.valor` é o preço ao paciente, markup da clínica, e **não**
+entra aqui). Como o laboratório agora é um workspace de 1ª classe, o mesmo evento de entrega
+lança um **par espelhado**, ambos sobre `os.custo`:
+
+```
+  entrega da OS (status='entregue', custo>0, tipo_os≠'garantia')
+        │
+        ├─► financeiro (DESPESA)  clinica_id = os.clinica_id       valor = os.custo  [já existe]
+        └─► financeiro (RECEITA)  clinica_id = os.laboratorio_id   valor = os.custo  [novo]
+```
+
+- Mesma **condição** da despesa já existente: só lança se `custo > 0` e `tipo_os ≠ 'garantia'`
+  (OS de garantia refaz sem cobrar). Sai no mesmo `if (novo === 'entregue')`.
+- Idempotente, no padrão da Fase 1: novo `protese_os.financeiro_lab_id` guarda o id do
+  lançamento de receita; se já existe (`COALESCE`), não duplica.
+- Isolado em `try/catch` para **nunca** derrubar a transição de status (mesma disciplina do
+  bloco GTO→protese_os da Fase 1).
+- Estorno: cancelar/estornar a entrega deve reverter **os dois** lançamentos.
+
+Por isso o **passo 2.1 já inclui o financeiro mínimo** (apenas o espelho de receita na
+entrega); o item de menu `lab-financeiro` completo (extrato, a-receber por cliente) continua
+na 2.3.
+
+> ⚠️ Pré-requisito: `laboratorio_id` precisa estar populado **antes** de ligar o espelho
+> (senão a receita nasce sem destino). Por isso a ordem **2.0 (backfill) → 2.1** é obrigatória.

doc/MARKETPLACE-TRANSACIONAL-PROTESE.md

@@ -0,0 +1,58 @@
+# Marketplace transacional de Prótese
+
+> Desenho (24/jun/2026). O último grande item do backlog do Provedor de Prótese.
+> Princípio: **transformar o diretório (descoberta) em jornada de compra** — descobrir → ver
+> serviços/preços → solicitar → cotar → contratar → vira OS. Reaproveita ao máximo o que já existe.
+
+## O que já existe (não recriar)
+- **Descoberta:** `/api/profissionais/marketplace` (busca por proximidade/especialidade) **+ Nota
+  ScoreOdonto** no card (feito).
+- **Catálogo:** `protese_produtos` (nome, preço, garantia) + `GET /api/protese/laboratorios/:id/produtos`
+  — já acessível a quem está no **diretório** (`proteticoAcessivelPelaClinica` aceita `disponivel_diretorio`).
+- **Propostas:** `propostas_profissional` (clínica→profissional: mensagem, `pendente→aceita/recusada`).
+- **Contratação:** a clínica **já cria OS para qualquer protético do diretório** (Nova OS).
+- **Pós-venda:** OS completa (etapas, custódia, ocorrências), financeiro, score — tudo pronto.
+
+**Conclusão:** o "transacional" não exige nova fundação — falta **costurar a jornada** dentro do
+marketplace (hoje a clínica vê nome/nota/distância, mas não os serviços, e contrata por outra tela).
+
+## Fatias
+
+### ✅ Fatia 1 — Vitrine (catálogo no marketplace) — IMPLEMENTADA
+No card do protético no marketplace, **"Ver catálogo"** expande os produtos (nome, preço, garantia)
+via `getLaboratorioProdutos(id)` (reuso — zero endpoint novo). A clínica passa a **decidir vendo
+serviços + preço + garantia + ★nota** antes de contratar. Botão de contato vira **"Solicitar
+prótese"** (proposta com contexto de prótese).
+
+### ✅ Fatia 2 — Solicitação → OS direto — IMPLEMENTADA
+"Solicitar prótese" (card do protético) abre o `SolicitarProteseModal` — fluxo enxuto com o lab
+**pré-selecionado**: produto do catálogo (ou descrição livre) + paciente (busca) + dentista + dentes
++ prazo + observações → **cria a OS** via `createProteseOS` (que já aceita lab do diretório, sem
+vínculo prévio). Tela de confirmação com CTA para a Bancada. Optei por um modal próprio e auto-contido
+(reusa getLaboratorioProdutos/getDentistas/getPacientes/createProteseOS) em vez de extrair a Nova OS —
+menor risco. Validado em DEV: OS criada para lab do diretório (Coroa de Zircônia, status solicitado).
+
+### ✅ Fatia 3 — Cotação (RFQ) — IMPLEMENTADA
+Entidades novas `protese_rfq` + `protese_rfq_cotacao`. Fluxo: a clínica descreve o trabalho e
+**convida N labs** → cada lab **cota** (valor/prazo/obs) → a clínica **compara** (ordenado por preço)
+e **escolhe** → vira **OS** (custo = valor da cotação) e a RFQ fecha (demais cotações recusadas).
+Endpoints: `POST/GET /protese/rfq`, `GET /protese/rfq/recebidas`, `POST /protese/rfq/cotacao/:id`,
+`POST /protese/rfq/:id/escolher`. UI: lado lab = tela **Cotações** (`lab-cotacoes`, responde); lado
+clínica = botão **Cotações** na tela de Prótese (pedir multi-lab + comparar + escolher). Validado em
+DEV ponta a ponta (pedido → cotação R$420 → escolha → OS criada → RFQ fechada).
+
+### ✅ Fatia 4 — Reputação (avaliação + selo) — IMPLEMENTADA
+A clínica avalia o laboratório (1-5★ + comentário) **após a entrega** (`protese_avaliacao`, 1 por OS,
+reavaliável). A satisfação **entra na Nota ScoreOdonto**: `0.6·operacional + 0.4·(estrelas/5·10)` (sem
+avaliações = só operacional). **Selo "Verificado"** com ≥ 5 entregas. Exposto no marketplace (★nota ·
+nº avaliações · Verificado) e nos indicadores do lab (KPI Satisfação). Endpoint `POST
+/protese/os/:id/avaliar`. Validado em DEV: 6 entregas + avaliações 5★/3★ → nota **9.2**, satisfação 4★,
+verificado, em marketplace e indicadores.
+
+**Marketplace transacional concluído (Fatias 1-4).**
+
+## Decisões de modelagem
+- **Catálogo público = catálogo atual** (`protese_produtos`); a vitrine só o exibe — sem duplicar.
+- **Solicitação reusa a OS** (não cria entidade paralela): toda contratação termina em `protese_os`,
+  preservando rastreabilidade/financeiro/score.
+- **Cotação (Fatia 3)** é o único caso que precisa de entidade nova (pré-OS multi-lab).

doc/MODO1-LINK-SEGURO-PROTESE.md

@@ -0,0 +1,108 @@
+# Modo 1 — Provedor de Prótese SEM conta (link seguro `/p/TOKEN`)
+
+> Desenho (24/jun/2026). Evolução registrada como "fora de escopo" em `PROVEDOR-PROTESE-DECISAO.md`.
+> Princípio (decisão arquitetural): **a clínica opera 100% da OS; o protético não precisa ter conta.**
+> O link é a porta de entrada do ecossistema — acompanha hoje, vira conta amanhã.
+
+## Objetivo
+A clínica cria/gere a OS normalmente. O protético recebe um **link seguro** (WhatsApp/e-mail) e,
+**sem login**, acompanha e atua na OS dele. Com CTA para criar conta grátis (conversão).
+
+```
+Clínica cria OS ──► gera link /p/TOKEN ──► WhatsApp/e-mail ──► Protético abre (sem conta)
+                                                                  ├─ vê a OS (sem CPF/valores do paciente)
+                                                                  ├─ confirma recebimento/devolução
+                                                                  ├─ avança etapa / anexa foto
+                                                                  └─ responde ocorrência
+                                                          "Crie sua conta grátis" ──► cadastro (card Protético)
+```
+
+## 1. Escopo do token: **por OS** (não por protético)
+Escopo mínimo = menor superfície de risco. Um token dá acesso a **uma OS**. Vantagens: revogável
+individualmente, expira por trabalho, não expõe a carteira inteira do protético. (Evolução: um token
+"carteira" por protético-na-clínica que lista várias OS — fica para depois.)
+
+## 2. Modelo de dados (revogável e auditável)
+```sql
+CREATE TABLE IF NOT EXISTS protese_os_link (
+    token TEXT PRIMARY KEY,            -- aleatório longo (≥ 32 bytes base62), NÃO sequencial
+    os_id TEXT NOT NULL,
+    protetico_id TEXT,                 -- a quem se destina (rastreio)
+    created_by TEXT,                   -- quem na clínica gerou
+    created_at TIMESTAMPTZ DEFAULT NOW(),
+    expires_at TIMESTAMPTZ,            -- opcional (ex.: +30 dias); null = sem expirar
+    revoked_at TIMESTAMPTZ,            -- revogação manual
+    last_access_at TIMESTAMPTZ,
+    acessos INTEGER DEFAULT 0
+);
+CREATE INDEX IF NOT EXISTS idx_protese_os_link_os ON protese_os_link (os_id);
+```
+> Preferir tabela a JWT puro: permite **revogar** e **auditar acessos**. O token nunca contém dados.
+
+## 3. Rotas públicas (sem `authGuard`; o token é a credencial)
+Todas resolvem `os_id` pelo token (valida não-revogado, não-expirado) e aplicam a **mesma blindagem
+do provedor**: sem `paciente_id`/CPF, sem valores do paciente (reusa a lógica `soLab`).
+
+| Rota | Ação |
+|---|---|
+| `GET /api/p/:token` | OS: nº, clínica, dentista, paciente (nome, conforme permissão), prazo, status, observações, fotos, componentes, ocorrências, custódia. **Sem CPF/valores do paciente.** |
+| `POST /api/p/:token/custodia` | confirmar recebimento / devolução (clínica↔lab) |
+| `POST /api/p/:token/status` | avançar a produção (recebido→…→finalizado) |
+| `POST /api/p/:token/foto` | anexar foto do trabalho (+ ocorrência) |
+| `POST /api/p/:token/ocorrencias/:id/resposta` | responder ocorrência (contraditório) |
+
+Cada ação registra no histórico da OS um **actor "Protético (link)"** com o `protetico_id` do token —
+mantendo a auditoria. Mesmas validações de status/foto já existentes.
+
+## 4. Geração e envio (lado clínica)
+Na OS (modal, aba Etapas ou Monitoramento): botão **"Enviar ao protético"** →
+`POST /api/protese/os/:id/link` gera/recupera o token e devolve a URL
+`https://scoreodonto.com/p/TOKEN`. Atalhos: **WhatsApp** (`https://wa.me/?text=…`) e **e-mail**
+(`mailto:`). Botão **"Revogar link"** para invalidar.
+
+## 5. Frontend público `/p/:token`
+Rota **fora do app autenticado** (sem Sidebar/login). Página enxuta que reusa as seções do
+`OSDetailModal` em modo "público/lab" (etapas, fotos, componentes, custódia, ocorrências — sem
+financeiro/clientes). Topo com a marca + rodapé fixo:
+
+> *"Gostou de acompanhar por aqui? Crie sua conta grátis e gerencie todos os seus laboratórios."*
+> → leva ao cadastro **já com o card Protético** (adicionado) e e-mail pré-preenchido.
+
+## 6. Segurança (checklist)
+- Token aleatório ≥ 32 bytes, base62, **não sequencial**; comparação em tempo constante.
+- Escopo de **1 OS**; expiração opcional; **revogável**; rate-limit por token/IP.
+- **Sem CPF e sem valores do paciente** (mesma blindagem `soLab` da Fase 1).
+- Ações registram actor no histórico (auditoria); `last_access_at`/`acessos` para detectar abuso.
+- OS `entregue`/`cancelado` → link vira **somente leitura**.
+
+## 7. Conversão (o "porquê de negócio")
+O link é aquisição: o protético experimenta o produto sem fricção e, ao criar conta, **herda o
+histórico** (as OS daquela clínica já estão ligadas ao `protetico_id` dele). Liga direto ao
+marketplace/score (Fase 5) — quanto mais clínicas o usam, mais OS e melhor o score do protético.
+
+## 8. Faseamento sugerido
+- **✅ 1a (núcleo) — IMPLEMENTADA 24/jun:** tabela `protese_os_link` (token aleatório 24 bytes
+  base64url, expira em 60 dias, revogável); `POST /api/protese/os/:id/link` (gera/recupera) +
+  `POST …/link/revogar`; `GET /api/p/:token` (leitura pública curada — sem CPF, sem valor do
+  paciente; conta acessos). Página pública `/p/:token` (`ProtesePublicView`, mobile-first 320px+,
+  interceptada no `index.tsx` antes do app autenticado); botão "Gerar link / WhatsApp / Copiar" na
+  aba Monitoramento (modo clínica). CTA "Criar conta grátis". Validado em DEV (leitura, blindagem,
+  token inválido→404, revogação→404).
+- **✅ 1b (ação) — IMPLEMENTADA 24/jun:** o protético, pelo link, **confirma recebimento/devolução**
+  (`POST /api/p/:token/custodia`), **avança a produção** (`/status`, só `recebido…finalizado` — nunca
+  entregue/cancelado, que são da clínica) e **anexa foto** (`/foto`). Tudo auditado como
+  `"<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 (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

@@ -0,0 +1,121 @@
+# Decisão arquitetural — Provedor de Prótese (módulo de Prótese)
+
+> Decisão de negócio/interface (24/jun/2026). Base: auditoria do código (`AUDITORIA-PROTESE.md`).
+> Princípio-guia: **a Clínica controla 100% do fluxo, mesmo que o Protético nunca crie conta.**
+> O login do Provedor é **alavanca de crescimento** (marketplace/ecossistema), não pré-requisito.
+
+## Conceito
+"**Provedor de Prótese**" é rótulo de **negócio/interface**. Internamente **NÃO se renomeia** o
+role `protetico` (aparece 87× no backend + 15 arquivos no front — refatorar = risco alto, ganho
+zero). As três formas são variações do **mesmo** workspace `tipo='laboratorio'`, diferenciadas por
+metadados (futuros `pessoa_tipo`, `tem_equipe`), não por novos roles:
+
+```
+PROVEDOR DE PRÓTESE  (role=protetico, workspace tipo='laboratorio')
+├── Profissional Individual (PF)
+├── Laboratório (PJ)
+└── Laboratório com Equipe (PJ + técnicos)
+```
+
+## Modos de operação
+- **Modo 1 — Protético SEM conta:** a Clínica opera tudo (OS, etapas, envio/recebimento/devolução,
+  pagamentos, componentes, ocorrências, encerramento). O Protético acompanha por **link seguro**
+  (`/p/TOKEN` via WhatsApp/e-mail), podendo confirmar recebimento/devolução, anexar fotos, responder
+  ocorrências. CTA: "crie sua conta ScoreOdonto".
+- **Modo 2 — Protético COM conta:** Dashboard, Ordens, Produção, Entregas, Clientes, Financeiro,
+  Catálogo, Notificações, Perfil.
+- **Modo 3 — Laboratório:** + Equipe, Relatórios, Marketplace, Configurações.
+
+## Cadastro/Login
+Card próprio **[ PROTÉTICO / LABORATÓRIO ]** com opção PF (Protético Individual) / PJ (Laboratório).
+Campos futuros (não obrigatórios no MVP): Nome, Nome Fantasia, CPF, CNPJ, CROT, Responsável Técnico,
+Cidade, Estado, Especialidades, Telefone, E-mail. (Campo `clinicas.documento` já existe para CPF/CNPJ.)
+
+## Rastreabilidade de componentes (modelo)
+Uma tabela (`protese_os_componente`) com eixo de direção/conferência, não duas:
+`enviado pela clínica → recebido pelo protético → devolvido pelo protético → conferido pela clínica`.
+A **ocorrência referencia o componente** (FK opcional).
+
+## Ocorrências + Contraditório
+Tabela própria. Categorias: não devolvido, danificado, incompatível, parafuso substituído/desgastado,
+peça incorreta, ajuste inadequado, falha de fabricação, retrabalho, outro. Campos: autor, data,
+categoria, descrição, fotos, evidências, anexos, responsável, status.
+**Fluxo com contraditório** (proteção dos dois lados): `Aberta → Respondida → Em análise → Resolvida`
+ou `Contestada`. **Só ocorrências resolvidas** alimentam indicadores — nunca automático.
+
+## Abas da OS (alvo)
+`Dados · Fotos · Componentes · Pagamentos · Custódia · Histórico · Ocorrências` (nova).
+
+## Indicadores (POR ÚLTIMO)
+Capturar primeiro (eventos, componentes, ocorrências, evidências, histórico); só depois derivar
+Score/ranking/marketplace. Não codar indicador antes de existir dado.
+
+---
+
+## Roadmap (5 fases)
+
+### ✅ FASE 1 — Origem da OS + LGPD (IMPLEMENTADA 24/jun)
+- **Clínica de origem** na bancada e no detalhe (`clinica_nome` via subquery) — visível ao protético
+  (badge na lista e no modal). Destrava o cenário multi-clínica.
+- **Blindagem de CPF:** confirmado que `pacientes.id` **É o CPF**. O protético (lab) deixa de receber
+  `paciente_id` (detalhe e bancada zeram), mantendo `paciente_nome`. A clínica continua vendo o CPF.
+- Validado em DEV: protético vê `clinica_nome` + `paciente_id:null`; clínica vê tudo.
+
+### ✅ FASE 2 — Rastreabilidade & Ocorrências (IMPLEMENTADA 24/jun)
+- **Componentes** ganham `direcao` (enviado/devolvido) e `status_conferencia` (pendente/ok/divergente/
+  ausente, com `conferido_nome/_em`). Endpoint `POST .../componentes/:id/conferir`.
+- **Ocorrências** (`protese_os_ocorrencia`): 10 categorias, descrição, responsável, autor, status.
+  Evidências via `protese_os_foto.ocorrencia_id` (reusa a infra de mídia).
+- **Contraditório**: `aberta → respondida → em_analise → resolvida | contestada`; `resolvida` é final
+  (409 ao remexer). Endpoints `/ocorrencias`, `/ocorrencias/:id/resposta`, `/ocorrencias/:id/status`.
+- **UI**: nova aba **Ocorrências** no modal (com contador) + conferência inline nos componentes.
+- Validado em DEV: componente `divergente`; ocorrência `parafuso_substituido` percorrendo todo o
+  contraditório até `resolvida`; resolvida final (409). Indicadores ficam para a Fase 5.
+
+### ✅ FASE 3 — Operação multi-clínica (IMPLEMENTADA 24/jun)
+- **Clientes** (tela `lab-clientes`): tabela das clínicas que enviam OS, com OS totais, ativas,
+  atrasadas, entregues, faturado e a-receber por cliente. Endpoint `GET /protese/lab/clientes`.
+- **Financeiro do lab** (tela `lab-financeiro`): KPIs (faturado/recebido/a-receber) + extrato de
+  recebimentos (pagamentos lado lab) com clínica/paciente/forma/data. Endpoint `GET /protese/lab/pagamentos`.
+  Regra: faturado = custo das OS entregues (exceto garantia); a-receber = faturado − recebido.
+- Menu do laboratório agora: Painel · Bancada · **Clientes** · **Financeiro** · Notificações · Config.
+- Histórico completo: a Bancada já lista entregues/cancelados com filtro de status (mantida).
+- Validado em DEV: agregação por clínica (faturado 600 / recebido 250 / a-receber 350) + extrato.
+
+### ✅ FASE 4 — Empresa de verdade (IMPLEMENTADA 24/jun)
+- **PF/PJ + documento**: `clinicas.pessoa_tipo` (PF=individual | PJ=laboratório); `documento` = CPF/CNPJ
+  (já existia, agora editável). Tela **Laboratório & Equipe** (`lab-equipe`): GET/PATCH `/protese/lab`.
+- **Equipe/Técnicos**: novo `vinculos.role='tecnico_protese'`. O dono convida por e-mail
+  (`ensureUsuarioPorEmail` → credencial temporária); endpoints `GET/POST/DELETE /protese/lab/equipe`.
+- **Acesso estendido**: `proteseOsAccesso` reconhece o técnico (vínculo no `laboratorio_id`); a bancada
+  usa `labDoUsuario` (dono **ou** técnico). Técnico opera a produção; **não** vê clientes/financeiro
+  (menu reduzido + endpoints retornam vazio/403). Gestão é exclusiva do dono.
+- Validado em DEV: dados PJ+CNPJ; técnico convidado acessa a bancada (vê clínica de origem), não vê
+  clientes (0) e leva 403 ao tentar gerenciar equipe.
+
+### ✅ FASE 5 — Indicadores & Score (IMPLEMENTADA 24/jun)
+- **Indicadores derivados** (`GET /protese/lab/indicadores`, só dono) calculados sobre a captura das
+  fases 2-4: entregues, tempo médio (solicitado→entregue), atraso %, retrabalho % (garantia),
+  ocorrências resolvidas %, componentes ausentes. Tela `lab-indicadores`.
+- **Nota ScoreOdonto** (0-10): `10 − (atraso%×3 + retrabalho%×4 + ocorrência%×3)`, só com **mínimo de
+  3 entregas** (senão "score em formação"). Só ocorrências **resolvidas** entram (contraditório respeitado).
+- **Ranking no marketplace**: `getProteseLaboratorios` passa a devolver a `nota` por protético e ordena
+  internos→maior nota→nome; a clínica vê `★ nota` no dropdown de Nova OS e do Lançar GTO.
+- Validado em DEV: 4 entregas (1 atrasada, 1 garantia) → atraso 25% / retrab 25% / **nota 8.3**; a
+  clínica vê a nota no dropdown; "score em formação" abaixo do mínimo.
+
+> Acoplamentos respeitados: PF/PJ veio com a equipe (Fase 4); Score só após a captura (Fases 2-4).
+
+### 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

@@ -1,6 +1,6 @@
 # Qual é a verdade hoje? — Auditoria de infra ScoreOdonto
 
-> Resposta direta às 6 perguntas essenciais, **verificada em 17/jun/2026**. Somente fatos do estado atual.
+> Resposta direta às 6 perguntas essenciais, **verificada em 23/jun/2026**. Somente fatos do estado atual.
 > **Documento principal: em caso de divergência entre docs, este prevalece.**
 > Como operar → `DEPLOY-PRODUCAO.md` (runbook). Para onde vamos → `deploy.md` (arquitetura-alvo).
 
@@ -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.16 · commit `471c2c2`**.
+- **Produção:** VPS1 roda **imagens versionadas do registry** (não código-fonte). No ar: **v1.0.29 · commit `cd89ca2`**.
 - **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.16 · `471c2c2` · 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.29 · `cd89ca2` · 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.16**), 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.29**), 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.

docker-compose.yml

@@ -37,8 +37,11 @@ services:
       - BAILEYS_ENGINE=infinite
       - PORT=8018
       - NODE_ENV=production
-      - DATABASE_URL=postgresql://${SCOREO_DB_USER:-scoreodonto_user}:${SCOREO_DB_PASS:-clube67_scoreodonto_pass_9903}@${SCOREO_DB_HOST:-10.99.0.3}:5432/${SCOREO_DB_NAME:-scoreodonto}?schema=public
-      - DRAGONFLY_URL=redis://:clube67_dragonfly_pass_9903@10.99.0.3:6379/1
+      # Senha do banco vem do ambiente (.env raiz em DEV; provisionado fora do git em PROD).
+      # `:?` falha o `up` se a senha não estiver definida — evita subir com senha vazia/errada.
+      # Host/usuário/banco mantêm default (não são segredo); só a senha é obrigatória via env.
+      - DATABASE_URL=postgresql://${SCOREO_DB_USER:-scoreodonto_user}:${SCOREO_DB_PASS:?defina SCOREO_DB_PASS no .env}@${SCOREO_DB_HOST:-10.99.0.3}:5432/${SCOREO_DB_NAME:-scoreodonto}?schema=public
+      # DRAGONFLY_URL (com senha) vem do env_file backend/.env — não fica em texto no compose.
       - NATS_URL=nats://10.99.0.3:4222
       - TEMPORAL_ADDRESS=10.99.0.3:7233
       - BAILEYS_SESSIONS_PATH=/app/sessions

documentação/AUDITORIA-ESTRATEGICA-MODELAGEM.md

@@ -0,0 +1,157 @@
+# AUDITORIA ESTRATÉGICA DE MODELAGEM — ScoreOdonto
+
+> **Análise crítica da modelagem e da visão de negócio.** Não altera código, banco, documentação ou migrations.
+> Baseada exclusivamente em evidências reais: `backend/server.js`, schema real (tabelas), fluxos existentes e
+> `MAPA-FUNCIONAL-COMPLETO.md`. Estado verificado: produção `v1.0.18` · DEV `dev`. Data: 19/jun/2026.
+
+---
+
+## Evidências-âncora (o que o código realmente diz)
+
+| Camada | Evidência no código | Tabela/linha |
+|---|---|---|
+| **Identidade (Pessoa)** | `usuarios` é o ponto único de login; perfil multi-área (`usuario_areas`), capacidades por pessoa (`usuario_plugins`), `is_tutor` | `usuarios`, `me/areas`, `me/plugins` |
+| **Vínculo (join)** | `vinculos(usuario_id, clinica_id, role, setor_id, funcao_id)` + `CHECK role IN (paciente, dentista, biomedico, protetico, funcionario, donoclinica, donoconsultorio, donosala, admin)` | `server.js:4851` |
+| **Workspace** | `clinicas` ganhou `tipo ∈ {pessoal, consultorio, clinica}` + `owner_id`; comentário literal **"Clinicas → workspaces (Fase 1)"** | `server.js:4822-4824` |
+| **Workspace pessoal automático** | No registro, cria `clinicas(tipo='pessoal', owner_id=usuario)` — **toda pessoa nasce com um workspace** | `server.js:537,550` |
+| **Agregação** | `me/workspaces` → `listarWorkspaces(userId)` reúne clínicas (via vínculo) + salas | `server.js:5680` |
+| **Marketplace = pessoa** | `propostas_profissional.profissional_id` → `JOIN usuarios u` | `server.js:6307` |
+| **Legado clínica-cêntrico** | `pacientes` tem `clinica_id` e **não tem `usuario_id`**; `dentistas` é tabela à parte com `usuario_id` opcional; tudo passa por `tenantGuard`+`clinica_id` | `pacientes`, `dentistas:1542` |
+
+**Leitura imediata:** a *espinha de identidade e acesso* **já é** Pessoa → Vínculo → Workspace (e isso está em migração ativa, declarada como "Fase 1"). Os *dados clínicos/operacionais* **ainda são** Clínica → Pessoa. O sistema é **híbrido, com a direção já apontada pelo próprio código**.
+
+---
+
+## ANÁLISE 1 — Pessoa × Workspace
+
+1. **Centrado em clínica ou pessoa?** Híbrido. **Autenticação/autorização/workspaces:** centrado em **pessoa**. **Operação clínica e financeira:** centrado em **clínica** (`tenantGuard` + `clinica_id`).
+2. **A pessoa é entidade principal?** **Sim, há evidência forte:** `usuarios` é a âncora; áreas, plugins e tutor são da pessoa; o profissional do marketplace é a pessoa; e cada pessoa recebe um **workspace pessoal** ao se cadastrar.
+3. **A clínica é apenas um workspace?** **Sim, há evidência explícita:** `clinicas.tipo` pode ser `pessoal | consultorio | clinica`, com `owner_id`. A clínica é hoje **um tipo de workspace** dentro da própria tabela `clinicas` (que virou, de fato, a tabela de workspaces).
+4. **Módulos que favorecem Pessoa→Vínculo→Workspace:** login/identidade, `vinculos`+RBAC (`funcoes`/`setores`), `me/workspaces`, `usuario_plugins`, `usuario_areas`, Salas (workspace `tipo='sala'`), Marketplace de Profissionais, Tutoria.
+5. **Módulos que favorecem Clínica→Pessoa:** Pacientes, Dentistas (tabela-recurso), Agenda, Financeiro/Comissão/Repasse, Orçamentos/Contratos, Glosas — **toda a operação** ainda é escopada por `clinica_id`.
+6. **Mais sustentável em 5 anos:** **Pessoa → Vínculo → Workspace.** Justificativa técnica: a tabela `vinculos` é N:N (uma pessoa, vários workspaces, papéis distintos por workspace) — é o único modelo que comporta dentista em várias clínicas, locação de salas, tutoria e marketplace **sem duplicar a pessoa**. O modelo clínica-cêntrico exige duplicar o humano por clínica (é o que `dentistas` já faz, e é exatamente o gargalo).
+
+---
+
+## ANÁLISE 2 — Consultório
+
+**Hoje é simultaneamente (A) Papel e (C) Workspace:** existe a *role* `donoconsultorio` em `vinculos` **e** o `tipo='consultorio'` em `clinicas` (`server.js:590` decide o `tipoWs` a partir da role do dono).
+
+**Classificação ideal:** **(C) Workspace** — um `tipo` de workspace, sendo `donoconsultorio` apenas o *papel do dono* dentro dele. O sistema já está ~80% nesse modelo.
+
+**Impactos:** baixo do ponto de vista de dados (já existe `tipo='consultorio'`). O resíduo é **semântico**: a role codifica o tipo do workspace (acoplamento role↔tipo). Enquanto persistir, decisões de UI/permissão ramificam em dois lugares ("é consultório?" pode ser perguntado pela role *ou* pelo tipo), gerando divergência.
+
+---
+
+## ANÁLISE 3 — Protéticos
+
+**Hoje o protético é:** **Usuário/Profissional.** É `usuarios` com role `protetico` em `vinculos`, recebe workspace pessoal, e produz trabalho via `protese_os`/`protese_produtos`.
+
+**Existe conflito conceitual? Sim.** O protético-pessoa está modelado como **profissional do ecossistema**, mas o **laboratório** (onde o trabalho/custo realmente reside, `protese_laboratorios` + custo lab que abate comissão) é um **cadastro interno separado**. Ou seja, a faceta "fornecedor" está **descolada** da pessoa: a pessoa é profissional, o fornecedor é um cadastro à parte.
+
+**Modelo que faz mais sentido: (B) Protético = profissional do ecossistema** — e o **laboratório** é que ocupa o papel de *fornecedor*. Justificativa: o protético, como humano, se encaixa perfeitamente em Pessoa→Vínculo→Workspace (igual a dentista/biomédico); empurrá-lo para "fornecedor" o trataria como entidade não-humana e quebraria o login/marketplace/áreas que já funcionam para ele. A natureza "fornecimento" pertence ao **laboratório**, não ao indivíduo (ver Análise 4). (C) só seria verdade se um protético autônomo *fosse* o próprio laboratório — caso que o modelo atual não distingue.
+
+---
+
+## ANÁLISE 4 — Laboratórios
+
+**Hoje aparecem como:** **(A) Cadastro interno** — `protese_laboratorios` escopado por clínica, alimentando OS e custo lab. Não há identidade própria nem login; não cruzam clínicas.
+
+| Classificação | Vantagens | Desvantagens |
+|---|---|---|
+| **A) Cadastro auxiliar** (estado atual) | Simples; isolado por clínica; zero atrito | Cada clínica recadastra o mesmo laboratório; sem visão consolidada; sem relação direta com a pessoa protético |
+| **B) Participante do ecossistema** (entidade própria) | Laboratório único reaproveitável; liga custo lab à entidade real; base para reputação/histórico | Exige resolver identidade/duplicidade e governança de dados entre clínicas |
+| **C) Workspace independente** | Coerente com a linha Pessoa/Workspace; laboratório operaria como ator (recebe OS de várias clínicas) | Maior complexidade de tenancy; só se justifica se o laboratório for *operar dentro* da plataforma |
+
+**Análise (sem assumir locação):** hoje é **A**, e isso é consistente com o legado clínica-cêntrico. A tensão é que o laboratório é a **única entidade "fornecedor" real** do sistema e está modelada como simples lookup — o que limita qualquer evolução para histórico/qualidade/integração entre clínicas. **B** é o ponto de equilíbrio entre o estado atual e a direção arquitetural; **C** só se sustenta se o laboratório virar *operador* na plataforma.
+
+---
+
+## ANÁLISE 5 — Pacientes
+
+**Hoje o paciente pertence à CLÍNICA.** Evidências: `pacientes.clinica_id`, **ausência de `usuario_id`**, e até **dois variantes de INSERT** (um com `clinica_id`, outro sem — resíduo legado). Não há identidade de paciente no ecossistema; o mesmo CPF em duas clínicas vira **dois registros**.
+
+- **Compartilhamento entre clínicas:** inexistente (duplicação por clínica).
+- **Histórico:** preso à clínica; não há prontuário único da pessoa.
+- **Multiempresa:** o isolamento é forte (bom para tenancy), mas impede portabilidade.
+- **Privacidade/LGPD:** o modelo atual é, na verdade, **mais seguro por isolamento** (cada clínica é controladora dos seus dados). Um paciente "do ecossistema" exigiria base legal/consentimento para compartilhar histórico entre controladores distintos — não trivial.
+
+**Abordagem mais coerente com a arquitetura ATUAL:** **o paciente pertence à clínica.** É o que o código faz e o que o LGPD-por-isolamento favorece. **Porém** isso é a **maior contradição** com a direção Pessoa→Workspace: o paciente é a única "pessoa" do sistema que **não** é tratada como pessoa. É coerente com o presente e **incoerente com o futuro declarado**.
+
+---
+
+## ANÁLISE 6 — Marketplace
+
+| Módulo | Encaixa em | Evidência |
+|---|---|---|
+| Salas | **Modelo B** | workspace `tipo='sala'`, reservas cross-clínica |
+| Profissionais | **Modelo B** | `profissional_id` → `usuarios`; cruza clínicas |
+| Tutoria | **Modelo B** | candidatura/pagamento ligados à pessoa (`is_tutor`, MercadoPago) |
+| Próteses | **Modelo A** (hoje) | `protese_os` por `clinica_id` |
+| Laboratórios | **Modelo A** (hoje) | cadastro interno por clínica |
+
+**Conclusão:** o marketplace **só faz sentido no Modelo B (Pessoa→Vínculo→Workspace→Marketplace)**. Salas, Profissionais e Tutoria já estão lá porque dependem da **pessoa cruzando fronteiras de clínica** — algo que o Modelo A (Clínica→Tudo) torna impossível sem duplicação. Próteses/Laboratórios são os **retardatários** ainda presos ao Modelo A; são a fronteira onde os dois modelos colidem.
+
+---
+
+## ANÁLISE 7 — Escalabilidade (horizonte 5 anos)
+
+| Cenário | Suporta hoje? | Gargalo |
+|---|---|---|
+| Dentista em múltiplas clínicas | **Parcial** | `vinculos` suporta a identidade, mas `dentistas` **duplica a pessoa por clínica** (agenda/horários presos a `dentistas.id`); não há visão unificada do profissional |
+| Biomédico em vários locais | Parcial | mesma duplicação via tabela-recurso |
+| Profissionais temporários (Delivery) | **Não** | marketplace só tem proposta-mensagem; sem contrato/pagamento/vínculo temporário |
+| Locação de salas | **Sim (estrutura)** | falta captura de pagamento (fluxo financeiro aberto) |
+| Tutoria | **Sim** | escala de oferta de tutores |
+| Marketplace | Parcial | só Tutoria fatura |
+| Protéticos independentes | Parcial | pessoa ok, mas laboratório-fornecedor é cadastro preso à clínica |
+| Redes de clínicas | **Não** | **não existe entidade "rede/grupo" acima da clínica**; workspaces são planos, sem hierarquia |
+
+**O modelo escala?** A **camada de identidade sim**; a **camada operacional não**. Gargalos críticos: (1) **duplicação da pessoa** em `dentistas`/recursos; (2) **paciente não-portável**; (3) **ausência de hierarquia** (rede→clínica); (4) **tenancy de `clinica_id` único** impede consolidação cross-clínica (uma pessoa ver tudo o que é seu em todas as clínicas).
+
+---
+
+## ANÁLISE 8 — Contradições (por gravidade)
+
+| Gravidade | Contradição | Evidência |
+|---|---|---|
+| **ALTA** | `dentistas` é entidade paralela a `usuarios` (mesmo humano duplicado por clínica, com `usuario_id` *opcional*) → identidade fragmentada | `dentistas:1542`, `:328` |
+| **ALTA** | `pacientes` é entidade clínica-presa sem identidade de pessoa, com **dois INSERTs** (com/sem `clinica_id`) → ambiguidade legada + bloqueio de portabilidade | INSERTs de `pacientes` |
+| **MÉDIA** | O "workspace" está **dividido em duas tabelas**: `clinicas` (pessoal/consultorio/clinica) **e** `salas` — conceito único, dois lugares | `clinicas:4823`, `salas` |
+| **MÉDIA** | Acoplamento **role ↔ tipo de workspace** (`donoconsultorio`⇄`tipo='consultorio'`) | `server.js:590` |
+| **MÉDIA** | Estado de capacidades em **dois lugares**: `usuario_plugins` (servidor) vs `localStorage` (cliente) → divergência entre dispositivos | `pluginRegistry.ts`, `me/plugins` |
+| **BAIXA** | Protético-pessoa (profissional) × laboratório (fornecedor) descolados | `protese_laboratorios` |
+| **BAIXA** | `superadmin` fora de `vinculos` (é `usuarios.role`) → plano de auth separado (aceitável, mas assimétrico) | `me/workspaces:5682` |
+
+---
+
+## RESULTADO FINAL
+
+**1. Resumo executivo.** O ScoreOdonto é um ERP odontológico multiempresa em **transição arquitetural declarada no próprio código** ("Fase 1: Clinicas → workspaces"). A **identidade, o acesso e os workspaces já operam no modelo Pessoa→Vínculo→Workspace**; a **operação clínica/financeira permanece clínica-cêntrica**. As três frentes de marketplace já vivem no modelo novo; pacientes, dentistas-recurso e laboratórios são o legado que ainda não migrou. As contradições graves são todas de **identidade duplicada** (a mesma pessoa existindo como `usuarios` + `dentistas`, e o paciente sem identidade de pessoa).
+
+**2. Modelo que melhor representa o sistema HOJE:** **híbrido** — `Pessoa → Vínculo → Workspace` na espinha; `Clínica → Pacientes/Dentistas/Financeiro` na operação.
+
+**3. Modelo que melhor representa o sistema NO FUTURO:** `Pessoa → Vínculo → Workspace → Serviços → Marketplace → Financeiro` — e o código já está pavimentado para ele.
+
+**4. Entidades CORRETAMENTE classificadas:** `usuarios` (Pessoa), `vinculos` (Vínculo+RBAC), Clínica/Consultório/Sala como **workspaces**, Dentista/Biomédico/Protético/Tutor como **papéis da pessoa**, Profissional do marketplace e capacidades (`areas`/`plugins`) como atributos da pessoa.
+
+**5. Entidades MAL classificadas:**
+- **`dentistas`** — modelada como entidade própria; é, na verdade, uma **projeção da pessoa por workspace** (duplica o humano).
+- **`pacientes`** — entidade presa à clínica; é a única "pessoa" do sistema **não tratada como pessoa**.
+- **Laboratórios** — cadastro auxiliar; é o **único fornecedor real** e está subdimensionado.
+- **Consultório** — vive como role **e** tipo (redundância).
+
+**6. Riscos arquiteturais:** identidade fragmentada (dentistas); paciente não-portável e com resíduo de schema; conceito de workspace partido em duas tabelas; ausência de hierarquia "rede→clínica"; tenancy de `clinica_id` único barrando visão consolidada da pessoa; estado de plugins divergente cliente/servidor.
+
+**7. Oportunidades arquiteturais:** a "Fase 1" **já entregou o mais difícil** (identidade + vínculo + workspace + workspace pessoal automático). O ecossistema (marketplace, salas, tutoria) **só existe** porque essa base existe. Unificar as entidades-recurso (dentista) e a entidade-paciente sob a pessoa **destravaria de uma vez** multi-clínica, portabilidade de histórico, redes e o marketplace — sem reescrever o que já está certo.
+
+**8. Recomendação estratégica única:** **assumir e consolidar a PESSOA como âncora única do sistema, reconhecendo que a clínica já é — no código — apenas um tipo de workspace.** A decisão estratégica de fundo não é "se" migrar para Pessoa→Vínculo→Workspace (o sistema já escolheu isso na Fase 1), e sim **parar de manter o legado clínica-cêntrico em paralelo** nas duas entidades que ainda o sustentam (paciente e dentista-recurso) — pois é a coexistência dos dois modelos, não a escolha de um, que gera todas as contradições de gravidade ALTA.
+
+---
+
+> *Nota de método: tudo acima decorre de leitura de `backend/server.js`, do schema real (tabelas `usuarios`,
+> `vinculos`, `clinicas`, `pacientes`, `dentistas`, `salas`, `protese_*`, `propostas_profissional`) e do
+> `MAPA-FUNCIONAL-COMPLETO.md`. Onde o código tinha ambiguidade (ex.: dois INSERTs de `pacientes`, role↔tipo),
+> descreveu-se o fato observado, sem inferir intenção. Conforme solicitado, não há propostas de implementação,
+> migrations, código ou tarefas.*
+</content>

documentação/MAPA-FUNCIONAL-COMPLETO.md

@@ -0,0 +1,485 @@
+# MAPA FUNCIONAL COMPLETO — ScoreOdonto
+
+> **Auditoria funcional baseada SOMENTE em evidências do código.** Nada aqui foi assumido.
+> Fonte: `frontend/` (React 19 + Vite, roteador próprio em `App.tsx`) e `backend/server.js`
+> (Express monolítico, ~516 KB, **277 rotas**, ~70 tabelas Postgres acessadas por SQL direto).
+> Estado verificado: produção `v1.0.18` · DEV `dev` (banco isolado `pgdev`). Data: 19/jun/2026.
+
+---
+
+## Sumário executivo (o que o sistema É, na prática)
+
+O ScoreOdonto é um **ERP odontológico multiempresa** (SaaS) cujo núcleo é o ciclo
+**Lead → Paciente → Agenda → Procedimento → Financeiro → Comissão → Repasse**, com módulos
+clínicos (Ortodontia, Próteses/GTO, RX), administrativos (Equipe/RBAC, Planos, Procedimentos)
+e três frentes de marketplace (**Locação de Salas**, **Diretório/Propostas de Profissionais**,
+**Tutoria de Ortodontia** — esta última a única com cobrança automatizada via MercadoPago).
+
+A arquitetura é **multi-tenant real**: quase toda rota passa por `tenantGuard` e filtra por
+`clinica_id`. O "workspace" ativo (clínica **ou** sala) governa menu, permissões e dados visíveis.
+
+**Evidências estruturais:**
+- Frontend sem `react-router`: roteamento próprio (`ROUTE_MAP` / `VIEW_TO_ROUTE` em `App.tsx`).
+- 44 views (`frontend/views/*.tsx`), 16 componentes, 3 plugins.
+- Backend num único `server.js` (516 KB) — sem camada de serviços/controllers separada.
+- Prisma quase não usado (4 modelos legados de GTO); o banco real é SQL puro via `pg`.
+
+---
+
+# ETAPA 1 — INVENTÁRIO DE ROTAS
+
+Roteamento definido em `frontend/App.tsx` (`ROUTE_MAP`, `VIEW_TO_ROUTE`, `renderView`, `isViewAllowed`).
+**Papéis (roles):** `superadmin`, `admin`, `donoclinica`, `donoconsultorio`, `funcionario`,
+`dentista`, `biomedico`, `protetico`, `paciente`, `donosala`.
+**Tipos de workspace:** `clínica` (padrão) e `sala` (isola o contexto). **Plugins:** `rx-scoreodonto`,
+`locacao-salas` (sempre ON), `profissionais-marketplace`.
+
+| URL | View | Componente / Arquivo | Acesso (papéis) | Origem | Destino |
+|---|---|---|---|---|---|
+| `/` | landing | `LandingPage.tsx` | Público | — | login / área |
+| `/login` | login | `LoginView.tsx` | Público | landing | dashboard por papel |
+| `/contato` | public | `PublicContactForm.tsx` | Público | landing | cria interesse/lead |
+| `/dashboard` | dashboard | `Dashboard.tsx` | admin/donos/func/dentista/bio/prot | login, menu | agenda, pacientes |
+| `/leads` | leads | `LeadsView.tsx` | admin/donos/funcionário | menu | converter→paciente+agenda |
+| `/pacientes` | pacientes | `PatientsView.tsx` | admin/donos/funcionário | menu, dashboard | agenda, orçamento, procedimento, ortodontia, RX |
+| `/agenda` | agenda | `AgendaView.tsx` | quase todos os papéis clínicos | menu, dashboard | paciente, avaliação, procedimento |
+| `/ortodontia` | ortodontia | `OrthoView.tsx` | dentista (odonto) | menu, paciente | evolução, fotos, tutoria |
+| `/financeiro` | financeiro | `FinanceiroView.tsx` | admin/donos/funcionário | menu | comissão, glosa |
+| `/comissoes` | comissoes | `ComissoesView.tsx` | admin/donos | **menu apenas** ⚠️ | repasse |
+| `/glosas` | glosas | `GlosasView.tsx` | admin/donos/funcionário | **menu apenas** ⚠️ | recebíveis convênio |
+| `/proteses` | proteses | `ProteseView.tsx` | dentista/protético/func | menu | OS de laboratório, GTO |
+| `/orcamentos` | orcamentos | `OrcamentosView.tsx` | admin/donos/funcionário | menu, paciente | contrato |
+| `/contratos` | contratos | `ContratosView.tsx` | admin/donos/funcionário | menu, orçamento | cobrança/financeiro |
+| `/relatorios` | relatorios | `ReportsView.tsx` | admin/donos/funcionário | menu | — |
+| `/tratamentos` | tratamentos | `MeusTratamentos.tsx` | paciente + clínicos | menu | — |
+| `/lancar-gto` | lancar-gto | `LancarGTO.tsx` | biomédico/protético/func | menu | guias odontológicas |
+| `/notificacoes` | notificacoes | `NotificationsView.tsx` | todos | menu | — |
+| `/clinicas` | clinicas | `ClinicasView.tsx` | membros | menu, seletor de workspace | criar-clinica |
+| `/gestao-equipe` | gestao-equipe | `GestaoEquipeView.tsx` | admin/donos | menu | membros, cargos (RBAC) |
+| `/admin/dentistas` | dentistas | `AdminViews.tsx` | admin/donos | menu | horários |
+| `/admin/especialidades` | especialidades | `AdminViews.tsx` | admin/donos/biomédico | menu | procedimentos |
+| `/admin/procedimentos` | procedimentos | `AdminViews.tsx` | admin/donos/biomédico | menu | valores por plano |
+| `/admin/planos` | planos | `AdminViews.tsx` | admin/donos | menu | — |
+| `/admin/sync` | sync | `AdminViews.tsx` (`SyncView`) | **NINGUÉM (bloqueado)** ⚠️ | — | — |
+| `/plugins` | plugins | `PluginsView.tsx` | **superadmin apenas** | menu (superadmin) | ativa plugins |
+| `/rx-radiografias` | rx-radiografias | `plugins/RXPlugin.tsx` | dentista/donos/func (plugin RX) | menu | dispositivos RX |
+| `/rx-config` | rx-config | `RxConfigView.tsx` | admin/donos/superadmin | menu | dispositivos RX |
+| `/salas` `/minhas-salas` `/alugar-salas` | salas | `plugins/SalasPlugin.tsx` | todos (plugin `locacao-salas`, sempre ON) | menu | reservas |
+| `/sala-home` | sala-home | `SalaHomeView.tsx` | workspace tipo `sala` | seletor de workspace | reservas da sala |
+| `/marketplace-profissionais` | marketplace-profissionais | `plugins/ProfissionaisPlugin.tsx` | clínicos exceto paciente (plugin) | menu | propostas |
+| `/diretorio-profissionais` | diretorio-profissionais | `DiretorioProfissionaisView.tsx` (absorvido pelo plugin) | clínicos | menu | — |
+| `/candidatura-tutor` | candidatura-tutor | `TutorCandidaturaView.tsx` | dentista | menu | pagamento MercadoPago |
+| `/tutoria-painel` | tutoria-painel | `TutorPainelView.tsx` | **tutores aprovados** (`is_tutor`) | menu | solicitações |
+| `/admin-gestao-tutores` | admin-gestao-tutores | `AdminGestaoTutoresView.tsx` | **superadmin** | menu | confirma pagamentos/repasses |
+| `/criar-clinica` | criar-clinica | `CreateClinicView.tsx` | admin/donos sem workspace | pós-cadastro | dashboard |
+| `/cadastro-dentista` | cadastro-dentista | `DentistRegisterView.tsx` | standalone (magic-link) | **menu apenas** ⚠️ | aguardando-convite |
+| `/aguardando-convite` | aguardando-convite | `WaitingInviteView.tsx` | dentista/bio/prot sem vínculo | pós-cadastro | — |
+| `/superadmin/*` | superadmin-* | `SuperAdminView.tsx` (tabs) | **superadmin** | menu | usuários, clínicas, logs, financeiro, notificações |
+| `/update` | update | `UpdateDbView.tsx` | técnica (URL direta, sempre liberada) | **fora do menu** | migração de banco |
+
+**⚠️ Inconsistências de roteamento encontradas (evidência: `ROUTE_MAP` vs `VIEW_TO_ROUTE` em `App.tsx`):**
+- `/comissoes`, `/glosas` e `/cadastro-dentista` **existem em `VIEW_TO_ROUTE`** (a navegação por menu empurra a URL),
+  mas **NÃO existem em `ROUTE_MAP`**. Consequência: abrir essas URLs direto (deep-link / refresh) cai em `dashboard`.
+  **Deep-link quebrado** para 3 telas reais.
+- `/admin/sync` está mapeada, mas `isViewAllowed` retorna `false` **sempre** (substituída por "backup por clínica").
+  A tela e a rota existem, porém são **inacessíveis** (código morto navegável).
+
+---
+
+# ETAPA 2 — INVENTÁRIO DE TELAS
+
+(Resumo por tela — objetivo / usuário-alvo / valor / dependências / impacto. Apenas telas reais.)
+
+### Dashboard
+- **Objetivo:** visão consolidada (KPIs via `GET /api/dashboard/stats`). **Usuário:** gestores/clínicos.
+- **Valor:** ponto de entrada operacional. **Depende de:** agenda, pacientes, financeiro. **Impacta:** navegação.
+
+### Leads / Gestão de Leads
+- **Objetivo:** captar e **converter** interessados em pacientes. **Usuário:** funcionário/donos.
+- **Valor:** topo do funil comercial. **Depende de:** `interesses`/contato público. **Impacta:** Pacientes + Agenda
+  (a conversão cria ambos — `POST /api/leads/:id/converter`).
+
+### Pacientes
+- **Objetivo:** prontuário e cadastro (dados, família, score, faltas). **Usuário:** funcionário/donos.
+- **Valor:** entidade central do negócio. **Depende de:** clínica ativa. **Impacta:** Agenda, Orçamento,
+  Procedimento realizado, Ortodontia, RX, Receita/Exame. É o hub clínico (view de 92 KB).
+
+### Agenda
+- **Objetivo:** agendar/confirmar/remarcar; controle de presença e anti-overbooking. **Usuário:** todos clínicos.
+- **Valor:** coração operacional. **Depende de:** Pacientes, Dentistas+horários. **Impacta:** Avaliação,
+  Procedimento, Financeiro (presença libera lançamento).
+
+### Ortodontia
+- **Objetivo:** tratamento orto completo (triagem, diagnóstico, plano, evoluções, fotos, contenção). **Usuário:** dentista.
+- **Valor:** vertical clínica de alto valor recorrente. **Depende de:** Paciente. **Impacta:** Tutoria, fotos.
+
+### Próteses / GTO
+- **Objetivo:** OS de laboratório (`protese_os`), produtos, custo lab, entrega. **Usuário:** protético/dentista.
+- **Valor:** controle do laboratório e do custo que abate comissão. **Depende de:** Procedimentos, Laboratórios.
+  **Impacta:** Comissão (custo lab entra no cálculo).
+
+### Financeiro
+- **Objetivo:** contas a receber/pagar (`financeiro`: RECEITA/DESPESA), formas, centro de custo, fornecedor. **Usuário:** gestores.
+- **Valor:** caixa da clínica. **Depende de:** Procedimentos realizados, Contratos, Repasses. **Impacta:** Comissão, Glosa.
+
+### Comissões
+- **Objetivo:** definir % (padrão da clínica, por procedimento, override por profissional) e ver produção/comissão.
+- **Usuário:** donos. **Depende de:** Procedimentos realizados + Próteses (custo lab). **Impacta:** Repasses.
+
+### Glosas
+- **Objetivo:** registrar glosa sobre recebíveis (convênio), recorrer, recuperar. **Usuário:** gestores.
+- **Valor:** recupera receita negada por convênio. **Depende de:** Financeiro (recebíveis). **Impacta:** caixa.
+
+### Orçamentos → Contratos
+- **Objetivo:** propor tratamento (itens/valores) e formalizar em contrato (modelos com variáveis, assinatura, cobrança).
+- **Usuário:** funcionário/donos. **Depende de:** Paciente, Procedimentos. **Impacta:** Financeiro (`gerar-cobranca`).
+
+### Equipe / Usuários (RBAC)
+- **Objetivo:** membros, cargos (`funcoes`), setores e permissões por workspace. **Usuário:** donos.
+- **Valor:** governa quem vê o quê. **Impacta:** menu e `isViewAllowed` de todos os membros.
+
+### Salas (Locação) / Painel da Sala
+- **Objetivo:** cadastrar salas, publicar no marketplace, receber/aceitar reservas. **Usuário:** qualquer conta.
+- **Valor:** receita de locação P2P. **Depende de:** conta/sala. **Impacta:** `sala_reservas`.
+
+### Marketplace de Profissionais / Diretório
+- **Objetivo:** profissional publica perfil; clínica envia proposta (`propostas_profissional`). **Usuário:** clínicas e profissionais.
+- **Valor:** conexão oferta/demanda de mão de obra. **Impacta:** mensagens/propostas (sem cobrança hoje).
+
+### Tutoria de Ortodontia (Candidatura / Painel / Gestão)
+- **Objetivo:** dentista vira tutor (pagando inscrição via MercadoPago); resolve solicitações orto.
+- **Usuário:** dentistas + superadmin (gestão). **Valor:** **única receita de plataforma automatizada**.
+
+### SuperAdmin (overview/users/clínicas/logs/financeiro/notificações)
+- **Objetivo:** administração global da plataforma (preços/assinaturas, broadcast, auditoria de acesso).
+- **Usuário:** superadmin. **Valor:** operação do SaaS.
+
+### Configurações / Notificações / Minhas Clínicas
+- Conta, integrações (Google), backup por clínica; notificações; seletor/gestão de workspaces.
+
+---
+
+# ETAPA 3 — INVENTÁRIO DE BOTÕES (telas transacionais)
+
+Rótulos extraídos das views; ações mapeadas para as rotas/tabelas do backend.
+
+### Agenda (`AgendaView.tsx`)
+- **Novo Agendamento** → `POST /api/agendamentos` → tabela `agendamentos`. Fluxo: Paciente ↓ Procedimento ↓ Financeiro.
+- **Confirmar / Confirmar Presença** → `POST /api/agendamentos/:id/confirmar` + `/api/agenda/presenca` → `agendamentos`, `agenda_presenca`. **Libera lançamento financeiro.**
+- **Reagendar / Remarcar** → `POST /api/agendamentos/:id/remarcar` → `agendamentos`.
+- **Registrar Falta** → `POST /api/agendamentos/:id/falta` → `agendamentos` (impacta score do paciente).
+- **Solicitar Avaliação** → `POST /api/agendamentos/:id/solicitar-avaliacao` → `avaliacoes`.
+
+### Pacientes (`PatientsView.tsx`)
+- **Editar/Cadastrar Paciente** → `POST|PUT /api/pacientes` → `pacientes`.
+- **Agendar** → abre fluxo da Agenda. **Lançar Procedimento** (`LancarProcedimentoModal`) → `POST /api/procedimentos-realizados` → `procedimentos_realizados` (+ gera `financeiro`).
+- **Orçamento** (`OrcamentoModal`) → `orcamentos`. **Receita** (`ReceitaModal`) → `modelos_receita`/`items_receita`. **Pedido de Exame** (`PedidoExameModal`) → `pedidos_exame`.
+
+### Financeiro (`FinanceiroView.tsx`)
+- **Novo lançamento** (RECEITA/DESPESA, forma, vencimento, centro de custo, fornecedor) → `POST /api/financeiro` → `financeiro`.
+- **Marcar Pago / Alterar / Excluir** → `PUT|DELETE /api/financeiro/:id` → `financeiro`.
+
+### Comissões (`ComissoesView.tsx`)
+- **Salvar % padrão / por procedimento / override por profissional** → `PUT /api/comissoes/regras` → `comissao_regras`.
+- **Base de cálculo** (produção × recebido) e **Custo lab** abatido. Próximo fluxo: **Fechar repasse**.
+
+### Repasses (em Financeiro/Comissões)
+- **Fechar Repasse** → `POST /api/repasses/fechar` → `repasses` (status `fechado`).
+- **Pagar** → `POST /api/repasses/:id/pagar` → cria DESPESA em `financeiro` (origem `repasse`, centro de custo `COMISSÕES`).
+- **Anexar Comprovante** → `POST /api/repasses/:id/comprovante`. **Cancelar** → estorna a despesa.
+
+### Glosas (`GlosasView.tsx`)
+- **Registrar Glosa** (total/livre, motivo, valor) → `POST /api/glosas` → `glosas`.
+- **Recorrer** → `POST /api/glosas/:id/recorrer`. **Recuperar** → `POST /api/glosas/:id/recuperar`.
+
+### Orçamentos / Contratos
+- **Novo Orçamento** (itens, valor, entrada, parcelas) → `POST /api/orcamentos` → `orcamentos`/`orcamento_itens`.
+- **Gerar Contrato** (modelo + variáveis + prévia) → `POST /api/contratos/instancias` → `contratos`.
+- **Enviar / Assinar / Gerar Cobrança / Cancelar** → `POST /api/contratos/instancias/:id/{enviar,assinar,gerar-cobranca,cancelar}` → liga ao `financeiro`.
+
+### Próteses (`ProteseView.tsx`)
+- **Nova OS** (produto, dentes, material, custo lab, preço, prazo) → `POST /api/protese/os` → `protese_os`.
+- **Marcar Entregue / Mudar Status** → `POST /api/protese/os/:id/status` → `protese_os_evento`.
+
+### Leads (`LeadsView.tsx`)
+- **Cadastrar Lead** → `POST /api/leads` → `leads`.
+- **Cadastrar o Paciente / Converter** (com data, hora, dentista) → `POST /api/leads/:id/converter` → cria `pacientes` **+** `agendamentos` (anti-overbooking).
+
+---
+
+# ETAPA 4 — FLUXOS DE NEGÓCIO
+
+## Fluxo principal (núcleo do produto) — COMPLETO
+
+```
+Lead/Interesse ──converter──▶ Paciente ──▶ Agenda ──confirmar/presença──▶ Atendimento
+   (leads)                   (pacientes)  (agendamentos)                      │
+                                                                              ▼
+                                                            Procedimento Realizado
+                                                            (procedimentos_realizados)
+                                                                              │ valor>0
+                                                                              ▼
+                                                   Financeiro RECEITA (origem='procedimento')
+                                                            (financeiro, flag sem_comissao)
+                                                                              │
+                                          computeComissoes = (base − custo_lab) × %
+                                                                              ▼
+                                              Repasse FECHADO (repasses) ──pagar──▶
+                                              Financeiro DESPESA (origem='repasse',
+                                                       centro_custo='COMISSÕES')
+```
+
+- **Onde começa:** Lead/Interesse (ou cadastro direto de Paciente).
+- **Onde termina:** pagamento do repasse ao profissional (DESPESA conciliada no caixa) — ciclo fechado.
+- **Onde quebra / desvio:**
+  - **Geração de RECEITA é opcional** (`gerarLancamento !== false` e `valor>0`): um procedimento sem valor
+    **não** entra no financeiro — possível receita não registrada (depende do operador).
+  - **Glosa** é um ramo paralelo sobre recebíveis de convênio (recupera receita), não integrado ao repasse.
+  - **Garantia/Reabertura** marcam `sem_comissao` (regra: garantia sempre; reabertura só se mesmo profissional)
+    — corretamente excluídas do repasse.
+- **Duplicidade:** não há dupla geração de comissão — o repasse pago entra como DESPESA com `sem_comissao=true`
+  (evita recomissionar). Bom controle.
+
+## Fluxo comercial paralelo
+
+```
+Orçamento (orcamentos) ──▶ Contrato (contratos) ──gerar-cobranca──▶ Financeiro (a receber)
+```
+
+## Fluxos de marketplace (ver Etapas 7 e 8)
+
+```
+Sala (salas) ──publica──▶ Marketplace ──reserva──▶ sala_reservas (valor, status) [pagamento MANUAL]
+Profissional ──perfil──▶ Diretório ──proposta──▶ propostas_profissional (mensagem) [sem cobrança]
+Dentista ──candidatura──▶ MercadoPago (pago) ──webhook──▶ Tutor ativo ──▶ Solicitações de tutoria
+```
+
+---
+
+# ETAPA 5 — MATRIZ DE MÓDULOS
+
+| Módulo | Existe? | Acessível? | Funcional? | Completo? | Em uso? | Classificação |
+|---|---|---|---|---|---|---|
+| Autenticação / Workspaces / RBAC | Sim | Sim | Sim | Sim | Sim | **Maduro** |
+| Pacientes | Sim | Sim | Sim | Sim | Sim | **Maduro** |
+| Agenda (+presença/anti-overbooking) | Sim | Sim | Sim | Sim | Sim | **Maduro** |
+| Financeiro (receita/despesa) | Sim | Sim | Sim | Sim | Sim | **Maduro** |
+| Comissão + Repasse | Sim | Sim | Sim | Sim | Sim | **Operacional** |
+| Glosas | Sim | menu apenas (deep-link quebrado) | Sim | Parcial | Sim | **Operacional** |
+| Orçamentos → Contratos | Sim | Sim | Sim | Sim | Sim | **Operacional** |
+| Ortodontia | Sim | Sim | Sim | Sim | Sim | **Maduro** |
+| Próteses / GTO | Sim | Sim | Sim | Parcial | Sim | **Operacional** |
+| Leads | Sim | Sim | Sim | Sim | Sim | **Operacional** |
+| Plano/Procedimentos/Especialidades | Sim | Sim | Sim | Sim | Sim | **Operacional** |
+| RX / Radiografias (plugin) | Sim | por plugin/papel | Sim | Parcial | depende clínica | **Parcial** |
+| Locação de Salas (marketplace) | Sim | Sim (sempre ON) | Sim | Parcial (sem gateway) | baixo | **Parcial** |
+| Marketplace Profissionais | Sim | por plugin | Sim | Parcial (só mensagem) | baixo | **MVP** |
+| Tutoria de Ortodontia (MercadoPago) | Sim | Sim | Sim | Sim | baixo | **Operacional** |
+| SuperAdmin | Sim | superadmin | Sim | Sim | Sim | **Operacional** |
+| Sync Google/legado (global) | Sim | **bloqueado** | parcial | — | **não** | **Abandonado** |
+| Relatórios | Sim | Sim | Sim | Parcial | Sim | **Parcial** |
+
+---
+
+# ETAPA 6 — MULTIEMPRESA
+
+**Evidência:** quase todas as 277 rotas usam `tenantGuard` e filtram por `req.clinicaId`/`clinica_id`.
+O workspace ativo é resolvido por `GET /api/me/workspaces` (tabela `vinculos` = usuário↔clínica) + salas próprias.
+
+| Entidade | Como é modelada | Multiempresa respeitado? |
+|---|---|---|
+| Workspaces | `vinculos` (clínica) + `salas` (tipo `sala`); seletor no Sidebar | ✅ Sim |
+| Clínicas | `clinicas` + `clinica_id` em todas as tabelas operacionais | ✅ Sim |
+| Consultórios | papel `donoconsultorio` (variação de dono, mesmo modelo de clínica) | ✅ Sim |
+| Dentistas / Biomédicos / Protéticos | papéis distintos com menus próprios; vínculo por clínica | ✅ Sim |
+| Salas | `salas` + workspace `tipo='sala'` **isola** o contexto (menu reduzido) | ✅ Sim |
+| Laboratórios | `protese_laboratorios` por clínica | ✅ Sim |
+
+- **Acoplamento indevido:** **não** encontrado acoplamento a "clínica única" — o `clinica_id` é onipresente.
+- **Ponto de atenção:** o contexto é **cacheado no `localStorage`** (`SCOREODONTO_USER_DATA`, plugins) e
+  reconciliado via `hydrateMyPlugins()`. Plugins ativos vivem em `localStorage` (cliente), não só no servidor —
+  risco de divergência entre dispositivos (mitigado por `me/plugins`, mas é o elo mais frágil do multiempresa).
+- O **marketplace de salas é cross-tenant** por desenho (uma clínica aluga sala de outra) — acoplamento *intencional*.
+
+**Veredito:** conceito multiempresa **bem respeitado** no backend; a fragilidade é o estado de UI/plugins no cliente.
+
+---
+
+# ETAPA 7 — MARKETPLACE
+
+```
+Salas (salas) ─┬─ Locação (sala_reservas: valor, modelo, status pendente/aceita)
+               └─ Profissionais (perfil) ─ Propostas (propostas_profissional: mensagem)
+                                         └─ Protéticos/Laboratórios (protese_*)
+```
+
+| Frente | O que existe hoje | O que falta | Gera receita? | Pode gerar |
+|---|---|---|---|---|
+| **Locação de salas** | CRUD de salas, publicação no marketplace, reserva com `valor` e workflow de status (`pendente`→`aceita`), painel da sala | **Gateway de pagamento** e taxa da plataforma (hoje o `valor` é registrado, mas o pagamento é **manual/externo**) | **Não diretamente** | **Sim** — comissão sobre locação |
+| **Profissionais** | Perfil público + envio de proposta (mensagem) clínica→profissional | Negociação, contrato, e qualquer cobrança | **Não** | Sim — taxa de match/assinatura premium |
+| **Protéticos / Laboratórios** | OS, produtos, custo lab integrados ao financeiro/comissão | Marketplace aberto de laboratórios (hoje é interno por clínica) | Indireto (operacional) | Sim — rede de laboratórios |
+| **Tutoria de Ortodontia** | Candidatura **paga via MercadoPago** (`preferences` + `mp-webhook`), `comissao_pct`, solicitações/mensagens | Escala (oferta de tutores), avaliação | ✅ **Sim (a única automatizada)** | Já gera |
+
+**Conclusão:** a infraestrutura de marketplace existe, mas **só a Tutoria tem captura de pagamento real**.
+Salas é a frente mais próxima de monetizar (já tem `valor` e reservas) — falta o gateway + a taxa.
+
+---
+
+# ETAPA 8 — FINANCEIRO
+
+```
+ORIGEM DO DINHEIRO                  →  DESTINO                       →  RESPONSÁVEL
+Procedimento realizado (RECEITA)   →  financeiro (a receber)        →  Clínica
+Contrato (gerar-cobranca)          →  financeiro (a receber)        →  Clínica
+Convênio (recebíveis) − Glosa      →  financeiro / recupera         →  Clínica
+Comissão (base − custo lab × %)    →  repasses (fechado)            →  Profissional
+Repasse pago                       →  financeiro DESPESA (COMISSÕES) →  Clínica paga Profissional
+Locação de sala (valor reserva)    →  sala_reservas (status)        →  Locador  [pagamento manual]
+Tutoria (inscrição)                →  MercadoPago → ativa tutor     →  Plataforma (comissao_pct)
+```
+
+| Item | Tabela | Estado |
+|---|---|---|
+| Orçamentos | `orcamentos`/`orcamento_itens` | ✅ completo |
+| Contratos | `contratos`/`contrato_*` | ✅ completo (modelos, variáveis, assinatura, cobrança) |
+| Convênios/Planos | `planos`, `procedimentos_valores_planos` | ✅ |
+| Produção | `procedimentos_realizados` → `financeiro` | ✅ (RECEITA opcional por valor) |
+| Comissão | `comissao_regras` + `computeComissoes` | ✅ (3 níveis de regra; abate custo lab) |
+| Repasse | `repasses` (fechar/pagar/cancelar/comprovante) | ✅ ciclo fechado, com estorno |
+| Glosas | `glosas` (recorrer/recuperar) | ✅ funcional, isolado do repasse |
+| Locação | `sala_reservas.valor` | ⚠️ registra valor, **sem captura de pagamento** |
+
+**Pontos fortes:** rastreabilidade (cada DESPESA de repasse referencia o período/profissional; `audit_log` em tudo),
+e não-duplicação de comissão (`sem_comissao` propagado). **Lacuna:** receita de procedimento depende de ação manual.
+
+---
+
+# ETAPA 9 — MAPA DE CONEXÕES (Mermaid)
+
+```mermaid
+flowchart TD
+  U[Usuário] --> WS{Workspace ativo}
+  WS -->|clínica| CL[Clínica / RBAC]
+  WS -->|sala| SH[Painel da Sala]
+
+  CL --> LEAD[Leads]
+  LEAD -->|converter| PAC[Pacientes]
+  PAC --> AG[Agenda]
+  AG --> AV[Avaliação]
+  AG --> PR[Procedimento Realizado]
+  PAC --> ORTO[Ortodontia]
+  PAC --> RX[RX / Radiografias]
+  PAC --> ORC[Orçamento]
+  ORC --> CON[Contrato]
+  CON -->|gerar-cobranca| FIN[Financeiro]
+  PR -->|RECEITA| FIN
+  PR --> COM[Comissão]
+  PROT[Próteses / Custo Lab] --> COM
+  COM --> REP[Repasse]
+  REP -->|pagar DESPESA| FIN
+  FIN --> GLO[Glosas]
+  FIN --> REL[Relatórios]
+
+  SH --> RES[Reservas de Sala]
+  CL --> SAL[Salas Marketplace]
+  SAL --> RES
+  CL --> MKP[Marketplace Profissionais]
+  MKP --> PROP[Propostas]
+  ORTO --> TUT[Tutoria Orto]
+  TUT -->|MercadoPago| MP[(Pagamento)]
+
+  SUPER[SuperAdmin] --> CL
+  SUPER --> PLUG[Plugins]
+```
+
+```mermaid
+flowchart LR
+  subgraph Núcleo financeiro
+    PR[procedimentos_realizados] --> FINr[financeiro RECEITA]
+    FINr --> CR[comissao_regras]
+    CR --> RP[repasses]
+    RP --> FINd[financeiro DESPESA]
+    FINr --> GL[glosas]
+  end
+```
+
+---
+
+# ETAPA 10 — OPORTUNIDADES
+
+## Funcionalidades órfãs (existem no código, ninguém usa)
+- **`views/OrthoReports.tsx`** — não é roteada em `App.tsx` **nem** importada por nenhuma view. Órfã real
+  (importa `OrthoPhotoWorkspace`, mas nada importa `OrthoReports`). Relatórios de ortodontia prontos e desligados.
+- **`SyncView` (`/admin/sync`)** — tela e rota existem, mas `isViewAllowed` retorna `false` sempre. Código morto navegável.
+
+## Funcionalidades escondidas (existem mas não aparecem no menu)
+- **`/update` (`UpdateDbView`)** — migração de banco; acessível por URL direta, fora do menu (ferramenta técnica).
+- **`/cadastro-dentista`** — só alcançável por fluxo/magic-link; sem entrada no menu e com deep-link quebrado.
+- **Comissões deep-link** — visível no menu (admin/donos) mas `/comissoes` direto cai em dashboard.
+
+## Funcionalidades incompletas (começam mas não terminam o fluxo)
+- **Locação de salas** — reserva com `valor` e status, mas **sem captura de pagamento** (fluxo financeiro não fecha).
+- **Marketplace de profissionais** — proposta é só mensagem; **não** evolui para contratação/cobrança.
+- **RECEITA de procedimento opcional** — pode não gerar lançamento (receita potencialmente não registrada).
+- **Glosas isoladas** — recuperam receita, mas não reconciliam com o repasse correspondente.
+
+## Funcionalidades de alto potencial (podem gerar receita)
+1. **Gateway na Locação de Salas** (já existe `valor`+reserva): cobrança + taxa da plataforma → receita recorrente.
+2. **Assinatura/planos da plataforma** (`superadmin/pricing`, `assinaturas` já existem): monetizar o SaaS por clínica.
+3. **Marketplace de Profissionais premium**: taxa de match / destaque de perfil.
+4. **Tutoria de Ortodontia em escala** (único pago hoje): aumentar oferta de tutores e volume.
+
+---
+
+# RESULTADO FINAL
+
+## Notas (0–100) — com base nas evidências
+
+| Eixo | Nota | Justificativa (evidência) |
+|---|---:|---|
+| **Arquitetura funcional** | 72 | Roteamento+RBAC robustos, mas `server.js` monolítico (516 KB), roteador próprio e 3 deep-links quebrados. |
+| **Integração dos módulos** | 78 | Cadeia Lead→…→Repasse bem costurada, com auditoria e não-duplicação de comissão. |
+| **Fluxos de negócio** | 70 | Núcleo clínico+financeiro completo; ramos de marketplace incompletos; receita às vezes manual. |
+| **Multiempresa** | 82 | `tenantGuard`+`clinica_id` onipresentes; isolamento de sala; fragilidade no estado de plugins no cliente. |
+| **Marketplace** | 45 | Infra existe; só Tutoria captura pagamento; Salas e Profissionais sem fechar fluxo financeiro. |
+| **Financeiro** | 80 | Receita/despesa, comissão (3 níveis), repasse com estorno, glosas, contratos com cobrança. |
+| **Experiência do usuário** | 70 | Menus por papel, nav mobile, "visualizar como"; prejudicada por deep-links quebrados e estado em localStorage. |
+| **Potencial de monetização** | 65 | Tutoria já fatura; Salas e Assinatura SaaS são alavancas prontas e subutilizadas. |
+
+## 1. O que remover
+- `views/OrthoReports.tsx` (órfã) — ou religar ao menu de Ortodontia se desejado.
+- `SyncView` / rota `/admin/sync` e telas de sync global desativadas (já substituídas por backup por clínica).
+- `server.js.bak` e scripts de transformação legados (`transform.js`, `pg-convert.js`) do diretório de produção.
+
+## 2. O que corrigir
+- **Adicionar `/comissoes`, `/glosas`, `/cadastro-dentista` ao `ROUTE_MAP`** (deep-link/refresh quebrado).
+- Reconciliação de **plugins ativos**: tratar o servidor como fonte da verdade (reduzir dependência de `localStorage`).
+- Tornar a **geração de RECEITA do procedimento** o padrão claro (evitar receita não registrada).
+
+## 3. O que finalizar
+- **Locação de Salas**: captura de pagamento + taxa da plataforma (fecha o fluxo financeiro do marketplace).
+- **Marketplace de Profissionais**: evoluir proposta → contratação → cobrança.
+- **Relatórios**: consolidar (há `reports/productivity` + telas parciais).
+
+## 4. O que priorizar
+1. Corrigir deep-links e estado de plugins (baixo esforço, destrava UX e confiabilidade).
+2. Gateway de pagamento na Locação de Salas (alavanca de receita mais próxima).
+3. Cobrança por assinatura da plataforma (`superadmin/pricing`+`assinaturas` já existem).
+
+## 5. O que gera receita mais rapidamente
+- **Locação de Salas com pagamento** — o `valor` e o fluxo de reserva já existem; falta só a captura + taxa.
+- **Assinatura SaaS por clínica** — a base multiempresa e o `pricing` já estão prontos no superadmin.
+
+## 6. Próximo módulo mais estratégico
+- **Monetização da plataforma (Billing/Assinaturas + taxa de marketplace de salas).** É o que converte uma base
+  técnica madura (ERP odontológico multiempresa funcional) em **receita recorrente da plataforma** — hoje só a
+  Tutoria cobra. Tudo o mais já está construído; falta o módulo que **fatura**.
+
+---
+
+> **Nota de método:** este mapa reflete exclusivamente o que foi encontrado no código em 19/jun/2026
+> (`frontend/App.tsx`, `frontend/views/*`, `frontend/components/Sidebar.tsx`, `backend/server.js`).
+> Onde havia ambiguidade (ex.: receita opcional, pagamento manual de salas), o fato foi descrito como está,
+> sem inferir intenção. Nenhuma funcionalidade foi inventada.
+</content>
+</invoke>

documentação/STATUS-SEGURANCA-E-PRODUCAO.md

@@ -0,0 +1,129 @@
+# Status — Segurança & Produção (ScoreOdonto)
+
+> Resumo do que foi feito e do que falta. Atualizado em **22/jun/2026**.
+> Produção no ar: **v1.0.19** (`715b2dc`) — fila **A** concluída (push → CI → tag → deploy). **Commits
+> publicados (`git push` feito).** A rotação do `JWT_SECRET` segue aplicada e verificada em produção.
+
+---
+
+## ✅ O QUE JÁ FOI FEITO
+
+### 1. Segredos
+- **`JWT_SECRET` rotacionado em DEV e PRODUÇÃO** (recriado o backend na VPS1 na mesma tag, sem rebuild;
+  `/api/health` e `/api/version` validados). → **vetor de tomada de conta FECHADO** (o segredo vazado não
+  forja mais tokens). **Ação operacional na VPS1 — sem commit** (o segredo não é versionado).
+- **`backend/.env` fora do tracking do git** + `backend/.dockerignore` (o Dockerfile fazia `COPY . .` sem
+  `.dockerignore` → segredos iam para dentro da imagem) + `.env.example`. Commits `fcf2fb1`.
+- **Senhas hardcoded removidas do `docker-compose.yml`**: banco via `SCOREO_DB_PASS` (com `:?` fail-fast);
+  `DRAGONFLY_URL` (com senha) movido para `env_file`. Commit `3aa6a44`. Validado em DEV (pgdev/cache ok).
+
+### 2. Frontend
+- **`/update` (migração de banco) restrito a superadmin** (era acessível a qualquer um, até deslogado).
+- **Deep-links corrigidos** (`/comissoes`, `/glosas` faltavam no `ROUTE_MAP` → caíam em dashboard).
+- Commit `1559387`. (Build compila; validação visual de RBAC precisa de navegador.)
+
+### 3. RBAC intra-clínica no backend (99 rotas) — **NÚCLEO FECHADO**
+Antes: qualquer membro autenticado (até paciente) podia chamar ações privilegiadas direto na API
+(a UI escondia, o backend não barrava). Agora há autorização por **cargo**, espelhando o `isViewAllowed`
+do frontend, via 3 helpers: `requireCapability`, `requireCapabilityRow`, `requireCapabilityFromOrders`.
+
+| Grupo | Commit |
+|---|---|
+| Financeiro (comissões/repasses/financeiro/glosas) | `f4e7fe3` |
+| Gestão de equipe/clínica (membros/setores/funções/reset-senha/cor) | `9ad65c3` |
+| Cadastros administrativos (dentistas/especialidades/procedimentos/planos + reorder) | `116200c` + `0667456` |
+| Operação clínica (pacientes/agenda/leads) | `5b58a8a` |
+| Orçamentos/Contratos | `16c13ad` |
+| Sub-pass clínico (presença/pendências/horários/detalhes de paciente) | `0fc69bb` |
+
+- **Marketplace (salas/sala-reservas/propostas): auditado — já protegido por POSSE** nos handlers
+  (`owner_usuario_id`, profissional destinatário, dono/solicitante). Sem gap; sem mudança. Commit `0667456`.
+- Validado em DEV com tokens forjados: dono passa, dentista/paciente 403, isolamento cross-tenant intacto.
+
+### 4. Documentação & Skills
+- `documentação/MAPA-FUNCIONAL-COMPLETO.md` (inventário rotas/telas/botões/fluxos/módulos).
+- `documentação/AUDITORIA-ESTRATEGICA-MODELAGEM.md` (Pessoa→Vínculo→Workspace, débitos, riscos).
+- `ScoreOdonto_Skills_Enterprise/`: **62/62 skills preenchidas** com conteúdo real. Commits `5b99292`, `e83af04`, `f22e30e`.
+
+### 5. Pré-requisito de produção
+- **`SCOREO_DB_PASS` provisionado na VPS1** (`/home/deploy/stack/scoreodonto.com/.env`, 0600), valores
+  extraídos do container em execução, `.gitignore` da VPS1 ajustado, conexão validada (`SELECT 1` = ok).
+
+### 6. Fila A concluída — **PRODUÇÃO EM `v1.0.19`** (22/jun/2026)
+- **`git push` do lote** (RBAC 99 rotas + segredos fora do compose/imagem + correções de frontend).
+- **CI desbloqueada:** o build falhou na 1ª vez (`SCOREO_DB_PASS` com `:?` quebrava a interpolação do
+  compose no `docker compose build` do runner) → corrigido com placeholder runtime-only no `build.yml`
+  (commit `715b2dc`). Build verde → imagens `:715b2dc` (back+front, atômicas) publicadas no registry.
+- **Tag `v1.0.19` → `715b2dc`:** job `promote` re-tagueou `:715b2dc` → `:v1.0.19` **sem rebuild**
+  (digests idênticos conferidos) e rodou `deploy-prod.sh v1.0.19` na VPS1.
+- **Backup do banco antes do deploy:** `~/backups/scoreodonto_20260622_0005.dump` na VPS1 (PG18).
+- **Verificado em produção:** `/api/version` = `v1.0.19` (`715b2dc`, PROD); `/api/health` = ok
+  (DB ok, cache ok). DEV (8020) realinhado ao mesmo commit via `./dev-build.sh` (mostra `v1.0.19`).
+- **Rollback trivial:** `./deploy-prod.sh v1.0.18` (+ dump do banco, se necessário).
+
+---
+
+## ⏳ O QUE FALTA
+
+### A) Levar o trabalho a produção (fila) — ✅ CONCLUÍDA
+1. ~~**Imagem limpa `v1.0.19`**~~ → **FEITO** (ver "Fila A concluída" acima). Produção em `v1.0.19`/`715b2dc`.
+2. **Compose novo na VPS1 (opcional, passo 2b):** `deploy-prod.sh` **não faz `git pull`** → o
+   `docker-compose.yml` da VPS1 segue o antigo. Para tirar a senha hardcoded do compose local, copiar o
+   novo `docker-compose.yml` (scp) + recreate. O root `.env` já provisionado cobre isso. **Ainda pendente.**
+
+### B) Rotação dos demais segredos (ainda vivos no histórico/artefatos antigos)
+3. **Senha do banco** (`scoreodonto_user`) — contida ao scoreodonto; exige refactor já feito no compose +
+   `ALTER USER` + atualizar `.env`/`backend/.env` + recreate. Risco de outage → com cuidado/janela.
+4. **Senha do Dragonfly (cache)** — ⚠️ **compartilhada** entre apps (rx, newwhats, subdominio, mercado);
+   trocar derruba os outros → exige **janela coordenada**.
+5. **`OPENAI_API_KEY` / `GEMINI_API_KEY`** — **só você** rotaciona (painéis OpenAI/Google); depois colo os
+   novos valores no `.env` e recrio.
+6. **Histórico do git** — `backend/.env` (e um `backend/.env.bak`) estão no histórico. Após rotacionar tudo,
+   o *scrub* de histórico (force-push, destrutivo) vira **cosmético** — não recomendado às pressas.
+
+### C) Residual de qualidade (não-bloqueante; do MAPA / AUDITORIA)
+- RECEITA de procedimento é **opcional** (`gerarLancamento`/`valor>0`) → decidir se vira padrão (risco de caixa).
+- Estado de plugins divergente cliente/servidor (`localStorage` vs `usuario_plugins`).
+- Órfã `OrthoReports.tsx`; `SyncView` desativada; `server.js.bak`/scripts legados → limpeza.
+- Marketplace: **gateway de pagamento** (salas têm `valor`, sem captura) e **assinaturas SaaS** (manual).
+
+### D) Débitos de modelagem (estratégico; exige aprovação + janela)
+- `dentistas` como **projeção** da pessoa (hoje duplica a pessoa por clínica).
+- `pacientes` com **identidade de pessoa** (hoje preso à clínica, não-portável) — antes, decisão LGPD/jurídica.
+- Unificar workspace (`clinicas` + `salas`); entidade **"rede/grupo"** acima da clínica.
+> Recomendação estratégica única: assumir a **Pessoa como âncora** e parar de manter o legado clínica-cêntrico
+> em paralelo. Detalhe em `AUDITORIA-ESTRATEGICA-MODELAGEM.md`.
+
+---
+
+## Commits da sessão — **PUBLICADOS** (`git push` feito; produção em `v1.0.19`)
+> Todos empurrados para `origin/main`. Promovidos a produção via tag `v1.0.19` (commit `715b2dc`).
+> A rotação do `JWT_SECRET` **não** está nesta lista (foi ação operacional na VPS, sem commit).
+```
+715b2dc ci(build): desbloqueia build — SCOREO_DB_PASS placeholder na interpolação
+8a27f3b docs+infra: corrige status (JWT/contagem) + versão em DEV (dev-build.sh)
+6adf353 docs: status geral de segurança & produção (este documento)
+f22e30e docs(skills): completa as 62 skills
+e83af04 docs(skills): biblioteca operacional
+5b99292 docs: auditoria funcional + estratégica
+0667456 security(rbac): reorder + auditoria do marketplace
+0fc69bb security(rbac): sub-pass clínico
+16c13ad security(rbac): orçamentos e contratos
+5b58a8a security(rbac): operação clínica
+116200c security(rbac): cadastros administrativos
+9ad65c3 security(rbac): gestão de equipe/clínica
+f4e7fe3 security(rbac): rotas financeiras
+1559387 security/fix(front): /update + deep-links
+3aa6a44 security(infra): senhas fora do compose
+fcf2fb1 security(infra): .env fora do git + .dockerignore
+```
+
+## Como retomar
+- **Fila A:** ✅ concluída — produção em **`v1.0.19`** (`715b2dc`). Próximo release: `git push` → CI
+  builda `:<sha>` → `git tag vX.Y.Z` → job `promote` deploya na VPS1.
+- **Antes de abrir a usuários reais:** concluir **B** (rotações) — sobretudo as API keys (você) e a senha do banco.
+- **Pendência pontual:** passo **A.2** (compose novo na VPS1 via scp + recreate) para tirar a senha
+  hardcoded do compose local.
+- Código rodando em **DEV** (`dev.scoreodonto.com`) e **PROD** no mesmo commit `715b2dc`; rollback de
+  prod: `./deploy-prod.sh v1.0.18` (+ dump `~/backups/scoreodonto_20260622_0005.dump` se necessário).
+</content>

frontend/App.tsx

@@ -31,6 +31,11 @@ import { ReportsView } from './views/ReportsView.tsx';
 import { ComissoesView } from './views/ComissoesView.tsx';
 import { GlosasView } from './views/GlosasView.tsx';
 import { SalaHomeView } from './views/SalaHomeView.tsx';
+import { LabHomeView } from './views/LabHomeView.tsx';
+import { LabClientesView } from './views/LabClientesView.tsx';
+import { LabCotacoesView } from './views/LabCotacoesView.tsx';
+import { LabEquipeView } from './views/LabEquipeView.tsx';
+import { LabIndicadoresView } from './views/LabIndicadoresView.tsx';
 import { ConfiguracoesView } from './views/ConfiguracoesView.tsx';
 import { OrcamentosView } from './views/OrcamentosView.tsx';
 import { ContratosView } from './views/ContratosView.tsx';
@@ -84,6 +89,13 @@ export type ViewKey =
   | 'minhas-salas'
   | 'alugar-salas'
   | 'sala-home'
+  | 'lab-home'
+  | 'lab-bancada'
+  | 'lab-clientes'
+  | 'lab-financeiro'
+  | 'lab-cotacoes'
+  | 'lab-equipe'
+  | 'lab-indicadores'
   | 'marketplace-profissionais'
   | 'criar-clinica'
   | 'rx-config'
@@ -134,6 +146,13 @@ const ROUTE_MAP: Record<string, ViewKey> = {
   '/minhas-salas': 'minhas-salas',
   '/alugar-salas': 'alugar-salas',
   '/sala-home': 'sala-home',
+  '/lab-home': 'lab-home',
+  '/lab-bancada': 'lab-bancada',
+  '/lab-clientes': 'lab-clientes',
+  '/lab-financeiro': 'lab-financeiro',
+  '/lab-cotacoes': 'lab-cotacoes',
+  '/lab-equipe': 'lab-equipe',
+  '/lab-indicadores': 'lab-indicadores',
   '/marketplace-profissionais': 'marketplace-profissionais',
   '/criar-clinica': 'criar-clinica',
   '/rx-config': 'rx-config',
@@ -151,6 +170,9 @@ const ROUTE_MAP: Record<string, ViewKey> = {
   '/aguardando-convite': 'aguardando-convite',
   '/diretorio-profissionais': 'diretorio-profissionais',
   '/proteses': 'proteses',
+  // Corrige deep-link/refresh: existiam em VIEW_TO_ROUTE mas faltavam aqui (caíam em dashboard).
+  '/comissoes': 'comissoes',
+  '/glosas': 'glosas',
 };
 
 const VIEW_TO_ROUTE: Record<ViewKey, string> = {
@@ -186,6 +208,13 @@ const VIEW_TO_ROUTE: Record<ViewKey, string> = {
   'minhas-salas': '/minhas-salas',
   'alugar-salas': '/alugar-salas',
   'sala-home': '/sala-home',
+  'lab-home': '/lab-home',
+  'lab-bancada': '/lab-bancada',
+  'lab-clientes': '/lab-clientes',
+  'lab-financeiro': '/lab-financeiro',
+  'lab-cotacoes': '/lab-cotacoes',
+  'lab-equipe': '/lab-equipe',
+  'lab-indicadores': '/lab-indicadores',
   'marketplace-profissionais': '/marketplace-profissionais',
   'criar-clinica': '/criar-clinica',
   'rx-config': '/rx-config',
@@ -274,7 +303,8 @@ const App: React.FC = () => {
   const clinColor = activeWorkspace?.cor || '#2563eb';
 
   const isViewAllowed = (view: ViewKey, role: string): boolean => {
-    if (['landing', 'login', 'public', 'update'].includes(view)) return true;
+    if (['landing', 'login', 'public'].includes(view)) return true;
+    // /update (migração de banco) é EXCLUSIVA do superadmin (liberado na linha seguinte).
     if (role === 'superadmin') return true;
     // Sync GLOBAL removido do app (substituído pelo backup por clínica em Configurações).
     if (view === 'sync') return false;
@@ -283,6 +313,8 @@ const App: React.FC = () => {
     if (view === 'salas' || view === 'minhas-salas' || view === 'alugar-salas') return isPluginActive('locacao-salas');
     // Contexto de SALA: isola da clínica — só painel da sala/salas/conta/notificações.
     if ((HybridBackend.getActiveWorkspace() as any)?.tipo === 'sala') return ['sala-home', 'configuracoes', 'notificacoes', 'clinicas'].includes(view);
+    // Contexto de LABORATÓRIO: área do protético — painel do lab + bancada/conta/notificações.
+    if ((HybridBackend.getActiveWorkspace() as any)?.tipo === 'laboratorio') return ['lab-home', 'lab-bancada', 'lab-clientes', 'lab-cotacoes', 'lab-financeiro', 'lab-equipe', 'lab-indicadores', 'configuracoes', 'notificacoes', 'clinicas'].includes(view);
     // Catálogo de PLUGINS: EXCLUSIVO do superadmin (já retorna true acima); ninguém mais.
     if (view === 'plugins') return false;
     // Admin/donos têm acesso amplo, MAS as telas de superadmin são exclusivas do superadmin.
@@ -301,7 +333,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', 'notificacoes', 'clinicas', 'configuracoes', 'plugins', 'salas', 'marketplace-profissionais', 'diretorio-profissionais'],
+      protetico: ['lab-home', 'lab-bancada', 'lab-clientes', 'lab-cotacoes', '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'],
     };
 
@@ -312,6 +344,8 @@ const App: React.FC = () => {
     if (role === 'superadmin') return 'superadmin-overview';
     // Contexto de SALA (workspace tipo='sala') sempre cai no painel da sala.
     if ((HybridBackend.getActiveWorkspace() as any)?.tipo === 'sala') return 'sala-home';
+    // Contexto de LABORATÓRIO (workspace tipo='laboratorio') cai no painel do lab.
+    if ((HybridBackend.getActiveWorkspace() as any)?.tipo === 'laboratorio') return 'lab-home';
     if (role === 'paciente')   return 'tratamentos';
     if (role === 'donosala')   return 'minhas-salas';
     return 'dashboard';
@@ -472,6 +506,13 @@ const App: React.FC = () => {
       case 'minhas-salas': return <SalasPlugin view="minhas" />;
       case 'alugar-salas': return <SalasPlugin view="alugar" />;
       case 'sala-home': return <SalaHomeView />;
+      case 'lab-home': return <LabHomeView />;
+      case 'lab-bancada': return <ProteseView />;
+      case 'lab-clientes': return <LabClientesView tab="clientes" />;
+      case 'lab-financeiro': return <LabClientesView tab="financeiro" />;
+      case 'lab-cotacoes': return <LabCotacoesView />;
+      case 'lab-equipe': return <LabEquipeView />;
+      case 'lab-indicadores': return <LabIndicadoresView />;
       case 'marketplace-profissionais': return <ProfissionaisPlugin />;
       case 'criar-clinica': return <CreateClinicView onCreated={() => { window.location.reload(); }} />;
       case 'rx-config': return <RxConfigView />;

frontend/components/Sidebar.tsx

@@ -37,9 +37,12 @@ export const Sidebar: React.FC<SidebarProps> = ({ activeTab, setActiveTab }) =>
       pluginMenuItems.push({ id: 'rx-config', label: 'DISPOSITIVOS RX', icon: Monitor, color: '#7c3aed' });
     }
   }
-  // Locação de Salas: capability SEMPRE ativa (sem desativar) p/ todos menos superadmin.
-  // Dois menus: administrar as próprias salas (locador) e alugar salas de terceiros (locatário).
-  if (currentRole !== 'superadmin') {
+  // Locação de Salas: menus de LOCADOR (administra as próprias salas) e LOCATÁRIO (aluga de
+  // terceiros). São decisões de NEGÓCIO do titular — não cabem a funcionário (subordinado) nem
+  // a paciente. Funcionário, quando muito, opera a AGENDA da sala (workspace tipo='sala'), não
+  // a locação. Por isso restringimos a papéis que podem ser titulares de sala.
+  const PAPEIS_LOCACAO = ['donosala', 'donoclinica', 'donoconsultorio', 'admin', 'dentista', 'biomedico', 'protetico'];
+  if (PAPEIS_LOCACAO.includes(currentRole)) {
     pluginMenuItems.push({ id: 'minhas-salas', label: 'MINHAS SALAS', icon: DoorOpen, color: '#0d9488' });
     pluginMenuItems.push({ id: 'alugar-salas', label: 'ALUGAR SALAS', icon: Building2, color: '#0d9488' });
   }
@@ -58,6 +61,13 @@ export const Sidebar: React.FC<SidebarProps> = ({ activeTab, setActiveTab }) =>
     { id: 'superadmin-financeiro',   label: 'FINANCEIRO',    icon: DollarSign },
     { id: 'superadmin-notificacoes', label: 'NOTIFICAÇÕES',  icon: Bell       },
     { id: 'sala-home', label: 'PAINEL DA SALA', icon: DoorOpen },
+    { id: 'lab-home', label: 'PAINEL DO LAB', icon: LayoutDashboard },
+    { id: 'lab-bancada', label: 'BANCADA', icon: FlaskConical },
+    { id: 'lab-clientes', label: 'CLIENTES', icon: Building2 },
+    { id: 'lab-cotacoes', label: 'COTAÇÕES', icon: FileText },
+    { id: 'lab-financeiro', label: 'FINANCEIRO', icon: DollarSign },
+    { id: 'lab-indicadores', label: 'INDICADORES', icon: BarChart3 },
+    { id: 'lab-equipe', label: 'EQUIPE', icon: UsersRound },
     { id: 'dashboard', label: 'VISÃO GERAL', icon: LayoutDashboard },
     { id: 'agenda', label: 'AGENDA', icon: CalendarIcon },
     { id: 'pacientes', label: 'PACIENTES', icon: Users },
@@ -94,11 +104,23 @@ export const Sidebar: React.FC<SidebarProps> = ({ activeTab, setActiveTab }) =>
 
     // PAINEL DA SALA só existe quando o workspace ativo é uma sala.
     if (item.id === 'sala-home') return (activeWorkspace as any)?.tipo === 'sala';
+    // PAINEL DO LAB / BANCADA só existem no workspace de laboratório.
+    if (['lab-home', 'lab-bancada', 'lab-clientes', 'lab-cotacoes', 'lab-financeiro', 'lab-equipe', 'lab-indicadores'].includes(item.id)) return (activeWorkspace as any)?.tipo === 'laboratorio';
 
     // Contexto de SALA (workspace tipo='sala'): isola da clínica — menu base só conta/notificações.
     // (MINHAS SALAS / ALUGAR SALAS são itens de plugin, mostrados à parte.)
     if ((activeWorkspace as any)?.tipo === 'sala') return ['sala-home', 'notificacoes', 'configuracoes'].includes(item.id);
 
+    // Contexto de LABORATÓRIO (workspace tipo='laboratorio'): área própria do protético —
+    // painel do lab + bancada de produção, sem as telas clínicas da clínica.
+    if ((activeWorkspace as any)?.tipo === 'laboratorio') {
+      // Técnico (vínculo tecnico_protese) só opera a produção; gestão é do dono.
+      const ehTecnico = (activeWorkspace as any)?.role === 'tecnico_protese';
+      return ehTecnico
+        ? ['lab-home', 'lab-bancada', 'notificacoes', 'configuracoes'].includes(item.id)
+        : ['lab-home', 'lab-bancada', 'lab-clientes', 'lab-cotacoes', 'lab-financeiro', 'lab-indicadores', 'lab-equipe', 'notificacoes', 'configuracoes'].includes(item.id);
+    }
+
     // plugins e gestão de tutores: exclusivo superadmin
     if (item.id === 'plugins' || item.id === 'admin-gestao-tutores') return false;
 
@@ -128,7 +150,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/index.tsx

@@ -1,6 +1,7 @@
 import React from 'react';
 import { createRoot } from 'react-dom/client';
 import App from './App.tsx';
+import { ProtesePublicView } from './views/ProtesePublicView.tsx';
 import { ErrorBoundary } from './components/ErrorBoundary.tsx';
 import { ToastProvider } from './contexts/ToastContext.tsx';
 import { ConfirmProvider } from './contexts/ConfirmContext.tsx';
@@ -34,13 +35,15 @@ window.addEventListener('vite:preloadError', () => {
 const rootElement = document.getElementById('root');
 if (rootElement) {
   const root = createRoot(rootElement);
+  // Modo 1 — link seguro: /p/TOKEN é página PÚBLICA (sem login), fora do app autenticado.
+  const publicMatch = window.location.pathname.match(/^\/p\/(.+)$/);
   root.render(
     <React.StrictMode>
       <QueryClientProvider client={queryClient}>
         <ErrorBoundary>
           <ToastProvider>
             <ConfirmProvider>
-              <App />
+              {publicMatch ? <ProtesePublicView token={decodeURIComponent(publicMatch[1])} /> : <App />}
             </ConfirmProvider>
           </ToastProvider>
         </ErrorBoundary>

frontend/services/backend.ts

@@ -778,13 +778,88 @@ export const HybridBackend = {
     if (!res.ok) throw new Error((await res.json().catch(() => ({}))).error || 'Erro ao mudar status');
     return await res.json();
   },
-  uploadProteseFoto: async (id: string, file: File) => {
+  uploadProteseFoto: async (id: string, file: File, legenda?: string, ocorrenciaId?: string) => {
     const fd = new FormData();
     fd.append('foto', file);
+    if (legenda) fd.append('legenda', legenda);
+    if (ocorrenciaId) fd.append('ocorrencia_id', ocorrenciaId);
     const res = await apiFetch(`${API_URL}/protese/os/${id}/foto`, { method: 'POST', body: fd });
     if (!res.ok) throw new Error((await res.json().catch(() => ({}))).error || 'Erro ao anexar foto');
     return await res.json();
   },
+  // Conferência de componente (status: ok | divergente | ausente | pendente)
+  conferirProteseComponente: async (compId: string, status_conferencia: string) => {
+    const res = await apiFetch(`${API_URL}/protese/os/componentes/${compId}/conferir`, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ status_conferencia }) });
+    if (!res.ok) throw new Error((await res.json().catch(() => ({}))).error || 'Erro ao conferir');
+    return await res.json();
+  },
+  // Ocorrências (contraditório)
+  abrirProteseOcorrencia: async (osId: string, body: { categoria: string; descricao: string; responsavel?: string; componente_id?: string }) => {
+    const res = await apiFetch(`${API_URL}/protese/os/${osId}/ocorrencias`, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(body) });
+    if (!res.ok) throw new Error((await res.json().catch(() => ({}))).error || 'Erro ao abrir ocorrência');
+    return await res.json();
+  },
+  responderProteseOcorrencia: async (ocId: string, resposta: string) => {
+    const res = await apiFetch(`${API_URL}/protese/os/ocorrencias/${ocId}/resposta`, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ resposta }) });
+    if (!res.ok) throw new Error((await res.json().catch(() => ({}))).error || 'Erro ao responder');
+    return await res.json();
+  },
+  statusProteseOcorrencia: async (ocId: string, status: string) => {
+    const res = await apiFetch(`${API_URL}/protese/os/ocorrencias/${ocId}/status`, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ status }) });
+    if (!res.ok) throw new Error((await res.json().catch(() => ({}))).error || 'Erro ao mudar status');
+    return await res.json();
+  },
+  deleteProteseFoto: async (fotoId: string) => {
+    const res = await apiFetch(`${API_URL}/protese/os/fotos/${fotoId}`, { method: 'DELETE' });
+    if (!res.ok) throw new Error((await res.json().catch(() => ({}))).error || 'Erro ao remover foto');
+    return await res.json();
+  },
+  // Componentes enviados ao laboratório (direcao: 'enviado' clínica→lab | 'devolvido' lab→clínica)
+  addProteseComponente: async (osId: string, body: { nome: string; quantidade?: number; observacao?: string; direcao?: 'enviado' | 'devolvido' }) => {
+    const res = await apiFetch(`${API_URL}/protese/os/${osId}/componentes`, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(body) });
+    if (!res.ok) throw new Error((await res.json().catch(() => ({}))).error || 'Erro ao adicionar componente');
+    return await res.json();
+  },
+  deleteProteseComponente: async (compId: string) => {
+    const res = await apiFetch(`${API_URL}/protese/os/componentes/${compId}`, { method: 'DELETE' });
+    if (!res.ok) throw new Error((await res.json().catch(() => ({}))).error || 'Erro ao remover componente');
+    return await res.json();
+  },
+  // Pagamentos/recebimentos da OS (lado: 'lab' | 'clinica')
+  addProtesePagamento: async (osId: string, body: { lado: 'lab' | 'clinica'; valor: number; forma?: string; observacao?: string; data?: string }) => {
+    const res = await apiFetch(`${API_URL}/protese/os/${osId}/pagamentos`, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(body) });
+    if (!res.ok) throw new Error((await res.json().catch(() => ({}))).error || 'Erro ao registrar pagamento');
+    return await res.json();
+  },
+  deleteProtesePagamento: async (pagId: string) => {
+    const res = await apiFetch(`${API_URL}/protese/os/pagamentos/${pagId}`, { method: 'DELETE' });
+    if (!res.ok) throw new Error((await res.json().catch(() => ({}))).error || 'Erro ao remover pagamento');
+    return await res.json();
+  },
+  // Custódia: registra que o trabalho mudou de mãos (para_local: 'clinica' | 'laboratorio')
+  moverProteseCustodia: async (osId: string, para_local: 'clinica' | 'laboratorio', observacao?: string) => {
+    const res = await apiFetch(`${API_URL}/protese/os/${osId}/custodia`, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ para_local, observacao }) });
+    if (!res.ok) throw new Error((await res.json().catch(() => ({}))).error || 'Erro ao registrar movimentação');
+    return await res.json();
+  },
+  // Editar campos do trabalho (cor, material, dentes, observações)
+  editarProteseOS: async (osId: string, campos: { cor?: string; material?: string; dentes?: string; observacoes?: string }) => {
+    const res = await apiFetch(`${API_URL}/protese/os/${osId}`, { method: 'PATCH', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(campos) });
+    if (!res.ok) throw new Error((await res.json().catch(() => ({}))).error || 'Erro ao editar');
+    return await res.json();
+  },
+  // Ajuste do valor cobrado do paciente (delta + ou −)
+  ajustarValorProtese: async (osId: string, delta: number, observacao?: string) => {
+    const res = await apiFetch(`${API_URL}/protese/os/${osId}/ajuste-valor`, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ delta, observacao }) });
+    if (!res.ok) throw new Error((await res.json().catch(() => ({}))).error || 'Erro ao ajustar valor');
+    return await res.json();
+  },
+  // Trocar o trabalho por outro (produto do catálogo ou tipo livre) + motivo
+  trocarTrabalhoProtese: async (osId: string, body: { produto_id?: string; tipo?: string; motivo: string }) => {
+    const res = await apiFetch(`${API_URL}/protese/os/${osId}/trocar`, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(body) });
+    if (!res.ok) throw new Error((await res.json().catch(() => ({}))).error || 'Erro ao trocar trabalho');
+    return await res.json();
+  },
   deleteProteseOS: async (id: string) => {
     const clinicaId = HybridBackend.getActiveWorkspace()?.id || '';
     await apiFetch(`${API_URL}/protese/os/${id}?clinicaId=${encodeURIComponent(clinicaId)}`, { method: 'DELETE' });
@@ -1011,6 +1086,134 @@ export const HybridBackend = {
     return await res.json().catch(() => ({ feitas: [], recebidas: [] }));
   },
 
+  // Laboratório (Fase 3): clientes (clínicas) com métricas + extrato de recebimentos.
+  getLabClientes: async (): Promise<any[]> => {
+    const res = await apiFetch(`${API_URL}/protese/lab/clientes`);
+    return await res.json().catch(() => []);
+  },
+  getLabPagamentos: async (): Promise<any[]> => {
+    const res = await apiFetch(`${API_URL}/protese/lab/pagamentos`);
+    return await res.json().catch(() => []);
+  },
+  // Fase 4: dados do laboratório (PF/PJ, CPF/CNPJ) + equipe de técnicos
+  getLabDados: async (): Promise<any> => {
+    const res = await apiFetch(`${API_URL}/protese/lab`);
+    return await res.json().catch(() => ({}));
+  },
+  updateLabDados: async (body: { nome_fantasia: string; documento?: string; pessoa_tipo?: 'PF' | 'PJ' }) => {
+    const res = await apiFetch(`${API_URL}/protese/lab`, { method: 'PATCH', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(body) });
+    if (!res.ok) throw new Error((await res.json().catch(() => ({}))).error || 'Erro ao salvar');
+    return await res.json();
+  },
+  getLabEquipe: async (): Promise<any[]> => {
+    const res = await apiFetch(`${API_URL}/protese/lab/equipe`);
+    return await res.json().catch(() => []);
+  },
+  addLabTecnico: async (body: { email: string; nome?: string }) => {
+    const res = await apiFetch(`${API_URL}/protese/lab/equipe`, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(body) });
+    if (!res.ok) throw new Error((await res.json().catch(() => ({}))).error || 'Erro ao adicionar técnico');
+    return await res.json();
+  },
+  removeLabTecnico: async (userId: string) => {
+    const res = await apiFetch(`${API_URL}/protese/lab/equipe/${userId}`, { method: 'DELETE' });
+    if (!res.ok) throw new Error((await res.json().catch(() => ({}))).error || 'Erro ao remover');
+    return await res.json();
+  },
+  // Fase 5: indicadores do laboratório (Nota ScoreOdonto + KPIs derivados)
+  getLabIndicadores: async (): Promise<any> => {
+    const res = await apiFetch(`${API_URL}/protese/lab/indicadores`);
+    return await res.json().catch(() => ({}));
+  },
+  // Fatia 4: a clínica avalia o laboratório ao final da OS
+  avaliarProteseOS: async (osId: string, body: { estrelas: number; comentario?: string }) => {
+    const res = await apiFetch(`${API_URL}/protese/os/${osId}/avaliar`, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(body) });
+    if (!res.ok) throw new Error((await res.json().catch(() => ({}))).error || 'Erro ao avaliar');
+    return await res.json();
+  },
+  // Modo 1: link seguro de acompanhamento da OS
+  gerarProteseLink: async (osId: string) => {
+    const res = await apiFetch(`${API_URL}/protese/os/${osId}/link`, { method: 'POST' });
+    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 }));
+  },
+  // Cotação (RFQ) — Fatia 3
+  criarRfq: async (body: any) => {
+    const cid = HybridBackend.getActiveWorkspace()?.id || '';
+    const res = await apiFetch(`${API_URL}/protese/rfq?clinicaId=${encodeURIComponent(cid)}`, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(body) });
+    if (!res.ok) throw new Error((await res.json().catch(() => ({}))).error || 'Erro ao pedir cotação');
+    return await res.json();
+  },
+  getRfqs: async (): Promise<any[]> => {
+    const cid = HybridBackend.getActiveWorkspace()?.id || '';
+    const res = await apiFetch(`${API_URL}/protese/rfq?clinicaId=${encodeURIComponent(cid)}`);
+    return await res.json().catch(() => []);
+  },
+  getRfqRecebidas: async (): Promise<any[]> => {
+    const res = await apiFetch(`${API_URL}/protese/rfq/recebidas`);
+    return await res.json().catch(() => []);
+  },
+  responderCotacao: async (cotacaoId: string, body: { valor: number; prazo_dias?: number; observacao?: string }) => {
+    const res = await apiFetch(`${API_URL}/protese/rfq/cotacao/${cotacaoId}`, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(body) });
+    if (!res.ok) throw new Error((await res.json().catch(() => ({}))).error || 'Erro ao cotar');
+    return await res.json();
+  },
+  escolherCotacao: async (rfqId: string, cotacaoId: string) => {
+    const cid = HybridBackend.getActiveWorkspace()?.id || '';
+    const res = await apiFetch(`${API_URL}/protese/rfq/${rfqId}/escolher?clinicaId=${encodeURIComponent(cid)}`, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ cotacao_id: cotacaoId }) });
+    if (!res.ok) throw new Error((await res.json().catch(() => ({}))).error || 'Erro ao escolher');
+    return await res.json();
+  },
+  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)}`);
+    if (!res.ok) throw new Error((await res.json().catch(() => ({}))).error || 'Link inválido ou expirado.');
+    return await res.json();
+  },
+  // Ações PÚBLICAS pelo link (Modo 1, fatia 1b) — sem login
+  custodiaPublic: async (token: string, para_local: 'clinica' | 'laboratorio') => {
+    const res = await fetch(`${API_URL}/p/${encodeURIComponent(token)}/custodia`, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ para_local }) });
+    if (!res.ok) throw new Error((await res.json().catch(() => ({}))).error || 'Erro ao registrar.');
+    return await res.json();
+  },
+  statusPublic: async (token: string, status: string) => {
+    const res = await fetch(`${API_URL}/p/${encodeURIComponent(token)}/status`, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ status }) });
+    if (!res.ok) throw new Error((await res.json().catch(() => ({}))).error || 'Erro ao avançar etapa.');
+    return await res.json();
+  },
+  uploadFotoPublic: async (token: string, file: File) => {
+    const fd = new FormData();
+    fd.append('foto', file);
+    const res = await fetch(`${API_URL}/p/${encodeURIComponent(token)}/foto`, { method: 'POST', body: fd });
+    if (!res.ok) throw new Error((await res.json().catch(() => ({}))).error || 'Erro ao anexar foto.');
+    return await res.json();
+  },
+
+  // Agenda de uma sala (reservas + bloqueios de manutenção) — usado pelo operador da unidade.
+  getSalaReservas: async (salaId: string): Promise<any[]> => {
+    const res = await apiFetch(`${API_URL}/salas/${salaId}/reservas`);
+    return await res.json().catch(() => []);
+  },
+
+  // Bloqueio de sala para manutenção (sem cobrança; tira a sala da agenda no intervalo).
+  criarManutencaoSala: async (salaId: string, body: { inicio: string; fim: string; motivo?: string }) => {
+    const res = await apiFetch(`${API_URL}/salas/${salaId}/manutencao`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(body)});
+    const data = await res.json().catch(() => ({}));
+    if (!res.ok) throw new Error(data?.error || 'Falha ao bloquear a sala.');
+    return data;
+  },
+
   saveFinanceiro: async (item: Partial<FinanceiroItem>) => {
     const clinicaId = HybridBackend.getActiveWorkspace()?.id || '';
     const data = enforceUppercase(item);

frontend/views/ClinicasView.tsx

@@ -1,5 +1,5 @@
 import React, { useState } from 'react';
-import { Building2, ArrowRight, Shield, MapPin, BadgeCheck, Palette, Save, Loader2 } from 'lucide-react';
+import { Building2, ArrowRight, Shield, MapPin, BadgeCheck, Palette, Save, Loader2, Plus, X } from 'lucide-react';
 import { HybridBackend } from '../services/backend.ts';
 import { PageHeader } from '../components/PageHeader.tsx';
 import { EmptyState } from '../components/EmptyState.tsx';
@@ -24,9 +24,43 @@ export const ClinicasView: React.FC = () => {
     const currentRole = HybridBackend.getCurrentRole();
     const isAdmin = currentRole === 'admin' || currentRole === 'donoclinica';
 
+    // Papel da CONTA (não da unidade ativa) — é o que o backend usa para decidir
+    // se a nova unidade nasce como 'clinica' ou 'consultorio'.
+    const accountRole = (() => {
+        try { return JSON.parse(localStorage.getItem('SCOREODONTO_USER_DATA') || '{}').role as string | undefined; }
+        catch { return undefined; }
+    })();
+    const isConsultorioAccount = accountRole === 'donoconsultorio';
+    const unitLabel = isConsultorioAccount ? 'CONSULTÓRIO' : 'CLÍNICA';
+    const canCreate = ['donoclinica', 'donoconsultorio', 'admin'].includes(accountRole || '');
+
     const [isEditingColor, setIsEditingColor] = useState<string | null>(null);
     const [savingColor, setSavingColor] = useState(false);
 
+    const [showCreate, setShowCreate] = useState(false);
+    const [newNome, setNewNome] = useState('');
+    const [newDoc, setNewDoc] = useState('');
+    const [creating, setCreating] = useState(false);
+
+    const handleCreate = async (e: React.FormEvent) => {
+        e.preventDefault();
+        if (!newNome.trim()) return;
+        setCreating(true);
+        try {
+            const result = await HybridBackend.createClinica(newNome.trim(), newDoc.trim() || undefined);
+            if (!result.success) { toast.error(result.message || 'ERRO AO CRIAR UNIDADE.'); return; }
+            // Recarrega a lista COMPLETA do servidor (acrescenta a nova unidade às existentes,
+            // em vez de sobrescrever). A tela relê os workspaces no reload.
+            await HybridBackend.refreshWorkspaces();
+            toast.success(`${unitLabel} CRIADA!`);
+            setTimeout(() => window.location.reload(), 900);
+        } catch {
+            toast.error('ERRO DE CONEXÃO.');
+        } finally {
+            setCreating(false);
+        }
+    };
+
     const handleSwitch = (workspaceId: string) => {
         if (activeWorkspace?.id === workspaceId) {
             toast.info("VOCÊ JÁ ESTÁ NESTA UNIDADE.");
@@ -81,6 +115,17 @@ export const ClinicasView: React.FC = () => {
                 description="Configure a identidade visual e selecione a clínica para gerenciar atendimentos."
             />
 
+            {canCreate && (
+                <div className="flex justify-end -mt-4">
+                    <button
+                        onClick={() => { setNewNome(''); setNewDoc(''); setShowCreate(true); }}
+                        className="inline-flex items-center gap-2 px-6 py-3 rounded-2xl bg-teal-600 hover:bg-teal-700 text-white text-xs font-black uppercase tracking-widest shadow-lg transition-colors"
+                    >
+                        <Plus size={16} /> Nova {unitLabel.toLowerCase()}
+                    </button>
+                </div>
+            )}
+
             {workspaces.length === 0 && (
                 <EmptyState icon={Building2} title="Nenhuma unidade ainda" description="Você ainda não tem clínicas ou consultórios vinculados a esta conta." />
             )}
@@ -208,6 +253,54 @@ export const ClinicasView: React.FC = () => {
                     ))}
                 </div>
             </div>
+
+            {showCreate && (
+                <div
+                    className="fixed inset-0 z-50 bg-black/40 backdrop-blur-sm flex items-center justify-center p-4"
+                    onClick={() => { if (!creating) setShowCreate(false); }}
+                >
+                    <div className="bg-white rounded-3xl w-full max-w-md p-8 shadow-2xl" onClick={e => e.stopPropagation()}>
+                        <div className="flex justify-between items-center mb-6">
+                            <h3 className="text-xl font-black text-gray-900 uppercase tracking-tight">Nova {unitLabel.toLowerCase()}</h3>
+                            <button
+                                onClick={() => { if (!creating) setShowCreate(false); }}
+                                className="p-2 text-gray-400 hover:text-gray-600 rounded-xl transition-colors"
+                            >
+                                <X size={18} />
+                            </button>
+                        </div>
+                        <form onSubmit={handleCreate} className="space-y-4">
+                            <div>
+                                <label className="block text-xs font-bold text-gray-500 mb-1 uppercase">Nome do {unitLabel.toLowerCase()} *</label>
+                                <input
+                                    autoFocus
+                                    required
+                                    value={newNome}
+                                    onChange={e => setNewNome(e.target.value.toUpperCase())}
+                                    className="w-full px-4 py-3 border border-gray-300 rounded-xl focus:ring-2 focus:ring-teal-500 outline-none text-sm font-medium uppercase"
+                                    placeholder={isConsultorioAccount ? 'EX: DR. SILVA - CONSULTÓRIO' : 'EX: CLÍNICA SORRISO'}
+                                />
+                            </div>
+                            <div>
+                                <label className="block text-xs font-bold text-gray-500 mb-1 uppercase">CNPJ / CPF (opcional)</label>
+                                <input
+                                    value={newDoc}
+                                    onChange={e => setNewDoc(e.target.value)}
+                                    className="w-full px-4 py-3 border border-gray-300 rounded-xl focus:ring-2 focus:ring-teal-500 outline-none text-sm font-medium"
+                                    placeholder="00.000.000/0000-00"
+                                />
+                            </div>
+                            <button
+                                type="submit"
+                                disabled={creating || !newNome.trim()}
+                                className="w-full bg-teal-600 hover:bg-teal-700 text-white py-3 rounded-xl font-black uppercase flex items-center justify-center gap-2 transition-all shadow-lg disabled:opacity-60 disabled:cursor-not-allowed"
+                            >
+                                {creating ? <><Loader2 className="animate-spin" size={18} /> Criando...</> : <><Plus size={18} /> Criar {unitLabel.toLowerCase()}</>}
+                            </button>
+                        </form>
+                    </div>
+                </div>
+            )}
         </div>
     );
 };

frontend/views/CreateClinicView.tsx

@@ -10,17 +10,6 @@ function getStoredUser(): { nome?: string; role?: string } {
   try { return JSON.parse(localStorage.getItem('SCOREODONTO_USER_DATA') || '{}'); } catch { return {}; }
 }
 
-function applyWorkspace(result: any, userRole: string) {
-  const ws = {
-    id: result.clinica.id,
-    nome: result.clinica.nome_fantasia,
-    cor: '#2563eb',
-    role: userRole,
-  };
-  localStorage.setItem('SCOREODONTO_WORKSPACES', JSON.stringify([ws]));
-  localStorage.setItem('SCOREODONTO_ACTIVE_WORKSPACE', JSON.stringify(ws));
-}
-
 export const CreateClinicView: React.FC<CreateClinicViewProps> = ({ onCreated }) => {
   const storedUser = getStoredUser();
   const userRole = storedUser.role || 'donoclinica';
@@ -37,7 +26,9 @@ export const CreateClinicView: React.FC<CreateClinicViewProps> = ({ onCreated })
   const doCreate = async (nomeFinal: string, doc?: string) => {
     const result = await HybridBackend.createClinica(nomeFinal.trim(), doc?.trim() || undefined);
     if (!result.success) return result;
-    applyWorkspace(result, userRole);
+    // Recarrega a lista do servidor (acrescenta a nova unidade às existentes em vez de
+    // sobrescrever). No onboarding o usuário tem só esta unidade, então vira a ativa.
+    await HybridBackend.refreshWorkspaces();
     return result;
   };
 

frontend/views/GestaoEquipeView.tsx

@@ -62,7 +62,9 @@ const PAGINAS_RBAC: Array<{ grupo: string; itens: Array<{ key: string; label: st
       { key: 'pacientes', label: 'PACIENTES' },
       { key: 'ortodontia', label: 'ORTODONTIA' },
       { key: 'tratamentos', label: 'TRATAMENTOS' },
+      { key: 'proteses', label: 'PRÓTESES' },
       { key: 'orcamentos', label: 'ORÇAMENTOS' },
+      { key: 'contratos', label: 'CONTRATOS' },
       { key: 'rx-radiografias', label: 'RX / RADIOGRAFIAS' },
     ],
   },
@@ -94,8 +96,8 @@ const TODAS_PAGINAS = PAGINAS_RBAC.flatMap(g => g.itens.map(i => i.key));
 
 // Modelos de cargo prontos (acelera a configuração).
 const TEMPLATES_CARGO: Array<{ nome: string; nivel: number; permissoes: string[] }> = [
-  { nome: 'RECEPÇÃO', nivel: 10, permissoes: ['dashboard', 'agenda', 'pacientes', 'leads', 'orcamentos'] },
-  { nome: 'AUXILIAR / ASB', nivel: 20, permissoes: ['dashboard', 'agenda', 'pacientes', 'ortodontia', 'tratamentos'] },
+  { nome: 'RECEPÇÃO', nivel: 10, permissoes: ['dashboard', 'agenda', 'pacientes', 'leads', 'orcamentos', 'contratos', 'lancar-gto', 'proteses'] },
+  { nome: 'AUXILIAR / ASB', nivel: 20, permissoes: ['dashboard', 'agenda', 'pacientes', 'ortodontia', 'tratamentos', 'proteses'] },
   { nome: 'FINANCEIRO', nivel: 30, permissoes: ['dashboard', 'pacientes', 'financeiro', 'relatorios', 'lancar-gto'] },
   { nome: 'GERENTE', nivel: 50, permissoes: [...TODAS_PAGINAS] },
 ];

frontend/views/LabClientesView.tsx

@@ -0,0 +1,123 @@
+import React, { useState, useEffect, useCallback } from 'react';
+import { Building2, Wallet, Clock, RefreshCw, Inbox, AlertTriangle, CheckCircle2 } from 'lucide-react';
+import { HybridBackend } from '../services/backend.ts';
+import { PageHeader } from '../components/PageHeader.tsx';
+
+const fmtBRL = (v: number) => 'R$ ' + Number(v || 0).toLocaleString('pt-BR', { minimumFractionDigits: 2 });
+const dataBR = (d: string) => (d || '').slice(0, 10).split('-').reverse().join('/');
+
+// Área do Laboratório (Fase 3): Clientes (clínicas que enviam OS) + Financeiro (a-receber).
+// Uma view, duas abas — o item de menu define a aba inicial.
+export const LabClientesView: React.FC<{ tab?: 'clientes' | 'financeiro' }> = ({ tab = 'clientes' }) => {
+  const [aba, setAba] = useState<'clientes' | 'financeiro'>(tab);
+  const [clientes, setClientes] = useState<any[]>([]);
+  const [pagamentos, setPagamentos] = useState<any[]>([]);
+  const [loading, setLoading] = useState(false);
+
+  useEffect(() => { setAba(tab); }, [tab]);
+
+  const carregar = useCallback(async () => {
+    setLoading(true);
+    try {
+      const [c, p] = await Promise.all([HybridBackend.getLabClientes(), HybridBackend.getLabPagamentos()]);
+      setClientes(Array.isArray(c) ? c : []);
+      setPagamentos(Array.isArray(p) ? p : []);
+    } catch { /* silent */ } finally { setLoading(false); }
+  }, []);
+  useEffect(() => { carregar(); }, [carregar]);
+
+  const totFaturado = clientes.reduce((s, c) => s + Number(c.faturado || 0), 0);
+  const totRecebido = clientes.reduce((s, c) => s + Number(c.recebido || 0), 0);
+  const totReceber = clientes.reduce((s, c) => s + Number(c.a_receber || 0), 0);
+
+  const KPI: React.FC<{ titulo: string; valor: string; cor: string; Icon: any }> = ({ titulo, valor, cor, Icon }) => (
+    <div className="bg-white p-5 rounded-2xl border border-gray-100 shadow-sm relative overflow-hidden">
+      <div className="absolute top-0 right-0 p-3 opacity-10"><Icon size={56} className={cor} /></div>
+      <h4 className="text-[10px] font-black text-gray-400 uppercase tracking-widest">{titulo}</h4>
+      <div className="mt-2 text-xl font-black text-gray-900">{valor}</div>
+    </div>
+  );
+
+  return (
+    <div className="space-y-6 pb-10">
+      <PageHeader title={aba === 'clientes' ? 'CLIENTES DO LABORATÓRIO' : 'FINANCEIRO DO LABORATÓRIO'}>
+        <button onClick={carregar} className="bg-white border border-gray-200 text-gray-600 p-2 rounded-lg hover:bg-gray-50 flex items-center gap-2 text-xs font-bold transition-all shadow-sm">
+          <RefreshCw size={16} /> <span className="hidden sm:inline">ATUALIZAR</span>
+        </button>
+      </PageHeader>
+
+      <div className="flex border-b border-gray-100">
+        {(['clientes', 'financeiro'] as const).map(t => (
+          <button key={t} onClick={() => setAba(t)} className={`px-4 py-2.5 text-xs font-black uppercase border-b-2 -mb-px transition-colors ${aba === t ? 'border-teal-600 text-teal-700' : 'border-transparent text-gray-400 hover:text-gray-600'}`}>{t === 'clientes' ? 'Clientes' : 'Financeiro'}</button>
+        ))}
+      </div>
+
+      {loading ? <div className="flex justify-center py-16"><RefreshCw className="animate-spin text-teal-600" size={28} /></div> : (
+        <>
+          {aba === 'clientes' && (
+            clientes.length === 0 ? (
+              <div className="py-16 text-center text-gray-400 font-bold uppercase text-sm">Nenhuma clínica enviou OS ainda.</div>
+            ) : (
+              <div className="bg-white rounded-2xl border border-gray-100 shadow-sm overflow-x-auto">
+                <table className="w-full text-left text-xs">
+                  <thead className="bg-gray-50/60"><tr>{['Clínica', 'OS', 'Ativas', 'Atrasadas', 'Entregues', 'Faturado', 'A receber'].map(h => <th key={h} className="px-4 py-3 text-[10px] font-black text-gray-400 uppercase tracking-widest whitespace-nowrap">{h}</th>)}</tr></thead>
+                  <tbody className="divide-y divide-gray-100">
+                    {clientes.map(c => (
+                      <tr key={c.clinica_id} className="hover:bg-gray-50/50">
+                        <td className="px-4 py-3 font-black text-gray-700 uppercase flex items-center gap-2"><Building2 size={14} className="text-teal-600 shrink-0" /> {c.clinica_nome || '—'}</td>
+                        <td className="px-4 py-3 text-gray-600 font-bold">{c.total}</td>
+                        <td className="px-4 py-3 text-teal-600 font-bold">{c.ativas}</td>
+                        <td className={`px-4 py-3 font-bold ${c.atrasadas > 0 ? 'text-red-500' : 'text-gray-400'}`}>{c.atrasadas}</td>
+                        <td className="px-4 py-3 text-green-600 font-bold">{c.entregues}</td>
+                        <td className="px-4 py-3 font-black text-gray-800">{fmtBRL(c.faturado)}</td>
+                        <td className={`px-4 py-3 font-black ${c.a_receber > 0 ? 'text-amber-600' : 'text-gray-300'}`}>{fmtBRL(c.a_receber)}</td>
+                      </tr>
+                    ))}
+                  </tbody>
+                </table>
+              </div>
+            )
+          )}
+
+          {aba === 'financeiro' && (
+            <>
+              <div className="grid grid-cols-1 sm:grid-cols-3 gap-4">
+                <KPI titulo="Faturado" valor={fmtBRL(totFaturado)} cor="text-gray-700" Icon={CheckCircle2} />
+                <KPI titulo="Recebido" valor={fmtBRL(totRecebido)} cor="text-green-600" Icon={Wallet} />
+                <KPI titulo="A receber" valor={fmtBRL(totReceber)} cor="text-amber-500" Icon={Clock} />
+              </div>
+              <div className="bg-white rounded-2xl border border-gray-100 shadow-sm overflow-hidden">
+                <div className="px-6 py-4 border-b border-gray-100 bg-gray-50/50 flex items-center gap-2">
+                  <Inbox size={16} className="text-teal-600" /><h3 className="text-sm font-black text-gray-800 uppercase">Recebimentos</h3>
+                  <span className="text-[10px] font-bold text-gray-400 uppercase ml-auto">{pagamentos.length} lançamento(s)</span>
+                </div>
+                {pagamentos.length === 0 ? (
+                  <div className="py-12 text-center text-gray-400 text-sm font-bold uppercase">Nenhum recebimento registrado.</div>
+                ) : (
+                  <div className="overflow-x-auto">
+                    <table className="w-full text-left text-xs">
+                      <thead className="bg-gray-50/60"><tr>{['Clínica', 'Paciente', 'Trabalho', 'Forma', 'Data', 'Valor'].map(h => <th key={h} className="px-4 py-3 text-[10px] font-black text-gray-400 uppercase tracking-widest whitespace-nowrap">{h}</th>)}</tr></thead>
+                      <tbody className="divide-y divide-gray-100">
+                        {pagamentos.map(p => (
+                          <tr key={p.id} className="hover:bg-gray-50/50">
+                            <td className="px-4 py-3 font-bold text-gray-700 uppercase">{p.clinica_nome || '—'}</td>
+                            <td className="px-4 py-3 text-gray-500 uppercase">{p.paciente_nome || '—'}</td>
+                            <td className="px-4 py-3 text-gray-500">{p.tipo || '—'}</td>
+                            <td className="px-4 py-3 text-gray-500">{p.forma || '—'}</td>
+                            <td className="px-4 py-3 text-gray-500 whitespace-nowrap">{dataBR(p.data)}</td>
+                            <td className="px-4 py-3 font-black text-green-700">{fmtBRL(p.valor)}</td>
+                          </tr>
+                        ))}
+                      </tbody>
+                    </table>
+                  </div>
+                )}
+              </div>
+              <p className="text-[10px] text-gray-300 font-bold uppercase flex items-center gap-1"><AlertTriangle size={11} /> Faturado = custo das OS entregues (exceto garantia). A receber = faturado − recebido.</p>
+            </>
+          )}
+        </>
+      )}
+    </div>
+  );
+};

frontend/views/LabCotacoesView.tsx

@@ -0,0 +1,85 @@
+import React, { useState, useEffect, useCallback } from 'react';
+import { FileText, RefreshCw, Building2, CheckCircle2, XCircle, Send, Clock } from 'lucide-react';
+import { HybridBackend } from '../services/backend.ts';
+import { useToast } from '../contexts/ToastContext.tsx';
+import { PageHeader } from '../components/PageHeader.tsx';
+
+const dataBR = (d: string) => (d || '').slice(0, 10).split('-').reverse().join('/');
+const fmtBRL = (v: number) => 'R$ ' + Number(v || 0).toLocaleString('pt-BR', { minimumFractionDigits: 2 });
+
+// Área do Laboratório (Fatia 3): pedidos de cotação recebidos das clínicas.
+export const LabCotacoesView: React.FC = () => {
+  const toast = useToast();
+  const [lista, setLista] = useState<any[]>([]);
+  const [loading, setLoading] = useState(false);
+  const [forms, setForms] = useState<Record<string, { valor: string; prazo: string; obs: string }>>({});
+  const [busy, setBusy] = useState('');
+
+  const carregar = useCallback(async () => {
+    setLoading(true);
+    try { const r = await HybridBackend.getRfqRecebidas(); setLista(Array.isArray(r) ? r : []); }
+    catch { /* silent */ } finally { setLoading(false); }
+  }, []);
+  useEffect(() => { carregar(); }, [carregar]);
+
+  const setF = (id: string, k: string, v: string) => setForms(s => ({ ...s, [id]: { ...(s[id] || { valor: '', prazo: '', obs: '' }), [k]: v } }));
+  const responder = async (c: any) => {
+    const f = forms[c.cotacao_id] || { valor: '', prazo: '', obs: '' };
+    const valor = parseFloat(f.valor);
+    if (!(valor > 0)) { toast.error('INFORME O VALOR.'); return; }
+    setBusy(c.cotacao_id);
+    try { await HybridBackend.responderCotacao(c.cotacao_id, { valor, prazo_dias: parseInt(f.prazo, 10) || undefined, observacao: f.obs.trim() || undefined }); toast.success('COTAÇÃO ENVIADA.'); carregar(); }
+    catch (e: any) { toast.error((e.message || 'ERRO').toUpperCase()); } finally { setBusy(''); }
+  };
+
+  return (
+    <div className="space-y-6 pb-10 max-w-2xl">
+      <PageHeader title="PEDIDOS DE COTAÇÃO">
+        <button onClick={carregar} className="bg-white border border-gray-200 text-gray-600 p-2 rounded-lg hover:bg-gray-50 flex items-center gap-2 text-xs font-bold shadow-sm"><RefreshCw size={16} /></button>
+      </PageHeader>
+
+      {loading ? <div className="flex justify-center py-16"><RefreshCw className="animate-spin text-teal-600" size={28} /></div>
+        : lista.length === 0 ? <div className="py-16 text-center text-gray-400 font-bold uppercase text-sm">Nenhum pedido de cotação.</div>
+          : (
+            <div className="space-y-3">
+              {lista.map(c => {
+                const aberta = c.rfq_status === 'aberta';
+                const ganhou = c.cotacao_status === 'escolhida';
+                const perdeu = c.cotacao_status === 'recusada';
+                const f = forms[c.cotacao_id] || { valor: '', prazo: '', obs: '' };
+                return (
+                  <div key={c.cotacao_id} className={`bg-white rounded-2xl border shadow-sm p-4 ${ganhou ? 'border-green-200' : 'border-gray-100'}`}>
+                    <div className="flex items-start justify-between gap-2">
+                      <div className="min-w-0">
+                        <p className="font-black text-gray-800 text-sm">{c.descricao}</p>
+                        <p className="text-[11px] text-gray-400 uppercase font-bold flex items-center gap-1 mt-0.5"><Building2 size={11} /> {c.clinica_nome || 'Clínica'}{c.dentes ? ` · dentes ${c.dentes}` : ''}</p>
+                      </div>
+                      {ganhou && <span className="text-[9px] font-black px-2 py-1 rounded-full bg-green-100 text-green-700 uppercase flex items-center gap-1 shrink-0"><CheckCircle2 size={11} /> Você ganhou</span>}
+                      {perdeu && <span className="text-[9px] font-black px-2 py-1 rounded-full bg-gray-100 text-gray-500 uppercase flex items-center gap-1 shrink-0"><XCircle size={11} /> Não escolhida</span>}
+                      {aberta && c.cotacao_status === 'enviada' && <span className="text-[9px] font-black px-2 py-1 rounded-full bg-amber-100 text-amber-700 uppercase shrink-0">Cotado · {fmtBRL(c.valor)}</span>}
+                    </div>
+                    {(c.paciente_nome || c.prazo_desejado) && <p className="text-[11px] text-gray-400 mt-2">{c.paciente_nome || ''}{c.prazo_desejado ? ` · prazo desejado ${dataBR(c.prazo_desejado)}` : ''}</p>}
+
+                    {aberta && (
+                      <div className="mt-3 pt-3 border-t border-gray-100 flex flex-wrap items-end gap-2">
+                        <div>
+                          <label className="text-[9px] font-black text-gray-400 uppercase block mb-1">Valor (R$)</label>
+                          <input type="number" step="0.01" value={f.valor} onChange={e => setF(c.cotacao_id, 'valor', e.target.value)} placeholder={c.valor ? String(c.valor) : '0,00'} className="w-24 p-2 bg-gray-50 border border-gray-100 rounded-lg text-xs font-bold outline-none focus:border-teal-400" />
+                        </div>
+                        <div>
+                          <label className="text-[9px] font-black text-gray-400 uppercase block mb-1">Prazo (dias)</label>
+                          <input type="number" value={f.prazo} onChange={e => setF(c.cotacao_id, 'prazo', e.target.value)} className="w-20 p-2 bg-gray-50 border border-gray-100 rounded-lg text-xs font-bold outline-none focus:border-teal-400" />
+                        </div>
+                        <input value={f.obs} onChange={e => setF(c.cotacao_id, 'obs', e.target.value)} placeholder="Observação" className="flex-1 min-w-[120px] p-2 bg-gray-50 border border-gray-100 rounded-lg text-xs outline-none focus:border-teal-400" />
+                        <button disabled={busy === c.cotacao_id} onClick={() => responder(c)} 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"><Send size={13} /> {c.cotacao_status === 'enviada' ? 'Atualizar' : 'Cotar'}</button>
+                      </div>
+                    )}
+                    {!aberta && !ganhou && !perdeu && <p className="text-[10px] text-gray-400 uppercase font-bold mt-2 flex items-center gap-1"><Clock size={11} /> Encerrado</p>}
+                  </div>
+                );
+              })}
+            </div>
+          )}
+    </div>
+  );
+};

frontend/views/LabEquipeView.tsx

@@ -0,0 +1,117 @@
+import React, { useState, useEffect, useCallback } from 'react';
+import { UsersRound, Building2, RefreshCw, Trash2, Plus, KeyRound, Save } from 'lucide-react';
+import { HybridBackend } from '../services/backend.ts';
+import { useToast } from '../contexts/ToastContext.tsx';
+import { useConfirm } from '../contexts/ConfirmContext.tsx';
+import { PageHeader } from '../components/PageHeader.tsx';
+
+// Área do Laboratório (Fase 4): dados PF/PJ (CPF/CNPJ) + equipe de técnicos.
+export const LabEquipeView: React.FC = () => {
+  const toast = useToast();
+  const confirm = useConfirm();
+  const [dados, setDados] = useState<any>(null);
+  const [equipe, setEquipe] = useState<any[]>([]);
+  const [loading, setLoading] = useState(false);
+  const [busy, setBusy] = useState(false);
+  const [email, setEmail] = useState('');
+  const [nome, setNome] = useState('');
+  const [cred, setCred] = useState<{ email: string; senha: string } | null>(null);
+
+  const carregar = useCallback(async () => {
+    setLoading(true);
+    try {
+      const [d, e] = await Promise.all([HybridBackend.getLabDados(), HybridBackend.getLabEquipe()]);
+      setDados(d || {});
+      setEquipe(Array.isArray(e) ? e : []);
+    } catch { /* silent */ } finally { setLoading(false); }
+  }, []);
+  useEffect(() => { carregar(); }, [carregar]);
+
+  const salvarDados = async () => {
+    if (!dados?.nome_fantasia?.trim()) { toast.error('INFORME O NOME.'); return; }
+    setBusy(true);
+    try { await HybridBackend.updateLabDados({ nome_fantasia: dados.nome_fantasia, documento: dados.documento || '', pessoa_tipo: dados.pessoa_tipo }); toast.success('DADOS SALVOS.'); carregar(); }
+    catch (e: any) { toast.error((e.message || 'ERRO').toUpperCase()); } finally { setBusy(false); }
+  };
+  const addTecnico = async () => {
+    if (!email.trim()) { toast.error('INFORME O E-MAIL.'); return; }
+    setBusy(true);
+    try {
+      const r = await HybridBackend.addLabTecnico({ email: email.trim(), nome: nome.trim() || undefined });
+      toast.success('TÉCNICO ADICIONADO.');
+      if (r?.created && r?.tempPassword) setCred({ email: email.trim().toLowerCase(), senha: r.tempPassword });
+      setEmail(''); setNome(''); carregar();
+    } catch (e: any) { toast.error((e.message || 'ERRO').toUpperCase()); } finally { setBusy(false); }
+  };
+  const remover = async (u: any) => {
+    if (!(await confirm(`REMOVER ${u.nome || u.email} DA EQUIPE?`))) return;
+    try { await HybridBackend.removeLabTecnico(u.id); toast.success('REMOVIDO.'); carregar(); }
+    catch (e: any) { toast.error((e.message || 'ERRO').toUpperCase()); }
+  };
+
+  if (loading || !dados) return <div className="flex justify-center py-20"><RefreshCw className="animate-spin text-teal-600" size={28} /></div>;
+  const ehPJ = dados.pessoa_tipo === 'PJ';
+
+  return (
+    <div className="space-y-6 pb-10 max-w-2xl">
+      <PageHeader title="LABORATÓRIO & EQUIPE">
+        <button onClick={carregar} className="bg-white border border-gray-200 text-gray-600 p-2 rounded-lg hover:bg-gray-50 flex items-center gap-2 text-xs font-bold shadow-sm"><RefreshCw size={16} /></button>
+      </PageHeader>
+
+      {/* Dados do provedor */}
+      <div className="bg-white rounded-2xl border border-gray-100 shadow-sm p-5 space-y-4">
+        <h3 className="text-sm font-black text-gray-800 uppercase flex items-center gap-2"><Building2 size={16} className="text-teal-600" /> Dados do provedor</h3>
+        <div className="flex gap-2">
+          {(['PF', 'PJ'] as const).map(t => (
+            <button key={t} onClick={() => setDados((d: any) => ({ ...d, pessoa_tipo: t }))} className={`flex-1 py-2.5 rounded-xl font-black text-xs uppercase border-2 transition-colors ${dados.pessoa_tipo === t ? 'border-teal-500 bg-teal-50 text-teal-700' : 'border-gray-100 text-gray-400'}`}>
+              {t === 'PF' ? 'Protético Individual (PF)' : 'Laboratório (PJ)'}
+            </button>
+          ))}
+        </div>
+        <div>
+          <label className="text-[10px] font-black text-gray-400 uppercase tracking-widest block mb-1.5">{ehPJ ? 'Nome Fantasia' : 'Nome'}</label>
+          <input value={dados.nome_fantasia || ''} onChange={e => setDados((d: any) => ({ ...d, nome_fantasia: e.target.value }))} className="w-full p-3 bg-gray-50 border-2 border-gray-100 rounded-xl text-sm font-bold text-gray-700 outline-none focus:border-teal-400 uppercase" />
+        </div>
+        <div>
+          <label className="text-[10px] font-black text-gray-400 uppercase tracking-widest block mb-1.5">{ehPJ ? 'CNPJ' : 'CPF'}</label>
+          <input value={dados.documento || ''} onChange={e => setDados((d: any) => ({ ...d, documento: e.target.value }))} placeholder={ehPJ ? '00.000.000/0000-00' : '000.000.000-00'} className="w-full p-3 bg-gray-50 border-2 border-gray-100 rounded-xl text-sm font-bold text-gray-700 outline-none focus:border-teal-400" />
+        </div>
+        <button disabled={busy} onClick={salvarDados} className="bg-teal-600 text-white px-4 py-2.5 rounded-xl font-black text-sm uppercase disabled:opacity-50 flex items-center gap-2"><Save size={15} /> Salvar dados</button>
+      </div>
+
+      {/* Equipe */}
+      <div className="bg-white rounded-2xl border border-gray-100 shadow-sm p-5 space-y-4">
+        <h3 className="text-sm font-black text-gray-800 uppercase flex items-center gap-2"><UsersRound size={16} className="text-violet-600" /> Equipe de técnicos</h3>
+        <p className="text-[11px] text-gray-400 font-bold uppercase">Técnicos veem a bancada e operam a produção — sem acesso a clientes, financeiro ou valores do paciente.</p>
+
+        {cred && (
+          <div className="bg-amber-50 border border-amber-200 rounded-xl p-3 text-xs">
+            <p className="font-black text-amber-700 uppercase flex items-center gap-1.5"><KeyRound size={13} /> Credencial criada</p>
+            <p className="text-amber-800 mt-1">{cred.email} · senha temporária: <b>{cred.senha}</b></p>
+            <button onClick={() => setCred(null)} className="text-[10px] font-black text-amber-600 uppercase mt-1">OK, anotei</button>
+          </div>
+        )}
+
+        <div className="space-y-1.5">
+          {equipe.map(u => (
+            <div key={u.id} className="flex items-center gap-2 bg-gray-50 rounded-lg px-3 py-2 text-xs">
+              <div className="w-7 h-7 rounded-lg bg-violet-100 flex items-center justify-center text-violet-600 font-black shrink-0">{(u.nome || u.email || '?')[0].toUpperCase()}</div>
+              <div className="min-w-0 flex-1">
+                <p className="font-bold text-gray-700 truncate uppercase">{u.nome || '—'}</p>
+                <p className="text-[10px] text-gray-400 truncate">{u.email}</p>
+              </div>
+              <button onClick={() => remover(u)} className="text-gray-300 hover:text-red-500"><Trash2 size={15} /></button>
+            </div>
+          ))}
+          {equipe.length === 0 && <p className="text-[11px] text-gray-300 font-bold uppercase">Nenhum técnico na equipe.</p>}
+        </div>
+
+        <div className="flex gap-2">
+          <input value={nome} onChange={e => setNome(e.target.value)} placeholder="Nome (opcional)" className="w-32 p-2.5 bg-gray-50 border border-gray-100 rounded-lg text-xs outline-none focus:border-teal-400" />
+          <input value={email} onChange={e => setEmail(e.target.value)} placeholder="E-mail do técnico" className="flex-1 p-2.5 bg-gray-50 border border-gray-100 rounded-lg text-xs outline-none focus:border-teal-400" />
+          <button disabled={busy} onClick={addTecnico} className="px-3 rounded-lg bg-violet-600 text-white text-xs font-black uppercase disabled:opacity-50 flex items-center gap-1"><Plus size={14} /></button>
+        </div>
+      </div>
+    </div>
+  );
+};

frontend/views/LabHomeView.tsx

@@ -0,0 +1,124 @@
+import React, { useState, useEffect, useCallback } from 'react';
+import { FlaskConical, Wallet, Clock, AlertTriangle, CheckCircle2, RefreshCw, Inbox } from 'lucide-react';
+import { HybridBackend } from '../services/backend.ts';
+import { PageHeader } from '../components/PageHeader.tsx';
+
+const fmtBRL = (v: number) => 'R$ ' + Number(v || 0).toLocaleString('pt-BR', { minimumFractionDigits: 2 });
+
+// Painel do LABORATÓRIO (protético): aparece quando o workspace ativo é tipo='laboratorio'.
+// Resumo a partir do que já existe — a Bancada (OS) + o financeiro do workspace do lab.
+export const LabHomeView: React.FC = () => {
+  const ws: any = HybridBackend.getActiveWorkspace();
+  const [os, setOs] = useState<any[]>([]);
+  const [fin, setFin] = useState<any[]>([]);
+  const [loading, setLoading] = useState(false);
+
+  const carregar = useCallback(async () => {
+    setLoading(true);
+    try {
+      const [b, f] = await Promise.all([HybridBackend.getProteseBancada(), HybridBackend.getFinanceiro()]);
+      setOs(Array.isArray(b) ? b : []);
+      setFin(Array.isArray(f) ? f : []);
+    } catch { /* silent */ } finally { setLoading(false); }
+  }, []);
+  useEffect(() => { carregar(); }, [carregar]);
+
+  const ativas = os.filter(o => o.status !== 'entregue' && o.status !== 'cancelado');
+  const atrasadas = os.filter(o => o.atrasada).length;
+  const ymMes = new Date().toISOString().slice(0, 7);
+  const entreguesMes = os.filter(o => o.status === 'entregue' && (o.updated_at || '').slice(0, 7) === ymMes).length;
+  // Faturamento do mês: RECEITA de prótese lançada no workspace do lab (espelho da entrega).
+  const fatMes = fin
+    .filter(l => l.origem === 'protese' && (l.data_competencia || l.datavencimento || '').slice(0, 7) === ymMes)
+    .reduce((s, l) => s + Number(l.valor || 0), 0);
+
+  const KPI: React.FC<{ titulo: string; valor: string; cor: string; Icon: any; sub?: string }> = ({ titulo, valor, cor, Icon, sub }) => (
+    <div className="bg-white p-5 rounded-2xl border border-gray-100 shadow-sm relative overflow-hidden">
+      <div className="absolute top-0 right-0 p-3 opacity-10"><Icon size={56} className={cor} /></div>
+      <h4 className="text-[10px] font-black text-gray-400 uppercase tracking-widest">{titulo}</h4>
+      <div className="mt-2 text-xl font-black text-gray-900">{valor}</div>
+      {sub && <p className="mt-2 text-[10px] font-bold text-gray-400 uppercase">{sub}</p>}
+    </div>
+  );
+
+  // Distribuição por status (fila de produção).
+  const STATUS_ORD = ['solicitado', 'recebido', 'producao', 'prova', 'ajuste', 'finalizado'];
+  const STATUS_LABEL: Record<string, string> = { solicitado: 'Solicitado', recebido: 'Recebido', producao: 'Produção', prova: 'Prova', ajuste: 'Ajuste', finalizado: 'Finalizado' };
+  const porStatus = STATUS_ORD.map(s => ({ s, n: ativas.filter(o => o.status === s).length })).filter(x => x.n > 0);
+
+  return (
+    <div className="space-y-6 pb-10">
+      <PageHeader title="PAINEL DO LABORATÓRIO">
+        <button onClick={carregar} className="bg-white border border-gray-200 text-gray-600 p-2 rounded-lg hover:bg-gray-50 flex items-center gap-2 text-xs font-bold transition-all shadow-sm">
+          <RefreshCw size={16} /> <span className="hidden sm:inline">ATUALIZAR</span>
+        </button>
+      </PageHeader>
+
+      <div className="bg-white rounded-2xl border border-gray-100 shadow-sm px-6 py-4 flex items-center gap-3">
+        <div className="w-10 h-10 rounded-xl flex items-center justify-center text-white shrink-0" style={{ backgroundColor: '#2d6a4f' }}><FlaskConical size={20} /></div>
+        <div className="min-w-0">
+          <p className="font-black text-gray-900 uppercase truncate">{ws?.nome || 'Laboratório'}</p>
+          <p className="text-[11px] text-gray-400 font-bold uppercase">Área de gestão do protético</p>
+        </div>
+      </div>
+
+      {loading ? <div className="flex justify-center py-16"><RefreshCw className="animate-spin text-teal-600" size={28} /></div> : (
+        <>
+          <div className="grid grid-cols-2 lg:grid-cols-4 gap-4">
+            <KPI titulo="Na bancada" valor={String(ativas.length)} cor="text-teal-600" Icon={Inbox} sub="OS em produção" />
+            <KPI titulo="Atrasadas" valor={String(atrasadas)} cor="text-red-500" Icon={AlertTriangle} sub="Prazo vencido" />
+            <KPI titulo="Entregues no mês" valor={String(entreguesMes)} cor="text-green-600" Icon={CheckCircle2} sub="Concluídas" />
+            <KPI titulo="Faturamento do mês" valor={fmtBRL(fatMes)} cor="text-violet-600" Icon={Wallet} sub="Receita de prótese" />
+          </div>
+
+          {/* Fila por status */}
+          <div className="bg-white rounded-2xl border border-gray-100 shadow-sm overflow-hidden">
+            <div className="px-6 py-4 border-b border-gray-100 bg-gray-50/50 flex items-center gap-2">
+              <Clock size={16} className="text-teal-600" />
+              <h3 className="text-sm font-black text-gray-800 uppercase">Fila de produção</h3>
+            </div>
+            {porStatus.length === 0 ? (
+              <div className="py-12 text-center text-gray-400 text-sm font-bold uppercase">Nenhuma OS em produção.</div>
+            ) : (
+              <div className="p-4 flex flex-wrap gap-3">
+                {porStatus.map(({ s, n }) => (
+                  <div key={s} className="px-4 py-3 rounded-xl bg-gray-50 border border-gray-100 min-w-[120px]">
+                    <p className="text-[10px] font-black text-gray-400 uppercase tracking-widest">{STATUS_LABEL[s]}</p>
+                    <p className="text-2xl font-black text-gray-800">{n}</p>
+                  </div>
+                ))}
+              </div>
+            )}
+          </div>
+
+          {/* Próximas entregas */}
+          <div className="bg-white rounded-2xl border border-gray-100 shadow-sm overflow-hidden">
+            <div className="px-6 py-4 border-b border-gray-100 bg-gray-50/50">
+              <h3 className="text-sm font-black text-gray-800 uppercase">Próximas entregas</h3>
+            </div>
+            {ativas.filter(o => o.prazo_entrega).length === 0 ? (
+              <div className="py-10 text-center text-gray-400 text-sm font-bold uppercase">Sem prazos agendados.</div>
+            ) : (
+              <div className="overflow-x-auto">
+                <table className="w-full text-left text-xs">
+                  <thead className="bg-gray-50/60"><tr>{['Paciente', 'Tipo', 'Prazo', 'Status', 'Valor'].map(h => <th key={h} className="px-4 py-3 text-[10px] font-black text-gray-400 uppercase tracking-widest">{h}</th>)}</tr></thead>
+                  <tbody className="divide-y divide-gray-100">
+                    {ativas.filter(o => o.prazo_entrega).sort((a, b) => (a.prazo_entrega || '').localeCompare(b.prazo_entrega || '')).slice(0, 12).map(o => (
+                      <tr key={o.id} className={`hover:bg-gray-50/50 ${o.atrasada ? 'bg-red-50/40' : ''}`}>
+                        <td className="px-4 py-3 font-bold text-gray-700 uppercase">{o.paciente_nome || '—'}</td>
+                        <td className="px-4 py-3 text-gray-500 uppercase">{o.tipo || '—'}</td>
+                        <td className={`px-4 py-3 whitespace-nowrap font-bold ${o.atrasada ? 'text-red-600' : 'text-gray-500'}`}>{(o.prazo_entrega || '').slice(0, 10).split('-').reverse().join('/')}</td>
+                        <td className="px-4 py-3"><span className="px-2 py-0.5 rounded-full text-[9px] font-black uppercase bg-teal-100 text-teal-700">{STATUS_LABEL[o.status] || o.status}</span></td>
+                        <td className="px-4 py-3 font-black text-gray-800">{fmtBRL(o.custo)}</td>
+                      </tr>
+                    ))}
+                  </tbody>
+                </table>
+              </div>
+            )}
+          </div>
+        </>
+      )}
+    </div>
+  );
+};

frontend/views/LabIndicadoresView.tsx

@@ -0,0 +1,72 @@
+import React, { useState, useEffect, useCallback } from 'react';
+import { BarChart3, RefreshCw, Clock, AlertTriangle, RotateCcw, PackageX, Award, CheckCircle2, BadgeCheck, Star } from 'lucide-react';
+import { HybridBackend } from '../services/backend.ts';
+import { PageHeader } from '../components/PageHeader.tsx';
+
+// Área do Laboratório (Fase 5): indicadores derivados da captura + Nota ScoreOdonto.
+export const LabIndicadoresView: React.FC = () => {
+  const [ind, setInd] = useState<any>(null);
+  const [loading, setLoading] = useState(false);
+
+  const carregar = useCallback(async () => {
+    setLoading(true);
+    try { setInd(await HybridBackend.getLabIndicadores()); } catch { /* silent */ } finally { setLoading(false); }
+  }, []);
+  useEffect(() => { carregar(); }, [carregar]);
+
+  const KPI: React.FC<{ titulo: string; valor: string; cor: string; Icon: any; sub?: string }> = ({ titulo, valor, cor, Icon, sub }) => (
+    <div className="bg-white p-5 rounded-2xl border border-gray-100 shadow-sm relative overflow-hidden">
+      <div className="absolute top-0 right-0 p-3 opacity-10"><Icon size={56} className={cor} /></div>
+      <h4 className="text-[10px] font-black text-gray-400 uppercase tracking-widest">{titulo}</h4>
+      <div className="mt-2 text-xl font-black text-gray-900">{valor}</div>
+      {sub && <p className="mt-2 text-[10px] font-bold text-gray-400 uppercase">{sub}</p>}
+    </div>
+  );
+
+  if (loading || !ind) return <div className="flex justify-center py-20"><RefreshCw className="animate-spin text-teal-600" size={28} /></div>;
+
+  const temNota = ind.nota !== null && ind.nota !== undefined;
+  const notaCor = ind.nota >= 9 ? 'text-green-600' : ind.nota >= 7 ? 'text-teal-600' : ind.nota >= 5 ? 'text-amber-500' : 'text-red-500';
+
+  return (
+    <div className="space-y-6 pb-10">
+      <PageHeader title="INDICADORES DO LABORATÓRIO">
+        <button onClick={carregar} className="bg-white border border-gray-200 text-gray-600 p-2 rounded-lg hover:bg-gray-50 flex items-center gap-2 text-xs font-bold shadow-sm"><RefreshCw size={16} /></button>
+      </PageHeader>
+
+      {/* Nota ScoreOdonto */}
+      <div className="bg-white rounded-2xl border border-gray-100 shadow-sm p-6 flex items-center gap-5">
+        <div className={`w-20 h-20 rounded-2xl border-4 flex flex-col items-center justify-center shrink-0 ${temNota ? 'border-current ' + notaCor : 'border-gray-200 text-gray-300'}`}>
+          <Award size={18} />
+          <span className="text-2xl font-black leading-none mt-0.5">{temNota ? ind.nota.toFixed(1) : '—'}</span>
+        </div>
+        <div className="min-w-0">
+          <div className="flex items-center gap-2 flex-wrap">
+            <h3 className="text-sm font-black text-gray-800 uppercase">Nota ScoreOdonto</h3>
+            {ind.verificado && <span className="text-[9px] font-black px-2 py-0.5 rounded-full bg-teal-100 text-teal-700 uppercase flex items-center gap-0.5"><BadgeCheck size={11} /> Verificado</span>}
+          </div>
+          {temNota ? (
+            <p className="text-[11px] text-gray-400 font-bold uppercase mt-1">Sobre {ind.entregues} entrega(s){ind.avaliacoes ? ` · ${ind.satisfacao}★ de ${ind.avaliacoes} avaliações` : ''}. Combina desempenho (atraso/retrabalho/ocorrências) e satisfação da clínica.</p>
+          ) : (
+            <p className="text-[11px] text-amber-500 font-bold uppercase mt-1">Score em formação — mínimo de {ind.min_os} entregas para gerar a nota.</p>
+          )}
+        </div>
+      </div>
+
+      <div className="grid grid-cols-2 lg:grid-cols-4 gap-4">
+        <KPI titulo="Entregues" valor={String(ind.entregues)} cor="text-green-600" Icon={CheckCircle2} sub={`${ind.total} OS no total`} />
+        <KPI titulo="Tempo médio" valor={`${ind.dias_medio} d`} cor="text-blue-600" Icon={Clock} sub="Solicitado → entregue" />
+        <KPI titulo="Atrasos" valor={`${ind.atraso_pct}%`} cor="text-amber-500" Icon={AlertTriangle} sub={`${ind.atrasados} entrega(s)`} />
+        <KPI titulo="Retrabalho" valor={`${ind.retrabalho_pct}%`} cor="text-orange-500" Icon={RotateCcw} sub={`${ind.garantia} garantia(s)`} />
+        <KPI titulo="Ocorrências" valor={`${ind.ocorrencia_pct}%`} cor="text-red-500" Icon={AlertTriangle} sub={`${ind.ocorrencias_resolvidas} resolvida(s)`} />
+        <KPI titulo="Componentes perdidos" valor={String(ind.componentes_ausentes)} cor="text-red-600" Icon={PackageX} sub="Conferidos como ausentes" />
+        <KPI titulo="Satisfação" valor={ind.satisfacao != null ? `${ind.satisfacao}★` : '—'} cor="text-amber-500" Icon={Star} sub={`${ind.avaliacoes || 0} avaliação(ões)`} />
+      </div>
+
+      <div className="bg-white rounded-2xl border border-gray-100 shadow-sm p-5">
+        <h3 className="text-sm font-black text-gray-800 uppercase flex items-center gap-2 mb-2"><BarChart3 size={16} className="text-teal-600" /> Como a nota é calculada</h3>
+        <p className="text-xs text-gray-500">Base 10, descontando proporcionalmente: <b>atraso</b> (peso 3), <b>retrabalho/garantia</b> (peso 4) e <b>ocorrências resolvidas</b> (peso 3). Só ocorrências <b>resolvidas</b> (após contraditório) entram — abertas/contestadas não pesam. A nota aparece para as clínicas no marketplace ao escolherem o laboratório.</p>
+      </div>
+    </div>
+  );
+};

frontend/views/LancarGTO.tsx

@@ -32,6 +32,9 @@ interface GTOItem {
     valorUnitario: number;
     valorTotal: number;
     observacao?: string;
+    // Prótese (Fase 1): item ligado ao catálogo do protético → gera OS ao finalizar.
+    produtoId?: string;
+    proteticoId?: string;
 }
 
 interface GTOStore {
@@ -119,6 +122,14 @@ export const LancarGTO: React.FC = () => {
     const [patientSearchOpen, setPatientSearchOpen] = useState(false);
     const [patientSearchTerm, setPatientSearchTerm] = useState('');
 
+    // --- PRÓTESE (Fase 1): catálogo do protético entra como "procedimentos" do GTO ---
+    const [laboratorios, setLaboratorios] = useState<any[]>([]);
+    const [selectedLab, setSelectedLab] = useState<string>('');
+    const [labProdutos, setLabProdutos] = useState<any[]>([]);
+    const [selectedProdutoId, setSelectedProdutoId] = useState<string>('');
+    const [protValor, setProtValor] = useState<string>('');
+    const [protObs, setProtObs] = useState<string>('');
+
     useEffect(() => {
         const load = async () => {
             const p = await HybridBackend.getPacientes();
@@ -140,14 +151,55 @@ export const LancarGTO: React.FC = () => {
         return procedimentos.filter(p => p.especialidadeId === selectedEsp);
     }, [selectedEsp, procedimentos]);
 
-    const filteredPatients = useMemo(() => {
-        if (!patientSearchTerm) return pacientes.slice(0, 30);
-        const term = normalize(patientSearchTerm);
-        return pacientes.filter(p =>
-            normalize(p.nome).includes(term) ||
-            (p.cpf && p.cpf.includes(patientSearchTerm.replace(/\D/g, '')))
-        ).slice(0, 30);
-    }, [pacientes, patientSearchTerm]); // eslint-disable-line react-hooks/exhaustive-deps
+    // Especialidade de prótese → o "procedimento" vem do catálogo do protético (não da
+    // tabela procedimentos). Detecta pela área da especialidade (re-tagueada no backend).
+    const isProtese = useMemo(
+        () => (especialidades.find(e => e.id === selectedEsp)?.area || '') === 'protese',
+        [especialidades, selectedEsp]
+    );
+    const selectedProduto = useMemo(
+        () => labProdutos.find(p => p.id === selectedProdutoId) || null,
+        [labProdutos, selectedProdutoId]
+    );
+
+    // Carrega os laboratórios acessíveis assim que a especialidade de prótese é escolhida.
+    useEffect(() => {
+        if (!isProtese || laboratorios.length) return;
+        HybridBackend.getProteseLaboratorios().then(l => setLaboratorios(Array.isArray(l) ? l : [])).catch(() => {});
+    }, [isProtese, laboratorios.length]);
+
+    // Catálogo do laboratório selecionado.
+    useEffect(() => {
+        if (!selectedLab) { setLabProdutos([]); return; }
+        let active = true;
+        HybridBackend.getLaboratorioProdutos(selectedLab)
+            .then(p => { if (active) setLabProdutos(Array.isArray(p) ? p : []); })
+            .catch(() => { if (active) setLabProdutos([]); });
+        return () => { active = false; };
+    }, [selectedLab]);
+
+    // Busca de pacientes é SERVER-SIDE: a clínica pode ter milhares e a rota sem termo
+    // devolve só as 50 primeiras. Filtrar essas 50 no cliente fazia a busca "não achar"
+    // quem estava fora da 1ª página. Sem termo, mostra a lista inicial (recentes).
+    const [patientResults, setPatientResults] = useState<Paciente[]>([]);
+    const [searchingPatients, setSearchingPatients] = useState(false);
+
+    useEffect(() => {
+        const term = patientSearchTerm.trim();
+        if (!term) { setPatientResults(pacientes.slice(0, 30)); setSearchingPatients(false); return; }
+        let active = true;
+        setSearchingPatients(true);
+        const t = setTimeout(async () => {
+            try {
+                const r: any = await HybridBackend.getPacientes(term);
+                const list: Paciente[] = Array.isArray(r) ? r : (r?.data ?? []);
+                if (active) setPatientResults(list);
+            } finally {
+                if (active) setSearchingPatients(false);
+            }
+        }, 300);
+        return () => { active = false; clearTimeout(t); };
+    }, [patientSearchTerm, pacientes]);
 
     useEffect(() => {
         const { pendingSearch } = store;
@@ -250,6 +302,31 @@ export const LancarGTO: React.FC = () => {
         setArcoObs('');
     };
 
+    // Adiciona um item de prótese (catálogo do protético) ao rascunho do GTO.
+    const handleAddProtese = () => {
+        if (!selectedLab) { toast.error("SELECIONE O LABORATÓRIO."); return; }
+        if (!selectedProduto) { toast.error("SELECIONE O PRODUTO DE PRÓTESE."); return; }
+        if (store.items.length >= 20) { toast.error("LIMITE DE 20 ITENS ATINGIDO."); return; }
+        const valor = parseFloat(protValor) || Number(selectedProduto.preco) || 0;
+        store.addItem({
+            id: Math.random().toString(36).substring(7),
+            procedimentoId: '',
+            codigoTUSS: '',
+            codigoInterno: '',
+            descricao: selectedProduto.nome,
+            quantidade: 1,
+            valorUnitario: valor,
+            valorTotal: valor,
+            observacao: protObs || undefined,
+            produtoId: selectedProduto.id,
+            proteticoId: selectedLab,
+        });
+        toast.success("PRÓTESE ADICIONADA AO RASCUNHO.");
+        setSelectedProdutoId('');
+        setProtValor('');
+        setProtObs('');
+    };
+
     const handleFinalize = async () => {
         if (!store.paciente || !store.dentista || store.items.length === 0) {
             toast.error("PACIENTE, DENTISTA E PELO MENOS 1 ITEM SÃO OBRIGATÓRIOS.");
@@ -276,9 +353,12 @@ export const LancarGTO: React.FC = () => {
                 credenciadaId: store.credenciada,
             });
             for (const it of store.items) {
-                const { arco, id: _localId, ...rest } = it as any;
+                const { arco, id: _localId, produtoId, proteticoId, ...rest } = it as any;
                 void arco; void _localId;
-                await HybridBackend.addGtoItem(id, rest);
+                const payload: any = { ...rest };
+                // Prótese: envia produto/protético (snake_case) → o backend abre a OS na finalização.
+                if (produtoId) { payload.produto_id = produtoId; payload.protetico_id = proteticoId; }
+                await HybridBackend.addGtoItem(id, payload);
             }
             const fin = await HybridBackend.finalizarGto(id);
             toast.success(fin?.financeiro_id
@@ -390,6 +470,9 @@ export const LancarGTO: React.FC = () => {
                         setSelectedProc(null);
                         setSelectedDentes([]);
                         setSelectedArco(null);
+                        setSelectedProdutoId('');
+                        setProtValor('');
+                        setProtObs('');
                     }}
                     className="w-full p-4 bg-gray-50 border-2 border-gray-100 rounded-2xl font-black text-gray-700 text-sm focus:border-teal-400 outline-none transition-all uppercase"
                 >
@@ -397,8 +480,82 @@ export const LancarGTO: React.FC = () => {
                     {especialidades.map(es => <option key={es.id} value={es.id}>{es.nome}</option>)}
                 </select>
 
-                {selectedEsp && (
+                {selectedEsp && isProtese && (
+                    <div className="space-y-3">
+                        <select
+                            value={selectedLab}
+                            onChange={(e) => { setSelectedLab(e.target.value); setSelectedProdutoId(''); setProtValor(''); }}
+                            className="w-full p-4 bg-gray-50 border-2 border-gray-100 rounded-2xl font-black text-gray-700 text-sm focus:border-teal-400 outline-none transition-all uppercase"
+                        >
+                            <option value="">ESCOLHA O LABORATÓRIO / PROTÉTICO...</option>
+                            {laboratorios.map(l => <option key={l.id} value={l.id}>{l.nome}{l.interno ? ' (INTERNO)' : ''}{l.nota != null ? ` · ★ ${l.nota}` : ''}</option>)}
+                        </select>
+
+                        {selectedLab && (labProdutos.length === 0 ? (
+                            <div className="bg-amber-50 border-2 border-amber-100 rounded-2xl p-4 text-center">
+                                <p className="text-[11px] font-black text-amber-700 uppercase tracking-wide">Este laboratório não tem produtos ativos</p>
+                            </div>
+                        ) : (
+                            <>
+                                <select
+                                    value={selectedProdutoId}
+                                    onChange={(e) => {
+                                        setSelectedProdutoId(e.target.value);
+                                        const pr = labProdutos.find(p => p.id === e.target.value);
+                                        setProtValor(pr ? String(pr.preco ?? '') : '');
+                                    }}
+                                    className="w-full p-4 bg-white border-2 border-teal-100 rounded-2xl font-black text-gray-800 text-sm shadow-inner uppercase"
+                                >
+                                    <option value="">ESCOLHA A PRÓTESE...</option>
+                                    {labProdutos.map(p => <option key={p.id} value={p.id}>{p.nome} — R$ {Number(p.preco || 0).toFixed(2)}</option>)}
+                                </select>
+
+                                {selectedProduto && (
+                                    <>
+                                        <div>
+                                            <label className="block text-[10px] font-black text-gray-400 uppercase tracking-widest mb-1.5">Valor (R$)</label>
+                                            <input
+                                                type="number"
+                                                step="0.01"
+                                                value={protValor}
+                                                onChange={e => setProtValor(e.target.value)}
+                                                className="w-full p-4 bg-gray-50 border-2 border-gray-100 rounded-2xl font-black text-gray-800 text-sm focus:border-teal-400 outline-none transition-all"
+                                                placeholder="0,00"
+                                            />
+                                        </div>
+                                        <textarea
+                                            value={protObs}
+                                            onChange={e => setProtObs(e.target.value)}
+                                            rows={2}
+                                            placeholder="OBSERVAÇÃO PARA O PROTÉTICO (cor, material, dentes...)"
+                                            className="w-full p-4 bg-gray-50 border-2 border-gray-100 rounded-2xl text-[11px] focus:border-amber-400 outline-none transition-all resize-none"
+                                        />
+                                        <div className="bg-teal-50 p-3 rounded-xl border border-teal-100">
+                                            <div className="flex items-center gap-1.5 text-[10px] font-bold text-teal-800">
+                                                <ChevronRight size={10} /> AO FINALIZAR A GTO, UMA OS DE PRÓTESE SERÁ ABERTA NA BANCADA DO LABORATÓRIO.
+                                            </div>
+                                        </div>
+                                        <button
+                                            onClick={handleAddProtese}
+                                            className="w-full bg-[#2d6a4f] text-white py-4 rounded-2xl font-black text-sm uppercase shadow-lg shadow-green-100 hover:bg-[#1b4332] active:scale-95 transition-all flex items-center justify-center gap-2 group"
+                                        >
+                                            ADICIONAR PRÓTESE <ChevronRight size={16} className="group-hover:translate-x-1 transition-transform" />
+                                        </button>
+                                    </>
+                                )}
+                            </>
+                        ))}
+                    </div>
+                )}
+
+                {selectedEsp && !isProtese && (
                     <div className="space-y-2">
+                        {filteredProcedimentos.length === 0 ? (
+                            <div className="bg-amber-50 border-2 border-amber-100 rounded-2xl p-4 text-center">
+                                <p className="text-[11px] font-black text-amber-700 uppercase tracking-wide">Nenhum procedimento cadastrado nesta especialidade</p>
+                                <p className="text-[10px] font-bold text-amber-500 uppercase mt-1">Cadastre em Procedimentos para usá-lo aqui</p>
+                            </div>
+                        ) : (
                             <select
                                 value={selectedProc?.id || ''}
                                 onChange={(e) => {
@@ -414,6 +571,7 @@ export const LancarGTO: React.FC = () => {
                                 <option value="">BUSCAR PROCEDIMENTO</option>
                                 {filteredProcedimentos.map(p => <option key={p.id} value={p.id}>{p.nome}</option>)}
                             </select>
+                        )}
 
                         {selectedProc && (
                             <div className="bg-teal-50 p-3 rounded-xl border border-teal-100">
@@ -854,12 +1012,12 @@ export const LancarGTO: React.FC = () => {
                                 className="w-full p-4 bg-gray-50 border-2 border-gray-100 rounded-2xl font-black text-gray-800 text-sm focus:border-teal-500 outline-none transition-all uppercase"
                             />
                             <div className="max-h-72 overflow-y-auto space-y-1">
-                                {filteredPatients.length === 0 ? (
+                                {patientResults.length === 0 ? (
                                     <div className="py-10 text-center text-gray-300 font-bold uppercase text-xs">
-                                        {patientSearchTerm ? 'NENHUM PACIENTE ENCONTRADO' : 'CARREGANDO...'}
+                                        {searchingPatients ? 'BUSCANDO...' : (patientSearchTerm ? 'NENHUM PACIENTE ENCONTRADO' : 'CARREGANDO...')}
                                     </div>
                                 ) : (
-                                    filteredPatients.map(p => (
+                                    patientResults.map(p => (
                                         <button
                                             key={p.id}
                                             onClick={() => {

frontend/views/OnboardingChat.tsx

@@ -1,6 +1,6 @@
 import React, { useState, useEffect, useRef } from 'react';
 import {
-  Building2, Briefcase, Stethoscope, Sparkles, DoorOpen,
+  Building2, Briefcase, Stethoscope, Sparkles, DoorOpen, FlaskConical,
   ArrowRight, ArrowLeft, ChevronLeft, Loader2, Send, Check, CheckCircle2, User as UserIcon
 } from 'lucide-react';
 
@@ -17,6 +17,7 @@ const SLIDES: { icon: any; accent: string; title: string; desc: string; cta: str
   { icon: Briefcase,   accent: '#0d9488', title: 'Consultórios', desc: 'Para quem voa solo: agenda inteligente e cobrança sem complicação.',          cta: 'Cadastrar meu consultório',   pre: { perfil: 'consultorio' } },
   { icon: Stethoscope, accent: '#7c3aed', title: 'Dentistas',    desc: 'Sua agenda única — sem overbooking, mesmo atendendo em vários lugares.',      cta: 'Sou dentista',                pre: { perfil: 'profissional', profissao: 'dentista' } },
   { icon: Sparkles,    accent: '#db2777', title: 'Biomédicos',   desc: 'Harmonização orofacial e estética com prontuário e fotos por procedimento.', cta: 'Sou biomédico(a)',            pre: { perfil: 'profissional', profissao: 'biomedico' } },
+  { icon: FlaskConical, accent: '#2d6a4f', title: 'Protéticos',  desc: 'Laboratório completo: bancada, ordens, etapas, componentes, financeiro e score.', cta: 'Sou protético(a)',          pre: { perfil: 'profissional', profissao: 'protetico' } },
   { icon: DoorOpen,    accent: '#0d9488', title: 'Salas',        desc: 'Alugue ou anuncie salas por hora, dia ou mês. Valor fixo ou negociado.',     cta: 'Tenho salas para alugar',     pre: { perfil: 'sala' } },
 ];
 

frontend/views/ProtesePublicView.tsx

@@ -0,0 +1,224 @@
+import React, { useState, useEffect, useCallback } from 'react';
+import { FlaskConical, Building2, Clock, ShieldCheck, AlertTriangle, CheckCircle2, Circle, Package, History, Camera, MapPin, ChevronRight, Loader2, ImagePlus, Zap } from 'lucide-react';
+import { HybridBackend } from '../services/backend.ts';
+import { useToast } from '../contexts/ToastContext.tsx';
+
+const fmtBRL = (v: number) => 'R$ ' + Number(v || 0).toLocaleString('pt-BR', { minimumFractionDigits: 2 });
+const dataBR = (d: string) => (d || '').slice(0, 10).split('-').reverse().join('/');
+const dataHoraBR = (d: string) => { if (!d) return ''; const x = new Date(d); return isNaN(x.getTime()) ? dataBR(d) : x.toLocaleString('pt-BR', { day: '2-digit', month: '2-digit', year: '2-digit', hour: '2-digit', minute: '2-digit' }); };
+
+const STATUS_LABEL: Record<string, string> = { solicitado: 'Solicitado', recebido: 'Recebido', producao: 'Em produção', prova: 'Prova', ajuste: 'Ajuste', finalizado: 'Finalizado', entregue: 'Entregue', cancelado: 'Cancelado' };
+const STATUS_COR: Record<string, string> = { solicitado: 'bg-gray-100 text-gray-600', recebido: 'bg-blue-100 text-blue-700', producao: 'bg-amber-100 text-amber-700', prova: 'bg-indigo-100 text-indigo-700', ajuste: 'bg-orange-100 text-orange-700', finalizado: 'bg-teal-100 text-teal-700', entregue: 'bg-green-100 text-green-700', cancelado: 'bg-red-100 text-red-600' };
+const FLUXO = ['solicitado', 'recebido', 'producao', 'prova', 'ajuste', 'finalizado', 'entregue'];
+const OCOR_CATS: Record<string, string> = { nao_devolvido: 'Componente não devolvido', danificado: 'Componente danificado', incompativel: 'Componente incompatível', parafuso_substituido: 'Parafuso substituído', parafuso_desgastado: 'Parafuso desgastado', peca_incorreta: 'Peça incorreta', ajuste_inadequado: 'Ajuste inadequado', falha_fabricacao: 'Falha de fabricação', retrabalho: 'Retrabalho', outro: 'Outro' };
+
+const Secao: React.FC<{ titulo: string; Icon: any; children: React.ReactNode }> = ({ titulo, Icon, children }) => (
+  <div className="bg-white rounded-2xl border border-gray-100 shadow-sm p-4">
+    <p className="text-[10px] font-black text-gray-400 uppercase tracking-widest mb-3 flex items-center gap-1.5"><Icon size={12} /> {titulo}</p>
+    {children}
+  </div>
+);
+
+const PROD_FLUXO = ['recebido', 'producao', 'prova', 'ajuste', 'finalizado'];
+
+export const ProtesePublicView: React.FC<{ token: string }> = ({ token }) => {
+  const toast = useToast();
+  const [os, setOs] = useState<any>(null);
+  const [erro, setErro] = useState('');
+  const [loading, setLoading] = useState(true);
+  const [busy, setBusy] = useState(false);
+
+  const recarregar = useCallback(() => HybridBackend.getProtesePublic(token).then(setOs).catch(e => setErro(e.message || 'Link inválido.')), [token]);
+  useEffect(() => { recarregar().finally(() => setLoading(false)); }, [recarregar]);
+
+  const act = async (fn: () => Promise<any>, ok: string) => {
+    setBusy(true);
+    try { await fn(); toast.success(ok); await recarregar(); }
+    catch (e: any) { toast.error((e.message || 'ERRO').toUpperCase()); } finally { setBusy(false); }
+  };
+  const receber = () => act(() => HybridBackend.custodiaPublic(token, 'laboratorio'), 'RECEBIMENTO CONFIRMADO.');
+  const devolver = () => act(() => HybridBackend.custodiaPublic(token, 'clinica'), 'DEVOLUÇÃO REGISTRADA.');
+  const avancar = (s: string) => act(() => HybridBackend.statusPublic(token, s), 'ETAPA ATUALIZADA.');
+  const anexar = (e: React.ChangeEvent<HTMLInputElement>) => {
+    const f = e.target.files?.[0]; if (!f) return;
+    act(() => HybridBackend.uploadFotoPublic(token, f), 'FOTO ANEXADA.'); e.target.value = '';
+  };
+
+  if (loading) return <div className="min-h-screen flex items-center justify-center bg-gray-50"><Loader2 className="animate-spin text-teal-600" size={32} /></div>;
+  if (erro || !os) return (
+    <div className="min-h-screen flex flex-col items-center justify-center bg-gray-50 p-6 text-center">
+      <AlertTriangle size={40} className="text-amber-400" />
+      <p className="mt-3 font-black text-gray-700 uppercase text-sm">{erro || 'Link inválido'}</p>
+      <p className="text-xs text-gray-400 mt-1">Peça um novo link à clínica.</p>
+    </div>
+  );
+
+  const noLab = (os.local_atual || 'clinica') === 'laboratorio';
+  const idxAtual = FLUXO.indexOf(os.status);
+  const cancelado = os.status === 'cancelado';
+
+  return (
+    <div className="min-h-screen bg-gray-50">
+      {/* Topo / marca */}
+      <header className="bg-[#2d6a4f] text-white px-4 py-3 flex items-center gap-2 sticky top-0 z-10">
+        <FlaskConical size={18} />
+        <div className="min-w-0 flex-1">
+          <p className="font-black text-sm leading-tight">ScoreOdonto</p>
+          <p className="text-[10px] text-white/70 uppercase tracking-wide leading-tight">Acompanhamento de prótese</p>
+        </div>
+        <span className="text-[9px] font-black px-2 py-0.5 rounded-full bg-white/15 uppercase">{os.finalizada ? 'Somente leitura' : 'Acompanhamento'}</span>
+      </header>
+
+      <main className="max-w-lg mx-auto p-3 space-y-3">
+        {/* Cabeçalho da OS */}
+        <div className="bg-white rounded-2xl border border-gray-100 shadow-sm p-4">
+          <div className="flex items-start justify-between gap-2">
+            <div className="min-w-0">
+              <h1 className="font-black text-gray-800 text-base leading-tight">{os.tipo}</h1>
+              <p className="text-xs text-gray-400 mt-0.5">OS {os.id}</p>
+            </div>
+            <span className={`text-[9px] font-black px-2 py-1 rounded-full uppercase shrink-0 ${STATUS_COR[os.status] || 'bg-gray-100 text-gray-600'}`}>{STATUS_LABEL[os.status] || os.status}</span>
+          </div>
+          <div className="mt-3 flex flex-wrap items-center gap-2">
+            {os.clinica_nome && <span className="text-[10px] font-black text-blue-700 bg-blue-50 px-2 py-1 rounded-lg uppercase flex items-center gap-1"><Building2 size={11} /> {os.clinica_nome}</span>}
+            <span className={`text-[10px] font-black px-2 py-1 rounded-lg uppercase flex items-center gap-1 ${noLab ? 'bg-violet-50 text-violet-700' : 'bg-blue-50 text-blue-700'}`}><MapPin size={11} /> {noLab ? 'Com o laboratório' : 'Na clínica'}</span>
+            {os.tipo_os === 'garantia' && <span className="text-[10px] font-black text-emerald-700 bg-emerald-50 px-2 py-1 rounded-lg uppercase flex items-center gap-1"><ShieldCheck size={11} /> Garantia</span>}
+          </div>
+        </div>
+
+        {/* Ações do protético (sem conta) */}
+        {!os.finalizada && (
+          <Secao titulo="Atualizar status" Icon={Zap}>
+            <div className="space-y-2">
+              {noLab
+                ? <button disabled={busy} onClick={devolver} className="w-full py-2.5 rounded-xl bg-blue-600 text-white font-black text-xs uppercase disabled:opacity-50">Devolvi à clínica</button>
+                : <button disabled={busy} onClick={receber} className="w-full py-2.5 rounded-xl bg-[#2d6a4f] text-white font-black text-xs uppercase disabled:opacity-50">Recebi o trabalho</button>}
+              <div>
+                <p className="text-[9px] font-black text-gray-400 uppercase mb-1">Etapa de produção</p>
+                <div className="flex flex-wrap gap-1.5">
+                  {PROD_FLUXO.map(s => (
+                    <button key={s} disabled={busy || os.status === s} onClick={() => avancar(s)}
+                      className={`px-2.5 py-1.5 rounded-lg text-[10px] font-black uppercase disabled:opacity-40 ${os.status === s ? 'bg-[#2d6a4f] text-white' : 'border border-gray-200 text-gray-500'}`}>{STATUS_LABEL[s]}</button>
+                  ))}
+                </div>
+              </div>
+              <label className={`w-full flex items-center justify-center gap-2 py-2.5 rounded-xl border border-dashed border-gray-200 text-gray-500 text-xs font-bold uppercase cursor-pointer ${busy ? 'opacity-50 pointer-events-none' : ''}`}>
+                <ImagePlus size={15} /> Anexar foto do trabalho
+                <input type="file" accept="image/*" className="hidden" onChange={anexar} />
+              </label>
+            </div>
+          </Secao>
+        )}
+
+        {/* Etapas */}
+        <Secao titulo="Etapas" Icon={Clock}>
+          {cancelado ? (
+            <div className="bg-red-50 rounded-xl px-3 py-2 text-xs font-black text-red-600 uppercase">OS cancelada</div>
+          ) : (
+            <div className="flex items-start overflow-x-auto pb-1 -mx-1 px-1">
+              {FLUXO.map((s, i) => {
+                const done = i < idxAtual, atual = i === idxAtual;
+                const ev = (os.eventos || []).find((e: any) => e.status === s);
+                return (
+                  <React.Fragment key={s}>
+                    <div className="flex flex-col items-center min-w-[52px]">
+                      {done ? <CheckCircle2 size={18} className="text-teal-600" /> : atual ? <div className="w-4 h-4 rounded-full bg-[#2d6a4f] ring-4 ring-green-100" /> : <Circle size={18} className="text-gray-200" />}
+                      <span className={`text-[7px] font-black uppercase mt-1 text-center leading-tight ${atual ? 'text-[#2d6a4f]' : done ? 'text-teal-700' : 'text-gray-300'}`}>{STATUS_LABEL[s]}</span>
+                      <span className="text-[7px] text-gray-300">{ev ? dataBR(ev.created_at) : ''}</span>
+                    </div>
+                    {i < FLUXO.length - 1 && <div className={`flex-1 h-0.5 mt-2 min-w-[8px] ${i < idxAtual ? 'bg-teal-400' : 'bg-gray-100'}`} />}
+                  </React.Fragment>
+                );
+              })}
+            </div>
+          )}
+        </Secao>
+
+        {/* Dados */}
+        <Secao titulo="Dados do trabalho" Icon={FlaskConical}>
+          <div className="grid grid-cols-2 gap-x-3 gap-y-2 text-xs">
+            {os.paciente_nome && <div className="col-span-2"><span className="text-gray-400 font-bold uppercase text-[9px] block">Paciente</span>{os.paciente_nome}</div>}
+            {os.dentista_nome && <div><span className="text-gray-400 font-bold uppercase text-[9px] block">Dentista</span>{os.dentista_nome}</div>}
+            {os.dentes && <div><span className="text-gray-400 font-bold uppercase text-[9px] block">Dentes</span>{os.dentes}</div>}
+            {os.material && <div><span className="text-gray-400 font-bold uppercase text-[9px] block">Material</span>{os.material}</div>}
+            {os.cor && <div><span className="text-gray-400 font-bold uppercase text-[9px] block">Cor</span>{os.cor}</div>}
+            {os.prazo_entrega && <div><span className="text-gray-400 font-bold uppercase text-[9px] block">Prazo</span>{dataBR(os.prazo_entrega)}</div>}
+            {Number(os.custo) > 0 && <div><span className="text-gray-400 font-bold uppercase text-[9px] block">Valor do lab</span>{fmtBRL(os.custo)}</div>}
+          </div>
+          {os.observacoes && <p className="text-xs text-gray-600 bg-gray-50 rounded-xl p-3 mt-3">{os.observacoes}</p>}
+          {os.garantia_ate && <div className="bg-emerald-50 rounded-xl px-3 py-2 mt-3 flex items-center gap-2 text-xs text-emerald-700 font-bold"><ShieldCheck size={14} /> Garantia até {dataBR(os.garantia_ate)}</div>}
+        </Secao>
+
+        {/* Componentes */}
+        {(os.componentes || []).length > 0 && (
+          <Secao titulo="Componentes" Icon={Package}>
+            <div className="space-y-1.5">
+              {os.componentes.map((c: any) => (
+                <div key={c.id} className="flex items-center gap-2 text-xs bg-gray-50 rounded-lg px-3 py-2">
+                  <span className={`text-[8px] font-black px-1.5 py-0.5 rounded uppercase ${c.direcao === 'devolvido' ? 'bg-blue-100 text-blue-700' : 'bg-teal-100 text-teal-700'}`}>{c.direcao === 'devolvido' ? 'Devolvido' : 'Enviado'}</span>
+                  <span className="font-black text-gray-700">{c.quantidade}×</span>
+                  <span className="font-bold text-gray-700 flex-1 truncate">{c.nome}</span>
+                </div>
+              ))}
+            </div>
+          </Secao>
+        )}
+
+        {/* Fotos */}
+        {(os.fotos || []).length > 0 && (
+          <Secao titulo="Fotos do trabalho" Icon={Camera}>
+            <div className="grid grid-cols-2 gap-2">
+              {os.fotos.map((f: any) => (
+                <a key={f.id} href={f.url} target="_blank" rel="noreferrer" className="block rounded-lg overflow-hidden border border-gray-100">
+                  <img src={f.url} alt="" className="w-full h-24 object-cover" />
+                  {f.legenda && <p className="text-[10px] font-bold text-gray-600 truncate px-2 py-1">{f.legenda}</p>}
+                </a>
+              ))}
+            </div>
+          </Secao>
+        )}
+
+        {/* Ocorrências */}
+        {(os.ocorrencias || []).length > 0 && (
+          <Secao titulo="Ocorrências" Icon={AlertTriangle}>
+            <div className="space-y-2">
+              {os.ocorrencias.map((o: any) => (
+                <div key={o.id} className="border border-gray-100 rounded-xl p-2.5 text-xs">
+                  <div className="flex items-center gap-2">
+                    <span className="text-[8px] font-black px-1.5 py-0.5 rounded uppercase bg-gray-100 text-gray-600">{(o.status || '').replace('_', ' ')}</span>
+                    <span className="font-black text-gray-700 flex-1">{OCOR_CATS[o.categoria] || o.categoria}</span>
+                  </div>
+                  <p className="text-gray-600 mt-1">{o.descricao}</p>
+                  {o.resposta && <p className="text-gray-500 mt-1"><b className="uppercase text-[9px]">Resposta:</b> {o.resposta}</p>}
+                </div>
+              ))}
+            </div>
+          </Secao>
+        )}
+
+        {/* Histórico */}
+        <Secao titulo="Histórico" Icon={History}>
+          <div className="space-y-2">
+            {(os.eventos || []).map((ev: any, i: number) => (
+              <div key={i} className="flex items-start gap-2 text-xs">
+                <span className={`w-2 h-2 rounded-full mt-1 shrink-0 ${ev.status === 'cancelado' ? 'bg-red-400' : ev.status === 'entregue' ? 'bg-green-500' : 'bg-[#2d6a4f]'}`} />
+                <div className="min-w-0">
+                  <span className="font-bold text-gray-700">{ev.observacao || STATUS_LABEL[ev.status] || ev.status}</span>
+                  <span className="text-gray-400 block text-[10px]">{dataHoraBR(ev.created_at)}{ev.actor_nome ? ` · ${ev.actor_nome}` : ''}</span>
+                </div>
+              </div>
+            ))}
+          </div>
+        </Secao>
+
+        {/* CTA de conversão */}
+        <a href="/" className="block bg-[#2d6a4f] text-white rounded-2xl p-4 text-center active:scale-[0.99] transition-transform">
+          <p className="font-black text-sm uppercase">Gostou de acompanhar por aqui?</p>
+          <p className="text-[11px] text-white/80 mt-1">Crie sua conta grátis e gerencie seu laboratório: bancada, etapas, financeiro e score.</p>
+          <span className="inline-flex items-center gap-1 mt-2 bg-white text-[#2d6a4f] font-black text-xs uppercase px-4 py-2 rounded-xl">Criar conta grátis <ChevronRight size={14} /></span>
+        </a>
+        <p className="text-center text-[10px] text-gray-300 uppercase font-bold pb-4">ScoreOdonto · Provedor de Prótese</p>
+      </main>
+    </div>
+  );
+};

frontend/views/ProteseView.tsx

@@ -1,5 +1,5 @@
 import React, { useState, useEffect, useCallback } from 'react';
-import { FlaskConical, Plus, X, Search, Clock, AlertTriangle, ImagePlus, ChevronRight, Trash2, RefreshCw, ShieldCheck, Tags, Pencil, Check } from 'lucide-react';
+import { FlaskConical, Plus, X, Search, Clock, AlertTriangle, ImagePlus, ChevronRight, Trash2, RefreshCw, ShieldCheck, Tags, Pencil, Check, Package, Wallet, Camera, CheckCircle2, Circle, History, Printer, MapPin, Building2, Share2, FileText, Star } from 'lucide-react';
 import { HybridBackend } from '../services/backend.ts';
 import { useToast } from '../contexts/ToastContext.tsx';
 import { useConfirm } from '../contexts/ConfirmContext.tsx';
@@ -7,6 +7,11 @@ import { PageHeader } from '../components/PageHeader.tsx';
 
 const fmtBRL = (v: number) => 'R$ ' + Number(v || 0).toLocaleString('pt-BR', { minimumFractionDigits: 2 });
 const dataBR = (d: string) => (d || '').slice(0, 10).split('-').reverse().join('/');
+const dataHoraBR = (d: string) => {
+    if (!d) return '';
+    const dt = new Date(d);
+    return isNaN(dt.getTime()) ? dataBR(d) : dt.toLocaleString('pt-BR', { day: '2-digit', month: '2-digit', year: 'numeric', hour: '2-digit', minute: '2-digit' });
+};
 
 const STATUS_LABEL: Record<string, string> = {
     solicitado: 'Solicitado', recebido: 'Recebido', producao: 'Em produção',
@@ -17,7 +22,6 @@ const STATUS_COR: Record<string, string> = {
     prova: 'bg-indigo-100 text-indigo-700', ajuste: 'bg-orange-100 text-orange-700', finalizado: 'bg-teal-100 text-teal-700',
     entregue: 'bg-green-100 text-green-700', cancelado: 'bg-red-100 text-red-600',
 };
-const LAB_FLUXO = ['recebido', 'producao', 'prova', 'ajuste', 'finalizado'];
 
 const Badge: React.FC<{ s: string }> = ({ s }) => (
     <span className={`text-[9px] font-black px-2 py-0.5 rounded-full uppercase ${STATUS_COR[s] || 'bg-gray-100 text-gray-600'}`}>{STATUS_LABEL[s] || s}</span>
@@ -117,7 +121,7 @@ const NovaOSModal: React.FC<{ onClose: () => void; onSaved: () => void }> = ({ o
                         <label className="text-[10px] font-black text-gray-500 uppercase">Laboratório / Protético *</label>
                         <select value={form.protetico_id} onChange={e => set('protetico_id', e.target.value)} className="w-full mt-1 px-3 py-2 rounded-xl border border-gray-200 text-sm">
                             <option value="">Selecione...</option>
-                            {labs.map(l => <option key={l.id} value={l.id}>{l.nome}{l.interno ? ' (interno)' : ''}</option>)}
+                            {labs.map(l => <option key={l.id} value={l.id}>{l.nome}{l.interno ? ' (interno)' : ''}{l.nota != null ? ` · ★ ${l.nota}` : ''}</option>)}
                         </select>
                         {labs.length === 0 && <p className="text-[10px] text-gray-400 mt-1">Nenhum protético com vínculo ou no diretório. Convide um na Equipe ou no marketplace de Profissionais.</p>}
                     </div>
@@ -176,6 +180,7 @@ const OSDetailModal: React.FC<{ id: string; modo: 'bancada' | 'clinica'; onClose
     const confirm = useConfirm();
     const [os, setOs] = useState<any>(null);
     const [busy, setBusy] = useState(false);
+    const [tab, setTab] = useState<'etapas' | 'timeline' | 'itens' | 'monitor' | 'ocorrencias'>('etapas');
 
     const carregar = useCallback(() => {
         HybridBackend.getProteseOSDetalhe(id).then(setOs).catch(() => toast.error('ERRO AO CARREGAR.'));
@@ -190,14 +195,6 @@ const OSDetailModal: React.FC<{ id: string; modo: 'bancada' | 'clinica'; onClose
         finally { setBusy(false); }
     };
 
-    const anexar = async (e: React.ChangeEvent<HTMLInputElement>) => {
-        const file = e.target.files?.[0]; if (!file) return;
-        setBusy(true);
-        try { await HybridBackend.uploadProteseFoto(id, file); toast.success('FOTO ANEXADA.'); carregar(); }
-        catch (err: any) { toast.error((err.message || 'ERRO').toUpperCase()); }
-        finally { setBusy(false); }
-    };
-
     const acionarGarantia = async () => {
         if (!(await confirm('ABRIR UMA OS DE GARANTIA (SEM CUSTO) PARA REFAZER ESTE TRABALHO?'))) return;
         setBusy(true);
@@ -216,100 +213,628 @@ const OSDetailModal: React.FC<{ id: string; modo: 'bancada' | 'clinica'; onClose
         finally { setBusy(false); }
     };
 
+    const moverCustodia = async (para: 'clinica' | 'laboratorio') => {
+        setBusy(true);
+        try { await HybridBackend.moverProteseCustodia(id, para); toast.success(para === 'laboratorio' ? 'TRABALHO COM O LABORATÓRIO.' : 'TRABALHO NA CLÍNICA.'); carregar(); onChanged(); }
+        catch (e: any) { toast.error((e.message || 'ERRO').toUpperCase()); }
+        finally { setBusy(false); }
+    };
+
     if (!os) return null;
     const finalizado = os.status === 'entregue' || os.status === 'cancelado';
     const naGarantia = os.status === 'entregue' && os.garantia_ate && os.garantia_ate >= new Date().toISOString().slice(0, 10);
+    const noLab = (os.local_atual || 'clinica') === 'laboratorio';
+
+    // Recibo imprimível de uma etapa (comprovante que circula com o trabalho).
+    // formato 'termica' (bobina 80mm) | 'laser' (folha A4). Dados preenchidos da OS.
+    const imprimirCupom = (etapa: string, formato: 'termica' | 'laser') => {
+        const comps = (os.componentes || []).map((c: any) => `${c.quantidade}× ${c.nome}`).join(', ') || '—';
+        const termica = formato === 'termica';
+        const page = termica ? '@page{size:80mm auto;margin:3mm}body{width:72mm;font-size:11px}'
+            : '@page{size:A4;margin:16mm}body{max-width:520px;font-size:12px}';
+        const sign = termica
+            ? '.sign{margin-top:24px}.sign div{border-top:1px solid #111;padding-top:4px;text-align:center;font-size:9px;text-transform:uppercase;color:#555;margin-top:18px}'
+            : '.sign{margin-top:34px;display:flex;justify-content:space-between;gap:16px}.sign div{flex:1;border-top:1px solid #111;padding-top:4px;text-align:center;font-size:9px;text-transform:uppercase;color:#555}';
+        const w = window.open('', '_blank', termica ? 'width=320,height=640' : 'width=560,height=720'); if (!w) return;
+        w.document.write(`<html><head><title>Recibo ${STATUS_LABEL[etapa] || etapa}</title><style>
+          *{font-family:Arial,Helvetica,sans-serif;color:#111;box-sizing:border-box}body{margin:0;padding:10px}
+          h1{font-size:${termica ? 13 : 16}px;margin:0 0 2px}.muted{color:#555;font-size:${termica ? 9 : 10}px}
+          .et{background:#111;color:#fff;padding:6px 8px;border-radius:5px;font-weight:bold;text-align:center;text-transform:uppercase;margin:10px 0;font-size:${termica ? 11 : 13}px}
+          table{width:100%;border-collapse:collapse;margin-top:6px}td{padding:3px 0;vertical-align:top}
+          .lbl{color:#555;text-transform:uppercase;font-size:9px;width:40%}
+          .hr{border-top:1px dashed #999;margin:9px 0}${sign}${page}</style></head><body>
+          <h1>ORDEM DE PRÓTESE</h1><div class="muted">OS ${os.id}<br>${new Date().toLocaleString('pt-BR')}</div>
+          <div class="et">Etapa: ${STATUS_LABEL[etapa] || etapa}</div>
+          <table>
+            <tr><td class="lbl">Paciente</td><td><b>${os.paciente_nome || '—'}</b></td></tr>
+            <tr><td class="lbl">Trabalho</td><td>${os.tipo || '—'}</td></tr>
+            <tr><td class="lbl">Dentista</td><td>${os.dentista_nome || '—'}</td></tr>
+            <tr><td class="lbl">Laboratório</td><td>${os.protetico_nome || '—'}</td></tr>
+            <tr><td class="lbl">Dentes</td><td>${os.dentes || '—'}</td></tr>
+            <tr><td class="lbl">Material / Cor</td><td>${os.material || '—'} / ${os.cor || '—'}</td></tr>
+            <tr><td class="lbl">Componentes</td><td>${comps}</td></tr>
+            <tr><td class="lbl">Prazo</td><td>${os.prazo_entrega ? dataBR(os.prazo_entrega) : '—'}</td></tr>
+            <tr><td class="lbl">Local atual</td><td>${noLab ? 'Laboratório' : 'Clínica'}</td></tr>
+          </table><div class="hr"></div>
+          ${os.observacoes ? `<div class="muted">Obs.: ${os.observacoes}</div>` : ''}
+          <div class="sign"><div>Entregue por</div><div>Recebido por</div></div>
+        </body></html>`);
+        w.document.close(); w.focus(); setTimeout(() => w.print(), 250);
+    };
+
+    const idxAtual = FLUXO_OS.indexOf(os.status);
+
+    const TABS = [
+        { id: 'etapas', label: 'Etapas' },
+        { id: 'itens', label: 'Itens & Valores' },
+        { id: 'monitor', label: 'Monitoramento' },
+        { id: 'ocorrencias', label: `Ocorrências${os.ocorrencias?.length ? ` (${os.ocorrencias.length})` : ''}` },
+        { id: 'timeline', label: 'Linha do tempo' },
+    ] as const;
 
     return (
         <div className="fixed inset-0 bg-black/40 z-50 flex items-center justify-center p-4" onClick={onClose}>
-            <div className="bg-white rounded-2xl w-full max-w-lg max-h-[90vh] overflow-y-auto" onClick={e => e.stopPropagation()}>
-                <div className="flex items-center justify-between p-5 border-b border-gray-100 sticky top-0 bg-white">
-                    <div>
+            <div className="bg-white rounded-2xl w-full max-w-2xl h-[88vh] flex flex-col" onClick={e => e.stopPropagation()}>
+                {/* Header */}
+                <div className="flex items-center justify-between px-5 py-4 border-b border-gray-100">
+                    <div className="min-w-0">
                         <h3 className="font-black text-gray-800 uppercase text-sm flex items-center gap-2"><FlaskConical size={16} className="text-violet-600" /> {os.tipo}</h3>
-                        <p className="text-xs text-gray-400 mt-0.5">{os.paciente_nome || 'Sem paciente'} {os.dentes ? `· dentes ${os.dentes}` : ''}</p>
+                        <p className="text-xs text-gray-400 mt-0.5 truncate">{os.paciente_nome || 'Sem paciente'} {os.dentes ? `· dentes ${os.dentes}` : ''}</p>
                     </div>
+                    <div className="flex items-center gap-2 shrink-0">
+                        <Badge s={os.status} />
                         <button onClick={onClose}><X size={20} className="text-gray-400" /></button>
                     </div>
-                <div className="p-5 space-y-4">
+                </div>
+                {/* Abas */}
+                <div className="flex border-b border-gray-100 px-2 overflow-x-auto">
+                    {TABS.map(t => (
+                        <button key={t.id} onClick={() => setTab(t.id)}
+                            className={`px-3 py-2.5 text-xs font-black uppercase border-b-2 -mb-px whitespace-nowrap transition-colors ${tab === t.id ? 'border-violet-600 text-violet-700' : 'border-transparent text-gray-400 hover:text-gray-600'}`}>{t.label}</button>
+                    ))}
+                </div>
+
+                <div className="flex-1 overflow-y-auto p-5">
+                    {tab === 'etapas' && (
+                        <div className="space-y-5">
+                            {/* Clínica de origem — crítico no multi-clínica (de qual clínica veio a OS). */}
+                            {modo === 'bancada' && os.clinica_nome && (
+                                <div className="bg-blue-50 rounded-xl px-3 py-2 flex items-center gap-2 text-xs font-black text-blue-700 uppercase"><Building2 size={14} /> Clínica: {os.clinica_nome}</div>
+                            )}
                             <div className="flex items-center gap-2 flex-wrap">
-                        <Badge s={os.status} />
                                 {os.tipo_os === 'garantia' && <span className="text-[9px] font-black px-2 py-0.5 rounded-full bg-emerald-100 text-emerald-700 uppercase flex items-center gap-1"><ShieldCheck size={10} /> Garantia</span>}
                                 {os.atrasada && <span className="text-[9px] font-black px-2 py-0.5 rounded-full bg-red-100 text-red-600 uppercase flex items-center gap-1"><AlertTriangle size={10} /> Atrasada</span>}
-                        {os.prazo_entrega && <span className="text-[10px] text-gray-400 flex items-center gap-1"><Clock size={11} /> {dataBR(os.prazo_entrega)}</span>}
+                                {os.prazo_entrega && <span className="text-[10px] text-gray-400 flex items-center gap-1"><Clock size={11} /> Prazo {dataBR(os.prazo_entrega)}</span>}
+                                <span className={`text-[9px] font-black px-2 py-0.5 rounded-full uppercase ${noLab ? 'bg-violet-100 text-violet-700' : 'bg-blue-100 text-blue-700'}`}>{noLab ? 'Com o laboratório' : 'Na clínica'}</span>
                             </div>
-                    {os.garantia_ate && (
-                        <div className="bg-emerald-50 rounded-xl px-3 py-2 flex items-center gap-2 text-xs text-emerald-700 font-bold">
-                            <ShieldCheck size={14} /> Garantia até {dataBR(os.garantia_ate)} ({os.garantia_meses || 12} meses)
-                        </div>
-                    )}
-                    <div className="grid grid-cols-2 gap-x-4 gap-y-1.5 text-xs">
+                            <EtapasStepper os={os} />
+                            {os.garantia_ate && (<div className="bg-emerald-50 rounded-xl px-3 py-2 flex items-center gap-2 text-xs text-emerald-700 font-bold"><ShieldCheck size={14} /> Garantia até {dataBR(os.garantia_ate)} ({os.garantia_meses || 12} meses)</div>)}
+                            <div className="grid grid-cols-2 sm:grid-cols-3 gap-x-4 gap-y-1.5 text-xs">
                                 {os.material && <div><span className="text-gray-400 font-bold uppercase text-[9px] block">Material</span>{os.material}</div>}
                                 {os.cor && <div><span className="text-gray-400 font-bold uppercase text-[9px] block">Cor</span>{os.cor}</div>}
                                 {os.dentista_nome && <div><span className="text-gray-400 font-bold uppercase text-[9px] block">Dentista</span>{os.dentista_nome}</div>}
                                 {modo === 'bancada' && Number(os.custo) > 0 && <div><span className="text-gray-400 font-bold uppercase text-[9px] block">Custo lab</span>{fmtBRL(os.custo)}</div>}
-                        {modo === 'clinica' && Number(os.valor) > 0 && <div><span className="text-gray-400 font-bold uppercase text-[9px] block">Valor</span>{fmtBRL(os.valor)}</div>}
+                                {modo === 'clinica' && Number(os.valor) > 0 && <div><span className="text-gray-400 font-bold uppercase text-[9px] block">Valor cobrado</span>{fmtBRL(os.valor)}</div>}
                             </div>
                             {os.observacoes && <p className="text-xs text-gray-600 bg-gray-50 rounded-xl p-3">{os.observacoes}</p>}
-
-                    {/* Fotos */}
-                    {os.fotos?.length > 0 && (
-                        <div className="flex gap-2 flex-wrap">
-                            {os.fotos.map((f: any) => (
-                                <a key={f.id} href={f.url} target="_blank" rel="noreferrer"><img src={f.url} alt="" className="w-16 h-16 object-cover rounded-lg border border-gray-100" /></a>
-                            ))}
+                            {/* Etapas do trabalho: avançar + imprimir recibo (térmica/laser) por etapa */}
+                            <div>
+                                <p className="text-[10px] font-black text-gray-400 uppercase mb-2">Etapas do trabalho</p>
+                                <div className="space-y-1.5">
+                                    {FLUXO_OS.map((s, i) => {
+                                        const done = i < idxAtual, atual = i === idxAtual;
+                                        const ev = (os.eventos || []).find((e: any) => e.status === s);
+                                        // Etapas livres: pode ir para qualquer uma (pular/repetir/voltar), exceto 'entregue' (timeline).
+                                        const acaoLabel = atual ? 'Repetir' : done ? 'Voltar' : 'Ir';
+                                        return (
+                                            <div key={s} className="flex items-center gap-2 bg-gray-50 rounded-xl px-3 py-2">
+                                                {done ? <CheckCircle2 size={16} className="text-teal-600 shrink-0" /> : atual ? <div className="w-4 h-4 rounded-full bg-violet-600 shrink-0" /> : <Circle size={16} className="text-gray-300 shrink-0" />}
+                                                <span className={`text-xs font-black uppercase ${atual ? 'text-violet-700' : done ? 'text-gray-700' : 'text-gray-400'}`}>{STATUS_LABEL[s]}</span>
+                                                <span className="text-[10px] text-gray-400">{ev ? dataBR(ev.created_at) : ''}</span>
+                                                <div className="flex-1" />
+                                                {!finalizado && s !== 'entregue' && <button disabled={busy} onClick={() => mudar(s)} className={`px-2.5 py-1 rounded-lg text-[10px] font-black uppercase disabled:opacity-50 ${atual ? 'border border-violet-200 text-violet-700 hover:bg-violet-50' : 'bg-violet-600 text-white'}`}>{acaoLabel}</button>}
+                                                {!finalizado && s === 'entregue' && <span className="text-[9px] text-amber-500 font-black uppercase">aba Linha do tempo</span>}
+                                                <button onClick={() => imprimirCupom(s, 'termica')} title="Imprimir em impressora térmica (bobina 80mm)" className="p-1.5 rounded-lg border border-gray-200 text-gray-500 hover:bg-white"><Printer size={13} /></button>
+                                                <button onClick={() => imprimirCupom(s, 'laser')} title="Imprimir em impressora laser (folha A4)" className="px-2 py-1.5 rounded-lg border border-gray-200 text-gray-500 hover:bg-white text-[9px] font-black uppercase">A4</button>
+                                            </div>
+                                        );
+                                    })}
+                                </div>
+                                <p className="text-[9px] text-gray-300 mt-1.5 uppercase font-bold flex items-center gap-1"><Printer size={10} /> = térmica 80mm · A4 = laser · etapas podem ser repetidas/puladas</p>
+                            </div>
+                            {!finalizado && <AjustesSecao os={os} modo={modo} onChanged={carregar} />}
                         </div>
                     )}
 
-                    {/* Timeline */}
-                    <div>
-                        <p className="text-[10px] font-black text-gray-400 uppercase mb-2">Histórico</p>
-                        <div className="space-y-2">
+                    {tab === 'timeline' && (
+                        <div className="space-y-4">
+                            <p className="text-[10px] font-black text-gray-400 uppercase flex items-center gap-1.5"><History size={12} /> Linha do tempo</p>
+                            <div className="space-y-2.5">
                                 {os.eventos?.map((ev: any, i: number) => (
-                                <div key={i} className="flex items-start gap-2 text-xs">
-                                    <span className="w-2 h-2 rounded-full bg-violet-400 mt-1 shrink-0" />
-                                    <div>
-                                        <span className="font-bold text-gray-700">{STATUS_LABEL[ev.status] || ev.observacao || ev.status}</span>
-                                        <span className="text-gray-400"> · {dataBR(ev.created_at)} {ev.actor_nome ? `· ${ev.actor_nome}` : ''}</span>
+                                    <div key={i} className="flex items-start gap-2.5 text-xs">
+                                        <span className={`w-2 h-2 rounded-full mt-1 shrink-0 ${ev.status === 'cancelado' ? 'bg-red-400' : ev.status === 'entregue' ? 'bg-green-500' : ev.status === 'custodia' ? 'bg-blue-400' : 'bg-violet-400'}`} />
+                                        <div className="min-w-0">
+                                            <span className="font-bold text-gray-700">{ev.observacao || STATUS_LABEL[ev.status] || ev.status}</span>
+                                            <span className="text-gray-400 block text-[11px]">{dataHoraBR(ev.created_at)}{ev.actor_nome ? ` · ${ev.actor_nome}` : ''}</span>
                                         </div>
                                     </div>
                                 ))}
                             </div>
-                    </div>
-                </div>
-
-                {/* Ações por papel */}
-                {!finalizado && (
-                    <div className="p-5 border-t border-gray-100 sticky bottom-0 bg-white space-y-2">
-                        {modo === 'bancada' ? (
-                            <>
-                                <div className="flex gap-2 flex-wrap">
-                                    {LAB_FLUXO.map(s => (
-                                        <button key={s} disabled={busy || os.status === s} onClick={() => mudar(s)}
-                                            className={`px-3 py-2 rounded-xl text-xs font-black uppercase disabled:opacity-40 ${os.status === s ? 'bg-violet-600 text-white' : 'border border-violet-200 text-violet-700 hover:bg-violet-50'}`}>{STATUS_LABEL[s]}</button>
-                                    ))}
-                                </div>
-                                <label className="flex items-center justify-center gap-2 py-2 rounded-xl border border-dashed border-gray-200 text-gray-500 text-xs font-bold uppercase cursor-pointer">
-                                    <ImagePlus size={15} /> Anexar foto do trabalho
-                                    <input type="file" accept="image/*" className="hidden" onChange={anexar} />
-                                </label>
-                            </>
-                        ) : (
-                            <>
-                                {!os.fotos?.length && <p className="text-[10px] text-amber-600 font-bold uppercase flex items-center gap-1"><AlertTriangle size={11} /> Anexe ao menos 1 foto antes de entregar (garantia)</p>}
+                            {!finalizado && modo === 'clinica' && (
+                                <div className="pt-3 border-t border-gray-100 space-y-2">
+                                    {!os.fotos?.length && <p className="text-[10px] text-amber-600 font-bold uppercase flex items-center gap-1"><AlertTriangle size={11} /> Anexe ao menos 1 foto (aba Itens) antes de entregar</p>}
                                     <div className="flex gap-2">
                                         <button disabled={busy} onClick={() => mudar('entregue')} className="flex-1 py-2.5 rounded-xl bg-green-600 text-white font-black text-sm uppercase disabled:opacity-50">Marcar entregue</button>
                                         <button disabled={busy} onClick={() => mudar('cancelado')} className="px-4 py-2.5 rounded-xl border border-red-200 text-red-600 font-black text-sm uppercase disabled:opacity-50">Cancelar</button>
                                     </div>
-                            </>
-                        )}
                                 </div>
                             )}
                             {naGarantia && modo === 'clinica' && (
-                    <div className="p-5 border-t border-gray-100 sticky bottom-0 bg-white">
                                 <button disabled={busy} onClick={acionarGarantia} className="w-full py-2.5 rounded-xl bg-emerald-600 text-white font-black text-sm uppercase disabled:opacity-50 flex items-center justify-center gap-2"><ShieldCheck size={16} /> Acionar garantia (refazer sem custo)</button>
+                            )}
+                            {os.status === 'entregue' && modo === 'clinica' && <AvaliacaoSecao os={os} onChanged={carregar} />}
+                        </div>
+                    )}
+
+                    {tab === 'itens' && (
+                        <div className="space-y-5">
+                            <ComponentesSecao os={os} podeEditar={!finalizado} onChanged={carregar} />
+                            <FotosSecao os={os} podeEditar={!finalizado} onChanged={carregar} />
+                            <PagamentosSecao os={os} modo={modo} podeEditar={!finalizado} onChanged={carregar} />
+                        </div>
+                    )}
+
+                    {tab === 'monitor' && (
+                        <div className="space-y-5">
+                            <MonitoramentoSecao os={os} podeEditar={!finalizado} busy={busy} onMover={moverCustodia} />
+                            {modo === 'clinica' && <CompartilharLinkSecao os={os} />}
+                        </div>
+                    )}
+                    {tab === 'ocorrencias' && <OcorrenciasSecao os={os} onChanged={carregar} />}
+                </div>
+            </div>
+        </div>
+    );
+};
+
+// ── Seção: Ajustes do trabalho (cor/material, valor ao paciente, troca) ─────
+const AjustesSecao: React.FC<{ os: any; modo: 'bancada' | 'clinica'; onChanged: () => void }> = ({ os, modo, onChanged }) => {
+    const toast = useToast();
+    const [cor, setCor] = useState(os.cor || '');
+    const [material, setMaterial] = useState(os.material || '');
+    const [delta, setDelta] = useState('');
+    const [obsVal, setObsVal] = useState('');
+    const [trocaOpen, setTrocaOpen] = useState(false);
+    const [novoTrab, setNovoTrab] = useState('');
+    const [motivo, setMotivo] = useState('');
+    const [busy, setBusy] = useState(false);
+
+    const salvarCM = async () => {
+        setBusy(true);
+        try { await HybridBackend.editarProteseOS(os.id, { cor: cor.trim(), material: material.trim() }); toast.success('TRABALHO ATUALIZADO.'); onChanged(); }
+        catch (e: any) { toast.error((e.message || 'ERRO').toUpperCase()); } finally { setBusy(false); }
+    };
+    const ajustar = async (sinal: number) => {
+        const v = parseFloat(delta);
+        if (!(v > 0)) { toast.error('INFORME O VALOR DO AJUSTE.'); return; }
+        setBusy(true);
+        try { await HybridBackend.ajustarValorProtese(os.id, sinal * v, obsVal.trim() || undefined); toast.success('VALOR DO PACIENTE AJUSTADO.'); setDelta(''); setObsVal(''); onChanged(); }
+        catch (e: any) { toast.error((e.message || 'ERRO').toUpperCase()); } finally { setBusy(false); }
+    };
+    const trocar = async () => {
+        if (!novoTrab.trim() || !motivo.trim()) { toast.error('INFORME O NOVO TRABALHO E O MOTIVO.'); return; }
+        setBusy(true);
+        try { await HybridBackend.trocarTrabalhoProtese(os.id, { tipo: novoTrab.trim(), motivo: motivo.trim() }); toast.success('TRABALHO TROCADO.'); setTrocaOpen(false); setNovoTrab(''); setMotivo(''); onChanged(); }
+        catch (e: any) { toast.error((e.message || 'ERRO').toUpperCase()); } finally { setBusy(false); }
+    };
+
+    return (
+        <div className="border-t border-gray-100 pt-4 space-y-3">
+            <p className="text-[10px] font-black text-gray-400 uppercase flex items-center gap-1.5"><Pencil size={12} /> Ajustes do trabalho</p>
+            {/* Cor / material */}
+            <div className="grid grid-cols-2 gap-2">
+                <input value={cor} onChange={e => setCor(e.target.value)} placeholder="Cor (ex.: A2)" className="p-2 bg-gray-50 border border-gray-100 rounded-lg text-xs outline-none focus:border-teal-400" />
+                <input value={material} onChange={e => setMaterial(e.target.value)} placeholder="Material" className="p-2 bg-gray-50 border border-gray-100 rounded-lg text-xs outline-none focus:border-teal-400" />
+            </div>
+            <button disabled={busy} onClick={salvarCM} className="px-3 py-1.5 rounded-lg bg-gray-700 text-white text-[11px] font-black uppercase disabled:opacity-50">Salvar cor / material</button>
+
+            {/* Ajuste de valor ao paciente — só clínica (protético não vê) */}
+            {modo === 'clinica' && (
+                <div className="bg-gray-50 rounded-xl p-3 space-y-2">
+                    <p className="text-[10px] font-black text-gray-500 uppercase">Ajustar valor do paciente {Number(os.valor) > 0 ? `· atual ${fmtBRL(os.valor)}` : ''}</p>
+                    <div className="flex gap-2">
+                        <input value={delta} onChange={e => setDelta(e.target.value)} type="number" step="0.01" placeholder="0,00" className="w-24 p-2 bg-white border border-gray-100 rounded-lg text-xs font-bold outline-none focus:border-teal-400" />
+                        <input value={obsVal} onChange={e => setObsVal(e.target.value)} placeholder="Motivo (ex.: pino extra)" className="flex-1 p-2 bg-white border border-gray-100 rounded-lg text-xs outline-none focus:border-teal-400" />
+                    </div>
+                    <div className="flex gap-2">
+                        <button disabled={busy} onClick={() => ajustar(1)} className="flex-1 py-1.5 rounded-lg bg-green-600 text-white text-[11px] font-black uppercase disabled:opacity-50">+ Acrescentar</button>
+                        <button disabled={busy} onClick={() => ajustar(-1)} className="flex-1 py-1.5 rounded-lg bg-amber-500 text-white text-[11px] font-black uppercase disabled:opacity-50">− Reduzir</button>
+                    </div>
+                </div>
+            )}
+
+            {/* Trocar trabalho */}
+            <button onClick={() => setTrocaOpen(o => !o)} className="px-3 py-1.5 rounded-lg border border-violet-200 text-violet-700 text-[11px] font-black uppercase hover:bg-violet-50 flex items-center gap-1.5"><RefreshCw size={12} /> Solicitar troca de trabalho</button>
+            {trocaOpen && (
+                <div className="bg-violet-50 rounded-xl p-3 space-y-2">
+                    <input value={novoTrab} onChange={e => setNovoTrab(e.target.value)} placeholder="Novo trabalho (ex.: PPR metálica)" className="w-full p-2 bg-white border border-violet-100 rounded-lg text-xs outline-none focus:border-violet-400" />
+                    <input value={motivo} onChange={e => setMotivo(e.target.value)} placeholder="Motivo da troca (obrigatório)" className="w-full p-2 bg-white border border-violet-100 rounded-lg text-xs outline-none focus:border-violet-400" />
+                    <button disabled={busy} onClick={trocar} className="w-full py-2 rounded-lg bg-violet-600 text-white text-[11px] font-black uppercase disabled:opacity-50">Confirmar troca</button>
                 </div>
             )}
         </div>
+    );
+};
+
+// ── Seção: Ocorrências (rastreabilidade técnica + contraditório) ────────────
+const OCOR_CATS: Record<string, string> = {
+    nao_devolvido: 'Componente não devolvido', danificado: 'Componente danificado', incompativel: 'Componente incompatível',
+    parafuso_substituido: 'Parafuso substituído', parafuso_desgastado: 'Parafuso desgastado', peca_incorreta: 'Peça recebida incorreta',
+    ajuste_inadequado: 'Ajuste inadequado', falha_fabricacao: 'Falha de fabricação', retrabalho: 'Retrabalho solicitado', outro: 'Outro',
+};
+const OCOR_STATUS_COR: Record<string, string> = {
+    aberta: 'bg-red-100 text-red-600', respondida: 'bg-amber-100 text-amber-700', em_analise: 'bg-blue-100 text-blue-700',
+    resolvida: 'bg-green-100 text-green-700', contestada: 'bg-orange-100 text-orange-700',
+};
+const OcorrenciasSecao: React.FC<{ os: any; onChanged: () => void }> = ({ os, onChanged }) => {
+    const toast = useToast();
+    const [open, setOpen] = useState(false);
+    const [cat, setCat] = useState('danificado');
+    const [desc, setDesc] = useState('');
+    const [resp, setResp] = useState('');
+    const [busy, setBusy] = useState(false);
+    const [respostas, setRespostas] = useState<Record<string, string>>({});
+    const finalizadoOS = os.status === 'entregue' || os.status === 'cancelado';
+    const err = (e: any) => toast.error((e.message || 'ERRO').toUpperCase());
+
+    const abrir = async () => {
+        if (!desc.trim()) { toast.error('DESCREVA A OCORRÊNCIA.'); return; }
+        setBusy(true);
+        try { await HybridBackend.abrirProteseOcorrencia(os.id, { categoria: cat, descricao: desc.trim(), responsavel: resp.trim() || undefined }); toast.success('OCORRÊNCIA ABERTA.'); setDesc(''); setResp(''); setOpen(false); onChanged(); }
+        catch (e) { err(e); } finally { setBusy(false); }
+    };
+    const responder = async (id: string) => {
+        const t = (respostas[id] || '').trim(); if (!t) { toast.error('ESCREVA A RESPOSTA.'); return; }
+        setBusy(true);
+        try { await HybridBackend.responderProteseOcorrencia(id, t); setRespostas(s => ({ ...s, [id]: '' })); onChanged(); } catch (e) { err(e); } finally { setBusy(false); }
+    };
+    const mudar = async (id: string, st: string) => { setBusy(true); try { await HybridBackend.statusProteseOcorrencia(id, st); onChanged(); } catch (e) { err(e); } finally { setBusy(false); } };
+    const anexar = async (id: string, e: React.ChangeEvent<HTMLInputElement>) => {
+        const f = e.target.files?.[0]; if (!f) return; setBusy(true);
+        try { await HybridBackend.uploadProteseFoto(os.id, f, undefined, id); onChanged(); } catch (er) { err(er); } finally { setBusy(false); e.target.value = ''; }
+    };
+
+    return (
+        <div className="space-y-4">
+            <div className="flex items-center justify-between">
+                <p className="text-[10px] font-black text-gray-400 uppercase flex items-center gap-1.5"><AlertTriangle size={12} /> Ocorrências</p>
+                {!finalizadoOS && <button onClick={() => setOpen(o => !o)} className="px-3 py-1.5 rounded-lg bg-red-600 text-white text-[11px] font-black uppercase">+ Abrir</button>}
+            </div>
+            {open && (
+                <div className="bg-red-50 rounded-xl p-3 space-y-2">
+                    <select value={cat} onChange={e => setCat(e.target.value)} className="w-full p-2 bg-white border border-red-100 rounded-lg text-xs font-bold outline-none focus:border-red-300">
+                        {Object.entries(OCOR_CATS).map(([k, v]) => <option key={k} value={k}>{v}</option>)}
+                    </select>
+                    <textarea value={desc} onChange={e => setDesc(e.target.value)} rows={3} placeholder="Descreva (ex.: enviado parafuso original Neodent CM; devolvido com sinais de uso incompatíveis)." className="w-full p-2 bg-white border border-red-100 rounded-lg text-xs outline-none focus:border-red-300 resize-none" />
+                    <input value={resp} onChange={e => setResp(e.target.value)} placeholder="Responsável apontado (ex.: Dr. João / Laboratório)" className="w-full p-2 bg-white border border-red-100 rounded-lg text-xs outline-none focus:border-red-300" />
+                    <button disabled={busy} onClick={abrir} className="w-full py-2 rounded-lg bg-red-600 text-white text-[11px] font-black uppercase disabled:opacity-50">Abrir ocorrência</button>
+                </div>
+            )}
+            <div className="space-y-3">
+                {(os.ocorrencias || []).map((o: any) => (
+                    <div key={o.id} className="border border-gray-100 rounded-xl p-3 space-y-2">
+                        <div className="flex items-center gap-2">
+                            <span className={`text-[8px] font-black px-1.5 py-0.5 rounded uppercase ${OCOR_STATUS_COR[o.status] || 'bg-gray-100 text-gray-500'}`}>{(o.status || '').replace('_', ' ')}</span>
+                            <span className="text-xs font-black text-gray-700 flex-1">{OCOR_CATS[o.categoria] || o.categoria}</span>
+                            <span className="text-[10px] text-gray-400">{dataBR(o.created_at)}</span>
+                        </div>
+                        <p className="text-xs text-gray-600">{o.descricao}</p>
+                        <p className="text-[10px] text-gray-400">Aberta por {o.autor_nome}{o.responsavel ? ` · responsável: ${o.responsavel}` : ''}</p>
+                        {o.resposta && <div className="bg-gray-50 rounded-lg p-2 text-xs"><span className="font-black text-gray-500 uppercase text-[9px]">Resposta ({o.resposta_nome}):</span> {o.resposta}</div>}
+                        {o.fotos?.length > 0 && <div className="flex gap-1.5 flex-wrap">{o.fotos.map((f: any) => <a key={f.id} href={f.url} target="_blank" rel="noreferrer"><img src={f.url} alt="" className="w-12 h-12 object-cover rounded border border-gray-100" /></a>)}</div>}
+                        {o.status !== 'resolvida' && (
+                            <div className="space-y-1.5 pt-1 border-t border-gray-50">
+                                <div className="flex gap-1.5">
+                                    <input value={respostas[o.id] || ''} onChange={e => setRespostas(s => ({ ...s, [o.id]: e.target.value }))} placeholder="Responder (contraditório)..." className="flex-1 p-1.5 bg-gray-50 border border-gray-100 rounded text-xs outline-none focus:border-teal-400" />
+                                    <button disabled={busy} onClick={() => responder(o.id)} className="px-2 rounded bg-gray-700 text-white text-[10px] font-black uppercase disabled:opacity-50">Responder</button>
+                                    <label className="px-2 py-1.5 rounded border border-gray-200 text-gray-500 cursor-pointer flex items-center"><ImagePlus size={12} /><input type="file" accept="image/*" className="hidden" onChange={e => anexar(o.id, e)} /></label>
+                                </div>
+                                <div className="flex gap-1.5">
+                                    <button disabled={busy} onClick={() => mudar(o.id, 'em_analise')} className="flex-1 py-1 rounded bg-blue-100 text-blue-700 text-[9px] font-black uppercase disabled:opacity-50">Em análise</button>
+                                    <button disabled={busy} onClick={() => mudar(o.id, 'contestada')} className="flex-1 py-1 rounded bg-orange-100 text-orange-700 text-[9px] font-black uppercase disabled:opacity-50">Contestar</button>
+                                    <button disabled={busy} onClick={() => mudar(o.id, 'resolvida')} className="flex-1 py-1 rounded bg-green-600 text-white text-[9px] font-black uppercase disabled:opacity-50">Resolver</button>
+                                </div>
+                            </div>
+                        )}
+                        {o.status === 'resolvida' && o.resolved_at && <p className="text-[9px] text-green-600 font-black uppercase">Resolvida em {dataBR(o.resolved_at)}</p>}
+                    </div>
+                ))}
+                {(os.ocorrencias || []).length === 0 && <p className="text-[11px] text-gray-300 font-bold uppercase">Nenhuma ocorrência registrada.</p>}
+            </div>
+            <p className="text-[9px] text-gray-300 uppercase font-bold">Só ocorrências resolvidas pesarão em indicadores (futuro).</p>
+        </div>
+    );
+};
+
+// ── Seção: Compartilhar link de acompanhamento com o protético (Modo 1) ─────
+const CompartilharLinkSecao: React.FC<{ os: any }> = ({ os }) => {
+    const toast = useToast();
+    const confirm = useConfirm();
+    const [st, setSt] = useState<any>(null); // null=carregando | {ativo,...}
+    const [busy, setBusy] = useState(false);
+    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 { 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(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>
+            {!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={() => 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={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>
+                    <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>
+    );
+};
+
+// ── Seção: Avaliar o laboratório (após a entrega, lado clínica) ─────────────
+const AvaliacaoSecao: React.FC<{ os: any; onChanged: () => void }> = ({ os, onChanged }) => {
+    const toast = useToast();
+    const [estrelas, setEstrelas] = useState<number>(os.avaliacao?.estrelas || 0);
+    const [coment, setComent] = useState<string>(os.avaliacao?.comentario || '');
+    const [busy, setBusy] = useState(false);
+    const salvar = async () => {
+        if (!estrelas) { toast.error('DÊ UMA NOTA DE 1 A 5.'); return; }
+        setBusy(true);
+        try { await HybridBackend.avaliarProteseOS(os.id, { estrelas, comentario: coment.trim() || undefined }); toast.success('AVALIAÇÃO ENVIADA.'); onChanged(); }
+        catch (e: any) { toast.error((e.message || 'ERRO').toUpperCase()); } finally { setBusy(false); }
+    };
+    return (
+        <div className="pt-3 border-t border-gray-100">
+            <p className="text-[10px] font-black text-gray-400 uppercase mb-2 flex items-center gap-1.5"><Star size={12} /> Avaliar o laboratório</p>
+            <div className="flex gap-1 mb-2">
+                {[1, 2, 3, 4, 5].map(n => (
+                    <button key={n} onClick={() => setEstrelas(n)} className={n <= estrelas ? 'text-amber-400' : 'text-gray-200'}><Star size={26} fill={n <= estrelas ? 'currentColor' : 'none'} /></button>
+                ))}
+            </div>
+            <textarea value={coment} onChange={e => setComent(e.target.value)} rows={2} placeholder="Comentário (opcional)" className="w-full p-2 bg-gray-50 border border-gray-100 rounded-lg text-xs outline-none focus:border-amber-400 resize-none" />
+            <button disabled={busy} onClick={salvar} className="mt-2 px-3 py-2 rounded-lg bg-amber-500 text-white text-[11px] font-black uppercase disabled:opacity-50">{os.avaliacao ? 'Atualizar avaliação' : 'Enviar avaliação'}</button>
+        </div>
+    );
+};
+
+// ── Seção: Monitoramento de custódia (onde o trabalho está) ─────────────────
+const MonitoramentoSecao: React.FC<{ os: any; podeEditar: boolean; busy: boolean; onMover: (p: 'clinica' | 'laboratorio') => void }> = ({ os, podeEditar, busy, onMover }) => {
+    const noLab = (os.local_atual || 'clinica') === 'laboratorio';
+    return (
+        <div className="space-y-5">
+            <p className="text-[10px] font-black text-gray-400 uppercase flex items-center gap-1.5"><MapPin size={12} /> Onde está o trabalho</p>
+            <div className={`rounded-2xl p-5 text-center ${noLab ? 'bg-violet-50' : 'bg-blue-50'}`}>
+                <div className={`w-14 h-14 rounded-2xl mx-auto flex items-center justify-center text-white ${noLab ? 'bg-violet-600' : 'bg-blue-600'}`}>{noLab ? <FlaskConical size={26} /> : <Building2 size={26} />}</div>
+                <p className={`mt-3 font-black uppercase text-sm ${noLab ? 'text-violet-700' : 'text-blue-700'}`}>{noLab ? 'Com o laboratório' : 'Na clínica'}</p>
+                <p className="text-[11px] text-gray-400 font-bold uppercase mt-0.5">{noLab ? 'O protético está com o trabalho' : 'O trabalho está na clínica'}</p>
+            </div>
+            {podeEditar && (
+                <div className="flex gap-2">
+                    <button disabled={busy || noLab} onClick={() => onMover('laboratorio')} className="flex-1 py-2.5 rounded-xl bg-violet-600 text-white font-black text-xs uppercase disabled:opacity-40 flex items-center justify-center gap-2"><FlaskConical size={14} /> Protético retirou</button>
+                    <button disabled={busy || !noLab} onClick={() => onMover('clinica')} className="flex-1 py-2.5 rounded-xl bg-blue-600 text-white font-black text-xs uppercase disabled:opacity-40 flex items-center justify-center gap-2"><Building2 size={14} /> Devolveu à clínica</button>
+                </div>
+            )}
+            <div>
+                <p className="text-[10px] font-black text-gray-400 uppercase mb-2 flex items-center gap-1.5"><History size={12} /> Movimentações</p>
+                <div className="space-y-2">
+                    {(os.custodia || []).map((c: any) => (
+                        <div key={c.id} className="flex items-center gap-2 text-xs bg-gray-50 rounded-lg px-3 py-2">
+                            <span className="text-[9px] font-black px-1.5 py-0.5 rounded uppercase bg-gray-200 text-gray-600">{c.de_local === 'clinica' ? 'Clínica' : 'Lab'} → {c.para_local === 'clinica' ? 'Clínica' : 'Lab'}</span>
+                            <span className="text-[10px] text-gray-400 flex-1 truncate">{c.actor_nome} · {dataHoraBR(c.created_at)}</span>
+                        </div>
+                    ))}
+                    {(os.custodia || []).length === 0 && <p className="text-[11px] text-gray-300 font-bold uppercase">Sem movimentações registradas.</p>}
+                </div>
+            </div>
+        </div>
+    );
+};
+
+// ── Stepper visual das etapas da OS ─────────────────────────────────────────
+const FLUXO_OS = ['solicitado', 'recebido', 'producao', 'prova', 'ajuste', 'finalizado', 'entregue'];
+const EtapasStepper: React.FC<{ os: any }> = ({ os }) => {
+    if (os.status === 'cancelado') {
+        return <div className="bg-red-50 rounded-xl px-3 py-2 text-xs font-black text-red-600 uppercase flex items-center gap-2"><X size={14} /> OS cancelada</div>;
+    }
+    const idxAtual = FLUXO_OS.indexOf(os.status);
+    const dataDe = (s: string) => { const ev = os.eventos?.find((e: any) => e.status === s); return ev ? dataBR(ev.created_at) : ''; };
+    return (
+        <div className="flex items-start overflow-x-auto pb-1">
+            {FLUXO_OS.map((s, i) => {
+                const done = i < idxAtual, atual = i === idxAtual;
+                return (
+                    <React.Fragment key={s}>
+                        <div className="flex flex-col items-center min-w-[58px]">
+                            {done ? <CheckCircle2 size={20} className="text-teal-600" />
+                                : atual ? <div className="w-5 h-5 rounded-full bg-violet-600 ring-4 ring-violet-100" />
+                                    : <Circle size={20} className="text-gray-200" />}
+                            <span className={`text-[8px] font-black uppercase mt-1 text-center leading-tight ${atual ? 'text-violet-700' : done ? 'text-teal-700' : 'text-gray-300'}`}>{STATUS_LABEL[s]}</span>
+                            <span className="text-[8px] text-gray-300 leading-tight">{dataDe(s)}</span>
+                        </div>
+                        {i < FLUXO_OS.length - 1 && <div className={`flex-1 h-0.5 mt-2.5 min-w-[10px] ${i < idxAtual ? 'bg-teal-400' : 'bg-gray-100'}`} />}
+                    </React.Fragment>
+                );
+            })}
+        </div>
+    );
+};
+
+// ── Seção: Componentes enviados ao laboratório ──────────────────────────────
+const CONF_COR: Record<string, string> = { pendente: 'bg-gray-100 text-gray-500', ok: 'bg-green-100 text-green-700', divergente: 'bg-amber-100 text-amber-700', ausente: 'bg-red-100 text-red-600' };
+const ComponentesSecao: React.FC<{ os: any; podeEditar: boolean; onChanged: () => void }> = ({ os, podeEditar, onChanged }) => {
+    const toast = useToast();
+    const [nome, setNome] = useState('');
+    const [qtd, setQtd] = useState('1');
+    const [direcao, setDirecao] = useState<'enviado' | 'devolvido'>('enviado');
+    const [busy, setBusy] = useState(false);
+    const add = async () => {
+        if (!nome.trim()) { toast.error('INFORME O COMPONENTE.'); return; }
+        setBusy(true);
+        try { await HybridBackend.addProteseComponente(os.id, { nome: nome.trim(), quantidade: parseInt(qtd, 10) || 1, direcao }); setNome(''); setQtd('1'); onChanged(); }
+        catch (e: any) { toast.error((e.message || 'ERRO').toUpperCase()); } finally { setBusy(false); }
+    };
+    const del = async (id: string) => { try { await HybridBackend.deleteProteseComponente(id); onChanged(); } catch (e: any) { toast.error((e.message || 'ERRO').toUpperCase()); } };
+    const conferir = async (id: string, st: string) => { try { await HybridBackend.conferirProteseComponente(id, st); onChanged(); } catch (e: any) { toast.error((e.message || 'ERRO').toUpperCase()); } };
+    return (
+        <div>
+            <p className="text-[10px] font-black text-gray-400 uppercase mb-2 flex items-center gap-1.5"><Package size={12} /> Rastreabilidade de componentes</p>
+            <div className="space-y-1.5">
+                {(os.componentes || []).map((c: any) => (
+                    <div key={c.id} className="text-xs bg-gray-50 rounded-lg px-3 py-2">
+                        <div className="flex items-center gap-2">
+                            <span className={`text-[8px] font-black px-1.5 py-0.5 rounded uppercase ${c.direcao === 'devolvido' ? 'bg-blue-100 text-blue-700' : 'bg-teal-100 text-teal-700'}`}>{c.direcao === 'devolvido' ? 'Devolvido' : 'Enviado'}</span>
+                            <span className="font-black text-gray-700">{c.quantidade}×</span>
+                            <span className="font-bold text-gray-700 flex-1 truncate">{c.nome}</span>
+                            <span className={`text-[8px] font-black px-1.5 py-0.5 rounded uppercase ${CONF_COR[c.status_conferencia] || CONF_COR.pendente}`}>{c.status_conferencia || 'pendente'}</span>
+                            {podeEditar && <button onClick={() => del(c.id)} className="text-gray-300 hover:text-red-500"><Trash2 size={13} /></button>}
+                        </div>
+                        <div className="flex items-center gap-2 mt-1">
+                            <span className="text-[9px] text-gray-400 flex-1 truncate">{c.enviado_nome} · {dataBR(c.created_at)}{c.conferido_nome ? ` · conferido por ${c.conferido_nome}` : ''}</span>
+                            {podeEditar && ['ok', 'divergente', 'ausente'].map(st => (
+                                <button key={st} onClick={() => conferir(c.id, st)} className={`text-[8px] font-black px-1.5 py-0.5 rounded uppercase border ${c.status_conferencia === st ? CONF_COR[st] + ' border-transparent' : 'border-gray-200 text-gray-400 hover:bg-white'}`}>{st}</button>
+                            ))}
+                        </div>
+                    </div>
+                ))}
+                {(os.componentes || []).length === 0 && <p className="text-[11px] text-gray-300 font-bold uppercase">Nenhum componente registrado.</p>}
+            </div>
+            {podeEditar && (
+                <div className="flex gap-2 mt-2">
+                    <select value={direcao} onChange={e => setDirecao(e.target.value as any)} className="p-2 bg-gray-50 border border-gray-100 rounded-lg text-[11px] font-bold outline-none focus:border-teal-400">
+                        <option value="enviado">Enviado</option>
+                        <option value="devolvido">Devolvido</option>
+                    </select>
+                    <input value={qtd} onChange={e => setQtd(e.target.value)} type="number" min="1" className="w-12 p-2 bg-gray-50 border border-gray-100 rounded-lg text-xs font-bold text-center outline-none focus:border-teal-400" />
+                    <input value={nome} onChange={e => setNome(e.target.value)} placeholder="Implante, pilar, parafuso..." className="flex-1 p-2 bg-gray-50 border border-gray-100 rounded-lg text-xs outline-none focus:border-teal-400" />
+                    <button disabled={busy} onClick={add} className="px-3 rounded-lg bg-teal-600 text-white text-xs font-black uppercase disabled:opacity-50 flex items-center gap-1"><Plus size={13} /></button>
+                </div>
+            )}
+        </div>
+    );
+};
+
+// ── Seção: Fotos (anexar com legenda, autor, remover) ───────────────────────
+const FotosSecao: React.FC<{ os: any; podeEditar: boolean; onChanged: () => void }> = ({ os, podeEditar, onChanged }) => {
+    const toast = useToast();
+    const [legenda, setLegenda] = useState('');
+    const [busy, setBusy] = useState(false);
+    const anexar = async (e: React.ChangeEvent<HTMLInputElement>) => {
+        const file = e.target.files?.[0]; if (!file) return;
+        setBusy(true);
+        try { await HybridBackend.uploadProteseFoto(os.id, file, legenda.trim() || undefined); setLegenda(''); onChanged(); }
+        catch (err: any) { toast.error((err.message || 'ERRO').toUpperCase()); } finally { setBusy(false); e.target.value = ''; }
+    };
+    const del = async (id: string) => { try { await HybridBackend.deleteProteseFoto(id); onChanged(); } catch (e: any) { toast.error((e.message || 'ERRO').toUpperCase()); } };
+    return (
+        <div>
+            <p className="text-[10px] font-black text-gray-400 uppercase mb-2 flex items-center gap-1.5"><Camera size={12} /> Fotos do trabalho</p>
+            <div className="grid grid-cols-2 sm:grid-cols-3 gap-2">
+                {(os.fotos || []).map((f: any) => (
+                    <div key={f.id} className="rounded-lg border border-gray-100 overflow-hidden group relative">
+                        <a href={f.url} target="_blank" rel="noreferrer"><img src={f.url} alt="" className="w-full h-24 object-cover" /></a>
+                        {podeEditar && <button onClick={() => del(f.id)} className="absolute top-1 right-1 bg-white/90 rounded-md p-1 text-gray-400 hover:text-red-500 opacity-0 group-hover:opacity-100 transition-opacity"><Trash2 size={12} /></button>}
+                        <div className="px-2 py-1">
+                            {f.legenda && <p className="text-[10px] font-bold text-gray-600 truncate">{f.legenda}</p>}
+                            <p className="text-[9px] text-gray-400 truncate">{f.uploaded_nome || '—'} · {dataBR(f.created_at)}</p>
+                        </div>
+                    </div>
+                ))}
+                {(os.fotos || []).length === 0 && <p className="text-[11px] text-gray-300 font-bold uppercase col-span-full">Nenhuma foto anexada.</p>}
+            </div>
+            {podeEditar && (
+                <div className="flex gap-2 mt-2">
+                    <input value={legenda} onChange={e => setLegenda(e.target.value)} placeholder="Legenda da próxima foto (opcional)" className="flex-1 p-2 bg-gray-50 border border-gray-100 rounded-lg text-xs outline-none focus:border-teal-400" />
+                    <label className={`flex items-center gap-1.5 px-3 rounded-lg border border-dashed border-gray-200 text-gray-500 text-xs font-bold uppercase cursor-pointer ${busy ? 'opacity-50 pointer-events-none' : ''}`}>
+                        <ImagePlus size={14} /> Anexar
+                        <input type="file" accept="image/*" className="hidden" onChange={anexar} />
+                    </label>
+                </div>
+            )}
+        </div>
+    );
+};
+
+// ── Seção: Pagamentos (dois lados) ──────────────────────────────────────────
+const PagamentosSecao: React.FC<{ os: any; modo: 'bancada' | 'clinica'; podeEditar: boolean; onChanged: () => void }> = ({ os, modo, podeEditar, onChanged }) => {
+    const toast = useToast();
+    const [lado, setLado] = useState<'lab' | 'clinica'>(modo === 'bancada' ? 'lab' : 'clinica');
+    const [valor, setValor] = useState('');
+    const [forma, setForma] = useState('');
+    const [busy, setBusy] = useState(false);
+    const pags = os.pagamentos || [];
+    const totalLab = pags.filter((p: any) => p.lado === 'lab').reduce((s: number, p: any) => s + Number(p.valor || 0), 0);
+    const totalClinica = pags.filter((p: any) => p.lado === 'clinica').reduce((s: number, p: any) => s + Number(p.valor || 0), 0);
+    const add = async () => {
+        const v = parseFloat(valor);
+        if (!(v > 0)) { toast.error('INFORME UM VALOR.'); return; }
+        setBusy(true);
+        try { await HybridBackend.addProtesePagamento(os.id, { lado, valor: v, forma: forma.trim() || undefined }); setValor(''); setForma(''); onChanged(); }
+        catch (e: any) { toast.error((e.message || 'ERRO').toUpperCase()); } finally { setBusy(false); }
+    };
+    const del = async (id: string) => { try { await HybridBackend.deleteProtesePagamento(id); onChanged(); } catch (e: any) { toast.error((e.message || 'ERRO').toUpperCase()); } };
+    return (
+        <div>
+            <p className="text-[10px] font-black text-gray-400 uppercase mb-2 flex items-center gap-1.5"><Wallet size={12} /> Valores recebidos</p>
+            {/* O protético (modo bancada) NÃO vê o que o paciente paga — só o que recebe do lab. */}
+            <div className={`grid ${modo === 'bancada' ? 'grid-cols-1' : 'grid-cols-2'} gap-2 mb-2`}>
+                {modo === 'clinica' && <div className="bg-green-50 rounded-xl px-3 py-2"><p className="text-[9px] font-black text-green-600 uppercase">Recebido do paciente</p><p className="text-sm font-black text-green-700">{fmtBRL(totalClinica)}</p></div>}
+                <div className="bg-violet-50 rounded-xl px-3 py-2"><p className="text-[9px] font-black text-violet-600 uppercase">Pago ao laboratório</p><p className="text-sm font-black text-violet-700">{fmtBRL(totalLab)}</p></div>
+            </div>
+            <div className="space-y-1.5">
+                {pags.map((p: any) => (
+                    <div key={p.id} className="flex items-center gap-2 text-xs bg-gray-50 rounded-lg px-3 py-2">
+                        <span className={`text-[9px] font-black px-1.5 py-0.5 rounded uppercase ${p.lado === 'lab' ? 'bg-violet-100 text-violet-700' : 'bg-green-100 text-green-700'}`}>{p.lado === 'lab' ? 'Lab' : 'Paciente'}</span>
+                        <span className="font-black text-gray-700">{fmtBRL(p.valor)}</span>
+                        <span className="text-[10px] text-gray-400 flex-1 truncate">{p.forma ? `${p.forma} · ` : ''}{p.recebido_nome} · {dataBR(p.data)}</span>
+                        {podeEditar && <button onClick={() => del(p.id)} className="text-gray-300 hover:text-red-500"><Trash2 size={13} /></button>}
+                    </div>
+                ))}
+                {pags.length === 0 && <p className="text-[11px] text-gray-300 font-bold uppercase">Nenhum pagamento registrado.</p>}
+            </div>
+            {podeEditar && (
+                <div className="flex gap-2 mt-2">
+                    {modo === 'clinica' ? (
+                        <select value={lado} onChange={e => setLado(e.target.value as any)} className="p-2 bg-gray-50 border border-gray-100 rounded-lg text-xs font-bold outline-none focus:border-teal-400">
+                            <option value="clinica">Paciente</option>
+                            <option value="lab">Lab</option>
+                        </select>
+                    ) : (
+                        <span className="p-2 bg-violet-50 rounded-lg text-xs font-black text-violet-700 uppercase flex items-center">Lab</span>
+                    )}
+                    <input value={valor} onChange={e => setValor(e.target.value)} type="number" step="0.01" placeholder="0,00" className="w-20 p-2 bg-gray-50 border border-gray-100 rounded-lg text-xs font-bold outline-none focus:border-teal-400" />
+                    <input value={forma} onChange={e => setForma(e.target.value)} placeholder="Forma (pix...)" className="flex-1 p-2 bg-gray-50 border border-gray-100 rounded-lg text-xs outline-none focus:border-teal-400" />
+                    <button disabled={busy} onClick={add} className="px-3 rounded-lg bg-teal-600 text-white text-xs font-black uppercase disabled:opacity-50 flex items-center gap-1"><Plus size={13} /></button>
+                </div>
+            )}
         </div>
     );
 };
@@ -387,6 +912,103 @@ const ProdutosModal: React.FC<{ onClose: () => void }> = ({ onClose }) => {
 };
 
 // ── View principal ──────────────────────────────────────────────────────────
+// ── Modal: Cotações (lado clínica) — pedir a N labs, comparar e escolher ────
+const CotacoesClinicaModal: React.FC<{ onClose: () => void; onEscolhida: () => void }> = ({ onClose, onEscolhida }) => {
+    const toast = useToast();
+    const confirm = useConfirm();
+    const [aba, setAba] = useState<'novo' | 'lista'>('lista');
+    const [rfqs, setRfqs] = useState<any[]>([]);
+    const [labs, setLabs] = useState<any[]>([]);
+    const [descricao, setDescricao] = useState('');
+    const [dentes, setDentes] = useState('');
+    const [prazo, setPrazo] = useState('');
+    const [sel, setSel] = useState<string[]>([]);
+    const [busy, setBusy] = useState(false);
+
+    const carregar = useCallback(() => HybridBackend.getRfqs().then(r => setRfqs(Array.isArray(r) ? r : [])).catch(() => setRfqs([])), []);
+    useEffect(() => { carregar(); HybridBackend.getProteseLaboratorios().then(r => setLabs(Array.isArray(r) ? r : [])).catch(() => setLabs([])); }, [carregar]);
+
+    const toggleLab = (id: string) => setSel(s => s.includes(id) ? s.filter(x => x !== id) : [...s, id]);
+    const criar = async () => {
+        if (!descricao.trim()) { toast.error('DESCREVA O TRABALHO.'); return; }
+        if (!sel.length) { toast.error('SELECIONE AO MENOS UM LABORATÓRIO.'); return; }
+        setBusy(true);
+        try { await HybridBackend.criarRfq({ descricao: descricao.trim(), dentes: dentes.trim() || undefined, prazo_desejado: prazo || undefined, proteticos: sel }); toast.success('COTAÇÃO ENVIADA AOS LABORATÓRIOS.'); setDescricao(''); setDentes(''); setPrazo(''); setSel([]); setAba('lista'); carregar(); }
+        catch (e: any) { toast.error((e.message || 'ERRO').toUpperCase()); } finally { setBusy(false); }
+    };
+    const escolher = async (rfq: any, cot: any) => {
+        if (!(await confirm(`ESCOLHER ${cot.protetico_nome} POR ${fmtBRL(cot.valor)}? UMA OS SERÁ CRIADA.`))) return;
+        setBusy(true);
+        try { await HybridBackend.escolherCotacao(rfq.id, cot.id); toast.success('OS CRIADA A PARTIR DA COTAÇÃO.'); carregar(); onEscolhida(); }
+        catch (e: any) { toast.error((e.message || 'ERRO').toUpperCase()); } finally { setBusy(false); }
+    };
+
+    return (
+        <div className="fixed inset-0 bg-black/40 z-50 flex items-center justify-center p-4" onClick={onClose}>
+            <div className="bg-white rounded-2xl w-full max-w-lg h-[88vh] flex flex-col" onClick={e => e.stopPropagation()}>
+                <div className="flex items-center justify-between px-5 py-4 border-b border-gray-100">
+                    <h3 className="font-black text-gray-800 uppercase text-sm flex items-center gap-2"><FileText size={16} className="text-violet-600" /> Cotações de prótese</h3>
+                    <button onClick={onClose}><X size={20} className="text-gray-400" /></button>
+                </div>
+                <div className="flex border-b border-gray-100 px-2">
+                    {(['lista', 'novo'] as const).map(t => (
+                        <button key={t} onClick={() => setAba(t)} className={`px-3 py-2.5 text-xs font-black uppercase border-b-2 -mb-px ${aba === t ? 'border-violet-600 text-violet-700' : 'border-transparent text-gray-400'}`}>{t === 'lista' ? 'Meus pedidos' : 'Pedir cotação'}</button>
+                    ))}
+                </div>
+                <div className="flex-1 overflow-y-auto p-5">
+                    {aba === 'novo' ? (
+                        <div className="space-y-3">
+                            <textarea value={descricao} onChange={e => setDescricao(e.target.value)} rows={3} placeholder="Descreva o trabalho (ex.: Coroa sobre implante, dente 36, cor A2)" className="w-full p-3 bg-gray-50 border border-gray-100 rounded-xl text-sm outline-none focus:border-violet-400 resize-none" />
+                            <div className="grid grid-cols-2 gap-2">
+                                <input value={dentes} onChange={e => setDentes(e.target.value)} placeholder="Dentes (ex.: 36)" className="p-2.5 bg-gray-50 border border-gray-100 rounded-xl text-sm outline-none focus:border-violet-400" />
+                                <input type="date" value={prazo} onChange={e => setPrazo(e.target.value)} className="p-2.5 bg-gray-50 border border-gray-100 rounded-xl text-sm outline-none focus:border-violet-400" />
+                            </div>
+                            <div>
+                                <p className="text-[10px] font-black text-gray-400 uppercase mb-2">Laboratórios a convidar</p>
+                                <div className="space-y-1.5 max-h-56 overflow-y-auto">
+                                    {labs.map(l => (
+                                        <button key={l.id} onClick={() => toggleLab(l.id)} className={`w-full flex items-center gap-2 px-3 py-2 rounded-xl border text-left ${sel.includes(l.id) ? 'border-violet-400 bg-violet-50' : 'border-gray-100'}`}>
+                                            <span className={`w-4 h-4 rounded border flex items-center justify-center ${sel.includes(l.id) ? 'bg-violet-600 border-violet-600' : 'border-gray-300'}`}>{sel.includes(l.id) && <Check size={11} className="text-white" />}</span>
+                                            <span className="text-sm font-bold text-gray-700 flex-1 truncate">{l.nome}</span>
+                                            {l.interno && <span className="text-[8px] font-black text-teal-600 uppercase">interno</span>}
+                                            {l.nota != null && <span className="text-[9px] font-black text-amber-600">★ {l.nota}</span>}
+                                        </button>
+                                    ))}
+                                </div>
+                            </div>
+                            <button disabled={busy} onClick={criar} className="w-full py-3 rounded-xl bg-[#2d6a4f] text-white font-black text-sm uppercase disabled:opacity-50">Enviar pedido a {sel.length} laboratório(s)</button>
+                        </div>
+                    ) : (
+                        rfqs.length === 0 ? <p className="text-center text-gray-300 font-bold uppercase text-sm py-12">Nenhum pedido de cotação ainda.</p> : (
+                            <div className="space-y-3">
+                                {rfqs.map(r => (
+                                    <div key={r.id} className="border border-gray-100 rounded-2xl p-3">
+                                        <div className="flex items-center justify-between gap-2">
+                                            <p className="font-black text-gray-800 text-sm">{r.descricao}</p>
+                                            <span className={`text-[8px] font-black px-2 py-0.5 rounded-full uppercase ${r.status === 'fechada' ? 'bg-green-100 text-green-700' : 'bg-amber-100 text-amber-700'}`}>{r.status === 'fechada' ? 'fechada' : 'aberta'}</span>
+                                        </div>
+                                        <div className="mt-2 space-y-1.5">
+                                            {(r.cotacoes || []).map((c: any) => (
+                                                <div key={c.id} className="flex items-center gap-2 text-xs bg-gray-50 rounded-lg px-3 py-2">
+                                                    <span className="font-bold text-gray-700 flex-1 truncate">{c.protetico_nome}</span>
+                                                    {c.status === 'convidada' ? <span className="text-[10px] text-gray-400 uppercase">aguardando…</span>
+                                                        : <><span className="font-black text-gray-800">{fmtBRL(c.valor)}</span>{c.prazo_dias ? <span className="text-[10px] text-gray-400">{c.prazo_dias}d</span> : null}</>}
+                                                    {c.status === 'escolhida' && <span className="text-[8px] font-black text-green-700 uppercase">escolhida</span>}
+                                                    {r.status === 'aberta' && c.status === 'enviada' && <button disabled={busy} onClick={() => escolher(r, c)} className="px-2 py-1 rounded-lg bg-[#2d6a4f] text-white text-[9px] font-black uppercase disabled:opacity-50">Escolher</button>}
+                                                </div>
+                                            ))}
+                                        </div>
+                                    </div>
+                                ))}
+                            </div>
+                        )
+                    )}
+                </div>
+            </div>
+        </div>
+    );
+};
+
 export const ProteseView: React.FC = () => {
     const role = HybridBackend.getCurrentRole();
     const modo: 'bancada' | 'clinica' = role === 'protetico' ? 'bancada' : 'clinica';
@@ -398,6 +1020,7 @@ export const ProteseView: React.FC = () => {
     const [novaOS, setNovaOS] = useState(false);
     const [detalhe, setDetalhe] = useState<string | null>(null);
     const [produtosModal, setProdutosModal] = useState(false);
+    const [cotacoesOpen, setCotacoesOpen] = useState(false);
 
     const carregar = useCallback(() => {
         setLoading(true);
@@ -425,9 +1048,10 @@ export const ProteseView: React.FC = () => {
                 description={modo === 'bancada' ? 'Fila de trabalhos do laboratório' : 'Ordens de serviço enviadas ao laboratório'}
             >
                 {modo === 'clinica' ? (
-                    <button onClick={() => setNovaOS(true)} className="flex items-center gap-2 bg-violet-600 text-white px-4 py-2 rounded-xl font-black text-sm uppercase">
-                        <Plus size={16} /> Nova OS
-                    </button>
+                    <>
+                        <button onClick={() => setCotacoesOpen(true)} className="flex items-center gap-2 border border-violet-200 text-violet-700 px-4 py-2 rounded-xl font-black text-sm uppercase hover:bg-violet-50"><FileText size={16} /> Cotações</button>
+                        <button onClick={() => setNovaOS(true)} className="flex items-center gap-2 bg-violet-600 text-white px-4 py-2 rounded-xl font-black text-sm uppercase"><Plus size={16} /> Nova OS</button>
+                    </>
                 ) : (
                     <>
                         <button onClick={() => setProdutosModal(true)} className="flex items-center gap-2 bg-violet-600 text-white px-4 py-2 rounded-xl font-black text-sm uppercase"><Tags size={16} /> Meus produtos</button>
@@ -467,6 +1091,10 @@ export const ProteseView: React.FC = () => {
                                     {modo === 'bancada' ? (os.paciente_nome || 'Sem paciente') : (os.protetico_nome || 'Laboratório')}
                                     {os.prazo_entrega ? ` · entrega ${dataBR(os.prazo_entrega)}` : ''}
                                 </p>
+                                {/* Clínica de origem: essencial quando o lab atende várias clínicas. */}
+                                {modo === 'bancada' && os.clinica_nome && (
+                                    <p className="text-[10px] font-black text-blue-600 uppercase truncate flex items-center gap-1"><Building2 size={10} /> {os.clinica_nome}</p>
+                                )}
                             </div>
                             <div className="flex items-center gap-2 shrink-0">
                                 {os.atrasada && <AlertTriangle size={14} className="text-red-500" />}
@@ -484,6 +1112,7 @@ export const ProteseView: React.FC = () => {
             {novaOS && <NovaOSModal onClose={() => setNovaOS(false)} onSaved={() => { setNovaOS(false); carregar(); }} />}
             {detalhe && <OSDetailModal id={detalhe} modo={modo} onClose={() => setDetalhe(null)} onChanged={carregar} />}
             {produtosModal && <ProdutosModal onClose={() => setProdutosModal(false)} />}
+            {cotacoesOpen && <CotacoesClinicaModal onClose={() => setCotacoesOpen(false)} onEscolhida={() => carregar()} />}
         </div>
     );
 };

frontend/views/SalaHomeView.tsx

@@ -1,5 +1,5 @@
 import React, { useState, useEffect, useCallback } from 'react';
-import { DoorOpen, Wallet, Clock, CalendarClock, CheckCircle, RefreshCw, MapPin, Inbox, BarChart3, Filter, ChevronLeft, ChevronRight, CalendarDays } from 'lucide-react';
+import { DoorOpen, Wallet, Clock, CalendarClock, CheckCircle, RefreshCw, MapPin, Inbox, BarChart3, Filter, ChevronLeft, ChevronRight, CalendarDays, Wrench, X } from 'lucide-react';
 import { HybridBackend } from '../services/backend.ts';
 import { useToast } from '../contexts/ToastContext.tsx';
 import { useConfirm } from '../contexts/ConfirmContext.tsx';
@@ -14,7 +14,7 @@ const H_INI = 7, H_FIM = 22, ROW_H = 40; // 07h–22h, 40px/hora
 const segOf = (d: Date) => { const x = new Date(d); const dow = (x.getDay() + 6) % 7; x.setHours(0, 0, 0, 0); x.setDate(x.getDate() - dow); return x; };
 const sameDay = (a: Date, b: Date) => a.getFullYear() === b.getFullYear() && a.getMonth() === b.getMonth() && a.getDate() === b.getDate();
 
-const AgendaSala: React.FC<{ reservas: any[] }> = ({ reservas }) => {
+const AgendaSala: React.FC<{ reservas: any[]; onBloquear?: () => void }> = ({ reservas, onBloquear }) => {
   const [weekStart, setWeekStart] = useState(() => segOf(new Date()));
   const dias = Array.from({ length: 7 }, (_, i) => { const d = new Date(weekStart); d.setDate(d.getDate() + i); return d; });
   const ativas = reservas.filter(r => r.status === 'pendente' || r.status === 'confirmada');
@@ -26,12 +26,17 @@ const AgendaSala: React.FC<{ reservas: any[] }> = ({ reservas }) => {
     if (!sameDay(ini, dia)) return null;
     const top = Math.max(0, (ini.getHours() + ini.getMinutes() / 60 - H_INI) * ROW_H);
     const height = Math.max(16, ((fim.getTime() - ini.getTime()) / 3600000) * ROW_H);
+    const manut = r.tipo === 'manutencao';
     const conf = r.status === 'confirmada';
+    const cls = manut ? 'bg-gray-200 border-gray-400 text-gray-700'
+      : conf ? 'bg-teal-100 border-teal-300 text-teal-800'
+      : 'bg-amber-100 border-amber-300 text-amber-800';
+    const legenda = manut ? (r.motivo || 'Manutenção') : (r.solicitante_nome || r.clinica_nome || 'Reserva');
     return (
-      <div key={r.id} className={`absolute left-0.5 right-0.5 rounded-md px-1 py-0.5 overflow-hidden border ${conf ? 'bg-teal-100 border-teal-300 text-teal-800' : 'bg-amber-100 border-amber-300 text-amber-800'}`}
-        style={{ top, height }} title={`${r.solicitante_nome || r.clinica_nome || ''} ${ini.toLocaleTimeString('pt-BR', { hour: '2-digit', minute: '2-digit' })}–${fim.toLocaleTimeString('pt-BR', { hour: '2-digit', minute: '2-digit' })}`}>
+      <div key={r.id} className={`absolute left-0.5 right-0.5 rounded-md px-1 py-0.5 overflow-hidden border ${cls}`}
+        style={{ top, height }} title={`${legenda} ${ini.toLocaleTimeString('pt-BR', { hour: '2-digit', minute: '2-digit' })}–${fim.toLocaleTimeString('pt-BR', { hour: '2-digit', minute: '2-digit' })}`}>
         <p className="text-[9px] font-black leading-tight truncate">{ini.toLocaleTimeString('pt-BR', { hour: '2-digit', minute: '2-digit' })}</p>
-        <p className="text-[9px] font-bold leading-tight truncate uppercase">{r.solicitante_nome || r.clinica_nome || 'Reserva'}</p>
+        <p className="text-[9px] font-bold leading-tight truncate uppercase">{legenda}</p>
       </div>
     );
   });
@@ -41,6 +46,11 @@ const AgendaSala: React.FC<{ reservas: any[] }> = ({ reservas }) => {
       <div className="px-6 py-4 border-b border-gray-100 bg-gray-50/50 flex items-center justify-between gap-3">
         <h3 className="text-sm font-black text-gray-800 uppercase flex items-center gap-2"><CalendarDays size={16} className="text-teal-600" /> Agenda da sala</h3>
         <div className="flex items-center gap-2">
+          {onBloquear && (
+            <button onClick={onBloquear} className="flex items-center gap-1.5 bg-gray-700 text-white px-3 py-1.5 rounded-lg font-black text-[10px] uppercase hover:bg-gray-800 transition-colors">
+              <Wrench size={12} /> Bloquear manutenção
+            </button>
+          )}
           <span className="text-[11px] font-black text-gray-500 uppercase">{label}</span>
           <button onClick={() => setWeekStart(d => { const x = new Date(d); x.setDate(x.getDate() - 7); return x; })} className="p-1.5 hover:bg-gray-100 rounded-lg text-gray-500"><ChevronLeft size={16} /></button>
           <button onClick={() => setWeekStart(segOf(new Date()))} className="text-[10px] font-black uppercase text-teal-600 hover:bg-teal-50 px-2 py-1.5 rounded-lg">Hoje</button>
@@ -82,6 +92,63 @@ const AgendaSala: React.FC<{ reservas: any[] }> = ({ reservas }) => {
       <div className="px-6 py-2 flex gap-4 text-[10px] font-bold text-gray-400 uppercase border-t border-gray-50">
         <span className="flex items-center gap-1.5"><span className="w-3 h-3 rounded bg-teal-200 border border-teal-300" /> Confirmada</span>
         <span className="flex items-center gap-1.5"><span className="w-3 h-3 rounded bg-amber-200 border border-amber-300" /> Pendente</span>
+        <span className="flex items-center gap-1.5"><span className="w-3 h-3 rounded bg-gray-200 border border-gray-400" /> Manutenção</span>
+      </div>
+    </div>
+  );
+};
+
+// Modal: bloquear a sala para manutenção (data + faixa de horário + motivo).
+const BloqueioModal: React.FC<{ onClose: () => void; onConfirm: (inicio: string, fim: string, motivo: string) => Promise<void> }> = ({ onClose, onConfirm }) => {
+  const toast = useToast();
+  const hojeYmd = new Date().toISOString().split('T')[0];
+  const [data, setData] = useState(hojeYmd);
+  const [hIni, setHIni] = useState('08:00');
+  const [hFim, setHFim] = useState('09:00');
+  const [motivo, setMotivo] = useState('');
+  const [saving, setSaving] = useState(false);
+
+  const salvar = async () => {
+    if (!data || !hIni || !hFim) { toast.error('PREENCHA DATA E HORÁRIOS.'); return; }
+    const inicio = new Date(`${data}T${hIni}`);
+    const fim = new Date(`${data}T${hFim}`);
+    if (fim <= inicio) { toast.error('O FIM DEVE SER DEPOIS DO INÍCIO.'); return; }
+    setSaving(true);
+    try { await onConfirm(inicio.toISOString(), fim.toISOString(), motivo.trim()); }
+    catch (e: any) { toast.error((e?.message || 'ERRO AO BLOQUEAR').toUpperCase()); }
+    finally { setSaving(false); }
+  };
+
+  return (
+    <div className="fixed inset-0 bg-black/60 z-50 flex items-center justify-center p-4 backdrop-blur-sm">
+      <div className="bg-white rounded-2xl shadow-2xl w-full max-w-sm">
+        <div className="flex items-center justify-between px-6 py-4 border-b border-gray-100">
+          <h3 className="font-black text-sm uppercase text-gray-800 flex items-center gap-2"><Wrench size={16} className="text-gray-600" /> Bloquear p/ manutenção</h3>
+          <button onClick={onClose} className="p-1.5 hover:bg-gray-100 rounded-lg"><X size={18} /></button>
+        </div>
+        <div className="p-6 space-y-4">
+          <div>
+            <label className="text-[10px] font-black text-gray-400 uppercase tracking-widest block mb-1.5">Data</label>
+            <input type="date" value={data} onChange={e => setData(e.target.value)} className="w-full bg-gray-50 border-2 border-gray-100 rounded-xl px-3 py-2.5 text-sm font-bold text-gray-700 outline-none focus:border-teal-400" />
+          </div>
+          <div className="grid grid-cols-2 gap-3">
+            <div>
+              <label className="text-[10px] font-black text-gray-400 uppercase tracking-widest block mb-1.5">Início</label>
+              <input type="time" value={hIni} onChange={e => setHIni(e.target.value)} className="w-full bg-gray-50 border-2 border-gray-100 rounded-xl px-3 py-2.5 text-sm font-bold text-gray-700 outline-none focus:border-teal-400" />
+            </div>
+            <div>
+              <label className="text-[10px] font-black text-gray-400 uppercase tracking-widest block mb-1.5">Fim</label>
+              <input type="time" value={hFim} onChange={e => setHFim(e.target.value)} className="w-full bg-gray-50 border-2 border-gray-100 rounded-xl px-3 py-2.5 text-sm font-bold text-gray-700 outline-none focus:border-teal-400" />
+            </div>
+          </div>
+          <div>
+            <label className="text-[10px] font-black text-gray-400 uppercase tracking-widest block mb-1.5">Motivo (opcional)</label>
+            <input value={motivo} onChange={e => setMotivo(e.target.value)} placeholder="Ex.: limpeza, conserto do equipo..." className="w-full bg-gray-50 border-2 border-gray-100 rounded-xl px-3 py-2.5 text-sm text-gray-700 outline-none focus:border-teal-400" />
+          </div>
+          <button onClick={salvar} disabled={saving} className="w-full bg-gray-700 text-white py-3 rounded-xl font-black text-sm uppercase hover:bg-gray-800 disabled:opacity-50 flex items-center justify-center gap-2">
+            {saving ? <RefreshCw size={16} className="animate-spin" /> : <Wrench size={16} />} Bloquear sala
+          </button>
+        </div>
       </div>
     </div>
   );
@@ -92,9 +159,12 @@ export const SalaHomeView: React.FC = () => {
   const toast = useToast();
   const confirm = useConfirm();
   const ws: any = HybridBackend.getActiveWorkspace();
+  // Operador (ex.: recepção): só vê a AGENDA e bloqueia manutenção — sem locação/financeiro.
+  const isOperador = ws?.papel_sala === 'operador';
   const [lancamentos, setLancamentos] = useState<any[]>([]);
   const [reservas, setReservas] = useState<{ feitas: any[]; recebidas: any[] }>({ feitas: [], recebidas: [] });
   const [loading, setLoading] = useState(false);
+  const [bloqueioOpen, setBloqueioOpen] = useState(false);
   // Relatório por sala (período)
   const hoje = new Date();
   const [inicio, setInicio] = useState(new Date(hoje.getFullYear(), hoje.getMonth(), 1).toISOString().split('T')[0]);
@@ -105,17 +175,25 @@ export const SalaHomeView: React.FC = () => {
   const carregar = useCallback(async () => {
     setLoading(true);
     try {
+      if (isOperador) {
+        // Operador não tem acesso ao financeiro/recebíveis: carrega só a agenda da sala.
+        const rs = await HybridBackend.getSalaReservas(ws.id);
+        setLancamentos([]);
+        setReservas({ feitas: [], recebidas: (Array.isArray(rs) ? rs : []).map((r: any) => ({ ...r, sala_id: ws.id })) });
+      } else {
         const [fin, res] = await Promise.all([HybridBackend.getFinanceiro(), HybridBackend.getMinhasReservas()]);
         setLancamentos(Array.isArray(fin) ? fin : []);
         setReservas(res && res.recebidas ? res : { feitas: [], recebidas: [] });
+      }
     } catch { /* silent */ } finally { setLoading(false); }
-  }, []);
+  }, [isOperador, ws?.id]);
   useEffect(() => { carregar(); }, [carregar]);
 
   const carregarRel = useCallback(() => {
+    if (isOperador) { setRel(null); return; }
     setRelLoading(true);
     HybridBackend.getSalasRelatorio(inicio, fim).then(setRel).catch(() => setRel(null)).finally(() => setRelLoading(false));
-  }, [inicio, fim]);
+  }, [inicio, fim, isOperador]);
   useEffect(() => { carregarRel(); }, [carregarRel]);
 
   const recebido = lancamentos.filter(l => l.status === 'Pago').reduce((s, l) => s + Number(l.valor), 0);
@@ -124,6 +202,13 @@ export const SalaHomeView: React.FC = () => {
   const pendentes = reservasDaSala.filter(r => r.status === 'pendente').length;
   const confirmadas = reservasDaSala.filter(r => r.status === 'confirmada').length;
 
+  const bloquearManutencao = async (inicio: string, fim: string, motivo: string) => {
+    await HybridBackend.criarManutencaoSala(ws.id, { inicio, fim, motivo });
+    toast.success('SALA BLOQUEADA PARA MANUTENÇÃO.');
+    setBloqueioOpen(false);
+    carregar();
+  };
+
   const darBaixa = async (l: any) => {
     if (!await confirm(`MARCAR como RECEBIDO ${fmtBRL(l.valor)} de "${l.descricao}"?`)) return;
     try {
@@ -160,15 +245,16 @@ export const SalaHomeView: React.FC = () => {
 
       {loading ? <div className="flex justify-center py-16"><RefreshCw className="animate-spin text-teal-600" size={28} /></div> : (
         <>
-          <div className="grid grid-cols-2 lg:grid-cols-4 gap-4">
-            <KPI titulo="Recebido" valor={fmtBRL(recebido)} cor="text-green-600" Icon={Wallet} sub="Locações pagas" />
-            <KPI titulo="A receber" valor={fmtBRL(aReceber)} cor="text-amber-500" Icon={Clock} sub="Pendentes" />
+          <div className={`grid grid-cols-2 ${isOperador ? 'lg:grid-cols-2' : 'lg:grid-cols-4'} gap-4`}>
+            {!isOperador && <KPI titulo="Recebido" valor={fmtBRL(recebido)} cor="text-green-600" Icon={Wallet} sub="Locações pagas" />}
+            {!isOperador && <KPI titulo="A receber" valor={fmtBRL(aReceber)} cor="text-amber-500" Icon={Clock} sub="Pendentes" />}
             <KPI titulo="Reservas pendentes" valor={String(pendentes)} cor="text-red-500" Icon={Inbox} sub="Aguardando resposta" />
             <KPI titulo="Reservas confirmadas" valor={String(confirmadas)} cor="text-teal-600" Icon={CalendarClock} sub="Nesta sala" />
           </div>
 
-          <AgendaSala reservas={reservasDaSala} />
+          <AgendaSala reservas={reservasDaSala} onBloquear={() => setBloqueioOpen(true)} />
 
+          {!isOperador && (<>
           <div className="bg-white rounded-2xl border border-gray-100 shadow-sm overflow-hidden">
             <div className="px-6 py-4 border-b border-gray-100 bg-gray-50/50 flex justify-between items-center">
               <h3 className="text-sm font-black text-gray-800 uppercase">Recebíveis de locação</h3>
@@ -240,8 +326,10 @@ export const SalaHomeView: React.FC = () => {
               </div>
             )}
           </div>
+          </>)}
         </>
       )}
+      {bloqueioOpen && <BloqueioModal onClose={() => setBloqueioOpen(false)} onConfirm={bloquearManutencao} />}
     </div>
   );
 };