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.

¿Dónde veo lo que tengo que pagar a la Asociación? En tu panel, en la tarjeta "Mis cobros", o directamente en /mis-cobros. Ahí ves lo pendiente, lo vencido, el total que debés y el historial de lo que pagaste, con el recibo de cada pago. Si no tenés cobros, la tarjeta no aparece. Los aficionados no tienen cobros.

¿Cómo pago un cobro? Por ahora no se paga online: pagás en la sede de la Asociación o por transferencia, según las instrucciones que figuran en /mis-cobros. Cuando la Asociación registra el pago, el cobro pasa a "Pagado", te llega una notificación y ya podés bajar el recibo.

¿Qué pasa si un cobro vence? Te avisamos por notificación (y por push, si las activaste) cuando faltan 3 días y cuando venció. En /mis-cobros y en tu panel aparece un aviso destacado con los pagos vencidos. Regularizalo en la sede o por transferencia.

¿Puedo ver los cobros de otro jugador o de mi club? No. Cada jugador ve solamente sus propios cobros y recibos. El admin de club ve, en modo lectura, los cobros y morosos de su club desde /admin/cobros.

¿Qué diferencia hay entre los niveles de sponsor? Hay cuatro niveles: Presenting, Oro, Plata y Bronce. El nivel ordena a los sponsors en el pie de página (primero Presenting) y define el tamaño de su logo. Además, cualquier sponsor vigente puede ser el que "presenta" un torneo (naming), y entonces aparece como "Presentado por" en ese torneo.

¿Qué pasa cuando vence el contrato de un sponsor? Su logo deja de mostrarse solo al pasar la fecha de "Vigente hasta", sin que haga falta borrarlo. Los lunes el sistema manda por mail la lista de contratos por vencer para renovarlos.

¿Cómo le damos a un comercio acceso al portal? Lo hace el Súper Admin desde /admin/promociones: en los beneficios del lugar, "Acceso al portal" permite crear la cuenta, generar una clave nueva o desactivarla. El comercio ingresa en /comercio.

¿Cómo valida un comercio un canje? En /comercio/validar escribe el código corto que figura en el comprobante del socio. El sistema le muestra el socio y el beneficio, y puede cargar una sola vez el monto de la compra. Ese monto cuenta en el panel solo si lo cargó el comercio.

¿Cómo se liquida a un club lo que le corresponde de los cobros? En /admin/cobros/saldos el Súper Admin ve, por club, lo cobrado que le corresponde y lo ya transferido. Al transferirle plata registra la liquidación, y el saldo baja. No se puede liquidar más que el saldo disponible.

¿Cómo uso la entrada con QR del partido? Desde Mis QRs descargás la entrada en PDF y la mostrás en la puerta desde el celular o impresa; solo escanean el QR. Cada QR se puede usar una vez.

¿Dónde ingresa un comercio al portal? En onapb.com/comercio. También hay un enlace "Comercios adheridos" en el pie de página y en la ficha de cada lugar.

¿Qué hago si un comercio no recibe el mail de invitación? Pedile que revise la carpeta de spam y reenviale la invitación desde "Acceso al portal". Si el mail sigue sin salir, generá una clave nueva: el sistema te la muestra una sola vez para que se la pases.

¿Qué puede hacer un comercio en su portal? Ver su retorno, validar canjes y cargar el monto de la compra, administrar sus propios beneficios (con revisión de la Asociación), descargar su cartel QR y pedir campañas.

¿Dónde cargo cuánto paga cada sponsor? En el formulario de cada sponsor, en Monto del contrato. Es el total del contrato y se usa solo en el reporte interno (costo por clic y por mil, prorrateado por la vigencia). Nunca se muestra al público ni va en el resumen que recibe el sponsor.

¿Qué diferencia hay entre una impresión y un clic de un sponsor? Una impresión es cada vez que se mostró su logo en una página; un clic es cada vez que alguien lo tocó. El CTR es la proporción entre ambos.

¿Cómo busco a un jugador de un equipo y categoría puntuales? En /admin/jugadores elegí el equipo y la categoría en la barra de filtros: la lista se actualiza sola. Podés sumar el club o el estado.

Filtré un listado y quiero volver a ver todo. ¿Cómo hago? Tocá Limpiar filtros, que aparece junto a la barra cuando hay algún filtro activo.

¿Cómo encuentro un apartado de este manual? Usá el índice: en la computadora está a la izquierda; en el celular, con el botón flotante Índice. Escribí una palabra en su buscador para filtrar los apartados.

¿Los comercios pueden cargar sus propios beneficios? Sí, desde /comercio/beneficios, hasta 10 activos por local. Por defecto, cada beneficio nuevo o modificado lo revisa la Asociación antes de publicarse. Si querés que se publiquen solos, desactivá la revisión en /admin/configuracion.

Un comercio cargó un beneficio y no aparece en la ficha del lugar. ¿Por qué? Probablemente está pendiente de aprobación. Revisalo en /admin/beneficios-pendientes y aprobalo o rechazalo. También puede estar pausado o fuera de sus fechas y horarios.

¿Cómo me entero de que un comercio cargó un beneficio? Por el contador del menú, la tarjeta Pendientes del dashboard y un mail resumen diario al email de reportes (solo si hay pendientes).

¿Qué pasa si rechazo un beneficio? Queda oculto y el comercio ve el motivo en su portal y le llega por mail. Puede corregirlo y reenviarlo, y vuelve a la lista de pendientes.

¿Un comercio puede crear un beneficio solo para abonados? Sí: al cargar el beneficio marca "Exclusivo para socios con abono activo". Solo lo canjean los socios con el abono del mes pagado, y en la lista de pendientes ves que es exclusivo antes de aprobarlo. Es el plus que le da valor al abono.

¿Un comercio puede mandar avisos a los socios cuando quiera? No. Pide una campaña, que respeta un cupo mensual según su plan y no se envía hasta que la Asociación la aprueba.

¿Cuánto cuesta cada plan de comercio? Lo define la Asociación en /admin/configuracion. Los valores iniciales del sistema son solo una propuesta.