## Bienvenido al Panel de Gestión

Esta es tu herramienta centralizada para gestionar pacientes, crear contenido clínico y monitorizar el progreso de la clínica.

Desde aquí puedes diseñar pautas de ejercicios, comunicarte directamente con tus pacientes, analizar su adherencia y administrar los recursos de la plataforma. Esta guía detalla cada módulo y las diferencias clave entre los roles de gestión.

## Gestión de tu Perfil

Puedes gestionar tus datos personales y tu contraseña en cualquier momento. Accede haciendo clic en tu nombre (en la barra de navegación superior) y seleccionando "Les meves dades".

#### Foto de Perfil (Avatar)

En la pestaña "Dades Personals", ahora puedes añadir una foto de perfil que será visible para tus pacientes en el chat y en la cabecera de la app.

- Previsualización: Verás un círculo donde aparecerá tu avatar.
- Añadir/Cambiar: Pulsa el botón "Canviar..." para seleccionar un archivo (JPG, PNG, GIF) de tu ordenador. El tamaño máximo es de 1MB.
- Eliminar: Pulsa el botón "Eliminar" para quitar tu foto de perfil actual.
- Guardar: Los cambios en el avatar (tanto subir uno nuevo como eliminarlo) se aplican solo después de pulsar el botón "Guardar Canvis".

#### Cambio de Contraseña

En la pestaña "Canviar Contrasenya", puedes actualizar tu contraseña. Por seguridad, deberás introducir tu contraseña actual antes de poder establecer una nueva.

## Roles y Permisos

### SUPERADMIN

Tiene control total sobre la plataforma. Puede ver, editar y eliminar el contenido de *todos* los fisioterapeutas.

- Gestión Total: Acceso a todos los pacientes, tratamientos, ejercicios y protocolos.
- Gestión de Catálogo: Único rol que puede editar el Gestor de Catálogo (Taxonomía) para crear las categorías y etiquetas que usarán todos.
- Gestión de Usuarios: Único rol que puede gestionar la lista de Fisioterapeutas y eliminar permanentemente a Pacientes.
- Mantenimiento: Acceso al Panel de Administración (Backups, Logs, Mantenimiento, etc.).
- Suplantación de Cuentas: (Ver sección Suplantación). Puede "iniciar sesión como" cualquier otro usuario para solucionar problemas.

### FISIO

Gestiona su propia cartera de pacientes y contenido. Los permisos se basan en la propiedad del contenido.

- Propiedad: Puede crear, editar y eliminar el contenido (ejercicios, protocolos, tratamientos) que él mismo ha creado.
- Colaboración: Puede ser añadido como "Colaborador" a un ejercicio o tratamiento. Como colaborador, puede editar el contenido, pero no puede eliminarlo.
- Filtro "Només els meus": Este filtro, presente en varias pantallas, mostrará todo el contenido donde seas el Creador O un Colaborador.
- Archivo Personal: Puede "Archivar" contenido (ej. un ejercicio) para ocultarlo de *su propia vista* sin que afecte al resto de fisios.
- Suplantación de Pacientes: (Ver sección Suplantación). Puede "iniciar sesión como" uno de sus propios pacientes.

## Panel de Control (Dashboard)

Tu página de inicio. Te ofrece una vista de pájaro de toda tu actividad clínica.

#### Indicadores Clave (KPIs)

Tarjetas de resumen que muestran: Pacientes Activos (pacientes únicos con tratamientos "En Curs"), Finalizan Pronto (tratamientos que acaban en 3 días), Tratamientos en Curso (conteo total de pautas activas) y Alertas Recientes (valoraciones >= 4 en los últimos 5 días).

#### Acciones Urgentes

Listas priorizadas que requieren tu atención inmediata.

Alertas Dolor/Esforç: Muestra valoraciones altas (>= 4) de tus pacientes.
Ejemplo de uso: Si ves una alerta, haz clic en el botón ("Descartar") para quitarla de *tu* lista de urgentes (esto no la borra, solo la oculta de este widget).

