Guia: operando o pátio
Passo a passo para configurar e operar o módulo YMS — do cadastro do pátio ao gate-out, com agendamentos, portaria e operações na doca.
Vá em Pátios e crie um novo pátio com nome, código, cidade e UF. Em seguida, cadastre as docas (loading, unloading ou both) e — se quiser — slots de staging/parking.
Cada doca pode estar disponível, ocupada ou em manutenção. A ocupação é gerenciada automaticamente quando você atribui veículos pela portaria.
Em Agenda, crie janelas vinculando — ou não — a um frete existente. Walk-ins (sem frete) são permitidos para operações eventuais.
Cada agendamento gera um QR token único: o motorista pode abrir /portaria/checkin/<token> sem precisar de login.
Em Portaria, registre o gate-in (placa, motorista, lacre). A tela atualiza em tempo real (badge "Live") graças ao Realtime do Supabase.
- Atribua a doca disponível diretamente do card.
- O status da doca passa para "ocupada" automaticamente.
- Ao registrar o gate-out, a doca volta para "disponível" e o frete vinculado (se houver, modo inbound) muda para entregue.
No detalhe da visita, inicie a operação quando o veículo encostar na doca. Registre divergências (avarias, faltas, sobras) e observações antes de concluir. Cada operação fica no histórico para auditoria.
O motor de regras conhece três triggers do pátio:
when_appointment_created— ex.: notificar motorista no WhatsApp.when_visit_gate_in— ex.: avisar conferente quando chegar carga perigosa.when_dwell_exceeds_threshold— ex.: alertar gestor se permanência > 120 min.
Os mesmos eventos saem por webhook: yard.appointment.created,yard.gate.checked_in, yard.dock.operation.completed eyard.visit.completed.
Conceitos e modelo de dados: /docs/yms.