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/PromocionRepository.cs

@@ -0,0 +1,93 @@
+using Dapper;
+using GestionIntegral.Api.Models.Suscripciones;
+using System.Data;
+using System.Text;
+
+namespace GestionIntegral.Api.Data.Repositories.Suscripciones
+{
+    public class PromocionRepository : IPromocionRepository
+    {
+        private readonly DbConnectionFactory _connectionFactory;
+        private readonly ILogger<PromocionRepository> _logger;
+
+        public PromocionRepository(DbConnectionFactory factory, ILogger<PromocionRepository> logger)
+        {
+            _connectionFactory = factory;
+            _logger = logger;
+        }
+
+        public async Task<IEnumerable<Promocion>> GetAllAsync(bool soloActivas)
+        {
+            var sql = new StringBuilder("SELECT * FROM dbo.susc_Promociones");
+            if(soloActivas)
+            {
+                sql.Append(" WHERE Activa = 1");
+            }
+            sql.Append(" ORDER BY FechaInicio DESC;");
+
+            using var connection = _connectionFactory.CreateConnection();
+            return await connection.QueryAsync<Promocion>(sql.ToString());
+        }
+
+        public async Task<Promocion?> GetByIdAsync(int id)
+        {
+            const string sql = "SELECT * FROM dbo.susc_Promociones WHERE IdPromocion = @Id;";
+            using var connection = _connectionFactory.CreateConnection();
+            return await connection.QuerySingleOrDefaultAsync<Promocion>(sql, new { Id = id });
+        }
+
+        public async Task<Promocion?> CreateAsync(Promocion nuevaPromocion, IDbTransaction transaction)
+        {
+            const string sql = @"
+                INSERT INTO dbo.susc_Promociones (Descripcion, TipoPromocion, Valor, FechaInicio, FechaFin, Activa, IdUsuarioAlta, FechaAlta)
+                OUTPUT INSERTED.*
+                VALUES (@Descripcion, @TipoPromocion, @Valor, @FechaInicio, @FechaFin, @Activa, @IdUsuarioAlta, GETDATE());";
+
+            if (transaction?.Connection == null)
+            {
+                throw new ArgumentNullException(nameof(transaction.Connection), "La conexión de la transacción no puede ser nula.");
+            }
+
+            return await transaction.Connection.QuerySingleAsync<Promocion>(sql, nuevaPromocion, transaction);
+        }
+
+        public async Task<bool> UpdateAsync(Promocion promocion, IDbTransaction transaction)
+        {
+            const string sql = @"
+                UPDATE dbo.susc_Promociones SET
+                    Descripcion = @Descripcion,
+                    TipoPromocion = @TipoPromocion,
+                    Valor = @Valor,
+                    FechaInicio = @FechaInicio,
+                    FechaFin = @FechaFin,
+                    Activa = @Activa
+                WHERE IdPromocion = @IdPromocion;";
+
+            if (transaction?.Connection == null)
+            {
+                throw new ArgumentNullException(nameof(transaction.Connection), "La conexión de la transacción no puede ser nula.");
+            }
+
+            var rows = await transaction.Connection.ExecuteAsync(sql, promocion, transaction);
+            return rows == 1;
+        }
+
+        public async Task<IEnumerable<Promocion>> GetPromocionesActivasParaSuscripcion(int idSuscripcion, DateTime fechaPeriodo, IDbTransaction transaction)
+        {
+            const string sql = @"
+                SELECT p.* FROM dbo.susc_Promociones p
+                JOIN dbo.susc_SuscripcionPromociones sp ON p.IdPromocion = sp.IdPromocion
+                WHERE sp.IdSuscripcion = @IdSuscripcion
+                  AND p.Activa = 1
+                  AND p.FechaInicio <= @FechaPeriodo
+                  AND (p.FechaFin IS NULL OR p.FechaFin >= @FechaPeriodo);";
+
+            if (transaction?.Connection == null)
+            {
+                throw new ArgumentNullException(nameof(transaction.Connection), "La conexión de la transacción no puede ser nula.");
+            }
+
+            return await transaction.Connection.QueryAsync<Promocion>(sql, new { IdSuscripcion = idSuscripcion, FechaPeriodo = fechaPeriodo }, transaction);
+        }
+    }
+}