Autor: Iker Acevedo¶

Fecha creacion: 2026-10-17 Estado: propuesta (pendiente de aprobación) Tipo: estándar de arquitectura frontend

Sistema de Experiencias¶

Qué es¶

LogiGho va a tener varias experiencias. Una experiencia es un frontend visual completo: cómo se organiza la barra de navegación, dónde quedan los botones, cómo se ven las tablas y tarjetas, qué colores y tipografía usa. Para el usuario es como usar otra aplicación.

Todas las experiencias comparten la misma lógica, las mismas rutas, los mismos permisos y el mismo backend. Lo único que cambia es lo visual.

Regla de oro: la lógica se escribe una vez; cada experiencia solo pinta.

El usuario elige su experiencia y toda la plataforma cambia. Hoy existe una sola, clasica (la plataforma actual). Se espera tener al menos tres y agregar más con el tiempo.

Por qué este nombre¶

Experiencia describe lo que de verdad cambia: la experiencia de usuario completa (UX y UI), no solo los colores. Se descartaron "tema" (en el equipo y en las librerías significa solo colores), "interfaz" (choca con interface de TypeScript) y "skin" (sugiere un cambio superficial).

Cómo está organizado¶

flowchart TB
    subgraph Logica["Lógica compartida (se escribe una vez)"]
        PF["Cerebro de la plataforma
usuario, menú permitido, alertas"]
        VF["Cerebro de cada vista
repository, store, facade, helpers"]
    end
    subgraph EC["Experiencia clasica"]
        C1[Shell y navegación] --- C2[Tokens y UI kit] --- C3[Versión de cada vista]
    end
    subgraph EB["Experiencia B"]
        B1[Shell y navegación] --- B2[Tokens y UI kit] --- B3[Versión de cada vista]
    end
    subgraph EN["Experiencia N"]
        N1[Shell y navegación] --- N2[Tokens y UI kit] --- N3[Versión de cada vista]
    end
    PF --> C1 & B1 & N1
    VF --> C3 & B3 & N3

Cada experiencia aporta cuatro cosas:

Qué ve el usuario¶

1. Inicia sesión. La plataforma carga la experiencia que tiene guardada (o clasica si nunca eligió).
2. Desde el selector de experiencia, elige otra.
3. La plataforma cambia de shell, menú, estilos y vistas, sin recargar el navegador y sin cambiar de URL.
4. Si una vista todavía no tiene versión para esa experiencia, se muestra la versión clasica con los colores de la experiencia elegida. A esto se le llama respaldo.
5. Su elección se guarda en el servidor: la encuentra igual en cualquier dispositivo.

Las reglas completas están en Reglas de cambio entre experiencias.

Glosario¶

Documentos¶

Historial de cambios¶