/** * EstimacionController - Controller de estimaciones de obra * * Endpoints REST para gestión de estimaciones periódicas. * Incluye workflow de aprobación: draft -> submitted -> reviewed -> approved -> invoiced -> paid * * @module Estimates */ import { Router, Request, Response, NextFunction } from 'express'; import { DataSource } from 'typeorm'; import { EstimacionService, CreateEstimacionDto, AddConceptoDto, AddGeneradorDto, EstimacionFilters, } from '../services/estimacion.service'; import { AuthMiddleware } from '../../auth/middleware/auth.middleware'; import { AuthService } from '../../auth/services/auth.service'; import { User } from '../../core/entities/user.entity'; import { Tenant } from '../../core/entities/tenant.entity'; import { RefreshToken } from '../../auth/entities/refresh-token.entity'; /** * Local interface for service context */ interface ServiceContext { tenantId: string; userId?: string; } /** * Crear router de estimaciones */ export function createEstimacionController(dataSource: DataSource): Router { const router = Router(); // Repositorios const userRepository = dataSource.getRepository(User); const tenantRepository = dataSource.getRepository(Tenant); const refreshTokenRepository = dataSource.getRepository(RefreshToken); // Servicios const estimacionService = new EstimacionService(dataSource); const authService = new AuthService(userRepository, tenantRepository, refreshTokenRepository as any); const authMiddleware = new AuthMiddleware(authService, dataSource); // Helper para crear contexto de servicio const getContext = (req: Request): ServiceContext => { if (!req.tenantId) { throw new Error('Tenant ID is required'); } return { tenantId: req.tenantId, userId: req.user?.sub, }; }; /** * GET /estimaciones * Listar estimaciones con filtros */ router.get('/', authMiddleware.authenticate, async (req: Request, res: Response, next: NextFunction): Promise => { try { const tenantId = req.tenantId; if (!tenantId) { res.status(400).json({ error: 'Bad Request', message: 'Tenant ID required' }); return; } const page = parseInt(req.query.page as string) || 1; const limit = Math.min(parseInt(req.query.limit as string) || 20, 100); const filters: EstimacionFilters = { contratoId: req.query.contratoId as string, fraccionamientoId: req.query.fraccionamientoId as string, status: req.query.status as any, periodFrom: req.query.periodFrom ? new Date(req.query.periodFrom as string) : undefined, periodTo: req.query.periodTo ? new Date(req.query.periodTo as string) : undefined, }; const result = await estimacionService.findWithFilters(getContext(req), filters, page, limit); res.status(200).json({ items: result.data, total: result.total, page: result.page, limit: result.limit, }); } catch (error) { next(error); } }); /** * GET /estimaciones/summary/:contratoId * Obtener resumen de estimaciones por contrato */ router.get('/summary/:contratoId', authMiddleware.authenticate, async (req: Request, res: Response, next: NextFunction): Promise => { try { const tenantId = req.tenantId; if (!tenantId) { res.status(400).json({ error: 'Bad Request', message: 'Tenant ID required' }); return; } const summary = await estimacionService.getContractSummary(getContext(req), req.params.contratoId); res.status(200).json(summary); } catch (error) { next(error); } }); /** * GET /estimaciones/:id * Obtener estimación con detalles completos */ router.get('/:id', authMiddleware.authenticate, async (req: Request, res: Response, next: NextFunction): Promise => { try { const tenantId = req.tenantId; if (!tenantId) { res.status(400).json({ error: 'Bad Request', message: 'Tenant ID required' }); return; } const estimacion = await estimacionService.findWithDetails(getContext(req), req.params.id); if (!estimacion) { res.status(404).json({ error: 'Not Found', message: 'Estimate not found' }); return; } res.status(200).json(estimacion); } catch (error) { next(error); } }); /** * POST /estimaciones * Crear estimación */ router.post('/', authMiddleware.authenticate, authMiddleware.authorize('admin', 'engineer', 'resident'), async (req: Request, res: Response, next: NextFunction): Promise => { try { const tenantId = req.tenantId; if (!tenantId) { res.status(400).json({ error: 'Bad Request', message: 'Tenant ID required' }); return; } const dto: CreateEstimacionDto = req.body; if (!dto.contratoId || !dto.fraccionamientoId || !dto.periodStart || !dto.periodEnd) { res.status(400).json({ error: 'Bad Request', message: 'contratoId, fraccionamientoId, periodStart and periodEnd are required' }); return; } const estimacion = await estimacionService.createEstimacion(getContext(req), dto); res.status(201).json(estimacion); } catch (error) { next(error); } }); /** * POST /estimaciones/:id/conceptos * Agregar concepto a estimación */ router.post('/:id/conceptos', authMiddleware.authenticate, authMiddleware.authorize('admin', 'engineer', 'resident'), async (req: Request, res: Response, next: NextFunction): Promise => { try { const tenantId = req.tenantId; if (!tenantId) { res.status(400).json({ error: 'Bad Request', message: 'Tenant ID required' }); return; } const dto: AddConceptoDto = req.body; if (!dto.conceptoId || dto.quantityCurrent === undefined || dto.unitPrice === undefined) { res.status(400).json({ error: 'Bad Request', message: 'conceptoId, quantityCurrent and unitPrice are required' }); return; } const concepto = await estimacionService.addConcepto(getContext(req), req.params.id, dto); res.status(201).json(concepto); } catch (error) { if (error instanceof Error && error.message.includes('non-draft')) { res.status(400).json({ error: 'Bad Request', message: error.message }); return; } next(error); } }); /** * POST /estimaciones/conceptos/:conceptoId/generadores * Agregar generador a concepto de estimación */ router.post('/conceptos/:conceptoId/generadores', authMiddleware.authenticate, authMiddleware.authorize('admin', 'engineer', 'resident'), async (req: Request, res: Response, next: NextFunction): Promise => { try { const tenantId = req.tenantId; if (!tenantId) { res.status(400).json({ error: 'Bad Request', message: 'Tenant ID required' }); return; } const dto: AddGeneradorDto = req.body; if (!dto.generatorNumber || dto.quantity === undefined) { res.status(400).json({ error: 'Bad Request', message: 'generatorNumber and quantity are required' }); return; } const generador = await estimacionService.addGenerador(getContext(req), req.params.conceptoId, dto); res.status(201).json(generador); } catch (error) { if (error instanceof Error && error.message === 'Concepto not found') { res.status(404).json({ error: 'Not Found', message: error.message }); return; } next(error); } }); /** * POST /estimaciones/:id/submit * Enviar estimación para revisión */ router.post('/:id/submit', authMiddleware.authenticate, authMiddleware.authorize('admin', 'engineer', 'resident'), async (req: Request, res: Response, next: NextFunction): Promise => { try { const tenantId = req.tenantId; if (!tenantId) { res.status(400).json({ error: 'Bad Request', message: 'Tenant ID required' }); return; } const estimacion = await estimacionService.submit(getContext(req), req.params.id); if (!estimacion) { res.status(400).json({ error: 'Bad Request', message: 'Cannot submit this estimate' }); return; } res.status(200).json(estimacion); } catch (error) { if (error instanceof Error && error.message.includes('Invalid status')) { res.status(400).json({ error: 'Bad Request', message: error.message }); return; } next(error); } }); /** * POST /estimaciones/:id/review * Revisar estimación */ router.post('/:id/review', authMiddleware.authenticate, authMiddleware.authorize('admin', 'engineer', 'director'), async (req: Request, res: Response, next: NextFunction): Promise => { try { const tenantId = req.tenantId; if (!tenantId) { res.status(400).json({ error: 'Bad Request', message: 'Tenant ID required' }); return; } const estimacion = await estimacionService.review(getContext(req), req.params.id); if (!estimacion) { res.status(400).json({ error: 'Bad Request', message: 'Cannot review this estimate' }); return; } res.status(200).json(estimacion); } catch (error) { if (error instanceof Error && error.message.includes('Invalid status')) { res.status(400).json({ error: 'Bad Request', message: error.message }); return; } next(error); } }); /** * POST /estimaciones/:id/approve * Aprobar estimación */ router.post('/:id/approve', authMiddleware.authenticate, authMiddleware.authorize('admin', 'director'), async (req: Request, res: Response, next: NextFunction): Promise => { try { const tenantId = req.tenantId; if (!tenantId) { res.status(400).json({ error: 'Bad Request', message: 'Tenant ID required' }); return; } const estimacion = await estimacionService.approve(getContext(req), req.params.id); if (!estimacion) { res.status(400).json({ error: 'Bad Request', message: 'Cannot approve this estimate' }); return; } res.status(200).json(estimacion); } catch (error) { if (error instanceof Error && error.message.includes('Invalid status')) { res.status(400).json({ error: 'Bad Request', message: error.message }); return; } next(error); } }); /** * POST /estimaciones/:id/reject * Rechazar estimación */ router.post('/:id/reject', authMiddleware.authenticate, authMiddleware.authorize('admin', 'engineer', 'director'), async (req: Request, res: Response, next: NextFunction): Promise => { try { const tenantId = req.tenantId; if (!tenantId) { res.status(400).json({ error: 'Bad Request', message: 'Tenant ID required' }); return; } const { reason } = req.body; if (!reason) { res.status(400).json({ error: 'Bad Request', message: 'reason is required' }); return; } const estimacion = await estimacionService.reject(getContext(req), req.params.id, reason); if (!estimacion) { res.status(400).json({ error: 'Bad Request', message: 'Cannot reject this estimate' }); return; } res.status(200).json(estimacion); } catch (error) { if (error instanceof Error && error.message.includes('Invalid status')) { res.status(400).json({ error: 'Bad Request', message: error.message }); return; } next(error); } }); /** * POST /estimaciones/:id/recalculate * Recalcular totales de estimación */ router.post('/:id/recalculate', authMiddleware.authenticate, authMiddleware.authorize('admin', 'engineer'), async (req: Request, res: Response, next: NextFunction): Promise => { try { const tenantId = req.tenantId; if (!tenantId) { res.status(400).json({ error: 'Bad Request', message: 'Tenant ID required' }); return; } await estimacionService.recalculateTotals(getContext(req), req.params.id); const estimacion = await estimacionService.findWithDetails(getContext(req), req.params.id); res.status(200).json(estimacion); } catch (error) { next(error); } }); /** * DELETE /estimaciones/:id * Eliminar estimación (solo draft) */ router.delete('/:id', authMiddleware.authenticate, authMiddleware.authorize('admin', 'director'), async (req: Request, res: Response, next: NextFunction): Promise => { try { const tenantId = req.tenantId; if (!tenantId) { res.status(400).json({ error: 'Bad Request', message: 'Tenant ID required' }); return; } const estimacion = await estimacionService.findById(getContext(req), req.params.id); if (!estimacion) { res.status(404).json({ error: 'Not Found', message: 'Estimate not found' }); return; } if (estimacion.status !== 'draft') { res.status(400).json({ error: 'Bad Request', message: 'Only draft estimates can be deleted' }); return; } const deleted = await estimacionService.softDelete(getContext(req), req.params.id); if (!deleted) { res.status(404).json({ error: 'Not Found', message: 'Estimate not found' }); return; } res.status(204).send(); } catch (error) { next(error); } }); return router; } export default createEstimacionController;