Guide de la Banque du Tour du Monde · mise à jour du 23 juillet 2026

Aide, fonctions et préparation

Manuel de bord de la borne locale et des pages destinées aux invités distants. Les fonctions indiquées comme opérationnelles sont présentes dans la version actuelle ; les deux chantiers restants sont regroupés à la fin.

1LancerDémarrer le serveur local puis ouvrir http://127.0.0.1:4173.

2SécuriserConfigurer le mot de passe administrateur et ceux des pages distantes.

3PréparerVérifier galeries, vidéos, musiques, fonds et calibrages.

4SauvegarderProtéger en permanence la base et les médias créés par les invités ; la copie globale du projet reste facultative.

Démarrage et navigation

Mode local hors connexion

Sur Windows, utilisez LANCER_APP_FIREFOX.bat ou LANCER_APP_FIREFOX_KIOSQUE.bat. Le lanceur kiosque emploie un profil Firefox GAB dédié qui autorise la musique dès l’arrivée sur l’accueil. Sur Linux Mint, lancez serveur_local.py puis ouvrez http://127.0.0.1:4173.

Chargement et navigation

L’écran de chargement possède un fond et un message personnalisables. L’étiquette commune gère Accueil et Retour. La touche Échap ou Esc ferme d’abord l’aide, une photo, une vidéo ou une fenêtre ouverte ; elle quitte le plein écran si celui-ci est actif, puis revient à la page précédente lorsqu’aucun élément n’est ouvert. Le bouton plein écran est placé près de la musique.

Important : ne pas ouvrir directement index.html. Le serveur local est nécessaire pour SQLite, les fichiers physiques, les vidéos longues et les pages protégées.

Accès administrateur et sécurité

Ouvrir l’admin : sur l’accueil, maintenir Ctrl et cliquer cinq fois en moins de cinq secondes sur le tampon officiel.
Mot de passe : au moins dix caractères ; seule son empreinte chiffrée est conservée.
Sessions : administration, dépôt de soirée et virement utilisent des sessions séparées.
En ligne : HTTPS est obligatoire pour les cookies sécurisés, la caméra, le microphone et les transferts.

Base locale, sauvegardes et restauration

Source de vérité

data/app.sqlite3 est la base locale durable. Elle contient l’état, les réglages de galerie, la visibilité des photos, les statistiques et les cinquante dernières révisions.

Miroirs lisibles

data/app-state.json et data/gallery-settings.json sont remplacés atomiquement après les sauvegardes.

Fichiers physiques

Les entrées invités sont enregistrées dans MEDIAS/STUDIO/, MEDIAS/CAPSULES/, MEDIAS/SOUVENIRS/ et MEDIAS/SOIREE/. Les galeries historiques restent dans MEDIAS/GALERIES/.

Navigateur

LocalStorage et IndexedDB ne sont plus la source principale. Ils servent de cache ou de secours ; les galeries sont chargées progressivement depuis les fichiers.

Exports

Admin > Vue d’ensemble > Exports de sécurité sert uniquement à créer les copies JSON ou ZIP. Une copie intégrale doit aussi inclure les dossiers physiques.

Centre d’import unique

Dans Admin > Imports & données, analysez un ancien JSON, un ZIP complet ou les bases IndexedDB encore présentes dans ce navigateur. Le mode recommandé affiche les messages, contributions, capsules, photos, vidéos et audios avant une réimportation sélective sans écrasement, avec leurs dates d’origine.

Restauration totale protégée

La restauration qui remplace l’état actuel est rangée dans une zone avancée du même centre. Elle reste verrouillée jusqu’à la confirmation d’une sauvegarde récente et la saisie du mot REMPLACER.

Nettoyage des tests

Dans Admin > Données, cochez des actions pour les supprimer sélectivement ou utilisez Purger les données de test. Contributions, messages, capsules et captures Studio sont retirés, puis le kilométrage et la dernière activité sont recalculés depuis les données restantes.

Périmètre automatique

Les messages, capsules, statistiques, journal, captures Studio, médias des souvenirs et dépôts de soirée sont toujours sauvegardés. La case de sauvegarde globale ajoute seulement le code, les films, musiques et galeries historiques.

Reprise

Les écritures sont versionnées et accompagnées d’une empreinte SHA-256. Les récupérations peuvent être conservées dans data/recovery/.

