rckrdmrd
ea1879f4ad
- Configure workspace Git repository with comprehensive .gitignore - Add Odoo as submodule for ERP reference code - Include documentation: SETUP.md, GIT-STRUCTURE.md - Add gitignore templates for projects (backend, frontend, database) - Structure supports independent repos per project/subproject level Workspace includes: - core/ - Reusable patterns, modules, orchestration system - projects/ - Active projects (erp-suite, gamilit, trading-platform, etc.) - knowledge-base/ - Reference code and patterns (includes Odoo submodule) - devtools/ - Development tools and templates - customers/ - Client implementations template 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
200 lines
5.5 KiB
Markdown
200 lines
5.5 KiB
Markdown
# EXT-008: White-label System (Tier 1)
|
|
|
|
> **⚠️ BACKLOG - FUERA DEL MVP**
|
|
>
|
|
> Esta épica está **parcialmente implementada (30%)** y **NO forma parte del MVP actual**.
|
|
> Razón: Depende de contratos enterprise.
|
|
> Ver: [Fase 4: Backlog](../../04-fase-backlog/README.md)
|
|
|
|
**Versión:** 1.0
|
|
**Fecha de creación:** 2025-11-07
|
|
**Prioridad:** P2 (Promovida desde P3)
|
|
**Story Points:** 20 SP
|
|
**Presupuesto:** $3,000 USD
|
|
**Timeline:** v1.5 (Semanas 25-32)
|
|
**Estado:** ⏳ BACKLOG (30% implementado)
|
|
|
|
---
|
|
|
|
## 📋 Descripción
|
|
|
|
Sistema de personalización de marca (white-label) **Tier 1 Básico** que permite a instituciones enterprise personalizar la plataforma GAMILIT con su propia identidad visual: logo, colores corporativos, nombre de plataforma y favicon.
|
|
|
|
**Tiers del sistema completo:**
|
|
- **Tier 1 (Básico):** Logo, colores, nombre, favicon - **20h (Esta épica)**
|
|
- Tier 2 (Avanzado): Dominio custom, emails, login page - 40h adicionales (v2.0+)
|
|
- Tier 3 (Completo): Fonts, CSS custom, ocultar branding GAMILIT- 60h adicionales (v2.0+)
|
|
|
|
---
|
|
|
|
## 🎯 Objetivos de Negocio
|
|
|
|
### Problema a Resolver
|
|
Instituciones enterprise requieren que la plataforma refleje su identidad corporativa:
|
|
- Logo institucional (no logo GAMILIT
|
|
- Colores de la universidad/colegio
|
|
- Nombre personalizado ("Portal Educativo Universidad X" vs "GAMILIT Platform")
|
|
|
|
### Valor Esperado
|
|
- **Enterprise pricing:** 3-5x vs plan institucional estándar
|
|
- **Churn reduction:** -15% (mayor apropiación institucional)
|
|
- **ARR incremental:** +$12,000/año
|
|
- **ROI:** 400% en año 1
|
|
|
|
### Pricing
|
|
- **Plan Pro:** $1,500/mes (Tier 1 white-label incluido)
|
|
- **Plan Enterprise:** $5,000/mes (Tier 1 + 2 + 3)
|
|
|
|
### Métricas de Éxito
|
|
- **Adoption:** >30% instituciones grandes usan white-label
|
|
- **Upgrade rate:** 20% instituciones básicas → Pro
|
|
- **Churn:** <8% (vs 10% plan básico)
|
|
|
|
---
|
|
|
|
## 🏗️ Arquitectura Técnica
|
|
|
|
### Componentes
|
|
|
|
1. **Tenant Branding Table (DB)**
|
|
- Schema: `system_configuration.tenant_branding`
|
|
- Almacena configuración por tenant
|
|
|
|
2. **Branding Service (Backend)**
|
|
- API para CRUD de configuración
|
|
- Endpoint público para obtener branding por domain
|
|
|
|
3. **WhiteLabelProvider (Frontend)**
|
|
- React Context Provider
|
|
- Aplica branding dinámicamente en carga
|
|
|
|
4. **Logo Storage**
|
|
- S3 / Cloudinary para archivos
|
|
- URLs públicas para logos/favicons
|
|
|
|
### Stack Tecnológico
|
|
|
|
**Backend:**
|
|
- NestJS + TypeScript
|
|
- PostgreSQL (tabla `tenant_branding`)
|
|
- S3/Cloudinary SDK para uploads
|
|
|
|
**Frontend:**
|
|
- React Context API
|
|
- CSS Variables para theming
|
|
- Dynamic `<title>` y `<link rel="icon">`
|
|
|
|
---
|
|
|
|
## 👥 User Stories
|
|
|
|
| ID | Historia | Esfuerzo | Prioridad |
|
|
|----|----------|----------|-----------|
|
|
| [US-WL-001](./historias/US-WL-001-branding-config.md) | Tenant Branding Configuration | 8h | P1 |
|
|
| [US-WL-002](./historias/US-WL-002-logo-colors.md) | Logo and Colors Upload | 6h | P1 |
|
|
| [US-WL-003](./historias/US-WL-003-platform-name.md) | Platform Name Customization | 6h | P2 |
|
|
|
|
**Total:** 20 horas ($3,000 USD)
|
|
|
|
---
|
|
|
|
## 🗄️ Modelo de Datos
|
|
|
|
### Schema: `system_configuration`
|
|
|
|
```sql
|
|
CREATE TABLE system_configuration.tenant_branding (
|
|
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
|
tenant_id UUID NOT NULL UNIQUE REFERENCES auth_management.tenants(id),
|
|
|
|
-- Tier 1 (Básico) - 20h
|
|
platform_name VARCHAR(100) DEFAULT 'GAMILIT Platform',
|
|
logo_url TEXT, -- S3/Cloudinary URL
|
|
favicon_url TEXT,
|
|
primary_color VARCHAR(7) DEFAULT '#3B82F6', -- Hex color
|
|
secondary_color VARCHAR(7) DEFAULT '#10B981',
|
|
|
|
-- Tier 2 (Avanzado) - 40h adicionales (v2.0+)
|
|
custom_domain VARCHAR(255), -- e.g., portal.universidad.edu
|
|
email_from_name VARCHAR(100),
|
|
login_page_background_url TEXT,
|
|
|
|
-- Tier 3 (Completo) - 60h adicionales (v2.0+)
|
|
custom_font_url TEXT,
|
|
custom_css TEXT,
|
|
hide_glit_branding BOOLEAN DEFAULT false,
|
|
|
|
-- Metadata
|
|
tier VARCHAR(20) DEFAULT 'basic', -- 'basic', 'pro', 'enterprise'
|
|
is_active BOOLEAN DEFAULT true,
|
|
created_at TIMESTAMPTZ DEFAULT NOW(),
|
|
updated_at TIMESTAMPTZ DEFAULT NOW()
|
|
);
|
|
|
|
CREATE INDEX idx_tenant_branding_tenant ON system_configuration.tenant_branding(tenant_id);
|
|
CREATE INDEX idx_tenant_branding_domain ON system_configuration.tenant_branding(custom_domain);
|
|
```
|
|
|
|
---
|
|
|
|
## 🔗 Dependencias
|
|
|
|
### Bloqueado por
|
|
- Multi-tenant architecture funcionando
|
|
- S3/Cloudinary configurado para file uploads
|
|
|
|
### Bloquea
|
|
- Tier 2 white-label (v2.0+)
|
|
- Enterprise onboarding (requiere white-label)
|
|
|
|
---
|
|
|
|
## 🚀 Plan de Implementación
|
|
|
|
### Sprint 25 (Semana 25) - 12h
|
|
- **US-WL-001:** Tenant Branding Configuration backend (8h)
|
|
- **US-WL-002:** Logo upload (4h)
|
|
|
|
### Sprint 26 (Semana 26) - 8h
|
|
- **US-WL-002:** Colors UI (2h)
|
|
- **US-WL-003:** Platform Name Customization (6h)
|
|
|
|
---
|
|
|
|
## 🧪 Testing
|
|
|
|
### Test Cases Críticos
|
|
1. **Multi-tenant Isolation:**
|
|
- Tenant A config no afecta Tenant B
|
|
- Logo Tenant A no visible para Tenant B
|
|
|
|
2. **CSS Variables:**
|
|
- Primary color aplicado en botones, links
|
|
- Secondary color en highlights, badges
|
|
|
|
3. **Dynamic Updates:**
|
|
- Admin cambia logo → refleja sin reload
|
|
- Color change → CSS variables actualizadas
|
|
|
|
---
|
|
|
|
## 📊 KPIs
|
|
|
|
### Post-Lanzamiento (3 meses)
|
|
- **Adoption:** >10 instituciones usando white-label
|
|
- **Upgrade to Pro:** >5 instituciones
|
|
- **ARR:** +$12,000
|
|
|
|
---
|
|
|
|
## 📚 Referencias
|
|
|
|
### Documentación Interna
|
|
- [ANALISIS-FEATURES-P3-ESTRATEGICAS.md](../../features/ANALISIS-FEATURES-P3-ESTRATEGICAS.md) - Sección White-label
|
|
- [FEATURES-PENDIENTES.md](../../features/FEATURES-PENDIENTES.md) - F-P2-020
|
|
|
|
---
|
|
|
|
**Creado:** 2025-11-07
|
|
**Responsable:** Full-stack Team
|