2026-08-07 — marvelousdb: enriquecimiento con peliculas (TMDB)

Contexto: el usuario pidio usar TMDB_AUTH_HEADER (v4 key de .env) para tomar “comics convertidos a peliculas” y mejorar la base de datos.

Implementacion

data/import-tmdb.js (npm run import:tmdb): para cada personaje corre search/movie?query=<name> en TMDB, guarda los top 4 resultados con poster en data/tmdb-films.json (id → [{tmdb_id, title, year, poster, overview}]). Incremental (—limit, —universe, —reset), sleep 350ms (rate ~40/10s), mensaje claro si 401/403.
api.js: carga tmdb-films.json al arranque (patron img-cache) y sirve films en /api/characters/:id.
Vista character: seccion “On Screen” con posters (image.tmdb.org w185, onerror → placeholder, link a themoviedb.org).
.env.example + README documentan TMDB_AUTH_HEADER. Test condicional si el archivo existe.

Flujo probado con tmdb-films.json simulado: Spider-Man → 2 films, vista renderiza On Screen (3 matchs). 21/21 tests.

Poner la v4 key en .env y correr npm run import:tmdb -- --limit 200 varias veces. 10k personajes = ~1 hora a 3 req/seg si corre completo (solo tiene sentido para personajes con peliculas: Marvel/DC).
Los posters se sirven del CDN de TMDB (vivo); cache local opcional futuro.