Documentación / Core

Introducción a la Plataforma

Qué es ClubPadel

ClubPadel es un marketplace especializado de arquitectura peer-to-peer (P2P) diseñado exclusivamente para la comercialización de equipamiento técnico de pádel. La plataforma actúa como un agregador centralizado que conecta de manera directa a usuarios compradores con vendedores certificados, optimizando el descubrimiento de productos y la tasa de conversión sin intermediación transaccional.

Cómo funciona el marketplace

La plataforma delega el procesamiento transaccional ecomercial a interacciones directas, eliminando los costes por comisión por venta. El ecosistema opera sobre tres pilares fundamentales: catalogación indexada para compradores, herramientas de gestión de inventario y captación de leads cualificados en tiempo real para vendedores.

Flujo comprador-vendedor

El ciclo de vida de un lead inicia cuando el comprador aplica filtros avanzados sobre el catálogo y gatilla un evento de contacto. Este evento redirige de forma parametrizada hacia el canal de WhatsApp del vendedor, mientras la plataforma registra la métrica y asocia el lead al perfil correspondiente de manera asíncrona.

[Imagen: flujo_comprador_vendedor_placeholder_800x400]
Módulo de Demanda

Módulo de Compradores

Cómo buscar productos

El catálogo utiliza un motor de búsqueda indexado que evalúa concordancia semántica en títulos, descripciones y marcas de equipamiento. Los usuarios pueden ejecutar consultas de texto libre obteniendo respuestas con latencia mínima.

Cómo usar filtros avanzados

Para refinar los resultados, la interfaz dispone de facetas de filtrado estructuradas por variables críticas del deporte: formato de pala, rango de peso, balance, nivel de desgaste (Nuevo/Usado) y precio. Las consultas combinadas actualizan los resultados del catálogo mediante mutaciones de estado de URL reflectivas.

Cómo ver detalles del ítem

La vista de detalle consolida las especificaciones técnicas provistas por el vendedor, galerías de imágenes optimizadas en formato de última generación y los metadatos de confiabilidad del perfil ofertante.

Cómo contactar vendedores

La comunicación se establece mediante redirección directa hacia la API de WhatsApp, inyectando un payload de texto preconfigurado con el ID del producto, el nombre y el valor comercial de la publicación para mitigar fricciones en la apertura del chat.

[Imagen: interfaz_busqueda_filtros_placeholder_800x400]
Módulo de Oferta

Módulo de Vendedores

Crear cuenta

El onboarding se realiza a través de proveedores de autenticación segura (OAuth2) o credenciales de correo electrónico validadas, asignando de manera inmediata un espacio aislado en base de datos para la gestión del inventario del vendedor.

Configurar perfil profesional

Los vendedores deben rellenar campos obligatorios que sustenten su identidad comercial ante el mercado: nombre de la tienda o alias, descripción operativa y zonas geográficas de cobertura para la entrega física de bienes.

Configurar enlace de WhatsApp

Es requisito de infraestructura estricto ingresar un número de teléfono en formato internacional (E.164). Este número actúa como el endpoint de mensajería destino donde impactarán los leads generados de forma orgánica por el catálogo.

[Imagen: onboarding_vendedor_placeholder_800x400]
Inventario

Publicación de Productos

El formulario de alta exige tipificación estricta de variables para asegurar la estandarización del catálogo y optimizar la indexación de los motores de búsqueda.

Nombre del producto

Debe estructurarse bajo el patrón Marca + Modelo + Año + Estado. Ejemplo: "Babolat Technical Viper 2024 - Excelente Estado". Evitar adjetivos subjetivos.

Categoría asignada

Asignación taxonómica obligatoria dentro del clúster disponible: Palas, Indumentaria, Calzado, Bolsos, Pelotas o Accesorios.

Estado físico

Clasificación determinante entre Nuevo (sin uso previo con empaque original) o Usado (requiere desglose de horas estimadas de juego o nivel de desgaste cosmético en la descripción).

Precio

Valor expresado en Pesos Argentinos (ARS) en formato numérico entero. La plataforma no admite publicaciones con valor cero o textos del tipo a convenir.

Fotografías técnicas

Soporte mínimo de 1 y un máximo de 8 archivos. Formatos admitidos: JPG, PNG, WebP. Peso máximo por archivo: 5MB. Se recomienda iluminación neutra y encuadres enfocados en el núcleo y caras de la pala.

Publicación inmediata

El pipeline de persistencia publica el ítem en producción en tiempo real tras la validación del formulario en el cliente, omitiendo colas de aprobación manuales.

[Imagen: formulario_publicacion_placeholder_800x400]
Publicar producto ahora
Flujos de Información

Gestión de Consultas y Leads

Funcionamiento de la API de WhatsApp

La integración asocia los clics de los usuarios con redirecciones a la interfaz externa de WhatsApp. Este canal descentralizado asegura una comunicación asíncrona fluida pero directa, eliminando sistemas de mensajería complejos con baja retención.

Sistema complementario de mensajería interna

Para escenarios donde el comprador prefiere no revelar su identificador telefónico en primera instancia, ClubPadel provee una bandeja de entrada interna. Este canal requiere autenticación de sesión en ambas partes y opera de forma aislada dentro de la plataforma.

Registro automático de leads

Independientemente del canal seleccionado por la demanda, cada intención de contacto genera un documento de auditoría de lead en el backend. Este objeto captura el ID del comprador (si posee sesión), ID del producto, marca temporal y tipo de canal seleccionado.

