WALL PHOTOS — Guide & README

Intro

WALL PHOTOS est un outil événementiel simple pour collecter des photos en direct (via une page Upload), les modérer en temps réel, et les afficher en Galerie, Polaroid ou Shape. Le tout avec un panneau d’administration et un mode modérateur.

Cette page documente le fonctionnement général, les liens utiles, et les options de configuration.

Fonctionnalités

• 📸 Upload avec PIN (optionnel par session).
• 🛡️ Super-admin avec mot de passe (changeable).
• 🧑‍⚖️ Modération live (approbation, masquage, suppression, rotation, légendes) avec WebSocket.
• 🖼️ Affichages :
  • Galerie (grid, sobre)
  • Polaroid (intro 3s + mélange automatique avec délai)
  • Shape (affichage libre — évolutif)
• 🗑️ Corbeille (restauration des fichiers supprimés).
• 📦 Export ZIP (photos + captions.csv).
• 🔗 Tokens : partages publics et modérateurs.

Pages & Menus

Astuce : Un QR code pour l’Upload est disponible depuis la page session admin.

Sécurité (Admin / PIN)

• Super-admin : protégez l’accès à /admin. Le mot de passe par défaut doit être modifié dans /admin/security.
• PIN Upload : activable/désactivable par session (visible/masqué côté Upload).
• PIN Modérateur : optionnel par session. Si activé, l’accès à /mod/:token demande un PIN modérateur.

Modération (live)

La page modération affiche 4 sections : En attente, Visibles, Masquées, Supprimées. Les actions possibles : Approuver, Masquer, Supprimer/Restaurer, Rotation, Légende.

Les changements sont diffusés en temps réel à toutes les vues (Galerie/Polaroid/Shape) grâce à Socket.io.

Export & Corbeille

• Exporter ZIP : photos + captions.csv pour Excel/Sheets.
• Corbeille : liste les fichiers supprimés et permet la restauration.

Polaroid (intro + mélange)

• Lorsqu’une nouvelle photo arrive, elle s’affiche en grand 3s puis rejoint la scène.
• Bouton Mélanger + option Auto avec délai (10s, 30s, 60s, 120s).
• Préférences mémorisées dans localStorage.
• Bouton Plein écran.

Structure du projet

project-root/
│
├── index.js                     ← serveur principal (Express + Socket.IO)
├── lib/                         ← logique métier (sessions, photos, etc.)
├── routes/                      ← routes Express (côté serveur)
│   ├── admin.js                 ← panneau admin complet
│   ├── moderator.js             ← panneau modération
│   ├── upload.js                ← upload des fichiers
│   ├── qr.js                    ← QR codes
│   └── public/                  ← routes publiques
│       ├── index.js             ← gère /wall/:token
│       ├── utils.js
│       ├── html/                ← modèles HTML publics
│           ├── gallery.html
│           ├── home.html
│           ├── login.html
│           ├── polaroid.html
│           └── shape.html
│       └── modes/               ← routes Polaroid, Shape, Gallery
│           ├── gallery.js
│           ├── polaroid.js
│           └── shape.js
├── public/                      ← fichiers statiques (servis via /static)
│   └── modes/
│       ├── polaroid-client.js   ← code client pour Polaroid
│       └── shape-client.js      ← code client pour Shape
│
├── static/                      ← ressources “fixes” (README, CSS)
└── uploads/                     ← photos uploadées (par sessions)

Routes utiles

• /admin, /admin/new-session, /admin/security
• /admin/session/:id, /admin/session/:id/export
• /s/:id/upload
• /wall/:token/gallery, /wall/:token/polaroid, /wall/:token/shape
• /mod/:token
• /qr/:sessionId
• /static/readme.html (cette page)

FAQ rapide

Je n’arrive pas à entrer sur /admin.

Vérifie le mot de passe super-admin. Tu peux le (ré)initialiser via /admin/security si tu es déjà connecté, sinon supprime son fichier data/config.json (selon ton implémentation) et redémarre.

Pourquoi l’Upload demande un PIN ?

Par défaut, chaque session exige un PIN d’upload. Tu peux le désactiver ou changer le PIN dans Admin > Session > PIN d’upload.

Je ne vois pas de photos dans Polaroid.

Polaroid affiche uniquement les photos visibles. Si la session demande une approbation, approuve au moins une photo via /mod/:token.

Comment partager la Galerie/Polaroid ?

Utilise le token de partage (visible dans la page admin de la session). Tu peux régénérer le token si nécessaire.