Feat: Implementa Reporte de Distribución de Suscripciones y Refactoriza Gestión de Ajustes

Se introduce una nueva funcionalidad de reporte crucial para la logística y se realiza una refactorización mayor del sistema de ajustes para garantizar la correcta imputación contable.

### ✨ Nuevas Características

- **Nuevo Reporte de Distribución de Suscripciones (RR011):**
    - Se añade un nuevo reporte en PDF que genera un listado de todas las suscripciones activas en un rango de fechas.
    - El reporte está diseñado para el equipo de reparto, incluyendo datos clave como nombre del suscriptor, dirección, teléfono, días de entrega y observaciones.
    - Se implementa el endpoint, la lógica de servicio, la consulta a la base de datos y el template de QuestPDF en el backend.
    - Se crea la página correspondiente en el frontend (React) con su selector de fechas y se añade la ruta y el enlace en el menú de reportes.

### 🔄 Refactorización Mayor

- **Asociación de Ajustes a Empresas:**
    - Se refactoriza por completo la entidad `Ajuste` para incluir una referencia obligatoria a una `IdEmpresa`.
    - **Motivo:** Corregir un error crítico en la lógica de negocio donde los ajustes de un suscriptor se aplicaban a la primera factura generada, sin importar a qué empresa correspondía el ajuste.
    - Se provee un script de migración SQL para actualizar el esquema de la base de datos (`susc_Ajustes`).
    - Se actualizan todos los DTOs, repositorios y servicios (backend) para manejar la nueva relación.
    - Se modifica el `FacturacionService` para que ahora aplique los ajustes pendientes correspondientes a cada empresa dentro de su bucle de facturación.
    - Se actualiza el formulario de creación/edición de ajustes en el frontend (React) para incluir un selector de empresa obligatorio.

### ⚡️ Optimizaciones de Rendimiento

- **Solución de N+1 Queries:**
    - Se optimiza el método `ObtenerTodos` en `SuscriptorService` para obtener todas las formas de pago en una única consulta en lugar de una por cada suscriptor.
    - Se optimiza el método `ObtenerAjustesPorSuscriptor` en `AjusteService` para obtener todos los nombres de usuarios y empresas en dos consultas masivas, en lugar de N consultas individuales.
    - Se añade el método `GetByIdsAsync` al `IUsuarioRepository` y su implementación para soportar esta optimización.

### 🐛 Corrección de Errores

- Se corrigen múltiples errores en el script de migración de base de datos (uso de `GO` dentro de transacciones, error de "columna inválida").
- Se soluciona un error de SQL (`INSERT` statement) en `AjusteRepository` que impedía la creación de nuevos ajustes.
- Se corrige un bug en el `AjusteService` que causaba que el nombre de la empresa apareciera como "N/A" en la UI debido a un mapeo incompleto en el método optimizado.
- Se corrige la lógica de generación de emails en `FacturacionService` para mostrar correctamente el nombre de la empresa en cada sección del resumen de cuenta.

Frontend/src/components/Modals/Suscripciones/AjusteFormModal.tsx

@@ -1,10 +1,9 @@
-// Archivo: Frontend/src/components/Modals/Suscripciones/AjusteFormModal.tsx
-
 import React, { useState, useEffect } from 'react';
 import { Modal, Box, Typography, TextField, Button, CircularProgress, Alert, FormControl, InputLabel, Select, MenuItem, type SelectChangeEvent, InputAdornment } from '@mui/material';
 import type { CreateAjusteDto } from '../../../models/dtos/Suscripciones/CreateAjusteDto';
 import type { UpdateAjusteDto } from '../../../models/dtos/Suscripciones/UpdateAjusteDto';
 import type { AjusteDto } from '../../../models/dtos/Suscripciones/AjusteDto';