Sauvegarde automatique : la base, les statistiques, le journal et les médias utilisateurs restent toujours protégés. Dans Admin > Données, la copie globale du projet et des galeries peut être activée séparément.

Interface, fonds et calibrage

Calibrage visuel

Position, dimensions, opacité, rotation, contour, lueur et taille des textes sont réglables par page. Les très petites tailles sont acceptées lorsque l’élément le permet.

Étiquette Accueil / Retour

Navigation fournit une prévisualisation, les textes, symboles, tailles, positions et le rognage de la ficelle. Dans Calibrage, l’étiquette peut être placée par page, même partiellement hors champ.

Fonds

Les fonds du GAB, du chargement, du dépôt soirée, de la galerie soirée et de la page virement sont administrables.

Curseur

Le curseur personnalisé est remplaçable, dimensionnable de 16 à 64 px et possède un point actif X/Y configurable.

Aide contextuelle par page

Le bouton i, placé à côté de la musique et du plein écran, ouvre une aide adaptée à la page affichée. Dans Admin > Aide, sélectionnez une page pour modifier son titre et ses explications, puis enregistrez. Le bouton de réinitialisation restaure le texte proposé par défaut.

Conseil : calibrer dans la résolution finale, idéalement en plein écran 16:9.

Galeries, vidéos et médias

Dossiers et onglets

Chaque galerie correspond à un dossier sous MEDIAS/GALERIES/. Si les onglets sont actifs, chaque sous-dossier devient un onglet. Un mode sans onglet lit la racine, notamment pour EVJF et EVG. Les anciennes vidéos AVI doivent être converties en MP4 H.264/AAC pour être lisibles dans un navigateur.

Gestion dédiée

Galeries affiche les vignettes et permet l’ajout unitaire ou en lot, l’import de dossier, la vue en grand, le masquage et la suppression.

Masonry

Colonnes, lignes, espacement, pagination, sous-onglet par défaut et décalage vertical du menu sont réglables. Les ratios sont conservés.

Chargement progressif

Les images sont chargées à la demande avec une animation. L’ordre est mélangé à chaque session et la visionneuse ne montre ni chemin ni nom de fichier.

Lecteurs vidéo

Le film et les messages ont deux lecteurs indépendants avec timeline précise. Le serveur gère les plages d’octets pour les vidéos longues.

Imports serveur

Les images d’interface glissées ou choisies sont copiées vers le dossier serveur concerné au lieu de dépendre uniquement du navigateur.

Cartes souvenir

Les cartes souvenir sont tirées aléatoirement depuis Voyages dans le temps. Dans Souvenirs, chaque carte peut contenir un titre, une période, un texte, un auteur et une photo ou vidéo.

La popup, ses zones de texte, le média, le bouton fermer et le bouton nouveau souvenir se règlent dans Calibrage > Popup carte souvenir.

Itinéraire et kilomètres

Dans Itinéraire, configurez les étapes du voyage : nom, icône, distance cumulée, ordre, position sur la carte et destination finale.

Les kilomètres gagnés déterminent automatiquement l'escale actuelle, la prochaine escale, la progression et les tours du monde accomplis.

Le tracé de l'accueil permet de régler couleur, opacité, épaisseur, fond, glow, pointillés et animation de dessin.

Animations et effets lumineux

Cadres cliquables : rythme global dans Animations, contour et lueur par élément dans Calibrage.
Animation cadeau : enveloppe, passeport, avion, tampon et timeline avancée.
Fenêtre de remerciement : tampon, liste de titres aléatoires, paragraphe et libellés des boutons sont modifiables dans le bloc Animation cadeau.
Avion accueil : position, taille, hélices, oscillation, reflets et sons.
Boussoles, flammes, objectifs, alliances, montres : effets positionnés via Calibrage.
Tampons donut : intensité, diffusion et vitesse de rotation dans les réglages d'animation.

Studio Souvenir et caméra

