# 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
```bash
docker compose up -d --build          # Desplegar todo
docker compose logs backend -f        # Logs backend
docker compose down -v                # Borrar datos y reiniciar
```