ContabilidadSaPolar/INIT_SUMMARY.md

Resumen del Proyecto

Fase actual: V11 (COMPLETADA) — Refactor Financiero

Estado actual (Julio 2026)

El proyecto Sa Polar está operativo con Docker Compose y todos los endpoints verificados.

Última sesión — Refactor V11: Dividir Ingresos/Gastos en Recibos y Plantillas

Objetivo: Migrar del modelo plano incomes/expenses a un modelo más escalable con recibos de ingresos, plantillas de gastos y recibos de gastos.

Cambios realizados:

Backend:

• Creadas 3 nuevas entidades: IncomeReceipt, ExpenseTemplate, ExpenseReceipt
• Creados repositorios: IncomeReceiptRepository, ExpenseTemplateRepository, ExpenseReceiptRepository
• Creados servicios: IncomeReceiptService, ExpenseTemplateService, ExpenseReceiptService
• Creados controladores: IncomeReceiptController, ExpenseTemplateController, ExpenseReceiptController
• Creado ExpenseScheduler para generación automática de recibos desde plantillas
• Refactorizados: PdfReceiptService, EmailReceiptService, ReceiptService, ReceiptController, ReportService, DashboardService, MaintenanceService, EmailLog (income_id → income_receipt_id)
• Eliminadas entidades antiguas: Income.java, Expense.java y sus repos, servicios, controladores

Base de datos:

• Creada migración V11 con 3 nuevas tablas y modificación de email_log
• Actualizados db/init.sql y db/seed.sql
• 25 tablas total (antes 23)

Frontend:

• Creadas páginas: IncomeReceipts.tsx, ExpenseTemplates.tsx, ExpenseReceipts.tsx
• Actualizados: Layout.tsx, App.tsx, api.ts, resources.ts
• Eliminadas páginas antiguas: Incomes.tsx, Expenses.tsx

Infraestructura:

• docker compose down -v && docker compose up -d --build exitoso
• Login verificado exitosamente con admin/admin123

Pendiente para V12:

• Terminar páginas avanzadas de frontend (IncomeReceipts, ExpenseTemplates, ExpenseReceipts con buscadores, filtros, etc.)
• Funcionalidad de inventario
• Candidatos
• Gestión de temporada
• Tests, CI/CD

Credenciales

• Usuario: admin | Contraseña: admin123

Comandos rápidos

docker compose up -d --build          # Desplegar todo
docker compose logs backend -f        # Logs backend
docker compose down -v                # Borrar datos y reiniciar