pular para o conteúdo

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.

ano
2025
área
API backend
estado
publicada
stack
Go · Gin · PostgreSQL · JWT

Scheduling API ver código

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.

a seguir: PsyPredict