# Relevamiento y validación UI/UX – Panel principal

**Rutas siempre visibles (sin depender de módulos):**

- **http://127.0.0.1:8000/home** – Dashboard
- **http://127.0.0.1:8000/site-data** – Modificar datos del sitio
- **http://127.0.0.1:8000/welcomecarousel** – Banner principal (carrusel portada)

---

## 1. Dashboard (`/home`)

### Estado actual
- **Menú:** Siempre visible como "Dashboard" (sin `module_check`). Roles: System Admin, Administrator, Contributor, Editor, Author.
- **Contenido:**
  - Franja de bienvenida con nombre de usuario, nombre del sitio y botón "Ver sitio web".
  - KPIs (secciones activas, contenidos publicados, nuevos este mes) solo si hay módulos activos.
  - Bloque "Tu sitio está listo para despegar" cuando hay módulos pero 0 contenido.
  - Tarjetas por sección (módulos activos) con enlace y estadísticas.
  - **Acciones rápidas:** Ahora incluyen siempre "Modificar datos del sitio" y "Banner principal"; luego las de módulos activos (hasta 6).
  - **Actividad reciente:** Listado de últimos contenidos por módulo; estado vacío amigable si no hay actividad.

### UI/UX
- Lenguaje orientado al usuario ("tu sitio", "desde aquí puedes gestionar").
- Sin referencias técnicas (p. ej. "Revisa config/cd-system.php").
- Mensajes claros cuando no hay módulos o no hay contenido.
- Acciones rápidas útiles incluso con 0 módulos (site-data y welcomecarousel).
- Responsive (columnas, tipografía).
- Botón "Ver sitio web" con target `_blank`.

### Mejoras aplicadas
- Acciones rápidas fijas: "Modificar datos del sitio" y "Banner principal" siempre presentes al inicio de la lista.

---

## 2. Modificar datos del sitio (`/site-data`)

### Estado actual
- **Menú:** "Modificar datos del sitio". Roles: System Admin, Administrator. Sin `module_check`.
- **Contenido:**
  - Título: "Datos del sitio".
  - Subtítulo: "Información básica, contacto, redes sociales y logos. Los cambios se verán en tu sitio web."
  - Secciones: Información básica (tagline, descripción), Contacto (teléfono, email, dirección, horarios), Redes sociales (activar + URL por red), Logos (principal, alternativo, loader, footer).
  - Feedback: alertas de éxito/error y listado de errores de validación.
  - Botones: "Cancelar" (vuelve a `/home`) y "Guardar cambios".

### UI/UX
- Etiquetas y placeholders claros.
- Agrupación lógica (básico, contacto, redes, logos).
- Campos requeridos marcados (`required` en tagline).
- Redes con switch + URL; texto de ayuda sobre uso de las URLs.
- Logos con vista previa si existe valor; texto "Máx. 5 MB" y formatos aceptados.
- Mensajes de éxito/error visibles y no técnicos.

### Buenas prácticas cubiertas
- Consistencia con el resto del panel (card, botones, clases Metronic).
- Accesibilidad: labels asociados, estructura de encabezados.
- Sin jerga técnica en pantalla.

---

## 3. Banner principal (`/welcomecarousel`)

### Estado actual
- **Menú:** "Banner Principal" (tooltip: "Gestionar imágenes del carrusel principal de la página de inicio"). Roles: System Admin, Administrator. Sin `module_check`.
- **Contenido:**
  - Título de página: "Banner Principal" (alineado con el ítem de menú).
  - Subtítulo: "Imágenes del carrusel de la página de inicio".
  - Formulario de subida: múltiple (máx. 5), campos de nombre por imagen generados por JS, formatos y tamaño indicados.
  - Tabla (desktop) / cards (móvil) con imagen, nombre, orden, acciones Editar / Eliminar.
  - Eliminación con confirmación (SweetAlert2).
  - Estado vacío: icono + "No hay imágenes en el carrusel" + "Sube algunas imágenes para comenzar".

### UI/UX
- Título unificado: "Banner Principal" en menú, header de módulo y vista (evita "Welcome Carousel" / "Banner HomePage").
- Scripts de la página pasan de `@section('scripts')` a `@push('scripts')` para que se incluyan correctamente en el layout (base tiene `@stack('scripts')`).
- Responsive: tabla en desktop, cards en móvil; botones e inputs adaptados.
- Confirmación antes de eliminar; mensajes de éxito/error claros.
- Textos en español y uso de `__()` donde aplica.

### Mejoras aplicadas
- Títulos y subtítulos unificados con el menú ("Banner Principal", "Imágenes del carrusel de la página de inicio").
- Corrección de inclusión de scripts para que eliminar y campos dinámicos funcionen bien.

---

## 4. Resumen de rutas y visibilidad

| Ruta            | Menú                    | Siempre visible (roles)        | Depende de módulos |
|-----------------|-------------------------|--------------------------------|--------------------|
| `/home`         | Dashboard               | Sí (todos los roles del panel) | No                 |
| `/site-data`    | Modificar datos del sitio | Sí (System Admin, Administrator) | No              |
| `/welcomecarousel` | Banner Principal     | Sí (System Admin, Administrator) | No              |

Las tres rutas están en `config/demo1/menu.php` sin `module_check`, por lo que se muestran siempre que el usuario tenga el rol indicado, tenga o no módulos activos.

---

## 5. Checklist UI/UX (buenas prácticas)

- **Claridad:** Títulos y descripciones entendibles para un usuario no técnico.
- **Consistencia:** Misma estructura (card, header, botones) y nomenclatura (Banner Principal en menú y página).
- **Feedback:** Mensajes de éxito, error y validación visibles y en español.
- **Acciones principales:** Siempre accesibles desde el dashboard (acciones rápidas: site-data y welcomecarousel).
- **Estados vacíos:** Mensajes y CTAs cuando no hay datos (dashboard, carrusel).
- **Destructivas:** Confirmación antes de eliminar (carrusel).
- **Responsive:** Tabla/cards y controles usables en móvil.
- **Accesibilidad:** Labels, estructura de encabezados y contraste coherentes con el tema.

---

## 6. Próximos pasos sugeridos

1. Habilitar módulos de a uno desde Mantenimiento y validar en front y panel.
2. Revisar que cada módulo use el mismo patrón de layout (`x-base-layout`, `x-admin-header`) y títulos en `config/modules/headers.php`.
3. Si se añaden más “páginas core” (siempre visibles), agregarlas al menú sin `module_check` y, si aplica, a las acciones rápidas del dashboard.