ElDocumentation Index
Fetch the complete documentation index at: https://mintlify.com/amarcano568/pensionalamedida/llms.txt
Use this file to discover all available pages before exploring further.
PerfilController gestiona el perfil personal del usuario autenticado en Pensión a la Medida y los datos estadísticos del tablero de control. Proporciona vistas dedicadas para consultar y editar los datos del perfil y para cambiar la contraseña, respaldadas por endpoints JSON que manejan la lógica de negocio. También expone un endpoint de resumen estadístico que alimenta los indicadores y el gráfico de líneas del dashboard de pensiones. Todas las rutas están protegidas por el middleware auth.
verPerfil
GET /ver-perfil
Renderiza la vista del perfil del usuario autenticado (perfiles.perfil). No devuelve datos directamente; la vista carga los datos del perfil de forma asíncrona llamando a buscarPerfil.
Este endpoint devuelve una vista HTML, no JSON.
buscarPerfil
GET /buscar-perfil
Obtiene los datos del usuario autenticado actualmente mediante Auth::user(), añade el nombre de su rol principal (obtenido con getRoleNames()[0]) y los devuelve en formato JSON.
true cuando los datos del perfil fueron obtenidos exitosamente.Mensaje descriptivo del resultado (
"Datos del perfil obtenido exitosamente").Objeto con la propiedad
user, que contiene todos los campos del modelo Usuario autenticado más el campo calculado rol con el nombre del primer rol asignado al usuario.actualizarPerfil
POST /actualizar-perfil
Actualiza los datos del perfil del usuario autenticado delegando la lógica de persistencia en el método estático Usuario::Guardar($request). La operación se ejecuta dentro de una transacción de base de datos.
Nombre completo del usuario.
Dirección de correo electrónico del usuario. Debe ser una dirección válida y única en el sistema.
true si el perfil fue guardado con éxito; false si hubo un error durante el guardado."Perfil guardado con exito." en caso de éxito, o "Hubo error intentando guardar el Perfil." en caso de fallo.cambiarContrasena
GET /cambiar-contrasena
Renderiza la vista del formulario de cambio de contraseña (perfiles.change-password). No devuelve datos directamente; la acción de cambio se realiza mediante actualizaPassword.
Este endpoint devuelve una vista HTML, no JSON.
actualizaPassword
POST /actualiza-password
Valida y actualiza la contraseña del usuario autenticado. Verifica que la contraseña actual sea correcta con Hash::check, que la nueva contraseña sea diferente a la actual y que la confirmación coincida. Aplica un hash seguro con Hash::make antes de almacenarla.
Contraseña actual del usuario. Se verificará con el hash almacenado en la base de datos. Mínimo 8 caracteres.
Nueva contraseña deseada. Debe ser diferente a
contrasenaActual y tener al menos 8 caracteres.Confirmación de la nueva contraseña. Debe coincidir exactamente con
newContrasena. Mínimo 8 caracteres.true si la contraseña fue actualizada correctamente; false si falló la validación o la contraseña actual es incorrecta.Mensaje descriptivo del resultado. Puede contener HTML con iconos. Ejemplos:
"Tu contraseña fue actualizada.", "Contraseña ingresada es incorrecta." o "Fallo al actualizar la contraseña.".Array vacío
[] en caso de éxito.Objeto con los errores de validación de Laravel cuando falla la validación de los campos. Cadena vacía si la contraseña actual es incorrecta. Mensaje de excepción en caso de error inesperado.
Todos los escenarios de respuesta devuelven código HTTP
200. Distinguir éxito de fallo usando el campo status.buscarDataTablero
GET — (invocado internamente desde la vista del dashboard)
Recopila y devuelve los datos estadísticos de pensiones para alimentar las tarjetas métricas y el gráfico de líneas del tablero de control. Calcula los totales de pensiones del día, del mes actual, del mes anterior y del año en curso, además de los datos serie para el gráfico agrupado por fecha.
Este endpoint no tiene una ruta explícita registrada en
web.php. Es accesible como método del controlador. Se recomienda registrarlo como GET /buscar-data-tablero si se consume desde AJAX.true cuando los datos del tablero fueron obtenidos exitosamente.Mensaje descriptivo del resultado (
"Data del tablero obtenida extisamente").Objeto con las siguientes propiedades:
| Propiedad | Tipo | Descripción |
|---|---|---|
hoy | array | ["Total: N", "día_semana dd-mm-YYYY"] — pensiones registradas hoy. |
pensionesMesActual | array | ["Total: N", "nombre_mes YYYY"] — pensiones del mes en curso. |
pensionesMesAnterior | array | ["Total: N", "nombre_mes YYYY"] — pensiones del mes anterior. |
pensionesAnoActual | array | ["Total: N", "YYYY"] — pensiones acumuladas en el año en curso. |
fechaGraph | array | Array de strings con fechas en formato "dd-mm" para el eje X del gráfico. |
valueGraph | array | Array de enteros con el recuento de pensiones por fecha para el eje Y del gráfico. |