scoreodonto.com/doc/AGENDA-COLETA-LAB.md

Agenda & Coleta do laboratório

Desenho + implementação (24/jun/2026). Gap apontado na auditoria: o lab não tem agenda de produção nem coleta logística (só "próximas entregas" por prazo e custódia de posse).

Conceito

• Coleta = o lab busca o trabalho na clínica (trabalho vai p/ o laboratório).
• Entrega = o lab leva o trabalho de volta (trabalho volta p/ a clínica).
• Cada agendamento tem data/hora, endereço, responsável, observação e status (agendada | realizada | cancelada). Ligado a uma OS.
• Integra com a custódia: ao marcar realizada, a custódia muda automaticamente (coleta→laboratorio, entrega→clinica) e entra no histórico da OS. Sem dado duplicado.

Modelo

CREATE TABLE protese_coleta (
  id TEXT PRIMARY KEY,
  os_id TEXT NOT NULL,
  clinica_id TEXT,
  laboratorio_id TEXT,
  protetico_id TEXT,
  tipo TEXT NOT NULL,            -- coleta | entrega
  data_hora TIMESTAMPTZ,
  endereco TEXT,
  responsavel TEXT,
  observacao TEXT,
  status TEXT DEFAULT 'agendada', -- agendada | realizada | cancelada
  created_by TEXT,
  created_at TIMESTAMPTZ DEFAULT NOW()
);

Endpoints

• POST /api/protese/os/:id/coleta — agenda (clínica ou lab).
• GET /api/protese/lab/agenda — coletas/entregas do lab (cronológica) + próximas entregas por prazo.
• POST /api/protese/coleta/:id/status — realizada (move a custódia) | cancelada.
• GET detalhe da OS passa a trazer coletas[].

UI

• Lab — tela Agenda (lab-agenda, novo item de menu): linha do tempo de coletas/entregas agendadas + entregas previstas (prazo da OS), com ação "marcar realizada".
• OS (aba Monitoramento) — agendar coleta/entrega ao lado da custódia (mesmo contexto físico).

Decisões

• 1 coleta por OS (MVP). Agrupar várias OS numa rota/motoboy fica como evolução.
• realizada é a fonte única do movimento físico (atualiza custódia) — evita registrar custódia e coleta em separado.