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/Data/Repositories/Suscripciones/FacturaRepository.cs

@@ -34,7 +34,7 @@ namespace GestionIntegral.Api.Data.Repositories.Suscripciones
         public async Task<Factura?> GetBySuscripcionYPeriodoAsync(int idSuscripcion, string periodo, IDbTransaction transaction)
         {
             const string sql = "SELECT TOP 1 * FROM dbo.susc_Facturas WHERE IdSuscripcion = @IdSuscripcion AND Periodo = @Periodo;";
-             if (transaction == null || transaction.Connection == null)
+            if (transaction == null || transaction.Connection == null)
             {
                 throw new ArgumentNullException(nameof(transaction), "La transacción o su conexión no pueden ser nulas.");
             }
@@ -55,7 +55,7 @@ namespace GestionIntegral.Api.Data.Repositories.Suscripciones
                 VALUES
                     (@IdSuscripcion, @Periodo, @FechaEmision, @FechaVencimiento, @ImporteBruto, 
                      @DescuentoAplicado, @ImporteFinal, @Estado);";
-            
+
             return await transaction.Connection.QuerySingleAsync<Factura>(sqlInsert, nuevaFactura, transaction);
         }
 
@@ -80,7 +80,7 @@ namespace GestionIntegral.Api.Data.Repositories.Suscripciones
             var rowsAffected = await transaction.Connection.ExecuteAsync(sql, new { NumeroFactura = numeroFactura, IdFactura = idFactura }, transaction);
             return rowsAffected == 1;
         }
-        
+
         public async Task<bool> UpdateLoteDebitoAsync(IEnumerable<int> idsFacturas, int idLoteDebito, IDbTransaction transaction)
         {
             if (transaction == null || transaction.Connection == null)
@@ -91,5 +91,55 @@ namespace GestionIntegral.Api.Data.Repositories.Suscripciones
             var rowsAffected = await transaction.Connection.ExecuteAsync(sql, new { IdLoteDebito = idLoteDebito, IdsFacturas = idsFacturas }, transaction);
             return rowsAffected == idsFacturas.Count();
         }
+
+        public async Task<IEnumerable<(Factura Factura, string NombreSuscriptor, string NombrePublicacion)>> GetByPeriodoEnrichedAsync(string periodo)
+        {
+            const string sql = @"
+                        SELECT  f.*, s.NombreCompleto AS NombreSuscriptor, p.Nombre AS NombrePublicacion
+                        FROM dbo.susc_Facturas f
+                        JOIN dbo.susc_Suscripciones sc ON f.IdSuscripcion = sc.IdSuscripcion
+                        JOIN dbo.susc_Suscriptores s ON sc.IdSuscriptor = s.IdSuscriptor
+                        JOIN dbo.dist_dtPublicaciones p ON sc.IdPublicacion = p.Id_Publicacion
+                        WHERE f.Periodo = @Periodo
+                        ORDER BY s.NombreCompleto;
+                    ";
+            try
+            {
+                using var connection = _connectionFactory.CreateConnection();
+                var result = await connection.QueryAsync<Factura, string, string, (Factura, string, string)>(
+                    sql,
+                    (factura, suscriptor, publicacion) => (factura, suscriptor, publicacion),
+                    new { Periodo = periodo },
+                    splitOn: "NombreSuscriptor,NombrePublicacion"
+                );
+                return result;
+            }
+            catch (Exception ex)
+            {
+                _logger.LogError(ex, "Error al obtener facturas enriquecidas para el período {Periodo}", periodo);
+                return Enumerable.Empty<(Factura, string, string)>();
+            }
+        }
+
+        public async Task<bool> UpdateEstadoYMotivoAsync(int idFactura, string nuevoEstado, string? motivoRechazo, IDbTransaction transaction)
+        {
+            if (transaction == null || transaction.Connection == null)
+            {
+                throw new ArgumentNullException(nameof(transaction), "La transacción o su conexión no pueden ser nulas.");
+            }
+
+            const string sql = @"
+                UPDATE dbo.susc_Facturas SET
+                    Estado = @NuevoEstado,
+                    MotivoRechazo = @MotivoRechazo
+                WHERE IdFactura = @IdFactura;";
+
+            var rowsAffected = await transaction.Connection.ExecuteAsync(
+                sql,
+                new { NuevoEstado = nuevoEstado, MotivoRechazo = motivoRechazo, IdFactura = idFactura },
+                transaction
+            );
+            return rowsAffected == 1;
+        }
     }
 }