Super Ciné Marbre

Le marbre du Super Cine Battle, en version interactive.

Sommaire

• Application web (webapp/)
• Importeur de listes (importer/)
• Serveur de programme TV (importer/tv-schedule-server.ts)
• Procédures
  • Mettre à jour les listes
  • Corriger un film
• Licence

Application web

Premier lancement

cd webapp
npm install
npm start

Commandes disponibles

• npm start : Lancement de la version développeur
• npm run build : Build JS (= met à jour la version déployée)
• npm run lint : S'assurer que le code est de toute beauté

Importeur de listes

Premier lancement

cd importer
npm install
npm start

Commandes

• [SCB_FORCE=true] [GSHEETS_FORCE=true] npm start : Mettre à jour les épisodes et les films. Utilise Super Ciné Battle, ce document Google Sheets et diverses sources de métadonnées de cinéma. SCB_FORCE et GSHEETS_FORCE permettent de forcer la synchronisation des sources correspondantes, même si elles ont été vérifiées dans les dernières 24 heures.
• [IMDB_ONLY=true] [OMDB_ONLY=true] [ALL=true] npm run invalidate -- [nom(s) de film(s) SCB] : Invalider des données de films. IMDB_ONLY et OMDB_ONLY permettent d'annuler seulement les données issues de IMDB et OMDB respectivement. ALL annule les données sur TOUS les films (à éviter).

A savoir

1. Pour que l'import OMDB fonctionne (couvertures de films etc.), il faudra obtenir une clef d'API (gratuite) à http://www.omdbapi.com et la mettre dans un fichier importer/data/omdbapikey.
2. Pour que l'import TMDB fonctionne, il faudra obtenir une clef d'API (gratuite pour un usage non commercial) à https://www.themoviedb.org/ et la mettre dans un fichier importer/data/tmdbapikey.
3. Pour que l'import des timestamps fonctionne, il faudra obtenir une clef d'API (gratuite) à https://console.developers.google.com/apis et la mettre dans un fichier importer/data/googlesheetsapikey.
4. La détection automatique des films n'est pas toujours fiable, voir plus bas la procédure en cas d'erreur.

Serveur de programme TV

Afin d'être capable de se mettre à jour quotidiennement, le programme TV est géré par un serveur à part.

cd importer
npm install
npm start:tv

Procédures

Mettre à jour les listes

Lancer l'importeur va vérifier à la fois les épisodes publiés sur supercinebattle.fr, et les nouveaux classements/timestamps sont disponibles sur Google Sheets. Pour chaque film ayant des métadonnées manquantes, elles sont rassemblées.

cd importer
npm start

Pour vérifier le résultat de l'import (en particulier la bonne correspondance des films), lancer la webapp en local :

cd webapp
npm start

Corriger un film

1. Retrouver le film en erreur dans webapp/public/scb_movies.json, et en particulier sa clef "id".

2. Modifier scb_patch.json, en ajoutant un objet avec l'ID du film. Compléter alors l'objet avec les valeurs à écraser. Généralement on souhaite juste réparer une correspondance de film : pour ça aller sur le bon film dans IMDB, retrouver son "tconst" en regardant l'URL (qui est au format https://www.imdb.com/title/[TCONST]/), puis ajouter au patch une clef "tconst".

3. Si les données du film (jaquette, note IMDB etc.) avaient déjà été importées dans scb_movies.json, il faut les invalider, de préférence avec l'outil en ligne de commande dédié :

cd importer
npm run invalidate "Nom exact issu de l'ID" "On peut en mettre plusieurs"

4. Et enfin relancer l'import :

npm start

Licence

Copyright (C) 2020 Marwane Kalam-Alami

Distribué sous licence ISC/OpenBSD.