Manual de Usuario.

Sistema de Gestión de Asociación de Básquet

Sitio: onapb.com

¿A quién está dirigido este manual?

OnAPB es utilizado por cuatro tipos de personas. Este manual explica paso a paso qué puede hacer cada una:

📌 Capítulo 1 — Visitante (Sin cuenta)

Cualquier persona puede ingresar a onapb.com sin necesidad de registrarse y acceder a información pública de la liga.

1.1 Página de Inicio (/)

Al entrar al sitio el visitante encuentra:

• Carrusel / Hero: Diapositivas destacadas configuradas por la asociación (noticias importantes, convocatorias, avisos).
• Próximos Partidos: Listado de los eventos más cercanos con día, hora y equipos.
• Noticias recientes: Artículos publicados por OnAPB.
• Sponsors: Franja rotativa con los patrocinadores de la liga visible en el pie de página.

1.2 Cartelera de Eventos (/eventos)

• Ver todos los partidos programados: próximos, en curso y finalizados.
• Cada tarjeta de evento muestra: equipos, categoría, fecha, hora y sede.
• Hacer clic en un evento abre el detalle del partido con información completa.
• Si el partido ya fue jugado, se muestran los marcadores finales.

1.3 Tabla de Posiciones y Goleadores de Torneo

• Desde la sección de torneos se puede ver:
  • Posiciones por grupo o categoría.
  • Tabla de goleadores del torneo con puntos acumulados.
  • Bracket de Playoffs: diagrama del cuadro eliminatorio cuando corresponde.

1.4 Noticias (/noticias)

• Listado de artículos publicados por la asociación con imagen, título y texto completo.

1.5 Lugares con Beneficios (/promos)

La sección Lugares muestra los comercios asociados que ofrecen descuentos y beneficios exclusivos para socios de OnAPB.

Mapa interactivo

• El mapa carga automáticamente al desplazarte a esa sección (carga diferida para mayor velocidad).
• Cada pin tiene el color e ícono del rubro del comercio.
• Al hacer clic en un pin se resalta la tarjeta correspondiente en la lista, y viceversa.
• El mapa usa Google Maps si hay clave configurada, o Leaflet + CARTO como respaldo automático gratuito.

Filtros disponibles

• Buscador de texto: buscá por nombre del local o dirección (filtrado en tiempo real con 180 ms de retardo para no saturar).
• Chips de rubro: filtrá por categoría (Gastronomía, Indumentaria, Salud, etc.). Cada chip tiene el color propio del rubro.
• "Cerca mío": al hacer clic, el sistema solicita tu ubicación GPS y ordena los locales por distancia. La ubicación nunca se accede automáticamente, solo cuando lo pedís explícitamente.

Tarjetas de locales

Cada tarjeta muestra:

• Foto del comercio.
• Mejor beneficio vigente del local (ej. "20% de descuento").
• Nombre, rubro con chip de color, y dirección.
• Distancia aproximada (solo cuando "Cerca mío" está activo).

Los locales con beneficios vigentes aparecen primero. Si activás "Cerca mío", el orden cambia a proximidad.

Ficha del lugar (/lugares/{id})

Al hacer clic en un local se abre su ficha completa, donde podés ver:

• Todos los beneficios vigentes: porcentaje/tipo, cuándo aplica (días de la semana y franja horaria).
• Dirección y botón "Cómo llegar" (abre la app de mapas del teléfono con la ubicación del local).
• Descripción del lugar.

Para canjear un beneficio en el comercio:

1. Estar logueado como socio (jugador o aficionado).
2. Ir al comercio presencialmente.
3. El comercio escanea el código QR del cartel del beneficio (está impreso en el local).
4. El sistema valida el canje con una geocerca de seguridad que confirma que estás en el lugar.

Si no tenés cuenta, el botón de canje te redirige a /asociate para registrarte.

1.6 Tienda OnAPB (/tienda)

La tienda permite comprar merchandising oficial de la APB.

Ver productos

• Grilla de productos disponibles con imagen y precio.
• Los socios (jugadores y aficionados) ven automáticamente los precios con su descuento al estar logueados. El público general ve el precio de lista.

Detalle del producto (/tienda/{slug})

• Imagen, descripción y precio final.
• Seleccioná talla y color de los disponibles para ese producto.
• El botón "Agregar al carrito" se habilita una vez que elegís ambas opciones. Si esa combinación no tiene stock, aparece como "Sin stock".

Carrito (/tienda/carrito)

• Lista de los productos agregados con cantidad y subtotal.
• Podés modificar cantidades o eliminar ítems.
• El total se actualiza automáticamente.

Checkout (/tienda/checkout)

• Resumen del pedido con el total final.
• Completar: Nombre completo, Email, Teléfono (opcional).
• Los pedidos se coordinan para retiro en sede de la APB. No hay envío a domicilio.
• Al confirmar, el sistema registra el pedido y te contactarán para coordinar el retiro.

Pedido confirmado (/tienda/pedido-confirmado)

• Resumen del pedido generado con número de referencia.
• El equipo de OnAPB se pondrá en contacto al email ingresado.

Tip: Iniciá sesión antes de ir al checkout para que tu descuento de socio se aplique automáticamente.

1.7 Clubes (/clubes)

Página pública con información institucional de todos los clubes de la liga.

Listado de clubes (/clubes)

• Grilla de todos los clubes con escudo, nombre, año de fundación y cantidad de equipos.

Ficha del club (/clubes/{id})

Cada club tiene su página propia con:

