83 Historial de Abonos en Tiempo Real: Listado de Pagos Parciales con Blade y Carbon en Laravel 🗓️💰

Duración: 13 min
Módulo: Módulo Pagos Parciales Lección 4 de 8

Descripción

🗓️ Lección 83: Historial de Abonos y Cálculo de Pagos Parciales

En esta sesión de Benji V2, transformamos la tabla de amortización para que refleje de manera transparente cada abono realizado por el cliente. Pasamos de tener solo un registro en la base de datos a una interfaz informativa que detalla montos, fechas y totales acumulados por cuota.

📊 Visualización Dinámica de Abonos

Aprovechamos las relaciones de Eloquent para traer los datos sin consultas adicionales complejas:

  • 🆕 Nueva Columna en la Tabla: Agregamos la columna "Pagos Parciales" a la tabla de amortización en la vista show.blade.php [01:52].
  • 🔄 Iteración con Blade: Utilizamos una directiva @foreach sobre la relación $pago->pagos_parciales para listar cada abono individualmente. Esto permite ver, por ejemplo, si una cuota se ha pagado en tres partes distintas (ej. 50, 10 y 10 bolivianos) [06:55].
  • 🗓️ Formateo con Carbon: Mostramos la fecha exacta de cada abono, permitiendo un seguimiento cronológico del compromiso del cliente [08:16].

🧮 Lógica de Acumulación y Totales

Para que el cajero sepa cuánto se ha cubierto de la cuota hasta el momento:

  • 🔢 Variable Acumuladora: Inicializamos una variable $total_pago_parcial en cero antes del bucle de abonos [09:56].
  • ➕ Suma en Tiempo Real: Dentro del @foreach, sumamos cada monto abonado a la variable acumuladora [10:27].
  • 💰 Resumen de Cuota: Al final del listado de abonos, mostramos el "Total Pagado" de esa cuota específica, formateado con la divisa correspondiente y dos decimales [10:54].

🎨 Optimización de la Interfaz (UX)

Aseguramos que la tabla mantenga un diseño limpio a pesar de la nueva información:

  • 📏 Control de Ancho: Aplicamos clases de Tailwind CSS (min-w-[220px] y flex-col) para que la información de los abonos se presente de forma vertical y organizada sin desbordar la tabla [03:48].
  • 🛡️ Manejo de Estados Vacíos: Si una cuota no tiene abonos, el sistema simplemente no muestra el desglose, evitando ruido visual innecesario [12:11].

Resultado de la Lección

La tabla de amortización ahora es una herramienta de auditoría potente. El administrador puede ver de un vistazo qué cuotas están recibiendo abonos, cuánto se ha pagado en total por cada una y en qué fechas se realizaron los movimientos.