photostation/memoire.md

Photostation

Description

Borne d'impression photo tactile. Les utilisateurs importent leurs photos (USB, WiFi, QR code, email), les éditent (recadrage, rotation, effets, goodies, multi-pose, texte) et les impriment sur imprimante sublimation.

Concept

Ce n'est PAS un photobooth (pas de capture photo). C'est une station de transfert/impression : les utilisateurs arrivent avec leurs propres photos et la borne permet de les éditer et imprimer.

Stack technique

• Interface : PyQt6 / QGraphicsScene (natif, léger, tactile — choisi au lieu de Chromium pour économiser la RAM sur RPi 3)
• Traitement image : Pillow (effets, redimensionnement, export)
• Impression : CUPS via pycups
• Hotspot WiFi : hostapd + dnsmasq + Flask (mini serveur upload)
• QR : qrcode (Python)

Matériel

• Prototype : Raspberry Pi 3B+ (1GB RAM) — en stock chez Jules
• Cible : Portable vers RPi 4 ou 5 sans aucun changement de code
• Écran tactile : en stock chez Jules (modèle à déterminer)
• Imprimante sublimation : à acheter (pistes : DNP DS620A, Mitsubishi CP-D90DW)
• Pas de capture photo — les utilisateurs apportent leurs propres photos

Architecture

src/
  main.py                    — Point d'entrée (--kiosk pour plein écran)
  services/
    usb_watcher.py           — Détection USB par polling (findmnt + scan récursif)
  ui/
    main_window.py           — Navigation QStackedWidget (4 écrans)
    screens/
      home_screen.py         — Accueil, 4 boutons import, status USB live
      import_screen.py       — Galerie de photos (grille scrollable)
      editor_screen.py       — Éditeur complet (voir fonctionnalités ci-dessous)
      print_screen.py        — Prévisualisation + choix format + impression
    widgets/
      crop_overlay.py        — Rectangle de crop avec poignées tactiles + grille des tiers
      goodies_panel.py       — Panneau latéral stickers/cadres (charge depuis assets/)
      multipose_dialog.py    — 5 templates multi-pose avec prévisualisation
assets/
  goodies/                   — Stickers PNG (à peupler)
  frames/                    — Cadres photo PNG (à peupler)
  fonts/                     — Polices custom
data/
  photos/                    — Photos importées (gitignored)
  exports/                   — Exports PNG (gitignored)
config/                      — Configuration (imprimante, WiFi, etc.)

Fonctionnalités implémentées (2026-03-21)

• Import USB : polling montages, scan récursif photos (jpg/png/bmp/tiff/webp/heic), bouton vert + compteur quand clé détectée
• Galerie : grille 4 colonnes avec miniatures cliquables
• Recadrage : overlay interactif, grille des tiers, poignées tactiles aux coins, zone assombrie
• Rotation : 90° par clic (transformation réelle, pas juste visuelle)
• Filtres Pillow : N&B, sépia, vintage (désaturation+contraste), contraste
• Goodies : panneau latéral toggle, stickers draggable (20% taille scène), cadres overlay
• Multi-pose : 5 templates (2h, 2v, 3 gauche, 4 grille, 3 bande), remplissage auto depuis galerie
• Texte : éditable + draggable, police 32pt blanche
• Annuler : reset à l'image originale
• Export : scène complète → PNG haute résolution (fichier temporaire)
• Impression : écran prévisualisation + sélection format (10x15, 13x18, 15x20 cm)

Dev

• Repo Gitea : https://git.copydev.fr/jules/photostation
• Token Gitea : 4bc923c47cf363a866daa1e1a6cf22bc44a78bc5 (claude-photostation)
• LXC dev : ID 164, hostname photostation, IP 192.168.111.164
  • Debian 12, 2GB RAM, 2 cores
  • Python 3 + PyQt6 6.10.2 + Pillow 12.1.1 + venv dans /opt/photostation/venv/
  • Code dans /opt/photostation/
  • Xvfb :99 (1024x600) + VNC port 5900 (sans mot de passe)
  • Lancer l'app : source venv/bin/activate && DISPLAY=:99 PYTHONPATH=src python3 src/main.py
• Lancement local : python3 src/main.py (fenêtré) ou python3 src/main.py --kiosk
• Git config : user Jules, email contact@copydev.fr
• Credentials git : stockés dans /tmp/.git-cred-photostation

TODO

• Peupler assets/goodies/ et assets/frames/ avec des stickers et cadres
• Impression CUPS réelle (pycups, détection imprimante, envoi job)
• WiFi hotspot (hostapd + dnsmasq + Flask page upload)
• QR code (génération lien vers page upload)
• Email (réception SMTP)
• Thème/style plus abouti
• Tests sur RPi 3 réel

Formats d'impression

• 10x15 cm
• 13x18 cm
• 15x20 cm

Notes

• Fichiers backend/ et frontend/ dans le repo = version alternative (probablement générée par un autre onglet Claude). Notre approche est dans src/ (PyQt6).
• Les libs xcb nécessaires sur le LXC : libxcb-cursor0, libxcb-xinerama0, libxcb-icccm4, libxcb-keysyms1, libxcb-render-util0, libxcb-shape0, libxcb-xfixes0, libxkbcommon-x11-0, libfontconfig1