Tractaments Finalitzant: Muestra pautas que acaban en 3 días.
Ejemplo de uso: Si el paciente necesita más tiempo, pulsa "+7 dies" para extender la pauta una semana.
Nota: El botón "Finalitzar" se ha eliminado de este widget para evitar clics accidentales. Para marcar un tratamiento como "Completat", debes ir al listado maestro de Tratamientos o a la Ficha del Paciente.

#### Feed de Actividad y Mi Resumen

Monitoriza la actividad reciente y tu contribución al contenido de la clínica.

- Ejercicios Realizados: Un feed cronológico de las valoraciones de tus pacientes, con insignias de Dolor (D) y Esfuerzo (E).
- Feedback Rápido: Puedes enviar un mensaje de chat rápido al paciente (basado en su valoración) pulsando el icono .
- Mi Contenido: Un conteo de cuántos Ejercicios, Protocolos, Vídeos e Imágenes has creado.
- Estado de Mis Tratamientos: Un gráfico circular que desglosa el estado de todos tus tratamientos (En Curs, Programat, Completat, Omés).

#### Vista Global (Dashboard) SUPERADMIN

Los Superadmins tienen un interruptor en la parte superior del dashboard para cambiar entre "Vista Personal" (por defecto) y "Vista Global".

- Vista Personal: Muestra los KPIs, alertas y resúmenes *solo* de los pacientes y contenido que gestionas (como un Fisio normal).
- Vista Global: Muestra los KPIs, alertas y resúmenes *acumulados* de toda la plataforma (todos los fisios y pacientes).
- En esta vista, los widgets de "Resumen" y "Estado de Tratamientos" reflejan las métricas totales de la clínica y el enlace "Veure Resum Detallat" se oculta.

## Ficha del Paciente

Aquí es donde gestionas la pauta clínica de un paciente individual. Es el flujo de trabajo más común.

#### Gestión de Tratamientos del Paciente

La ficha se divide en "Tractaments Actius" y "Historial". Desde aquí puedes:

- Nuevo Tratamiento: Abre el modal para crear una pauta personalizada desde cero.
- Asignar des de Protocol: Te permite seleccionar un protocolo (plantilla) de la biblioteca, que se copia como un nuevo tratamiento para el paciente.
- Editar: Modifica una pauta existente. Si eliminas un ejercicio que el paciente ya ha valorado, la app te pedirá confirmación.

#### El Modal de "Evolución"

Al pulsar el botón Evolución en un tratamiento, se abre el panel de análisis más importante:

##### Métricas de Adherencia

Verás dos barras de progreso: Progrés (Temps) (cuánto tiempo del tratamiento ha pasado) y Adherència (Realització) (qué porcentaje de los ejercicios *programados hasta hoy* ha completado el paciente).

##### Pestaña "Calendari"

Te permite ver el cumplimiento día a día. Cada día tiene un anillo de progreso (verde si completó el 100%).

Ejemplo de uso: Haz clic en un día. La lista de abajo mostrará qué ejercicios se registraron, con sus puntuaciones de Dolor , Esfuerzo y sus comentarios .

##### Pestaña "Gràfic"

Muestra la tendencia de Dolor (línea roja) y Esfuerzo (línea azul) a lo largo del tiempo.

Ejemplo de uso: Si ves un pico de dolor, usa el Filtro de Ejercicio en la parte superior del modal para seleccionar un ejercicio específico. El gráfico se recalculará, permitiéndote ver si ese ejercicio en particular es el causante del dolor.

## Gestión de Contenido Clínico

Estas secciones te permiten crear los "bloques" que usarás para construir tus tratamientos.

#### a. Galería de Medios

Aquí subes tus Vídeos (archivos MP4/WebM o enlaces de YouTube/Vimeo) e Imágenes (JPG/PNG). Este es el primer paso, ya que los ejercicios se vinculan a estos medios.

#### b. Catálogo de Ejercicios

Aquí creas las plantillas de ejercicios. Un ejercicio incluye:

- Un medio vinculado (de la Galería).
- Una pauta base (Series, Repeticiones, Descanso).
- Clasificación (Categoría y Etiquetas, definidas por el Superadmin).
- Fisios Colaboradores: (Novedad) Un campo para añadir a otros fisios que pueden editar este ejercicio. El creador original es el único (aparte del Superadmin) que puede eliminarlo.

