Feat: Implementa flujo completo de facturación y promociones

Este commit introduce la funcionalidad completa para la facturación mensual,
la gestión de promociones y la comunicación con el cliente en el módulo
de suscripciones.

Backend:
- Se añade el servicio de Facturación que calcula automáticamente los importes
  mensuales basándose en las suscripciones activas, días de entrega y precios.
- Se implementa el servicio DebitoAutomaticoService, capaz de generar el
  archivo de texto plano para "Pago Directo Galicia" y de procesar el
  archivo de respuesta para la conciliación de pagos.
- Se desarrolla el ABM completo para Promociones (Servicio, Repositorio,
  Controlador y DTOs), permitiendo la creación de descuentos por porcentaje
  o monto fijo.
- Se implementa la lógica para asignar y desasignar promociones a suscripciones
  específicas.
- Se añade un servicio de envío de email (EmailService) integrado con MailKit
  y un endpoint para notificar facturas a los clientes.
- Se crea la lógica para registrar pagos manuales (efectivo, tarjeta, etc.)
  y actualizar el estado de las facturas.
- Se añaden todos los permisos necesarios a la base de datos para
  segmentar el acceso a las nuevas funcionalidades.

Frontend:
- Se crea la página de Facturación, que permite al usuario seleccionar un
  período, generar la facturación, listar los resultados y generar el archivo
  de débito para el banco.
- Se implementa la funcionalidad para subir y procesar el archivo de
  respuesta del banco, actualizando la UI en consecuencia.
- Se añade la página completa para el ABM de Promociones.
- Se integra un modal en la gestión de suscripciones para asignar y
  desasignar promociones a un cliente.
- Se añade la opción "Enviar Email" en el menú de acciones de las facturas,
  conectada al nuevo endpoint del backend.
- Se completan y corrigen los componentes `PagoManualModal` y `FacturacionPage`
  para incluir la lógica de registro de pagos y solucionar errores de TypeScript.

Backend/GestionIntegral.Api/Models/Dtos/Suscripciones/CreatePagoDto.cs

@@ -0,0 +1,29 @@
+// Archivo: GestionIntegral.Api/Dtos/Suscripciones/CreatePagoDto.cs
+
+using System;
+using System.ComponentModel.DataAnnotations;
+
+namespace GestionIntegral.Api.Dtos.Suscripciones
+{
+    public class CreatePagoDto
+    {
+        [Required]
+        public int IdFactura { get; set; }
+
+        [Required]
+        public DateTime FechaPago { get; set; }
+
+        [Required(ErrorMessage = "Debe seleccionar una forma de pago.")]
+        public int IdFormaPago { get; set; }
+
+        [Required(ErrorMessage = "El monto es obligatorio.")]
+        [Range(0.01, 99999999.99, ErrorMessage = "El monto debe ser un valor positivo.")]
+        public decimal Monto { get; set; }
+
+        [StringLength(100)]
+        public string? Referencia { get; set; } // Nro. de comprobante, etc.
+
+        [StringLength(250)]
+        public string? Observaciones { get; set; }
+    }
+}

Backend/GestionIntegral.Api/Models/Dtos/Suscripciones/CreatePromocionDto.cs

@@ -0,0 +1,26 @@
+using System.ComponentModel.DataAnnotations;
+
+namespace GestionIntegral.Api.Dtos.Suscripciones
+{
+    public class CreatePromocionDto
+    {
+        [Required]
+        [StringLength(200)]
+        public string Descripcion { get; set; } = string.Empty;
+
+        [Required]
+        public string TipoPromocion { get; set; } = string.Empty;
+
+        [Required]
+        [Range(0.01, 99999999.99)]
+        public decimal Valor { get; set; }
+
+        [Required]
+        public DateTime FechaInicio { get; set; }
+        public DateTime? FechaFin { get; set; }
+        public bool Activa { get; set; } = true;
+    }
+}
+
+// UpdatePromocionDto puede ser idéntico al de creación por ahora
+using UpdatePromocionDto = CreatePromocionDto;

Backend/GestionIntegral.Api/Models/Dtos/Suscripciones/FacturaDto.cs

@@ -0,0 +1,22 @@
+namespace GestionIntegral.Api.Dtos.Suscripciones
+{
+    /// <summary>
+    /// DTO para enviar la información de una factura generada al frontend.
+    /// Incluye datos enriquecidos como nombres para facilitar su visualización en la UI.
+    /// </summary>
+    public class FacturaDto
+    {
+        public int IdFactura { get; set; }
+        public int IdSuscripcion { get; set; }
+        public string Periodo { get; set; } = string.Empty; // Formato "YYYY-MM"
+        public string FechaEmision { get; set; } = string.Empty; // Formato "yyyy-MM-dd"
+        public string FechaVencimiento { get; set; } = string.Empty; // Formato "yyyy-MM-dd"
+        public decimal ImporteFinal { get; set; }
+        public string Estado { get; set; } = string.Empty;
+        public string? NumeroFactura { get; set; }
+
+        // Datos enriquecidos para la UI, poblados por el servicio
+        public string NombreSuscriptor { get; set; } = string.Empty;
+        public string NombrePublicacion { get; set; } = string.Empty;
+    }
+}

Backend/GestionIntegral.Api/Models/Dtos/Suscripciones/PagoDto.cs

@@ -0,0 +1,17 @@
+namespace GestionIntegral.Api.Dtos.Suscripciones
+{
+    public class PagoDto
+    {
+        public int IdPago { get; set; }
+        public int IdFactura { get; set; }
+        public string FechaPago { get; set; } = string.Empty; // "yyyy-MM-dd"
+        public int IdFormaPago { get; set; }
+        public string NombreFormaPago { get; set; } = string.Empty; // Enriquecido
+        public decimal Monto { get; set; }
+        public string Estado { get; set; } = string.Empty; // "Aprobado", "Rechazado"
+        public string? Referencia { get; set; }
+        public string? Observaciones { get; set; }
+        public int IdUsuarioRegistro { get; set; }
+        public string NombreUsuarioRegistro { get; set; } = string.Empty; // Enriquecido
+    }
+}

Backend/GestionIntegral.Api/Models/Dtos/Suscripciones/ProcesamientoLoteResponseDto.cs

@@ -0,0 +1,11 @@
+namespace GestionIntegral.Api.Dtos.Suscripciones
+{
+    public class ProcesamientoLoteResponseDto
+    {
+        public int TotalRegistrosLeidos { get; set; }
+        public int PagosAprobados { get; set; }
+        public int PagosRechazados { get; set; }
+        public List<string> Errores { get; set; } = new List<string>();
+        public string MensajeResumen { get; set; } = string.Empty;
+    }
+}

Backend/GestionIntegral.Api/Models/Dtos/Suscripciones/PromocionDto.cs

@@ -0,0 +1,13 @@
+namespace GestionIntegral.Api.Dtos.Suscripciones
+{
+    public class PromocionDto
+    {
+        public int IdPromocion { get; set; }
+        public string Descripcion { get; set; } = string.Empty;
+        public string TipoPromocion { get; set; } = string.Empty;
+        public decimal Valor { get; set; }
+        public string FechaInicio { get; set; } = string.Empty; // yyyy-MM-dd
+        public string? FechaFin { get; set; }
+        public bool Activa { get; set; }
+    }
+}