Servicentos

Problema

Hoy, quien busca manicurista, peluquero o esteticista lo hace en Instagram, coordina por WhatsApp, paga a mano y elige por recomendación. Para el profesional, la agenda vive en un cuaderno y el cliente que no aparece no deja rastro.

Solución

• Cliente: búsqueda con filtros y orden por cercanía, perfil y portafolio del profesional, reserva, chat por reserva y reseña.
• Profesional: onboarding, agenda propia, lista de espera, control de no-show y cancelación con aviso a la otra parte, y respuesta a las reseñas.
• Modelo de negocio sin comisión: el cliente paga directamente al profesional por PIX (el pago instantáneo de Brasil), y los ingresos vienen del plan Profesional (R$ 39,90/mes, con 30 días de prueba).

Rol

Producto propio, hecho en solitario: producto, modelado de datos, API, frontend, pagos, seguridad, infraestructura y pruebas.

Arquitectura

• API: FastAPI con SQLAlchemy 2 asíncrono, Pydantic v2 y Alembic, con REST y WebSocket.
• Base de datos: PostgreSQL con PostGIS para la búsqueda por ubicación, índices y restricciones como una reserva por horario.
• Colas y caché: Redis y un worker Celery para tareas fuera de la solicitud.
• Frontend: Next.js y TypeScript, con TanStack Query, Zod y Tailwind CSS, SEO y páginas legales.
• Integraciones: Stripe para suscripciones, Firebase Cloud Messaging para push e inicio de sesión con Google.

Decisiones técnicas

• La comisión por transacción se cambió por una suscripción del profesional: sin repasos, reembolsos ni retenciones que gestionar, y con ingresos previsibles.
• Una sola regla de visibilidad: el profesional aparece si y solo si su suscripción está al día. El estado detallado es solo informativo.
• Webhooks de Stripe idempotentes, donde un pago nunca acorta el vencimiento y se ignoran los eventos de suscripciones antiguas.
• El pago del servicio va directo al profesional, que lo confirma en la app, sin que la plataforma toque el dinero.

Seguridad y LGPD

• Lista negra de tokens al cerrar sesión, sesiones revocadas tras cambiar la contraseña y un WebSocket que rechaza cuentas inactivas o tokens revocados.
• Rate limiting en login, búsqueda, uploads y recuperación de contraseña, cabeceras de seguridad y logs sin datos sensibles.
• Uploads validados por el tipo real del archivo, corrección de XSS en el chat y escape de HTML en los correos.
• Exportación y eliminación de la cuenta por el propio usuario, y lectura de chats por el admin solo con un motivo registrado en la auditoría.

Ingeniería de producción

• Stack de producción con Caddy y HTTPS, contenedores sin root, healthchecks, límites de recursos y rotación de logs.
• Scripts de deploy, rollback, smoke test, backup y restauración, con runbook documentado.
• CI en GitHub Actions con lint, migraciones en una base limpia, pruebas, build del frontend y de las imágenes y auditoría de dependencias.
• Pruebas de punta a punta en el navegador que cubren suscripción, reservas, PIX, registro de profesionales, autenticación y panel de administración.

Números

• 153 commits, de marzo a octubre de 2026.
• 25 migraciones de base de datos versionadas.
• Cobertura mínima del 70% exigida por pytest en el CI.
• 8 flujos principales probados de punta a punta.

Stack

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