Refactor: Mejora la lógica de facturación y la UI

Este commit introduce una refactorización significativa en el módulo de
suscripciones para alinear el sistema con reglas de negocio clave:
facturación consolidada por empresa, cobro a mes adelantado con
imputación de ajustes diferida, y una interfaz de usuario más clara.

Backend:
- **Facturación por Empresa:** Se modifica `FacturacionService` para
  agrupar las suscripciones por cliente y empresa, generando una
  factura consolidada para cada combinación. Esto asegura la correcta
  separación fiscal.
- **Imputación de Ajustes:** Se ajusta la lógica para que la facturación
  de un período (ej. Septiembre) aplique únicamente los ajustes
  pendientes cuya fecha corresponde al período anterior (Agosto).
- **Cierre Secuencial:** Se implementa una validación en
  `GenerarFacturacionMensual` que impide generar la facturación de un
  período si el anterior no ha sido cerrado, garantizando el orden
  cronológico.
- **Emails Consolidados:** El proceso de notificación automática al
  generar el cierre ahora envía un único email consolidado por
  suscriptor, detallando los cargos de todas sus facturas/empresas.
- **Envío de PDF Individual:** Se refactoriza el endpoint de envío manual
  para que opere sobre una `idFactura` individual y adjunte el PDF
  correspondiente si existe.
- **Repositorios Mejorados:** Se optimizan y añaden métodos en
  `FacturaRepository` y `AjusteRepository` para soportar los nuevos
  requisitos de filtrado y consulta de datos consolidados.

Frontend:
- **Separación de Vistas:** La página de "Facturación" se divide en dos:
  - `ProcesosPage`: Para acciones masivas (generar cierre, archivo de
    débito, procesar respuesta).
  - `ConsultaFacturasPage`: Una nueva página dedicada a buscar,
    filtrar y gestionar facturas individuales con una interfaz de doble
    acordeón (Suscriptor -> Empresa).
- **Filtros Avanzados:** La página `ConsultaFacturasPage` ahora incluye
  filtros por nombre de suscriptor, estado de pago y estado de
  facturación.
- **Filtros de Fecha por Defecto:** La página de "Cuenta Corriente"
  ahora filtra por el mes actual por defecto para mejorar el rendimiento
  y la usabilidad.
- **Validación de Fechas:** Se añade lógica en los filtros de fecha para
  impedir la selección de rangos inválidos.
- **Validación de Monto de Pago:** El modal de pago manual ahora impide
  registrar un monto superior al saldo pendiente de la factura.

Frontend/src/pages/Suscripciones/SuscripcionesIndexPage.tsx

@@ -3,80 +3,76 @@ import { Box, Tabs, Tab, Paper, Typography } from '@mui/material';
 import { Outlet, useNavigate, useLocation } from 'react-router-dom';
 import { usePermissions } from '../../hooks/usePermissions';
 
