📄 CatalogQR – Arquitectura del Sistema
Este documento detalla la infraestructura tecnológica y la lógica de segmentación de la plataforma CatalogQR.
🏗️ Modelo Multi-tenant Agnóstico
La arquitectura ha sido diseñada para soportar el aislamiento total de datos entre diferentes unidades de negocio (Comercios) sin importar su sector.
1. Capa de Datos (Supabase)
- Row Level Security (RLS): Cada consulta SQL se filtra automáticamente mediante el
business_idoowner_id. - Agnosticismo de Esquema: Las tablas de productos y servicios utilizan estructuras genéricas que permiten almacenar desde SKUs de retail hasta descripciones de servicios profesionales.
2. Capa de Aplicación (SvelteKit)
- Rutas Dinámicas: Uso de
slugspara la generación de portales de catálogo públicos. - Gestión de Estados: Runes de Svelte 5 para una reactividad de alto rendimiento en tableros de gestión.
3. Niveles de Acceso
- Staff Core: Administración de la infraestructura SaaS.
- Merchant Layer: Panel de control del negocio (CRUD de catálogos y gestión de órdenes).
- Public Gateway: Interfaz optimizada para el consumidor final vía QR.