Servicentos

Problema

Hoje quem procura manicure, cabeleireiro ou esteticista busca no Instagram, combina pelo WhatsApp, paga de forma manual e decide por indicação. Para o profissional, a agenda vive no caderno e o cliente que falta não deixa rastro.

Solução

• Cliente: busca com filtros e ordenação por proximidade, perfil e portfólio do profissional, agendamento, chat por agendamento e avaliação.
• Profissional: onboarding, agenda própria, lista de espera, controle de no-show e cancelamento com aviso à outra parte, e resposta às avaliações.
• Modelo de negócio sem comissão: o cliente paga direto ao profissional via PIX, e a receita vem do plano Profissional (R$ 39,90/mês, com 30 dias de teste).

Papel

Projeto próprio, feito sozinho: produto, modelagem, API, frontend, pagamentos, segurança, infraestrutura e testes.

Arquitetura

• API: FastAPI com SQLAlchemy 2 assíncrono, Pydantic v2 e Alembic, com REST e WebSocket.
• Banco: PostgreSQL com PostGIS para busca por localização, índices e constraints como agendamento único por horário.
• Filas e cache: Redis e worker Celery para tarefas fora da requisição.
• Frontend: Next.js e TypeScript, com TanStack Query, Zod e Tailwind CSS, SEO e páginas legais.
• Integrações: Stripe para assinaturas, Firebase Cloud Messaging para push e login com Google.

Decisões técnicas

• A comissão por transação foi trocada por assinatura do prestador: elimina repasse financeiro, reembolso e retenção, e deixa a receita previsível.
• Uma única regra de visibilidade: o prestador aparece se e somente se a assinatura está em dia. O status detalhado é só informativo.
• Webhooks do Stripe idempotentes, com pagamento que nunca reduz o vencimento e eventos de assinaturas antigas ignorados.
• Pagamento do serviço direto ao profissional, confirmado por ele no app, sem a plataforma tocar no dinheiro.

Segurança e LGPD

• Blacklist de token no logout, sessões revogadas após troca de senha e WebSocket que rejeita conta inativa ou token revogado.
• Rate limiting em login, busca, upload e recuperação de senha, cabeçalhos de segurança e logs sem dados sensíveis.
• Uploads validados pelo tipo real do arquivo, correção de XSS no chat e escape de HTML nos e-mails.
• Exportação e exclusão de conta pelo próprio usuário, e leitura de chat pelo admin só com motivo registrado em auditoria.

Engenharia de produção

• Stack de produção com Caddy e HTTPS, containers sem root, healthchecks, limites de recursos e rotação de logs.
• Scripts de deploy, rollback, smoke test, backup e restauração, com runbook documentado.
• CI no GitHub Actions com lint, migrações em banco limpo, testes, build do frontend e das imagens e auditoria de dependências.
• Testes ponta a ponta no navegador cobrindo assinatura, agendamento, PIX, cadastro de prestador, autenticação e painel admin.

Números

• 153 commits, de março a outubro de 2026.
• 25 migrações de banco versionadas.
• Cobertura mínima de 70% exigida pelo pytest no CI.
• 8 fluxos principais testados de ponta a ponta.

Stack

• Python
• FastAPI
• PostgreSQL
• PostGIS
• Redis
• Celery
• Stripe
• Next.js
• TypeScript
• Docker
• Caddy