#### c. Biblioteca de Protocolos

Un protocolo es una plantilla de tratamiento. Es un conjunto de ejercicios (con sus pautas) guardado para ser reutilizado.

Ejemplo de uso: Creas un protocolo llamado "Post-Op LCA (Semana 1-2)". Cuando tienes un paciente nuevo con esa cirugía, vas a su Ficha de Paciente, pulsas "Asignar des de Protocol", seleccionas tu plantilla y la app la copia como un nuevo tratamiento para ese paciente.

## Gestión de Tratamientos (Listado Maestro)

A diferencia de la "Ficha del Paciente", esta pantalla (`treatments.php`) es un listado maestro de *todos* los tratamientos de la clínica (o los tuyos, si usas el filtro "Només els meus").

#### Visualización

Los tratamientos (tanto los Activos como el Historial) se presentan ahora en formato de tarjetas (cards) adaptables a dispositivos móviles y escritorio.
Las tarjetas del Historial se distinguen por tener un fondo más grisáceo y la imagen en blanco y negro (desaturada).

#### Estados del Tratamiento

- Programat: El tratamiento está creado, pero su fecha de inicio es futura. No es visible para el paciente.
- En Curs: El tratamiento está activo y visible para el paciente.
- Completat: El tratamiento ha finalizado (manual o automáticamente). La app calcula y guarda el porcentaje de adherencia final.
- Omés: El tratamiento se ha saltado o finalizado sin completar.

#### Acciones Comunes

Ejemplo (Finalizar): Un tratamiento "En Curs" llega a su fin. En el menú de acciones , seleccionas "Marcar como Completat". La app calcula la adherencia y lo mueve al historial del paciente.

Ejemplo (Reactivar): Un paciente ha tenido una recaída. Vas a su tratamiento "Completat", pulsas y seleccionas "Reactivar Tratamiento". Vuelve a estar "En Curs" (quizás tengas que editarlo para ajustar las fechas).

Ejemplo (Transferir): SUPERADMIN Un fisio deja la clínica. Vas a un tratamiento "En Curs" del que era propietario, pulsas y seleccionas "Transferir Tratamiento". Podrás reasignarlo a un nuevo fisio, que se convertirá en el nuevo propietario (creador).

## Mensajería (Chat)

Tu bandeja de entrada (`chat_inbox.php`) centraliza todas las conversaciones. A diferencia del paciente, tú ves una lista de pacientes en lugar de una lista de fisios.

- Visibilidad: Solo verás conversaciones con pacientes que tengan un tratamiento activo ("En Curs") donde tú seas el creador o colaborador.
- Gestión de Borrado: Al pulsar el icono de papelera en una conversación, tienes dos opciones:
  - Eliminar sólo para mí: Oculta el historial para ti. El paciente lo conserva. (Acción por defecto).
  - Eliminar para mí y para el paciente: Oculta el historial para ambos.

## Herramientas de Administración

Esta sección detalla las herramientas avanzadas disponibles para Fisios y Superadmins en diferentes partes de la aplicación.

#### a. Gestión de Anuncios

Permite enviar comunicados a diferentes grupos de usuarios.

- FISIO: Puede enviar anuncios a "Todos mis pacientes" o "Pacientes Específicos" (de entre los suyos).
- SUPERADMIN: Puede enviar a todos, o a grupos específicos de fisios o pacientes.
- Anuncio Bloqueante: (Solo Superadmin) Al marcar "Requerir lectura", el anuncio aparecerá en una ventana emergente que bloquea la app hasta que el usuario la cierre. Úsalo solo para avisos críticos.

#### b. Gestor de Catálogo (Taxonomía)

SUPERADMIN Esta es la sección (`taxonomy.php`) donde se define la estructura de clasificación de la clínica.

Aquí puedes crear, editar y eliminar las Categorías (ej. "Hombro", "Rodilla") y Etiquetas (ej. "Fuerza", "Movilidad") que todos los fisios usarán para clasificar sus ejercicios.

#### c. Gestión de Usuarios y Suplantación

En la pantalla (`users.php`), tanto el SUPERADMIN como el FISIO pueden ver la lista de usuarios, aunque con distintos permisos.

##### Función de Suplantación (Impersonation)

