Ahora si :))))

2026-06-04 15:02:32 -03:00
parent 8fc619f9e7
commit 8af8ed4454
40 changed files with 2918 additions and 0 deletions
@@ -0,0 +1,42 @@
+# Análisis de Requisitos del Sistema (OnAPB)
+
+En base a la imagen `requerimientos.jpeg` y la inspección del código fuente actual, aquí está el detalle de qué puntos cumple el sistema, cuáles faltan por desarrollar, y cuáles dependen exclusivamente de la presentación oral.
+
+## ✅ Requisitos Cumplidos (Implementados en Software)
+
+| Punto | Descripción | Estado en el Sistema |
+| :---: | :--- | :--- |
+| **1** | **Innovación** | **Cumple.** La implementación de un sistema de códigos QR digitales para el acceso a eventos y manejo de "Pases" de jugadores digitaliza procesos típicamente manuales o en papel. |
+| **2** | **Investigación durante el desarrollo** | **Cumple.** Se evidencia el uso del framework Laravel 11, sistema de autenticación custom (aficionados/jugadores/admin), y estructuración de base de datos relacional. |
+| **6** | **Justificación de Ingeniería de Software** | **Cumple.** El sistema utiliza un patrón arquitectónico claro (MVC provisto por Laravel), ORM (Eloquent), migraciones de base de datos y un enrutamiento ordenado. |
+| **7** | **Conocimiento del negocio** | **Cumple.** El software modela perfectamente la lógica de una asociación de básquet: Clubes, Equipos, Jugadores, pases interclubes, categorías por edad y gestión de aforos de QRs por partido. |
+| **9** | **Completitud de software** | **Parcialmente Cumplido.** El sistema tiene paneles de usuario y admin muy completos (fases 1 a 5 de la Hoja de Ruta). Sin embargo, la **Fase 6 (Pagos con Banco Macro)** está pendiente. |
+
+---
+
+## ❌ Requisitos Faltantes (Deuda Técnica a Resolver)
+
+| Punto | Descripción | Lo que falta hacer |
+| :---: | :--- | :--- |
+| **8** | **Pruebas y errores, end-to-end** | **FALTA.** La carpeta `tests/` está vacía (solo tiene el test de ejemplo de Laravel). No hay pruebas unitarias (PHPUnit) ni pruebas de integración o E2E (Laravel Dusk) configuradas ni ejecutadas. |
+| **10** | **Recuperación ante fallos/desastres** | **FALTA.** No hay un sistema de copias de seguridad de la base de datos (ej. Laravel Backup). Además, los modelos actuales **no usan SoftDeletes**, por lo que si un admin elimina un equipo, jugador o evento, los datos **se pierden permanentemente** (Hard Delete) y pueden romper relaciones. |
+| **13** | **Documentación Técnica y de Usuario** | **FALTA.** El archivo `README.md` del repositorio es el que viene por defecto con Laravel original en inglés. La `HOJA-DE-RUTA.md` es solo un checklist. Se necesita redactar un manual de usuario (ej: cómo usar el panel admin) y un manual técnico (cómo instalar el proyecto, variables de entorno, esquema de BD). |
+
+---
+
+## 🗣️ Requisitos que NO dependen del software (Evaluación Oral/Grupal)
+
+Estos puntos no se programan, sino que se evaluarán durante la defensa del proyecto:
+
+* **3 - Tiempo/dedicación en finalizar.** (Se demuestra presentando el volumen de trabajo hecho, que es bastante amplio).
+* **4 - Exposición oral.**
+* **5 - Evaluación de dinámica grupal.**
+* **11 - Revisiones de procesos y sugerencias por parte de los profesionales.** (Conclusiones del grupo).
+* **12 - Pruebas y errores durante la exposición (datos reales).** (Asegúrense de tener la base de datos poblada con clubes, jugadores y eventos reales o realistas el día de la presentación).
+
+---
+
+### 🚀 Siguientes pasos recomendados para aprobar:
+1. Reemplazar el `README.md` por documentación real técnica y de usuario.
+2. Añadir `SoftDeletes` a las tablas críticas (`jugadores`, `clubes`, `equipos`, `eventos`) para cumplir el Punto 10.
+3. Escribir al menos 3 o 4 Tests básicos (Feature tests) simulando el login y la emisión de QRs para cubrir el Punto 8.