Métricas generadas por interacción

Los datos anonimizados de los eventos alimentan la canalización analítica del marketplace, actualizando los registros agregados por publicación que posteriormente se exponen en el panel de control del ofertante.

[Imagen: flujo_mensajeria_leads_placeholder_800x400]
Analíticas

Dashboard del Vendedor

El panel de analíticas avanzadas se localiza en el módulo central de administración bajo el endpoint de control interno. Desglosa los siguientes KPIs de rendimiento técnico:

Métrica de Visitas

Cuantificación agregada de impresiones únicas en las páginas de detalle de los productos del vendedor dentro de ventanas temporales parametrizables (7d, 30d, histórico).

Volumen de Leads

Conteo de interacciones efectivas de intención de compra (clics hacia WhatsApp e inicio de conversaciones internas).

Click-Through Rate (CTR) de Contacto

Ecuación porcentual que mide la eficiencia de la publicación: $\text = (\text/ \text) \times 100$. Tasas inferiores al 2% sugieren la optimización de activos gráficos o ajuste del valor de mercado.

Rendimiento por Producto

Tabla jerárquica que ordena el catálogo del usuario según el nivel de tracción comercial para detectar anomalías de demanda.

Gestión Autónoma de Publicaciones

Abstracción CRUD que permite transicionar los estados de las publicaciones a través de tres mutaciones lógicas en la base de datos: Activa, Pausada (fuera de catálogo temporalmente) o Vendida (remoción del flujo de contacto pero persistencia histórica).

[Imagen: dashboard_vendedor_placeholder_800x400]
Comercial

Modelos de Suscripción

El acceso general y las búsquedas en ClubPadel carecen de costes operativos para el extremo comprador. Los oferentes de equipamiento se segmentan según las siguientes especificaciones operativas de cuenta:

EspecificaciónFreeProPremium
Coste Mensual0.00 ARSConsultar tarifasConsultar tarifas
Límite de PublicacionesIlimitadoIlimitadoIlimitado
Canales IntegradosWhatsApp / MensajesWhatsApp / MensajesWhatsApp / Mensajes
Distintivo en CatálogoEstándarBadge Vendedor ProBadge Verificado
Algoritmo de ExposiciónOrgánico baseIndexación destacadaPrioridad absoluta alta
Métricas de CTRBásicas agregadasHistorial avanzadoExportación en tiempo real
Solicitar actualización de plan comercial
Protocolos

Seguridad y Buenas Prácticas

Para Compradores

  • Priorizar interacciones con perfiles de vendedores que cuenten con el distintivo de Verificado emitido por la auditoría interna.
  • Exigir el número de guía e información de seguimiento logístico de forma inmediata si se acuerda un despacho de paquetería a distancia.
  • Inspeccionar de forma exhaustiva la integridad estructural de la pala (presencia de fisuras moleculares, estado del marco y del protector) antes de dar por finalizada la transacción.

Para Vendedores

  • Mantener un registro íntegro de la condición del producto mediante capturas fotográficas fechadas antes de efectuar entregas físicas.
  • No procesar despachos de material hasta que la acreditación de los fondos sea visible y confirmada directamente en la entidad bancaria del destino.
  • Reportar al equipo de soporte cualquier comportamiento inusual o sospecha de fraude de identidad por parte de las cuentas demandantes.

Recomendaciones de Pasarelas de Pago y Entrega

Al ser ClubPadel un entorno descentralizado en el flujo monetario, se prescribe el uso de herramientas financieras como Mercado Pago para transacciones remotas debido a sus políticas internas de protección. Para transacciones presenciales presenciales, se aconseja fijar puntos de encuentro en establecimientos deportivos públicos o clubes de pádel con alta concurrencia horaria.

Resolución

Preguntas Frecuentes

¿ClubPadel aplica comisiones sobre el volumen de ventas?
No. El modelo arquitectónico no intercepta el flujo de caja de la transacción. El contacto es directo P2P, garantizando una tasa de comisión del 0% sobre las transacciones completadas.
¿Cuál es la latencia de indexación de un producto nuevo?
Inmediata. La persistencia en la base de datos distribuida sincroniza el catálogo de manera reactiva, omitiendo procesos de staging o aprobaciones asíncronas externas.
¿Existe restricción de publicación para usuarios particulares?
No. La taxonomía del sistema admite perfiles tanto de jugadores particulares que liquidan equipamiento usado como de tiendas del sector comercial.
¿Cómo se gestiona el flujo de pagos alternativos?
La negociación del medio de pago es potestad exclusiva de las partes. El sistema tolera efectivo, transferencias directas bajo códigos CBU/CVU o links de pago externos.
¿Cómo se realiza el de-provisionamiento de una publicación?
Desde el panel de control del vendedor, el usuario ejecuta una mutación de estado a "Cerrada" o "Vendida", lo que purga el registro de las queries de búsqueda del catálogo de manera síncrona.
¿Es posible publicar artículos de disciplinas deportivas ajenas al pádel?
No. El catálogo rechaza e invalida cualquier registro indexado que no pertenezca estrictamente al ecosistema de pádel (palas, indumentaria de pádel, accesorios y calzado técnico) para preservar la especialización de la plataforma.

Fin de la Guía de Referencia

Podés proceder a operar sobre los módulos productivos del marketplace o consultar al canal oficial de soporte si tu escenario de integración requiere asistencia adicional.