⚙️ Stack tecnológico
El ecosistema de FixBoard ofrece rendimiento, seguridad y escalabilidad en un entorno SaaS multi-tenant.
🧱 Componentes principales
| Capa | Tecnología / Servicio | Descripción |
|---|---|---|
| Frontend | Vue 3 + Vite + Tailwind CSS | Aplicación SPA rápida, modular y optimizada. |
| Backend / BBDD | Supabase (PostgreSQL + Auth + Storage + RLS) | Gestión de datos, autenticación y seguridad. |
| Despliegue | Cloudflare Pages | Hosting estático con CDN global y previews automáticos. |
| Control de versiones | GitLab + GitFlow | Flujo basado en ramas (main, develop, feature/*). |
| Automatización | GitLab CI + n8n | Integraciones, tareas programadas y notificaciones. |
| Analítica | Tablas de eventos + vistas SQL | Métricas de uso y rendimiento por tenant. |
| Documentación | Markdown + VitePress | Documentación técnica y funcional versionada. |
🧩 Dependencias principales
Frontend
vue— framework principal.vite— bundler rápido.tailwindcss— utilidades CSS.@supabase/supabase-js— cliente oficial Supabase.pinia— estado global.vue-router— enrutamiento SPA.
Backend (Supabase)
- PostgreSQL 15+
- Supabase Auth (JWT con
tenant_idyrole) - Supabase Storage
- RLS en tablas del esquema
public - Funciones y triggers SQL
🚀 Flujo de desarrollo
- Rama
feature/<nombre>desdedevelop. - Código + documentación en el MR.
- GitLab CI ejecuta tests/build.
- Cloudflare Pages crea preview.
- Merge a
developomaintras aprobación.
🧠 Requisitos mínimos
| Entorno | Versión |
|---|---|
| Node.js | 20.x |
| NPM | 10.x |
| Supabase CLI | ≥ 1.150 |
| VitePress | ≥ 1.3 |
| PostgreSQL | ≥ 15 |
🔒 Buenas prácticas
- Mantener dependencias actualizadas.
- Nunca exponer
service_roleen el frontend. - Usar
VITE_SUPABASE_URLyVITE_SUPABASE_ANON_KEY. - Activar RLS en todas las tablas del esquema
public. - Validar JWTs antes de acciones sensibles.