+import type { EmpresaDropdownDto } from '../../../models/dtos/Distribucion/EmpresaDropdownDto';
 
 const modalStyle = {
   position: 'absolute' as 'absolute',
@@ -27,9 +26,10 @@ interface AjusteFormModalProps {
   idSuscriptor: number;
   errorMessage?: string | null;
   clearErrorMessage: () => void;
+  empresas: EmpresaDropdownDto[];
 }
 
-const AjusteFormModal: React.FC<AjusteFormModalProps> = ({ open, onClose, onSubmit, idSuscriptor, errorMessage, clearErrorMessage, initialData }) => {
+const AjusteFormModal: React.FC<AjusteFormModalProps> = ({ open, onClose, onSubmit, idSuscriptor, errorMessage, clearErrorMessage, initialData, empresas }) => {
   const [formData, setFormData] = useState<AjusteFormData>({});
   const [loading, setLoading] = useState(false);
   const [localErrors, setLocalErrors] = useState<{ [key: string]: string | null }>({});
@@ -38,16 +38,16 @@ const AjusteFormModal: React.FC<AjusteFormModalProps> = ({ open, onClose, onSubm
 
   useEffect(() => {
     if (open) {
-      // Formatear fecha correctamente: el DTO de Ajuste tiene FechaAlta con hora, pero el input necesita "yyyy-MM-dd"
       const fechaParaFormulario = initialData?.fechaAjuste
-        ? initialData.fechaAjuste.split(' ')[0] // Tomar solo la parte de la fecha
+        ? initialData.fechaAjuste.split(' ')[0]
         : new Date().toISOString().split('T')[0];
 
       setFormData({
         idSuscriptor: initialData?.idSuscriptor || idSuscriptor,
+        idEmpresa: initialData?.idEmpresa || undefined, // undefined para que el placeholder se muestre
         fechaAjuste: fechaParaFormulario,
         tipoAjuste: initialData?.tipoAjuste || 'Credito',
-        monto: initialData?.monto || undefined, // undefined para que el placeholder se muestre
+        monto: initialData?.monto || undefined,
         motivo: initialData?.motivo || ''
       });
       setLocalErrors({});
@@ -56,6 +56,7 @@ const AjusteFormModal: React.FC<AjusteFormModalProps> = ({ open, onClose, onSubm
 
   const validate = (): boolean => {
     const errors: { [key: string]: string | null } = {};
+    if (!formData.idEmpresa) errors.idEmpresa = "Debe seleccionar una empresa.";
     if (!formData.fechaAjuste) errors.fechaAjuste = "La fecha es obligatoria.";
     if (!formData.tipoAjuste) errors.tipoAjuste = "Seleccione un tipo.";
     if (!formData.monto || formData.monto <= 0) errors.monto = "El monto debe ser mayor a cero.";
@@ -64,7 +65,6 @@ const AjusteFormModal: React.FC<AjusteFormModalProps> = ({ open, onClose, onSubm
     return Object.keys(errors).length === 0;
   };
 
-  // --- HANDLERS CON TIPADO EXPLÍCITO ---
   const handleInputChange = (e: React.ChangeEvent<HTMLInputElement>) => {
     const { name, value } = e.target;
     setFormData((prev: AjusteFormData) => ({
@@ -75,7 +75,7 @@ const AjusteFormModal: React.FC<AjusteFormModalProps> = ({ open, onClose, onSubm
     if (errorMessage) clearErrorMessage();
   };
 
-  const handleSelectChange = (e: SelectChangeEvent<string>) => { // Tipado como string
+  const handleSelectChange = (e: SelectChangeEvent<string | number>) => { // Acepta string o number
     const { name, value } = e.target;
     setFormData((prev: AjusteFormData) => ({ ...prev, [name]: value }));
     if (localErrors[name]) setLocalErrors(prev => ({ ...prev, [name]: null }));
@@ -108,7 +108,25 @@ const AjusteFormModal: React.FC<AjusteFormModalProps> = ({ open, onClose, onSubm
       <Box sx={modalStyle}>
         <Typography variant="h6">{isEditing ? 'Editar Ajuste Manual' : 'Registrar Ajuste Manual'}</Typography>
         <Box component="form" onSubmit={handleSubmit} sx={{ mt: 2 }}>
+
           <TextField name="fechaAjuste" label="Fecha del Ajuste" type="date" value={formData.fechaAjuste || ''} onChange={handleInputChange} required fullWidth margin="dense" InputLabelProps={{ shrink: true }} error={!!localErrors.fechaAjuste} helperText={localErrors.fechaAjuste} />
+          <FormControl fullWidth margin="dense" required error={!!localErrors.idEmpresa}>
+            <InputLabel id="empresa-label">Empresa</InputLabel>
+            <Select
+              name="idEmpresa"
+              labelId="empresa-label"
+              value={formData.idEmpresa || ''}
+              onChange={handleSelectChange}
+              label="Empresa"
+            >
+              {empresas.map((empresa) => (
+                <MenuItem key={empresa.idEmpresa} value={empresa.idEmpresa}>
+                  {empresa.nombre}
+                </MenuItem>
+              ))}
+            </Select>
+            {localErrors.idEmpresa && <Typography color="error" variant="caption">{localErrors.idEmpresa}</Typography>}
+          </FormControl>
           <FormControl fullWidth margin="dense" error={!!localErrors.tipoAjuste}>
             <InputLabel id="tipo-ajuste-label" required>Tipo de Ajuste</InputLabel>
             <Select name="tipoAjuste" labelId="tipo-ajuste-label" value={formData.tipoAjuste || ''} onChange={handleSelectChange} label="Tipo de Ajuste">
@@ -116,12 +134,16 @@ const AjusteFormModal: React.FC<AjusteFormModalProps> = ({ open, onClose, onSubm
               <MenuItem value="Debito">Débito (Cargo extra al cliente)</MenuItem>
             </Select>
           </FormControl>
+
           <TextField name="monto" label="Monto" type="number" value={formData.monto || ''} onChange={handleInputChange} required fullWidth margin="dense" error={!!localErrors.monto} helperText={localErrors.monto} InputProps={{ startAdornment: <InputAdornment position="start">$</InputAdornment> }} inputProps={{ step: "0.01" }} />
           <TextField name="motivo" label="Motivo" value={formData.motivo || ''} onChange={handleInputChange} required fullWidth margin="dense" multiline rows={3} error={!!localErrors.motivo} helperText={localErrors.motivo} />
+
           <Alert severity="info" sx={{ mt: 2 }}>
-            Nota: Este ajuste se aplicará en la facturación del período correspondiente a la "Fecha del Ajuste".
+            Nota: Este ajuste se aplicará a la factura de la <strong>empresa seleccionada</strong> en el período correspondiente a la "Fecha del Ajuste".
           </Alert>
+
           {errorMessage && <Alert severity="error" sx={{ mt: 2 }}>{errorMessage}</Alert>}
+
           <Box sx={{ mt: 3, display: 'flex', justifyContent: 'flex-end', gap: 1 }}>
             <Button onClick={onClose} color="secondary" disabled={loading}>Cancelar</Button>
             <Button type="submit" variant="contained" disabled={loading}>

Frontend/src/components/Modals/Suscripciones/SuscriptorFormModal.tsx

@@ -79,24 +79,41 @@ const SuscriptorFormModal: React.FC<SuscriptorFormModalProps> = ({ open, onClose
     if (!formData.nroDocumento?.trim()) errors.nroDocumento = 'El número de documento es obligatorio.';
     if (!formData.idFormaPagoPreferida) errors.idFormaPagoPreferida = 'La forma de pago es obligatoria.';
 
-    if (CBURequerido) {
-      if (!formData.cbu || formData.cbu.trim().length !== 22) {
-        errors.cbu = 'El CBU es obligatorio y debe tener 22 dígitos.';
-      }
-    } else if (formData.cbu && formData.cbu.trim().length > 0 && formData.cbu.trim().length !== 22) {
-      errors.cbu = 'El CBU debe tener 22 dígitos o estar vacío.';
+    // Validar formato de Nro de Documento (solo números)
+    if (formData.nroDocumento && !/^[0-9]+$/.test(formData.nroDocumento)) {
+      errors.nroDocumento = 'El documento solo debe contener números.';
     }
 
+    // Validar formato de Email
     if (formData.email && !/^\S+@\S+\.\S+$/.test(formData.email)) {
       errors.email = 'El formato del email no es válido.';
     }
+
+    // Validar formato y longitud de CBU
+    if (CBURequerido) {
+      if (!formData.cbu || !/^[0-9]+$/.test(formData.cbu) || formData.cbu.length !== 22) {
+        errors.cbu = 'El CBU es obligatorio y debe tener 22 dígitos numéricos.';
+      }
+    } else if (formData.cbu && formData.cbu.trim().length > 0 && (!/^[0-9]+$/.test(formData.cbu) || formData.cbu.length !== 26)) {
+      errors.cbu = 'El CBU debe tener 22 dígitos numéricos o estar vacío.';
+    }
+
     setLocalErrors(errors);
     return Object.keys(errors).length === 0;
   };
 
+  // --- HANDLER DE INPUT MEJORADO ---
   const handleInputChange = (e: React.ChangeEvent<HTMLInputElement>) => {
     const { name, value } = e.target;
-    setFormData(prev => ({ ...prev, [name]: value }));
+
+    // Prevenir entrada de caracteres no numéricos para CBU y NroDocumento
+    if (name === 'cbu' || name === 'nroDocumento') {
+      const numericValue = value.replace(/[^0-9]/g, '');
+      setFormData(prev => ({ ...prev, [name]: numericValue }));
+    } else {
+      setFormData(prev => ({ ...prev, [name]: value }));
+    }
+
     if (localErrors[name]) setLocalErrors(prev => ({ ...prev, [name]: null }));
     if (errorMessage) clearErrorMessage();
   };
@@ -164,7 +181,7 @@ const SuscriptorFormModal: React.FC<SuscriptorFormModalProps> = ({ open, onClose
                 <MenuItem value="CUIL">CUIL</MenuItem>
               </Select>
             </FormControl>
-            <TextField name="nroDocumento" label="Nro Documento" value={formData.nroDocumento || ''} onChange={handleInputChange} required fullWidth margin="dense" sx={{ flex: 2 }} error={!!localErrors.nroDocumento} helperText={localErrors.nroDocumento} disabled={loading} />
+            <TextField name="nroDocumento" label="Nro Documento" value={formData.nroDocumento || ''} onChange={handleInputChange} required fullWidth margin="dense" sx={{ flex: 2 }} error={!!localErrors.nroDocumento} helperText={localErrors.nroDocumento} disabled={loading} inputProps={{ maxLength: 11 }} />
           </Box>
           <FormControl fullWidth margin="dense" error={!!localErrors.idFormaPagoPreferida}>
             <InputLabel id="forma-pago-label" required>Forma de Pago</InputLabel>