¿Qué es? Es una herramienta de diagnóstico que permite "convertirse" temporalmente en otro usuario.

- El SUPERADMIN puede suplantar a cualquier Fisio o Paciente.
- El FISIO puede suplantar a uno de sus propios Pacientes.

Se activa pulsando el icono en la lista de usuarios.

¿Para qué sirve? Esta es una herramienta de soporte. Te permite tomar el control total de la sesión del usuario para ver exactamente lo que él ve, replicar un error que está reportando o solucionar un problema en su nombre.

¿Cómo funciona?

- Verás una barra de advertencia amarilla en la parte superior de la pantalla en todo momento.
- Para volver a tu cuenta, simplemente haz clic en el enlace "Tornar al meu compte" en esa barra.
- Por seguridad: Mientras suplantas a un usuario, los menús "El Meu Perfil" (acceso a `#profileModal`) y "Tancar Sessió" desaparecerán. Esto impide que un administrador pueda ver o modificar la contraseña o los datos personales del usuario suplantado.

#### d. Panel de Administración (Modal Superadmin)

SUPERADMIN Accesible desde el menú de tu perfil -> "Administració". Este modal centraliza todas las herramientas de mantenimiento de la plataforma.

##### Pestaña: Backups

Te permite crear una copia manual de la base de datos (formato `.sql`), restaurar desde una copia guardada en el servidor o subir y restaurar un archivo `.sql` desde tu ordenador.

Nota sobre Subidas: La subida de archivos `.sql` está optimizada. Los archivos grandes se procesan por trozos (chunks) y verás una barra de progreso que indica el estado de la subida y la posterior restauración.

##### Pestaña: Mantenimiento

El botón "Comprobar Integridad" realiza un escaneo de solo lectura en busca de datos "huérfanos" (ej. una valoración de un ejercicio que ya no existe). Si encuentra problemas, aparecerán botones de "Purgar" para limpiar esos registros obsoletos de forma permanente.

##### Pestaña: Auditoria (Logs)

Esta es una herramienta crítica de seguridad y privacidad. Al pulsar el botón, se abre en una nueva pestaña el registro (`admin_logs.php`) de todas las acciones sensibles de la plataforma.

¿Qué se registra?

- Accesos: Inicios de sesión (éxito y fallo), cierre de sesión.
- Suplantación: Quién ha suplantado a quién y cuándo.
- Gestión de Contenido: Creación, edición y eliminación de tratamientos, protocolos, ejercicios y usuarios.
- Acciones de Admin: Creación y restauración de backups.

Importancia de la Privacidad:

- Este registro es de solo lectura y solo accesible por el Superadmin.
- NO se guardan contraseñas (ni siquiera encriptadas).
- NO se guardan datos médicos (ej. el texto de una anamnesis o un mensaje de chat). El log solo registra la *acción* (ej: "Fisio 'Juan' envió un mensaje al paciente 'Ana'", pero no el contenido del mensaje).

##### Pestaña: Accés (Control de Acceso)

Permite fortalecer la seguridad del registro:

- Emails Banejats: Añadir direcciones de email que no podrán crear una cuenta nueva.
- Contrasenyes Prohibides: Añadir contraseñas débiles (ej: "123456", "password") para que no puedan ser usadas por los usuarios.

##### Pestaña: Emails

Permite controlar globalmente el envío de correos automáticos desde la plataforma. Se dividen en dos categorías:

- Correos Críticos: Incluye notificaciones de seguridad, registro de nuevos usuarios y restablecimiento de contraseña. Se recomienda mantenerlos activos.
- Correos Opcionales: Incluye avisos como "Nuevo mensaje de chat" o "Resumen semanal". Puedes desactivarlos si deseas reducir el volumen de correos enviados.

##### Pestaña: Preferències

Permite personalizar la experiencia de uso del panel de administración:

- Filtro por defecto: Activa automáticamente la opción "Només els meus" al entrar en los listados de contenidos.
- Elementos por página: Selecciona la cantidad de registros (tratamientos, usuarios, ejercicios) que deseas ver por página en los listados (4, 8, 12, 20, 50 o 100). Útil para ajustar la vista según el tamaño de tu pantalla.