Scheduling API
API de agendamento para entrega de produtos: fornecedor marca horário com o funcionário, com verificação de disponibilidade e conflito — não com planilha.
- 2025
- API backend
- publicada
- Go · Gin · PostgreSQL · JWT
o problema
Agendar entrega de fornecedor costuma acabar em planilha compartilhada ou mensagem no grupo. O resultado é previsível: dois fornecedores no mesmo horário, funcionário que não está disponível, e nenhum histórico de quem marcou o quê.
Do lado de quem constrói, o problema interessante não é guardar a data — é decidir se aquele horário pode existir antes de aceitá-lo, com regra de acesso por papel e sem espalhar essa lógica pelas rotas.
a abordagem
A API é em Go com Gin e GORM sobre PostgreSQL, autenticação por JWT e controle de acesso por papel. A verificação de disponibilidade e a detecção de conflito acontecem na camada de regra, antes de qualquer escrita — o handler não decide nada sozinho.
O desenho segue arquitetura em camadas de propósito: as regras de agendamento ficam testáveis isoladamente, que é onde a maior parte dos erros costuma nascer.
estado hoje
API publicada no GitHub, com autenticação, agendamento com detecção de conflito, disponibilidade, gestão de compromissos e endpoints de estatística e relatório.