Guia para usar el sistema

1. Registro de usuario

Desde el login, el usuario presiona Registrarme y completa nombre, correo, usuario, telefono y contrasena.

2. Activacion e inicio de sesion

1. El usuario revisa su correo y abre el enlace recibido.
2. Tambien puede entrar a Activar cuenta y escribir el codigo de 6 caracteres.
3. Cuando la cuenta queda activa, vuelve al login.
4. Puede iniciar sesion usando correo o nombre de usuario.
5. Si olvida la contrasena, usa Olvide contrasena para recibir un enlace de recuperacion.

3. Roles y permisos

4. Preparar catalogos

Antes de anotar juegos se recomienda crear la base en este orden:

1. Temporadas.
2. Torneos dentro de la temporada.
3. Equipos, con logo y color si estan disponibles.
4. Jugadores, con numero, posicion, foto, tallas, correo y telefono cuando aplique.
5. Campos de juego si se usaran ubicaciones.

5. Ejemplo: crear una temporada

1. Entra a Catalogos > Temporadas.
2. Presiona Nuevo.
3. Escribe el nombre, por ejemplo Temporada 2026.
4. Escribe el ano, por ejemplo 2026.
5. Deja marcada la opcion Activo.
6. Presiona Guardar para guardar y seguir creando, o Guardar y volver a la lista.

6. Crear y anotar juegos

1. Entra a Anotacion y presiona Crear juego.
2. Selecciona temporada, torneo, fecha, equipos, innings y pitchers iniciales si se conocen.
3. Guarda y abre el centro de anotacion.
4. Con el juego programado, puedes preparar el Lineup de ambos equipos.
5. Cuando el partido vaya a comenzar, presiona Iniciar juego. Esto marca hora de inicio y abre turnos, marcador, pitcheo, errores y cierre.
6. En Turno, el bateador debe venir del lineup y en orden de bateo. El pitcher se mantiene hasta que se cambie.
7. En Marcador, puedes corregir carreras, hits y errores por inning si la anotacion automatica necesita ajuste.
8. En Pitcheo, registra o corrige actuacion de pitchers. Solo puede haber un PG, un PP y un SV por juego.
9. Al terminar, usa Cierre. El sistema valida que existan las anotaciones minimas necesarias antes de finalizar.

7. Hojas fisicas, plantillas y revision

El sistema permite trabajar con hojas de anotacion impresas para evitar depender de laptop, tablet o celular durante el juego. Este flujo es ideal cuando el anotador lleva el juego en papel y luego se sube la imagen al sistema para revisar y cargar datos.

Que hace hoy el sistema

1. Desde el juego, puedes imprimir o guardar PDF de la hoja de anotacion.
2. La hoja se genera con los datos del juego, equipos, fecha, torneo, innings, numero de juego y version impresa.
3. Si el juego tiene lineup, la hoja imprime los jugadores en orden. Si no tiene lineup, deja los nombres vacios para completarlos a mano.
4. La hoja incluye espacios para marcador, turnos por inning, diamante de avance de corredores, totales, pitchers, sustituciones, datos obligatorios y observaciones.
5. Cuando subes una foto o PDF de la hoja, el sistema crea una bandeja/lote de revision.
6. En la lista de hojas subidas aparece el boton Revisar.
7. En Revisar puedes ver la imagen original y capturar los datos por secciones: Lineup, Marcador, Turnos, Pitcheo y Errores.
8. Lineup se guarda directo en el juego, porque es la base para validar bateadores y orden.
9. Marcador, turnos, pitcheo y errores se guardan primero en tablas temporales de revision.
10. Cuando todo este verificado, presiona Publicar revision para mover esos datos a las tablas reales y afectar estadisticas.

Versiones de hoja y control

Si ya existen anotaciones cargadas

Si el juego ya tiene datos cargados desde la web y luego subes una hoja manual, la hoja debe usarse como revision/auditoria. No se debe publicar automaticamente sin comparar, porque puede haber diferencias entre lo anotado en vivo y lo escrito en papel.

Permisos para subir imagenes

Para cargar fotos de jugadores, logos, organizaciones y hojas fisicas, el servidor debe permitir escritura en public/uploads.

chown -R www:www public/uploads
chmod -R 775 public/uploads

8. Resultados, estadisticas y reportes