BeautyHubDocumentación técnica

Plataforma marketplace + SaaS para servicios de belleza en Colombia

Ver arquitectura

PRD Principal

Dominios →

🔐

auth · authz

Identidad con JWT + autorización ReBAC con OpenFGA. Schema con tuples de estado y intersecciones nativas.

Ver authz →

🏢

accounts

Account, Business, Branch, Professional y membresías. Patrón CTI para profesionales y colaboradores.

Ver accounts →

📋

catalog

ServiceTemplate → ProfessionalService → BranchService con flujo de aprobación entre profesional y dueño.

Ver catalog →

📅

scheduling

Horarios y bloques de sede, ausencias del profesional. API interna pura — sin conocimiento de bookings.

Ver scheduling →

📌

booking

Núcleo transaccional. Reservas con precio congelado, EXCLUDE GIST para overlaps, disponibilidad real.

Ver booking →

🔍

discovery

Índices Postgres + PostGIS para búsqueda geoespacial, full-text y filtros. Read model puro.

Ver discovery →

⭐

reviews

Reputación portable del profesional. Las reseñas siguen al profesional, no a la sede.

Ver reviews →

🔔

notifications

Push · Email · SMS con idempotencia estricta, quiet hours, categorías y override para eventos críticos.

Ver notifications →

💳

billing

Pagos con Wompi. authorize → capture(total) + refund(exceso). Ledger de doble entrada. Payouts semanales.

Ver billing →

Estado de los PRDs

Dominio	Estado	Descripción
01 · auth	✅ Listo	Identidad, sesiones, OTP
02 · authz	✅ Listo	ReBAC + OpenFGA, tuples de estado
03 · accounts	✅ Listo	Cuentas, negocios, membresías
04 · catalog	✅ Listo	Servicios con aprobación
05 · scheduling	✅ Listo	Horarios y disponibilidad
06 · booking	✅ Listo	Reservas, GIST overlap, disponibilidad
07 · discovery	✅ Listo	Búsqueda geoespacial
08 · reviews	✅ Listo	Reputación portable
09 · notifications	✅ Listo	Push · Email · SMS
10 · billing	✅ Listo	Pagos · Comisiones · Payouts

Stack tecnológico

Capa	Tecnología
Backend	Go (modular monolith)
Autorización	OpenFGA (ReBAC)
Base de datos	PostgreSQL + PostGIS
Búsqueda	Postgres tsvector + GIST
Eventos	domain_events + LISTEN/NOTIFY
Consumer App	React Native / Expo
Business App	React Native / Expo
Web Admin	React
Infra	VPS + Docker Compose