Modes photo et vidéo, aperçu, déclencheur, enregistrement et sauvegarde physique.
Une capture n’est annoncée comme sauvegardée qu’après confirmation de l’API et de son fichier physique.
Dans la Capsule 2036, le bouton + accepte une photo, une vidéo ou un audio par glisser-déposer, explorateur ou galerie du téléphone.
Détection des caméras et choix entre webcam directe et caméra virtuelle OBS.
La webcam directe utilise getUserMedia et le rendu final Canvas dans le navigateur, en local comme à distance. OBS reste une source facultative sur le GAB.
Après un refus, un panneau explique comment réautoriser la caméra et propose Réessayer.
Le bouton d’activation suit l’état réel de la caméra et indique sa fonction au survol.
Les fonds webcam du mode direct sont importables et administrables.
Quand un fond est choisi, le détourage de la personne est calculé directement dans le navigateur par le modèle MediaPipe fourni dans le projet. Le GAB n’a pas besoin d’Internet.
Dans l’administration du Studio, choisissez Automatique recommandé, Qualité maximale, Performance ou Manuel avancé. Le mode manuel donne accès à la stabilité, l’adoucissement, au seuil, à la réduction du halo et à la correction d’exposition.

Limite actuelle : OBS Virtual Camera est sélectionnable, mais la gestion automatisée du fond directement dans OBS reste à développer.

Audio et effets sonores

Musique configurable par page depuis la bibliothèque du serveur ou par import.
Playlists de plusieurs morceaux pour les galeries, lues dans l’ordre puis en boucle.
Mise en retrait automatique de la musique pendant la lecture d’une vidéo.
Effets sonores administrables pour les interactions et animations principales.
Bouton public de lecture/pause placé près du bouton plein écran.

Pages destinées aux invités distants

Dépôt de soirée

Page protégée : glisser-déposer, fichiers multiples, dossier complet sur ordinateur et galerie photo/vidéo sur téléphone. L’envoi ne commence qu’après validation.

Galerie de soirée

Galerie progressive avec visionneuse, adresse, fond et mot de passe éventuel indépendants.

Accès par énigme

Dans Voyages dans le Temps, maintenir la boussole environ trois secondes puis relâcher ouvre la galerie si l’option est active.

Virement

Page distincte protégée par mot de passe, avec fond administrable et coordonnées sensibles absentes du HTML public.

Adresses

Les chemins du dépôt et de la galerie sont renommables. Les adresses historiques restent disponibles comme secours.

Stockage

Les dépôts sont écrits dans MEDIAS/SOIREE/uploads/ et catalogués dans MEDIAS/SOIREE/catalog.json.

Statistiques des visites serveur

Visites lit les événements stockés dans SQLite. Les visites locales sont exclues par défaut et peuvent être incluses pour les tests.

PagesVisiteursPaysSupportSystèmeNavigateurRésolutionLangueFuseauRéférentConnexion

Le pays dépend du proxy/hébergeur ou d’une base GeoIP. L’adresse IP brute et le user-agent complet ne sont pas conservés dans les statistiques.

Navigateurs et Safari

Les fonctions principales ciblent Firefox, Chrome, Edge et Safari récents. Le plein écran inclut les variantes WebKit et la sélection mobile ouvre la photothèque sans imposer la caméra.

Sur iPhone/iPad, utiliser HTTPS pour la caméra, le microphone et les pages en ligne.
L’import d’un dossier complet est affiché seulement si le navigateur de bureau le prend en charge.
Sur Safari : Safari → Réglages pour ce site → Caméra → Autoriser en cas de refus.
Faire un test final sur le véritable iPhone/iPad et sur la résolution du GAB.

Check-list jour J

Copier data/, MEDIAS/, user-assets/ et videos/ sur un autre support.
Redémarrer complètement le serveur et vérifier le retour de l’état et des galeries.
Tester toutes les pages du GAB, les galeries et les deux lecteurs vidéo.
Tester webcam, autorisations, modes photo/vidéo et OBS si utilisé.
Tester musiques, playlists de galerie et effets sonores.
Tester dépôt, galerie soirée et virement depuis un téléphone extérieur.
Contrôler mots de passe, HTTPS, adresses publiques et espace disque.
Passer en plein écran ou kiosque seulement après validation.

Chantiers restant à réaliser

1. Gestion OBS du fond caméra

Ajouter le pilotage ou le processus complet du fond dans OBS. La détection et la sélection d’OBS Virtual Camera existent déjà.

2. Debian, MariaDB et synchronisation

Migrer le schéma vers MariaDB sur Debian, connecter l’API distante, ajouter l’authentification de synchronisation et synchroniser données et fichiers entre le GAB et le serveur dédié.

Règle : ne pas appliquer « le fichier le plus complet gagne ». Fusionner les contributions par identifiant, contrôler les fichiers par empreinte et journaliser les conflits de réglages.