Saltar al contenido
hg.Héctor GarridoCiencia de datos · Estadística · Ingeniería de datos
← Volver al blog
YouTube Analytics

El frontend, la infraestructura y los bugs del último kilómetro

Este artículo describe la implementación de un dashboard de analíticas de YouTube usando React y Recharts. Se centra en los desafíos del despliegue en producción, incluyendo un bug de colisión de nombres en el frontend resuelto renombrando una función. Además, aborda problemas de accesibilidad en componentes Select de Material UI y la importancia de añadir enlaces de navegación para asegurar la visibilidad de nuevas funcionalidades. El lector aprenderá sobre la resolución de errores comunes en el desarrollo frontend y la importancia de la accesibilidad.

El frontend, la infraestructura y los bugs del último kilómetro

El backend estaba completo. Los modelos, el ETL, los endpoints — todo funcionando en local. Lo que faltaba era el frontend y la parte que suele parecer trivial hasta que no lo es: poner todo eso a funcionar en producción sin que se rompa algo ya existente.

Spoiler: se rompió algo.

El dashboard con Recharts

YouTubeDashboard.js es la página más visual del proyecto. Cuatro secciones, cada una con sus propios componentes, todas detrás del mismo guard de acceso que usan Tasks e InternalPosts:

if (!user?.is_employee) {
  return <Alert severity="warning">Acceso restringido al personal interno.</Alert>;
}

La sección más útil resultó ser la de tags. Tres tabs — canal propio, competencia, Ciencia & Tecnología — con un BarChart horizontal de los 15 tags más frecuentes y un LineChart de evolución temporal de los 5 principales. Ver qué etiquetas dominan en el nicho semana a semana, comparadas con las que uso yo, es exactamente la información que quería.

Recharts fue una buena elección. La librería es declarativa, fácil de integrar con el estado local de React y tiene un API consistente para los distintos tipos de gráfico:

<ResponsiveContainer width="100%" height={300}>
  <LineChart data={evolutionData}>
    <XAxis dataKey="date" />
    <YAxis yAxisId="subs" orientation="left" />
    <YAxis yAxisId="views" orientation="right" />
    <Tooltip />
    <Legend />
    <Line yAxisId="subs" dataKey="subscribers" stroke="#8884d8" />
    <Line yAxisId="views" dataKey="total_views"  stroke="#82ca9d" />
  </LineChart>
</ResponsiveContainer>

El dual-eje en la evolución del canal era necesario: suscriptores y vistas totales tienen órdenes de magnitud distintos, y en un solo eje uno aplasta al otro.

El bug de producción que no vi venir

Cuando hice el build de producción con Kaniko, falló con:

ERROR: Identifier 'getYoutubeVideos' has already been declared.

El problema: client.js ya tenía una función llamada getYoutubeVideos desde antes — el proxy del blog que usa Home.js para cargar los últimos videos del canal en la portada. Al agregar el nuevo endpoint del DataMart, le puse el mismo nombre sin darme cuenta.

En desarrollo no explotó porque los módulos ES de CRA son más permisivos con los exports duplicados en modo watch. Kaniko, que hace una build más estricta, lo rechazó.

La solución fue renombrar el original:

// Antes — colisión de nombres
export const getYoutubeVideos = (channel) =>
  api.get(`/blog/youtube/${encodeURIComponent(channel)}/`);

// Después — nombre descriptivo que evita la ambigüedad
export const getBlogYoutubeVideos = (channel) =>
  api.get(`/blog/youtube/${encodeURIComponent(channel)}/`);

Y actualizar el import en Home.js. Tres líneas de cambio, treinta minutos de diagnóstico. El tipo de bug que solo aparece cuando el código sale de tu máquina.

El enlace que faltaba

Después de desplegar el dashboard, nadie podría haberlo encontrado. La ruta /youtube existía, React.lazy la registraba, pero no había ningún enlace en la navegación para llegar ahí.

// Layout.js — menú visible solo para is_employee
items.splice(4, 0,
  { label: 'Ideas sueltas', path: '/internal' },
  { label: 'Tareas',        path: '/tasks'    },
  { label: 'YouTube',       path: '/youtube'  },  // ← nuevo
);

Una línea. Pero sin ella el dashboard es como una habitación sin puerta.

Accesibilidad: el id que faltaba en el Select

El último fix fue técnico pero irreprochable: el Select de la sección de competidores generaba dos advertencias de accesibilidad en la consola — campo de formulario sin id y <label> sin campo asociado. Material UI requiere que el InputLabel tenga un id y que el Select lo referencie con labelId:

<InputLabel id="competitor-query-label">Término de búsqueda</InputLabel>
<Select
  labelId="competitor-query-label"
  inputProps={{ id: 'competitor-query', name: 'competitor-query' }}
  ...
>

No es un bug funcional, pero sí un problema real para usuarios de lectores de pantalla. Vale la pena corregirlo aunque nadie lo haya reportado.

El cierre de la serie

El YouTube Analytics DataMart está en producción desde finales de febrero. Tres posts, nueve modelos, un ETL que corre solo cada madrugada y un dashboard que por fin me dice lo que YouTube Studio no quiere contarme.

Lo que más me sorprendió del proceso: el diseño previo funcionó casi perfectamente. Los modelos del documento de diseño son prácticamente idénticos a los que terminaron en models.py. La excepción fue YtTagOccurrence — la fact table que más pensé en el diseño fue también la que más lógica necesitó en el ETL para mantener la idempotencia.

Lo que repetiría: escribir el presupuesto de cuota antes de codear. Lo que no repetiría: hacer un commit de 400+ líneas cuando hay partes claramente separables.


Serie: YouTube Analytics DataMart — ← Parte 2: El backend

Este artículo es parte de la serie "YouTube Analytics DataMart". El código fuente completo está en GitHub.