# Manual de Usuario — ProyectoSincronizador

> **Versión:** 1.0  
> **Última actualización:** Abril 2026  
> **Audiencia:** Usuarios finales y administradores del sistema

---

## Índice

1. [Introducción](#1-introducción)
2. [Acceso al sistema](#2-acceso-al-sistema)
3. [Dashboard](#3-dashboard)
4. [Sincronizador](#4-seccion-lateral-sincronizador)
5. [Medidas y datos](#5-medidas-y-datos)
6. [Panel de administración](#6-panel-de-administración)
7. [Gestión de usuarios](#7-gestión-de-usuarios)
8. [Cierre de sesión](#8-cierre-de-sesión)
9. [Preguntas frecuentes](#9-preguntas-frecuentes)

---

## 1. Introducción

**ProyectoSincronizador** es una aplicación web de visualización y seguimiento de medidas sincronizadas. Permite a los 
usuarios consultar datos de campañas, configurar layouts personalizados con componentes de visualización, y a los 
administradores gestionar los usuarios y permisos del sistema. Todo creado sobre una base escalable para futuro.

### Roles disponibles

| Rol               | Descripción                                           |
|-------------------|-------------------------------------------------------|
| **Usuario**       | Consulta de datos, gestión de sus propios layouts     |
| **Administrador** | Todo lo anterior + gestión de usuarios y permisos     |


---

## 2. Acceso al sistema

### 2.1 Inicio de sesión

1. Abre el navegador y accede a la URL del sistema.
2. Introduce tu **nombre de usuario** y **contraseña** en el formulario de login.
3. Pulsa **Entrar**.

> ⚠️ Si olvidaste tu contraseña, contacta con el administrador.

### 2.2 Verificación de sesión

El sistema verifica automáticamente que tu sesión sigue activa. Si la sesión expira o se detecta un acceso desde una IP 
diferente, serás redirigido al login automáticamente.

---

## 3. Dashboard

El dashboard es la pantalla principal tras iniciar sesión. Desde aquí puedes:

- Consultar un resumen de los datos más recientes.
- Acceder a los distintos módulos mediante el menú lateral.
- Ver la campaña activa y su última fecha de actualización.

### 3.1 Navegación

La interfaz se divide en dos elementos de navegación:

- **Barra lateral (sidebar):** acceso a los módulos principales.
- **Barra superior (topbar):** información del usuario activo y acceso al cierre de sesión.

---

## 4. Seccion lateral: sincronizador
En la barra lateral se pueden visualizar distintas secciones donde iremos explicando el flujo, funcionamiento y matices
de cada seccion y paginas que los compone.

### 4.1 Gráficos
Esta pagina esta creada con el fin de mostrar gráficas dinámicas de los datos de tipo secundario dado un periodo de tiempo.

Para su uso:
1. Eliga un periodo de fecha de busqueda ( ultima campaña - ultima campaña + 4 meses por defecto ).
2. Seleccione un tipo de medida del menú desplegable.
3. Seleccion el tipo de gráfico para visualizar los datos.
4. Seleccione la agrupacion de los datos ( por defecto en dias ).
5. Seleccione el periodo de tiempo para rellenar con ceros ( por defecto sin, se aplica el mismo tiempo que la agrupacion ).
6. Pulse sobre [ + Añadir gráfico ].

Se creara un nuevo gráfico, que podrá mover libremente por la pagina, cambiar de tamaño, eliminar, entre otros. Asi mismo, dentro
de cada gráfico constamos de diferentes opciones:
1. Añadir Serie: Añade la serie activa que quieras visualizar, pudiendo añadir tantas como quieras ( no repetidas ).
2. Borrar Serie: Al lado del boton de añadir, el icono de la basura.
3. Arriba a la derecha, en el boton de engranaje: cambiar la agrupación y rellenos dinámicamente.
4. Arriba a la derecha, en el boton de tres lineas: configura dos lineas horizontales, mínimo y máximo, como umbrales visuales.
5. Arriba a la derecha, sobre el boton de gráfico: pinche para cambiar entre los tipos de gráficos disponibles.
6. En la leyenda, en la zona de abajo, pinche sobre una serie para NO mostrarla, pinche para reactivarla.

Además, en esta página se toma un control de layouts para poder cargar, guardar, modificar y borrar tus configuración de
gráficos de una forma rápida y sencilla:
- **Guardar**: puedes guardar el estado de los gráficos que hayas creado, su configuración, datos, posición, entre otros. Para
ello pinche en la parte superior, sección de layouts, en el boton
- **Mis layouts**: Pulse en - Mis Layouts - para ver los layouts que previamente haya guardado. Una vez seleccionado puede
  - **Cargar layout**: Pulse en el botón de play ( triangulo azul ) para cargar tu layout.
  - **Modificar**: Cambie el nombre y el estado de tu layout.
  - **Borrar**: Habiendo seleccionado un layout de tu lista, pincha en borrar y confirmar para eliminarlo de forma definitiva.
> ⚠️ La eliminación física es irreversible.

### 4.2 Sincronizador
Esta página tiene como objetivo mostrar datos de secundario dado su tiposec, subtiposecundario y tiposecundario.

Para su uso:
1. Eliga un rango de fechas para la busqueda ( por defecto igual que antes).
2. Eliga un tipo de dato.
3. Eliga un subtipo y su medida ( va en función del tipo seleccionado ).
4. Al igual que antes, puedes seleccionar su agrupación.
5. Al igual que antes, puedes seleccionar su relleno de huecos con ceros.

Pulse añadir para incluirlo en la búsqueda. A medida de que vayas añadiendo se irán visualizando en la tabla de en medio
"filtro activados". Ahi puedes quitar filtros pulsando su botón de borrar.

Una vez termines pulse el boton [ buscar ]. Se creará un gráfico con las series seleccionados. 

Puedes pulsar, en la leyenda de abajo, las series para activarla o desactivarlas.

Ademas, arriba a la derecha del gráfico verás un botón de descarga, para descargar el gráfico como una imagen png.

---
## 5. Sección lateral: Listado de parámetros.
> 🔒 Esta sección es exclusiva para usuarios con rol **Administrador** o superior aunque le puede asignar permiso a un
> usuario normal.

Esta sección esta planteada para mostrar parámetros del sistema que se consideren necesarios y que un usuario podria 
llegar a ver. Ahora mismo solo consta de ``listado de usuarios`` pero pensado para ampliación.

### 5.1. Listado de usuarios.
Esta pagina sirve para mostrar simplemente todos los usuarios del sistema. 

Consta de un filtro por nombre y por rol, junto a su respectivo boton de [ borrar filtros ].

---

## 6. Seccion lateral: Control de usuarios

> 🔒 Esta sección es exclusiva para usuarios con rol **Administrador** o superior. No se le puede asignar permiso a un
> usuario normal.

### 6.1. Panel de administrador
El panel de administración (`panelAdmin`) centraliza la gestión del usuarios, implicando todo su ciclo de vida, desde 
creación, modificación a eliminación. 

Para su uso:
- En el panel de administración encontrarás una tabla con todos los usuarios del sistema, mostrando:
  - Nombre
  - Nombre de usuario
  - Tipo de usuario
  - Estado (habilitado / deshabilitado)
  - Centro
  - CIF


- **Para la creación de un usuario**
  1. Pulsa el botón **Nuevo Usuario**.
  2. Rellena el formulario:
      - **Nombre** — nombre visible del usuario.
      - **Usuario** — nombre de login, debe ser único.
      - **Contraseña** — mínimo 8 caracteres, se almacena cifrada.
      - **Tipo** — rol del usuario.
      - **Habilitado** — si el usuario puede acceder al sistema.
      - **Centro** — centro asociado al usuario.
      - **CIF** — identificador fiscal.
  3. Pulsa **Crear**.
  > Si el nombre de usuario ya existe, el sistema mostrará un aviso de datos duplicados.


- **Para editar a un usuario**
  - Localiza el usuario en la tabla y pulsa el icono de **edición** ( lapiz ).
  - La pestaña de edicion esta divida en tres pestañas:
    - **Datos generales**: cambiar los datos generales de un usuario
      - Nombre completo
      - Nombre de usuario
      - Rol
      - Estado de la cuenta
      - Centro
      - CIF
    - **Contraseña**: cambio de contraseña del usuario
      - Contraseña actual
      - Nueva contraseña
      - Repetir nueva contraseña
    - **Permisos**: Paginas a la que tiene acceso ese usuario en concreto
      - Habilitar/deshabilitar permisos 
  - Pulsa **Guardar** para aplicar los cambios.


- **Para deshabilitar a un usuario**
  - La deshabilitación es una eliminación lógica; El usuario deja de poder acceder pero sus datos se conservan.
    1. Localiza el usuario en la tabla.
    2. Pulsa el icono de borrar ( basura )
    3. Seleccione la opción de **deshabilitar**.
    4. Confirma la acción.


- **Para eliminar a un usuario**
  - La eliminación física borra el usuario de forma permanente.
    1. Localiza el usuario en la tabla.
    2. Pulsa el icono de borrar ( basura )
    3. Seleccione la opción de **eliminar**
    4. Confirma la acción en el modal de confirmación.

  > ⚠️ Esta acción es irreversible.

---

## 7. Cierre de sesión

Para cerrar sesión de forma segura:

1. Pulsa tu nombre de usuario en la barra superior.
2. Selecciona **Cerrar sesión**.

> Al cerrar sesión, la cookie de sesión se elimina y será necesario volver a autenticarse.

---

## 8. Preguntas frecuentes

**¿Qué hago si olvidé mi contraseña?**  
Contacta con el administrador del sistema. Por seguridad, las contraseñas no se pueden recuperar, solo restablecer.

**¿Por qué no puedo acceder al panel de administración?**  
Tu usuario no tiene el rol necesario. Contacta con el administrador para que revise tus permisos.

**¿Por qué no veo ciertas paginas desde mi usuario?**
Cada usuario tiene acceso a ciertas páginas unicamente. Si echa en falta alguna contacte con su administrador.

**¿Se pierden los datos si deshabilito un usuario?**
No. La deshabilitación es lógica, el usuario no puede acceder pero sus datos y layouts se conservan.

---

*Para incidencias técnicas o consultas sobre el sistema, contacta con el equipo de soporte.*