-// Define las pestañas del módulo. Ajusta los permisos según sea necesario.
 const suscripcionesSubModules = [
   { label: 'Suscriptores', path: 'suscriptores', requiredPermission: 'SU001' },
-  { label: 'Facturación', path: 'facturacion', requiredPermission: 'SU006' },
+  { label: 'Consulta Pagos y Facturas', path: 'consulta-facturas', requiredPermission: 'SU006' },
+  { label: 'Cierre y Procesos', path: 'procesos', requiredPermission: 'SU006' },
   { label: 'Promociones', path: 'promociones', requiredPermission: 'SU010' },
 ];
 
 const SuscripcionesIndexPage: React.FC = () => {
-  const navigate = useNavigate();
-  const location = useLocation();
-  const { tienePermiso, isSuperAdmin } = usePermissions();
-  const [selectedSubTab, setSelectedSubTab] = useState<number | false>(false);
-
-  // Filtra los sub-módulos a los que el usuario tiene acceso
-  const accessibleSubModules = suscripcionesSubModules.filter(
-    (subModule) => isSuperAdmin || tienePermiso(subModule.requiredPermission)
-  );
-
-  useEffect(() => {
-    if (accessibleSubModules.length === 0) {
-        // Si no tiene acceso a ningún submódulo, no hacemos nada.
-        // El enrutador principal debería manejar esto.
-        return;
-    }
-
-    const currentBasePath = '/suscripciones';
-    const subPath = location.pathname.startsWith(`${currentBasePath}/`)
-      ? location.pathname.substring(currentBasePath.length + 1)
-      : (location.pathname === currentBasePath ? accessibleSubModules[0]?.path : undefined);
-
-    const activeTabIndex = accessibleSubModules.findIndex(
-      (subModule) => subModule.path === subPath
-    );
-
-    if (activeTabIndex !== -1) {
-      setSelectedSubTab(activeTabIndex);
-    } else if (location.pathname === currentBasePath) {
-      navigate(accessibleSubModules[0].path, { replace: true });
-    } else {
-      setSelectedSubTab(false);
-    }
-  }, [location.pathname, navigate, accessibleSubModules]);
+    const navigate = useNavigate();
+    const location = useLocation();
+    const { tienePermiso, isSuperAdmin } = usePermissions();
+    const [selectedSubTab, setSelectedSubTab] = useState<number | false>(false);
   
-  const handleSubTabChange = (_event: React.SyntheticEvent, newValue: number) => {
-    navigate(accessibleSubModules[newValue].path);
-  };
+    const accessibleSubModules = suscripcionesSubModules.filter(
+      (subModule) => isSuperAdmin || tienePermiso(subModule.requiredPermission)
+    );
+  
+    useEffect(() => {
+        if (accessibleSubModules.length === 0) return;
+    
+        const currentPath = location.pathname;
+        const basePath = '/suscripciones';
+        
+        // Encuentra la pestaña que mejor coincide con la ruta actual
+        const activeTabIndex = accessibleSubModules.findIndex(subModule => 
+            currentPath.startsWith(`${basePath}/${subModule.path}`)
+        );
 
-  if (accessibleSubModules.length === 0) {
-    return <Typography sx={{ p: 2 }}>No tiene permisos para acceder a este módulo.</Typography>;
-  }
-
-  return (
-    <Box>
-      <Typography variant="h5" gutterBottom>Módulo de Suscripciones</Typography>
-      <Paper square elevation={1}>
-        <Tabs
-          value={selectedSubTab}
-          onChange={handleSubTabChange}
-          indicatorColor="primary"
-          textColor="primary"
-          variant="scrollable"
-          scrollButtons="auto"
-          aria-label="sub-módulos de suscripciones"
-        >
-          {accessibleSubModules.map((subModule) => (
-            <Tab key={subModule.path} label={subModule.label} />
-          ))}
-        </Tabs>
-      </Paper>
-      <Box sx={{ pt: 2 }}>
-        <Outlet />
+        if (activeTabIndex !== -1) {
+            setSelectedSubTab(activeTabIndex);
+        } else if (currentPath === basePath && accessibleSubModules.length > 0) {
+            // Si estamos en la raíz del módulo, redirigir a la primera pestaña accesible
+            navigate(accessibleSubModules[0].path, { replace: true });
+        } else {
+            setSelectedSubTab(false); // Ninguna pestaña activa
+        }
+    }, [location.pathname, navigate, accessibleSubModules]);
+    
+    const handleSubTabChange = (_event: React.SyntheticEvent, newValue: number) => {
+      navigate(accessibleSubModules[newValue].path);
+    };
+  
+    if (accessibleSubModules.length === 0) {
+      return <Typography sx={{ p: 2 }}>No tiene permisos para acceder a este módulo.</Typography>;
+    }
+  
+    return (
+      <Box>
+        <Typography variant="h5" gutterBottom>Módulo de Suscripciones</Typography>
+        <Paper square elevation={1}>
+          <Tabs
+            value={selectedSubTab}
+            onChange={handleSubTabChange}
+            indicatorColor="primary"
+            textColor="primary"
+            variant="scrollable"
+            scrollButtons="auto"
+            aria-label="sub-módulos de suscripciones"
+          >
+            {accessibleSubModules.map((subModule) => (
+              <Tab key={subModule.path} label={subModule.label} />
+            ))}
+          </Tabs>
+        </Paper>
+        <Box sx={{ pt: 2 }}>
+          {/* Aquí se renderizará el componente de la sub-ruta activa */}
+          <Outlet />
+        </Box>
       </Box>
-    </Box>
-  );
+    );
 };
 
 export default SuscripcionesIndexPage;