✨ L-SPA Web (Monorepo)

Plataforma integral para la gestión de servicios de Spa de lujo, migrada a una arquitectura de Monorepo moderna usando SvelteKit y Hono.

🚀 Características Principales

• 🔐 Autenticación Robusta: Sistema gestionado por Better Auth con integración de Dashboard (Infra).
• 📅 Gestión de Citas: Motor de reservas interactivo con Svelte 5 Runes.
• 🛒 Experiencia E-commerce: Catálogo dinámico de servicios, carrito de compras persistente y flujo de checkout.
• 🎨 UI Moderna: Interfaz de alto nivel con Tailwind CSS 4 y Svelte 5.
• 🎨 UI Moderna: Interfaz de alto nivel con Tailwind CSS 4 y Svelte 5.
• ⚡ Arquitectura Decoupled: Frontend en SvelteKit y Backend API pura en Hono.
• 🗄️ Persistencia de Datos: Integración con PostgreSQL vía Drizzle ORM.

🛠️ Stack Tecnológico

Monorepo (Bun Workspaces)

• Runtime: Bun
• Frontend: SvelteKit 2 + Svelte 5 (Runes), TanStack Query, Lucide Svelte, Tailwind CSS.
• Backend: Hono API Framework + Better Auth (Drizzle Adapter).
• Base de Datos: PostgreSQL (Neon), Drizzle ORM.

🏗️ Estructura del Proyecto

├── apps/
│   ├── backend/       # API REST con Hono y Better Auth
│   └── frontend/      # SvelteKit 5 (Runes) + Tailwind CSS
├── packages/
│   ├── database/      # Drizzle ORM Schema & Migrations (Neon DB)
│   └── shared-types/  # Tipos TypeScript compartidos entre apps
└── drizzle/           # Archivos de migración SQL

🚀 Inicio Rápido

Asegúrate de tener Bun instalado.

1. Instalar dependencias:

   bun install
   

2. Configuración de Variables de Env: Crea un .env en la raíz con:

   • DATABASE_URL: Tu conexión a Neon DB.
   • BETTER_AUTH_SECRET: Secreto para encriptación.
   • BETTER_AUTH_URL: http://localhost:3000 (Backend URL).

3. Desarrollo: Lanza el backend y el frontend simultáneamente:

   # Desde la raíz (inicia backend y frontend)
   bun run dev
   

   También puedes ejecutar por separado:

   # Frontend (desde su carpeta)
   cd apps/frontend && bun run dev
   
   # Backend (modo hot reload)
   bun run dev:backend:root
   

4. Base de Datos:

   • Empujar cambios: bun run db:push
   • Drizzle Studio: bun run db:studio

© 2026 L-SPA. Todos los derechos reservados.

• Auth: Better Auth
• Database: Drizzle ORM + PostgreSQL
• Estilos: Tailwind CSS 4

📂 Estructura del Monorepo

apps/
├── frontend/     # SvelteKit 5 App (SSR & Client)
├── backend/      # Hono API Server
packages/
├── database/     # Esquemas de Drizzle y cliente DB común
├── shared-types/ # Tipos TyperScript compartidos entre apps

🛠️ Instalación y Desarrollo

Este proyecto utiliza Bun Workspaces.

# Instalar dependencias
bun install

# Levantar todo el monorepo en desarrollo (desde la raíz)
bun run dev

# Levantar aplicaciones específicas
# Frontend
cd apps/frontend && bun run dev

# Backend (modo hot reload)
bun run dev:backend:root

📝 Notas de Migración

Este proyecto se encuentra en una fase de migración de una base de código React monolitica a este monorepo basado en micro-monolitos. La lógica original se encuentra en el directorio raíz (temporalmente) mientras se extrae a los nuevos servicios en apps/.

├── db/ # Configuración de Drizzle y Schemas SQL ├── features/ # Módulos por dominio (auth, booking, catalog, admin) ├── lib/ # Utilidades y librerías (Cloudinary, etc.) ├── models/ # Interacción directa con servicios/BBDD └── types/ # Definiciones de tipos TypeScript globales

---

## ⚙️ Configuración del Entorno

1. **Clonar el repositorio:**
   ```bash
   git clone https://github.com/tu-usuario/L-SPA.git
   cd L-SPA

2. Instalar dependencias:

   bun install
   

3. Variables de Entorno: Crea un archivo .env basado en .env.example:

   DATABASE_URL=...
   CLOUDINARY_CLOUD_NAME=...
   CLOUDINARY_API_KEY=...
   CLOUDINARY_API_SECRET=...
   AUTH0_DOMAIN=...
   AUTH0_CLIENT_ID=...
   

🛠️ Scripts Disponibles

👤 Autor

• Juan Camacho

📄 Licencia

Este proyecto está bajo la licencia MIT.

Desarrollado con ❤️ usando Bun y Svelte 5.