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.
78 lines
3.0 KiB
TypeScript
78 lines
3.0 KiB
TypeScript
import React, { useState, useEffect } from 'react';
|
|
import { Box, Tabs, Tab, Paper, Typography } from '@mui/material';
|
|
import { Outlet, useNavigate, useLocation } from 'react-router-dom';
|
|
import { usePermissions } from '../../hooks/usePermissions';
|
|
|
|
const suscripcionesSubModules = [
|
|
{ label: 'Suscriptores', path: 'suscriptores', requiredPermission: 'SU001' },
|
|
{ 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);
|
|
|
|
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 (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>
|
|
);
|
|
};
|
|
|
|
export default SuscripcionesIndexPage; |