3R
Barber

O Desafio

Sistema de agendamento pronto não falta no mercado — o problema é que todos cobram mensalidade. Eu precisava entregar reserva pública, fila em tempo real e dashboard com métricas sem custo de infraestrutura, mantendo o horário certo entre fusos e isolando de verdade o acesso de cada papel:

• / Converter corretamente horários de funcionamento em BRT para timestamps UTC na geração de slots de agendamento.
• / Suportar agendamentos com 'qualquer barbeiro', onde o primeiro a atender ganha o cliente, sem gerar conflitos de concorrência.
• / Isolar dados por papel (client/barber/admin) garantindo que um barbeiro só acesse a própria fila e agenda.
• / Evitar agendamentos duplicados por reenvio de formulário (duplo clique, retry de rede) sem exigir conta do cliente.

A Solução

A API roda em Hono no Cloudflare Worker, Drizzle sobre D1, toda mutação validada por Zod. Autenticação e RBAC ficam com o Better Auth. Toda rota de barbeiro busca primeiro o próprio registro pelo usuário logado — um barbeiro não acessa a agenda de outro. A conversão BRT→UTC fica num único helper no backend. Reserva duplicada (duplo clique, retry de rede) é barrada na aplicação e reforçada por um índice único no banco.

// Slot generation: BRT hora + 3 = UTC hora
const BRT_TO_UTC_H = 3;

export function getDayBounds(dateBRT: string) {
  const [y, m, d] = dateBRT.split("-").map(Number);
  const startTs = Date.UTC(y, m - 1, d, BRT_TO_UTC_H, 0) / 1000;
  const endTs = startTs + 24 * 60 * 60 - 1;
  return { startTs, endTs };
}