Barber App

Plataforma de agendamento para barbearias com dois perfis de usuário: clientes (que buscam e agendam horários) e barbeiros (que gerenciam sua agenda, serviços e horários de funcionamento).

Estrutura do Repositório

barber-app/
├── barber-app-backend/   # API REST (Fastify + PostgreSQL)
├── barber-app-frontend/  # Web app (Next.js + React)
└── scripts/

Funcionalidades

Cliente

• Cadastro e login
• Busca e visualização de barbearias
• Agendamento de serviços com seleção de data e horário
• Visualização e cancelamento de agendamentos

Barbeiro

• Cadastro de barbearia e serviços
• Configuração de horários de funcionamento e pausas
• Painel com resumo do dia
• Agenda de atendimentos com atualização de status

Pré-requisitos

• Node.js 22+
• Docker (para PostgreSQL em desenvolvimento local)

Início Rápido

1. Backend

cd barber-app-backend

# Suba o banco de dados
docker compose up -d

# Crie o arquivo .env
cat > .env << 'EOF'
PORT=3333
DATABASE_URL="postgresql://docker:docker@localhost:5432/barber-app"
JWT_SECRET_KEY="barber-app-secret"
BASE_URL="http://localhost:3333"
EOF

# Gere as migrations, aplique e sincronize o schema
npx drizzle-kit generate
npx drizzle-kit migrate
npx drizzle-kit push

# Popule o banco com dados de exemplo
npm run seed

# Inicie o servidor
npm run dev
# API disponível em http://localhost:3333
# Docs Swagger em http://localhost:3333/docs

2. Frontend

cd barber-app-frontend

# Crie o arquivo .env.local
cat > .env.local << 'EOF'
NEXT_PUBLIC_BACKEND_URL=http://localhost:3333
EOF

# Instale as dependências e inicie
npm install
npm run dev
# App disponível em http://localhost:3000

Stack

Camada	Tecnologia
Frontend	Next.js 16, React 19, TypeScript
Estilização	Tailwind CSS 4
Estado	Zustand + TanStack React Query
Backend	Fastify 5, Node.js 22, TypeScript
Banco	PostgreSQL 16+ com Drizzle ORM
Auth	JWT
Deploy	Vercel

Documentação

• Backend →
• Frontend →