2

misc/HOJA-DE-RUTA.md

@@ -0,0 +1,92 @@
+# Hoja de Ruta - Migración a Laravel
+
+## Fase 1: Fundamentos (✅ Completado)
+- Modelos Eloquent
+- Controladores RESTful
+- Rutas API
+- Layout base + Welcome
+
+## Fase 2: Autenticación (✅ Completado)
+- AuthController (login/logout player + admin)
+- Recuperar contraseña (token + email + vista reset ✅)
+- Registro de jugadores/aficionados
+- Middlewares de autenticación
+
+## Fase 3: Vistas Públicas (✅ Completado)
+- Vista eventos (lista)
+- Vista evento_detalle
+- Vista promos (mapa/lista)
+- Vista asociate (registro)
+- Vista noticias
+
+## Fase 4: Panel de Usuario (✅ Completado)
+- Dashboard usuario
+- Mis QRs
+- Solicitar QR para eventos ✅
+- Generar QR para promociones ✅
+
+## Fase 5: Admin - Gestión (✅ Completado)
+- [x] ABM Clubes (API ✅, vistas ✅)
+- [x] ABM Equipos (API ✅, vistas ✅)
+- [x] ABM Jugadores (API ✅, vistas ✅)
+- [x] ABM Eventos (API ✅, CRUD completo ✅)
+- [x] ABM Promociones/Lugares (✅)
+- [x] ABM Noticias (API ✅, vistas ✅)
+- [x] Escanear/validar QR (✅)
+
+## Fase 6: Pagos - Banco Macro (⏳ Pendiente - esperando credenciales)
+
+### 6.1 Configuración Inicial
+- [ ] Obtener credenciales de Banco Macro (CLIENT_ID, CLIENT_SECRET)
+- [ ] Configurar ambiente sandbox
+- [ ] Configurar webhook
+
+### 6.2 Modelado de Datos
+- [ ] Crear modelo ConceptoPago
+- [ ] Crear modelo Deuda
+- [ ] Extender modelo PagoMp existente
+
+### 6.3 Backend - API
+- [ ] CRUD conceptos de pago
+- [ ] CRUD deudas
+- [ ] Generación masiva de deudas (ej: cuota a todos)
+- [ ] Integración Botón Integrado Macro Click
+- [ ] Endpoint webhook para notificaciones
+- [ ] Endpoint validación de pagos
+
+### 6.4 Frontend - Panel Usuario
+- [ ] Sección "Mis Pagos" en panel usuario
+- [ ] Listado de deudas pendientes
+- [ ] Historial de pagos
+- [ ] Componente Botón Integrado (formulario embebido)
+- [ ] Estados de éxito/error del pago
+
+### 6.5 Panel Admin - Gestión de Pagos
+- [ ] Dashboard de deudas y cobros
+- [ ] Crear sanción individual a jugador
+- [ ] Generar cuotas masivas por club/equipo
+- [ ] Validación manual de pagos
+- [ ] Reportes (Excel/PDF)
+
+## Fase 7: Panel Usuario - QRs y Pagos (✅ Completado parcial)
+- [x] Solicitar QR para evento (desde detalle de evento)
+- [x] Generar QR tras solicitud (sin pago por ahora, Fase 6 pendiente)
+- [x] Visualizar mis QRs activos (con estado válido/usado)
+- [x] Generar QR para promociones (desde vista de promos)
+- [ ] Integrar generación de QR tras pago exitoso (depende de Fase 6)
+
+## Fase 8: Varias (✅ Completado parcial)
+- [x] Completar recuperar contraseña (vista reset + proceso completo)
+- [x] Fix formulario recuperar contraseña (HTML roto)
+- [ ] Envío de emails (deuda generada, pago confirmado) — depende de config SMTP
+- [x] Limpieza links admin (editar/eliminar desde detalle evento, promos admin)
+- [ ] Testing webhooks — depende de Fase 6
+
+---
+
+## Notas
+
+- **Fase 6 reemplaza MercadoPago** por Macro Click de Banco Macro
+- La integración será mediante **Botón Integrado** (pago dentro de la app)
+- El sistema permitirá autogestión de pagos por parte de los jugadores
+- **Reset password** incluye enlace de desarrollo directo (en producción, se enviaría por email)