Avatar digital del deportista: arquitectura de un prototipo de navegador en 3000 líneas de JS puroArtículo · digest del 3 de noviembre
Plano minimalista del circuito modular interactivo del avatar digital del deportista en JavaScript puro.
Artículo4 secciones≈ 6 min

Avatar digital del deportista: arquitectura de un prototipo de navegador en 3000 líneas de JS puro

En el desarrollo de software moderno existe una enfermedad extendida que los arquitectos experimentados llaman «la trampa del stack pesado». Imagina una situación clásica: una startup o el laboratorio de innovación de una gran empresa decide lanzar un producto digital complejo. En el proyecto hay planificados una quincena de escenarios complejos: perfiles digitales, cálculo de regalías, catálogos de alquiler, integraciones con patrocinadores y analítica.

¿Cómo suele empezar un proyecto así? El equipo se sienta y pasa tres meses configurando infraestructura: levanta un clúster de Kubernetes, configura PostgreSQL, conecta Prisma ORM, prepara Redux Toolkit, discute sobre la librería de UI y depura pipelines de CI/CD. Pasa medio año, se han gastado millones del presupuesto y el inversor o cliente final todavía no puede hacer clic en un prototipo funcional.

El desarrollador del ecosistema deportivo «Avatar digital del deportista» (TsAS) mostró en un artículo detallado en Habr un contraejemplo radical de ingeniería: un circuito de demostración totalmente funcional de 14 módulos independientes, escrito íntegramente en solo 3000 líneas de Vanilla JavaScript puro, sin dependencias npm externas, frameworks ni backend.

Arquitectura de 14 módulos funcionales sin servidor

El objetivo principal del proyecto era la validación instantánea de un modelo de producto y economía complejo ante federaciones deportivas y patrocinadores. En lugar de explicar la arquitectura en diapositivas de PowerPoint, el autor creó un entorno interactivo donde cada afirmación de la lógica de negocio se comprueba en un par de clics directamente en el navegador.

El sistema abarca el ciclo de vida completo del activo digital del deportista:

  1. Pasaporte del avatar: verificación de estado, historial de logros deportivos, indicadores antropométricos.
  2. Núcleo metodológico del entrenador: formalización de metodologías de entrenamiento de autor en forma de grafos de ejercicios.
  3. Catálogo de subarrendamiento y grafo en cascada de regalías: cesión en alquiler de metodologías a otros clubes con reparto automático de pagos entre entrenador, atleta y club.
  4. Coaching con IA: emulación de la adaptación del plan de entrenamiento según parámetros de fatiga.
  5. Paneles de patrocinador y federación: auditoría del gasto específico de subvenciones, contratos y registros de deportistas.

Todos estos 14 módulos se abren como una única aplicación SPA desde una memoria USB estática o mediante GitHub Pages.

11 restricciones arquitectónicas y legales conscientes

El secreto de lo compacto de la base de código no reside en magia de compresión, sino en aquello a lo que el desarrollador renunció conscientemente:

  • Ningún dato personal (DP): en el sistema no hay apellidos, datos de pasaporte ni teléfonos. Todas las entidades operan con identificadores despersonalizados (ath-01, meth-99). Esto permitió eliminar por completo los requisitos legales de la ley 152-FZ y del GDPR en la fase de prototipado.
  • Sin backend ni bases de datos: todo el estado vive en la memoria RAM del navegador (in-memory store), con posibilidad de reinicio rápido o guardado de una instantánea en localStorage.
  • Renuncia a frameworks (React, Vue, Svelte): la ausencia de Virtual DOM, Babel y cientos de megabytes de node_modules volvió el código transparente para una auditoría integral.
  • CSS Grid y Flexbox puros: prescindir de Tailwind y kits de UI externos libró al proyecto de la fase de compilación.

Reactividad con primitivas nativas: EventTarget y CustomEvent

¿Cómo gestionar el estado de 14 pantallas sin Redux ni Pinia? El desarrollador utilizó la clase nativa del navegador EventTarget, implementando un Event Bus reactivo en apenas treinta líneas de código:

// core-store.js: store reactivo minimalista sin dependencias
class AthleteStore extends EventTarget {
  constructor() {
    super();
    this.state = {
      athlete: { id: 'ath-01', level: 'Pro', fatigue: 12 },
      methodology: { id: 'meth-99', royaltyRate: 0.15, activeRentals: 4 },
      wallet: { balance: 142000, currency: 'RUB' }
    };
  }

  getState() {
    return this.state;
  }

  dispatchAction(action, payload) {
    switch (action) {
      case 'RENT_METHODOLOGY':
        this.state.methodology.activeRentals += 1;
        this.state.wallet.balance += 25000 * (1 - this.state.methodology.royaltyRate);
        break;
      case 'UPDATE_FATIGUE':
        this.state.athlete.fatigue = payload;
        break;
    }
    // Notificación a los suscriptores mediante CustomEvent nativo
    this.dispatchEvent(new CustomEvent('stateChanged', { detail: this.state }));
  }
}

export const store = new AthleteStore();

Los componentes de la interfaz de usuario simplemente se suscriben al evento stateChanged y actualizan sus árboles DOM mediante plantillas literales nativas:

// ui-renderer.js: actualización reactiva de la pantalla de regalías
import { store } from './core-store.js';

function renderRoyaltyDashboard() {
  const container = document.getElementById('royalty-view');
  const state = store.getState();

  container.innerHTML = `
    <div class="card">
      <h3>Saldo de pagos: ${state.wallet.balance.toLocaleString('ru-RU')} ₽</h3>
      <p>Alquileres activos de metodologías: ${state.methodology.activeRentals}</p>
      <button id="btn-rent" class="btn-primary">Simular alquiler (+25,000 ₽)</button>
    </div>
  `;

  container.querySelector('#btn-rent').addEventListener('click', () => {
    store.dispatchAction('RENT_METHODOLOGY');
  });
}

// Suscripción al bus de eventos del almacén
store.addEventListener('stateChanged', renderRoyaltyDashboard);

En el contexto de la conversación sobre contratos y reglas declarativas del desarrollo web, este enfoque nos devuelve a los orígenes: el navegador por sí solo ya es una plataforma potentísima que no requiere capas adicionales para tareas básicas.

Dónde está el límite de aplicabilidad de Vanilla JS

Este enfoque es ideal para la fase pre-seed de una startup, hackatones, validación de modelos de negocio y demostraciones a clientes. Cuando la lógica ya está validada en 3000 líneas de JS puro, reescribirla en un stack industrial con microservicios y Postgres lleva semanas en lugar de meses, porque el modelo de dominio ya está completamente limpio de ilusiones.

Límites de ingeniería

Por supuesto, sería ingenuo lanzar un prototipo así a producción real con un millón de usuarios. La memoria del navegador es limitada, los datos no están protegidos frente a la limpieza de caché y las transacciones financieras reales exigen garantías ACID estrictas de un SGBD.

Pero como herramienta de validación rápida de hipótesis, el caso TsAS demuestra lo esencial: la disciplina arquitectónica y el valor de decir «no» a librerías innecesarias importan infinitamente más para el éxito del producto que perseguir frameworks de moda.

Quiero un análisis detalladoLos votos ayudan a elegir qué analizar a fondo. Este material tiene 0 votos.
Fuentes · 3