• Escudo e identidad del club.
• Año de fundación y descripción histórica.
• Palmarés: títulos y logros del club a lo largo del tiempo.
• Estadio / Sede: nombre e historia de la sede donde juega el club.
• Lista de equipos: todos los equipos activos. Hacer clic en un equipo lleva a su página (/equipos/{id}) con el plantel completo.

1.8 Registrarse (/asociate)

Para obtener todos los beneficios del sistema, el visitante puede crear una cuenta. Existen dos vías:

Vía A — Registrarse como Aficionado

1. Ir a /asociate y seleccionar la pestaña "Soy Aficionado".
2. Completar el formulario: Nombre, Apellido, DNI, Email, Fecha de Nacimiento (opcional), Teléfono (opcional), Localidad (opcional), Contraseña.
3. Resolver el captcha de seguridad (Cloudflare Turnstile).
4. Hacer clic en Registrarme.
5. El sistema envía un correo de bienvenida a la dirección ingresada.
6. ✅ Listo. Ya se puede iniciar sesión con DNI y contraseña.

Vía B — Activar cuenta como Jugador Federado

Para jugadores que ya fueron cargados en el sistema por el administrador de su club.

1. Ir a /asociate y seleccionar la pestaña "Soy Jugador".
2. Ingresar Nombre, Apellido y DNI (tal como aparecen en la ficha).
3. Aceptar los términos y hacer clic en Buscar.
4. El sistema valida los datos con el padrón. Si hay coincidencia, muestra la ficha del jugador (nombre, club, categoría).
5. Completar el formulario de activación: Email, Teléfono (opcional), Contraseña.
6. Resolver el captcha de seguridad.
7. Hacer clic en Activar mi cuenta.
8. El sistema envía un correo de bienvenida.
9. ✅ Listo. La cuenta queda activa y se puede iniciar sesión.

Nota: Si el DNI no se encuentra en el padrón de jugadores, el sistema sugiere registrarse como Aficionado.

1.9 Iniciar Sesión

• Desde el menú superior hacer clic en "Iniciar Sesión" o ir a la pantalla de login.
• Se muestra un formulario con dos pestañas:
  • Jugadores / Aficionados: ingresar DNI y contraseña + captcha.
  • Administradores: ingresar usuario y contraseña + captcha.

1.10 Recuperar Contraseña (/recuperar)

En caso de olvidar la contraseña:

1. Ir a /recuperar.
2. Ingresar el DNI y la dirección de email asociados a la cuenta.
3. El sistema envía un enlace de restablecimiento válido por 1 hora.
4. Hacer clic en el enlace del correo y establecer la nueva contraseña (mínimo 6 caracteres, requiere confirmación).

❓ Preguntas Frecuentes

¿Cómo sé si ya tengo una cuenta de jugador? Si sos jugador federado, tu DNI ya está en el sistema cargado por el admin de tu club. Solo debés ir a /asociate → pestaña "Soy Jugador" e ingresar tus datos para activar la cuenta.

¿Puedo tener cuenta de jugador Y de aficionado con el mismo DNI? No. El sistema detecta si ya existe un registro (como jugador o aficionado) y te informa antes de permitir el registro.

¿Qué pasa si el QR que generé fue escaneado? El estado del QR cambia a "Usado" y no puede ser utilizado nuevamente. Cada QR tiene un solo uso.

¿Puedo generar el QR de una promo más de una vez? No. Por cada usuario y cada promoción, solo se puede generar un QR de beneficio.

¿Qué significa cada tipo de QR?

• invitado → Jugador que pertenece a un equipo del partido. Puede generar múltiples (para acompañantes).
• libre_50 → Jugador de categoría Libre. Obtiene descuento del 50% en la entrada.
• publico → Aficionado. Acceso estándar.

¿Cómo funciona el descuento de la tienda para socios? Al estar logueado como jugador o aficionado, los precios de la tienda se muestran automáticamente con tu descuento aplicado. No hace falta hacer nada adicional. El precio que ves en pantalla es el que se cobra.

¿Cómo se coordina el retiro de un pedido de la tienda? La tienda funciona con retiro en sede de la APB. Una vez confirmado el pedido, el equipo de OnAPB te contactará al email o teléfono ingresado para coordinar el día y horario de retiro.

¿Cómo canjeo un beneficio en un comercio? Debés estar logueado como socio, ir al comercio presencialmente y mostrar la app. El comercio escanea el código QR del cartel del beneficio (que tiene impreso en el local). El sistema valida tu presencia con una geocerca.

¿Qué pasa si un beneficio tiene horario o días específicos? En la ficha del lugar (/lugares/{id}) podés ver exactamente cuándo aplica cada beneficio: si es "Jueves y viernes de 18:00 a 23:00", el canje solo se valida en ese horario. Fuera de ese horario, el sistema lo rechaza.

¿Dónde veo la historia e información de un club? En la sección Clubes del menú (/clubes), podés seleccionar cualquier club para ver su ficha completa: año de fundación, descripción, palmarés y estadio. También podés ver los equipos y acceder al plantel de cada uno.

¿Qué son los rubros en el mapa de Lugares? Los rubros son las categorías de los comercios (Gastronomía, Indumentaria, Salud, etc.). Cada rubro tiene un color e ícono propios que se ven en los pines del mapa y en los chips de filtro. Los configura el Súper Admin desde /admin/rubros.

¿El mapa de Lugares siempre usa Google Maps? No necesariamente. Si OnAPB tiene configurada una clave de Google Maps, se usa Google Maps. Si no hay clave o si Google falla, el sistema cambia automáticamente a Leaflet + CARTO (mapa gratuito). La experiencia es la misma en ambos casos.

Manual redactado para el Proyecto Integrador OnAPB — Taller de Integración, FCYT UADER 2026.