331 lines
20 KiB
Markdown
331 lines
20 KiB
Markdown
# Journal des décisions
|
||
|
||
Ce fichier consigne les décisions structurantes actées pour le projet, avec
|
||
la date à laquelle elles ont été prises. Toute nouvelle décision structurante
|
||
(schéma DB, auth, hébergement, etc.) doit être ajoutée ici après validation
|
||
par Kévin.
|
||
|
||
## 2026-10-15
|
||
|
||
- **Miniatures générées côté client** (validé par Kévin) : à l'upload,
|
||
`src/e/upload.js` produit une miniature (480 px côté long, JPEG ≤ 75 Ko,
|
||
sans EXIF) via browser-image-compression et l'envoie à côté de l'original :
|
||
`{event_id}/{uuid}_thumb.jpg`. Convention de nommage plutôt qu'une colonne
|
||
(aucune migration) ; même dossier que l'original pour que la purge J+7
|
||
(liste non récursive de `{event_id}/`) l'emporte. Pas de ligne
|
||
`photobooth.photos` pour la miniature : jamais dans le ZIP, jamais comptée
|
||
dans `max_photos_per_guest`. Échec de la miniature non bloquant ; les
|
||
galeries retombent sur l'original (anciennes photos incluses).
|
||
- **Nom de marque : « Tablée »** (validé par Kévin, alternatives écartées :
|
||
Convives, Pellicule). INPI et disponibilité de domaine non vérifiées.
|
||
- **Nouvelle DA « Faire-part »** (ivoire / encre / accent bordeaux,
|
||
Cormorant Garamond + Inter) : remplace « Polaroid Néon », jugée « tcheap »
|
||
par Kévin. Appliquée d'abord à la vitrine (`src/landing/`), puis étendue
|
||
à tous les écrans de l'appli. Référence : `.claude/skills/photobooth-da/`.
|
||
- **Purge J+7 confirmée active** : workflow n8n « Purge Storage J+7 » en
|
||
succès quotidien (le point « reste ouvert » du 2026-09-16 est clos).
|
||
- **Contact RGPD / éditeur** sur la page invité : Kévin Lecou, entrepreneur
|
||
individuel, lecoukevin@gmail.com ; TVA non applicable (art. 293 B du CGI).
|
||
- Travail de commercialisation : voir `docs/go-to-market/README.md`.
|
||
- **Token admin dans le fragment** (validé par Kévin) : `create-event` génère
|
||
désormais `/admin/<slug>#token=…` (jamais envoyé au serveur ni dans les
|
||
logs). Les anciens liens `?token=` restent acceptés et sont réécrits en
|
||
`#token=` côté client. nginx : `access_log off` sur `/admin/` ; logs Docker
|
||
bornés à 3×10 Mo. Le workflow n8n de création ne change pas.
|
||
- **Slug non devinable** (validé par Kévin) : suffixe aléatoire de 6 hex
|
||
toujours ajouté (`mariage-clara-mehdi-3021e3`), migration
|
||
`20261015130000_slug_random_suffix.sql`. Events existants inchangés.
|
||
- **Supabase `kevin-lecou-hub` hébergé en `eu-west-3` (Paris)** : vérifié,
|
||
« hébergé en France » utilisable dans les textes.
|
||
|
||
## 2026-09-18 (sept)
|
||
|
||
- **Code poussé sur Gitea** : premier `git push` réussi vers
|
||
`https://git.assistantaikev.eu/KevinLecou/photobooth-qr.git`. Accroc en
|
||
cours de route : le conteneur Gitea avait démarré avant que le DNS de
|
||
`git.assistantaikev.eu` soit propagé, donc la première tentative
|
||
Traefik/Let's Encrypt avait échoué (NXDOMAIN) et n'était jamais
|
||
retentée automatiquement — `git push` échouait avec une erreur de
|
||
certificat. Fix : redémarrer le conteneur Traefik une fois le DNS
|
||
propagé force une nouvelle tentative ACME, qui a réussi. À retenir pour
|
||
la prochaine fois qu'un nouveau sous-domaine est ajouté derrière ce
|
||
Traefik : DNS d'abord, puis démarrer le service, sinon redémarrer
|
||
Traefik après coup.
|
||
- Workflow n8n "Créer un événement" **publié/actif** :
|
||
`https://n8n.assistantaikev.eu/form/abe61d87-7696-4542-8403-bf11f2d98ba4`
|
||
— URL stable, Kévin peut l'utiliser directement sans passer par moi.
|
||
- Boucle `create-event` → lien QR complétée : la fonction renvoie
|
||
désormais `?slug=...&baseUrl=...`, et `/admin/qrcode/` +
|
||
`/admin/print-template/` lisent les deux pour se pré-remplir
|
||
entièrement (avant : ces pages ne lisaient aucun paramètre, il fallait
|
||
tout ressaisir à la main).
|
||
- **V1 considérée close** par Kévin après cette session (DA "polaroid
|
||
poussé à fond" validée en conditions réelles, pipeline de création
|
||
d'event bout-en-bout fonctionnel, code sauvegardé sur Gitea). Prochain
|
||
chantier évoqué : V2/V3 commercialisation, RGPD/mentions légales pro en
|
||
premier (bloquant juridique avant de vendre à des tiers), pas encore
|
||
démarré.
|
||
|
||
## 2026-09-18 (six)
|
||
|
||
- **Limitation connue (pas un bug à corriger)** : sur /e/OS + navigateur
|
||
DuckDuckGo, le bouton "Prendre une photo" (`capture="environment"`)
|
||
ouvre la galerie au lieu de l'appareil photo, et l'inverse pour "Depuis
|
||
la galerie". Vérifié : le HTML/JS est conforme à la spec (wiring
|
||
correct), c'est DuckDuckGo Android qui n'honore pas fiablement
|
||
l'attribut `capture`. Décision : ne rien coder de spécifique pour ce
|
||
navigateur (combo /e/OS + DuckDuckGo trop marginal côté invités réels,
|
||
qui arrivent très majoritairement via Safari/Chrome par défaut) — à
|
||
revérifier par Kévin sur iPhone/Android dès qu'il en a sous la main.
|
||
- **Événement de test créé en conditions réelles** via le workflow n8n +
|
||
`create-event` (slug `test-da-verification-kevin`) : premier passage
|
||
bout-en-bout du pipeline complet (n8n → Edge Function → Telegram),
|
||
fonctionnel. Confirme aussi que le déploiement de la passe DA
|
||
"polaroid poussé à fond" (voir entrée précédente) rend bien en
|
||
conditions réelles sur le domaine de prod, pas seulement en local —
|
||
modale de bienvenue et état vide de la galerie vérifiés par capture
|
||
d'écran sur `https://photobooth.assistantaikev.eu`.
|
||
- **Déployé sur le VPS** (scp direct des 7 fichiers modifiés vers
|
||
`/home/kevin/photobooth-qr/site/`, pas de rebuild nécessaire — site
|
||
statique servi par nginx).
|
||
|
||
## 2026-09-18 (cinq)
|
||
|
||
- **2e itération de la 4e passe DA, plus radicale** : retour Kévin sur la
|
||
version "rim light + grain" ("franchement c'est nul", captures à l'appui
|
||
après avoir vérifié moi-même dans Chrome) — l'effet était bien trop
|
||
subtil, l'app restait un grand vide noir avec une petite carte sombre
|
||
illisible. Changement structurel plutôt qu'un réglage plus fort du même
|
||
hack : les cartes "props" côté invité (bloc de chargement/erreur/succès,
|
||
modale de bienvenue, formulaire prénom+message) passent en **papier
|
||
clair** (`#FAF6F0`, encre `#12100E`) posé sur la table sombre, avec un
|
||
ruban "washi tape" en haut de carte et une légère inclinaison
|
||
(-2.2°/+1.8° selon l'état) — comme un vrai polaroid, plutôt qu'un panneau
|
||
UI sombre. Une carte claire sur fond quasi noir projette une vraie ombre
|
||
(`--shadow-paper`), contrairement à une carte sombre sur fond sombre :
|
||
ça résout le problème à la racine plutôt qu'en le maquillant.
|
||
- Bug technique corrigé au passage : l'inclinaison ne s'affichait pas du
|
||
tout au premier essai — une `animation` qui touche `transform`
|
||
(`fade-rise`) remplace toute la propriété, elle ne fusionne pas avec un
|
||
`rotate()` posé à côté en statique. Fix : rotation intégrée dans les
|
||
keyframes (`state-card-in`), avec repli statique sous
|
||
`prefers-reduced-motion: reduce`.
|
||
- **Écran admin** (galerie + générateur QR) : reste sombre/sobre, sans
|
||
tilt ni tape (exception du skill DA conservée), mais `--color-card`
|
||
légèrement éclairci (`#1E1B18` → `#241F1A`) et liseré coloré plein en
|
||
haut de carte (plus un fond teinté translucide) pour rester repérable —
|
||
même diagnostic que côté invité (contraste carte/fond trop faible pour
|
||
se voir), remède différent (sobre, pas de papier). Le générateur QR
|
||
(`src/admin/qrcode/`) n'avait quasiment aucune mise en forme avant cette
|
||
passe (champs nus sur le fond, aucun regroupement visuel, police
|
||
"General Sans" référencée mais jamais chargée dans ce fichier) : plus
|
||
gros écart identifié lors de l'audit, corrigé (carte de formulaire,
|
||
police chargée, contraste champs/carte).
|
||
- **Vérifié visuellement cette fois** : captures d'écran via Chrome headless
|
||
local (`google-chrome --headless=new --screenshot=...`) sur les 5 écrans
|
||
+ la modale de bienvenue forcée visible temporairement pour vérification
|
||
— pas juste une relecture de CSS. Contrastes WCAG AA recalculés pour les
|
||
nouvelles combinaisons papier (encre/muted sur `#FAF6F0`) : ≥5:1 sur tous
|
||
les textes ajoutés.
|
||
- Pas testé avec un vrai événement (formulaire rempli, grille de photos
|
||
garnie, écran de succès) faute de slug valide en local — seuls les états
|
||
vides/erreur ont pu être vérifiés en conditions réelles de rendu.
|
||
|
||
## 2026-09-18 (quater)
|
||
|
||
- **4e passe DA "Polaroid Néon"** : suite au retour "ça fait vraiment
|
||
low-cost, il faut me rendre cette application sexy", audit écran par
|
||
écran (upload, galerie invité, admin galerie, générateur QR, carton
|
||
imprimable). Diagnostic : ce n'était pas la direction elle-même
|
||
(conservée intégralement, aucune valeur de palette changée) mais des
|
||
défauts d'exécution — ombres noires invisibles sur fond quasi noir
|
||
(`#12100E`), fond en aplat sans texture, pastille de marque non
|
||
généralisée à tous les écrans, icône manquante sur le lien "Télécharger"
|
||
admin. Corrigé via : liseré clair ("rim light") sur les cartes/boutons,
|
||
grain de fond en SVG data URI inline (~350 octets, 0 requête réseau),
|
||
pastille corail derrière le logo sur tous les écrans, icône ajoutée au
|
||
lien de téléchargement admin. Bug `[hidden]` masqué par un `display`
|
||
auteur (déjà rencontré 3 fois sur ce projet) anticipé et corrigé au
|
||
passage sur `#empty-state` (galerie invité, passé en `display: flex`).
|
||
Contrastes WCAG AA revérifiés, aucun n'a changé (aucune couleur de texte/
|
||
fond modifiée). Non vérifié visuellement dans un navigateur avant cette
|
||
entrée (pas d'accès Chrome dans l'environnement) — à prévisualiser en
|
||
local avant déploiement.
|
||
|
||
## 2026-09-18 (ter)
|
||
|
||
- **`create-event` déployée en prod** sur `kevin-lecou-hub` (migration
|
||
`20260918100000_create_event_rpc.sql` + Edge Function
|
||
`supabase/functions/create-event/`). Vérifié après coup : grants limités à
|
||
`service_role` (n'apparaît pas dans les fonctions `SECURITY DEFINER`
|
||
exécutables par `anon`/`authenticated`, contrairement à
|
||
`get_public_event`/`insert_public_photo` qui le sont intentionnellement).
|
||
Un `search_path` manquant sur la fonction interne
|
||
`photobooth.generate_unique_slug` (signalé par le linter sécurité Supabase
|
||
juste après déploiement) a été corrigé dans la foulée
|
||
(`20260918101500_harden_generate_unique_slug_search_path.sql`).
|
||
- Le workflow n8n `photobooth-qr — Créer un événement` reste **inactif** :
|
||
à activer par Kévin une fois le DNS `git.assistantaikev.eu` et un premier
|
||
test réel du formulaire validés.
|
||
|
||
## 2026-09-18 (bis)
|
||
|
||
- **Création d'événement** : via un **formulaire n8n** (Form Trigger),
|
||
plutôt qu'un formulaire dans l'appli photobooth-qr ou du SQL manuel. Le
|
||
workflow insère l'event en base (génère `slug` + `admin_token`) et
|
||
renvoie les liens invité/admin à Kévin. Choisi pour rester cohérent avec
|
||
la stack n8n déjà en place et éviter d'ajouter une nouvelle couche
|
||
d'authentification "admin produit" dans l'appli (aujourd'hui il n'existe
|
||
que des tokens par événement, pas de compte admin global).
|
||
- **Pas de personnalisation visuelle par événement** : la DA "Polaroid
|
||
Néon" reste identique pour tous les événements ; seules les infos
|
||
textuelles varient par event (nom, date, limite de photos). Pas de
|
||
marque blanche (palette/logo par client) en V1 — jugé de la
|
||
sur-ingénierie pour un besoin V2/V3 pas encore confirmé par un client
|
||
réel.
|
||
- **Remote Git : Gitea auto-hébergé sur le VPS existant** (plutôt que
|
||
GitHub). Cohérent avec la préférence d'autonomie de Kévin — tout reste
|
||
chez lui, pas de dépendance à un service tiers pour le code source. Le
|
||
VPS héberge déjà n8n (Traefik/SSL en place) ; Gitea tournera comme
|
||
service Docker supplémentaire derrière le même reverse proxy. Détails
|
||
d'implémentation (sous-domaine, ressources, sauvegarde) à définir avant
|
||
déploiement.
|
||
|
||
## 2026-09-18
|
||
|
||
- **Galerie invité (revirement)** : les invités peuvent désormais voir
|
||
**toutes** les photos de l'événement (pas juste envoyer la leur), dans
|
||
le cadre de la nouvelle DA "Polaroid Néon". Ça **inverse** la décision du
|
||
cahier des charges initial ("Pas de galerie visible côté invité,
|
||
confirmé : upload only"). Conséquence RGPD : le texte de mention légale
|
||
(`docs/rgpd.md` + modale de bienvenue) doit indiquer que photo/prénom/
|
||
message sont visibles par les autres invités de l'événement, pas
|
||
seulement mis à disposition de l'organisateur — mis à jour dans la
|
||
foulée. Implémentation : backend (nouvelle RPC/Edge Function publique de
|
||
listing + URLs signées pour les invités) pas encore fait à cette date,
|
||
seul le rendu visuel est en cours.
|
||
- **Nouvelle direction artistique "Polaroid Néon"** actée, voir
|
||
`.claude/skills/photobooth-da/SKILL.md` pour le détail complet (palette,
|
||
typographie, composant polaroid signature). Remplace les 3 passes DA
|
||
précédentes (palette corail/prune/doré + Fraunces) — celles-ci restent
|
||
en prod tant que la nouvelle direction n'est pas implémentée écran par
|
||
écran.
|
||
- **Stack confirmée inchangée** : vanilla JS/HTML/CSS, pas de framework
|
||
(React proposé dans un brief externe, décliné — mandat CLAUDE.md déjà
|
||
explicite sur ce point, aucune décision contraire prise).
|
||
|
||
## 2026-09-16 (récap fin de journée)
|
||
|
||
Produit passé de "code écrit, rien de déployé" à **réellement en ligne et
|
||
testé** : `https://photobooth.assistantaikev.eu` (VPS Hostinger, nginx +
|
||
Traefik), backend sur le projet Supabase définitif `kevin-lecou-hub`.
|
||
|
||
- **Bugs réels trouvés et corrigés en cours de route** (tous via tests en
|
||
conditions réelles, pas en théorie) :
|
||
- MIME type `.mjs` mal servi par nginx (bloquait tout le JS qui importe
|
||
un module vendorisé — upload invité ET générateur QR étaient cassés).
|
||
- Chemins relatifs (`style.css`, `config.js`, `gallery.js`) cassés sur les
|
||
URLs réécrites `/e/<slug>` et `/admin/<slug>` — passage en chemins
|
||
absolus partout.
|
||
- Bug de cascade CSS présent **depuis le tout premier commit** :
|
||
`display: flex` déclaré en dur sur `.upload-form`/`.welcome-modal`
|
||
empêchait `hidden` (JS) de masquer quoi que ce soit visuellement — le
|
||
formulaire est resté affiché en permanence, superposé aux autres états,
|
||
sans que personne ne s'en rende compte avant un test réel.
|
||
- Faille d'abus sur `insert_public_photo` (spam de lignes sans upload
|
||
réel) — corrigée, vérification d'existence du fichier Storage ajoutée.
|
||
- **Nouvelle fonctionnalité** : limite de photos par invité par événement
|
||
(`max_photos_per_guest`), appliquée côté serveur via un `guest_id`
|
||
anonyme (localStorage) — pas une identité vérifiée, contournable, mais
|
||
fait respecter la vraie limite côté base.
|
||
- **RGPD** : mention légale déplacée d'un bloc permanent vers une modale de
|
||
bienvenue personnalisée (nom de l'événement) au premier passage par
|
||
événement — texte légal inchangé, juste la présentation.
|
||
- **Direction artistique** : 3 passes (palette sobre → palette punchy
|
||
corail/prune/doré/Fraunces → mode sombre + finition animations). Statut
|
||
au 2026-09-16 soir : jugée "pas mal, vraiment fonctionnel" par Kévin,
|
||
mais **couleurs/DA pas encore validées définitivement** — Kévin prévoit
|
||
un retour détaillé à l'agent direction-artistique lors d'une prochaine
|
||
session.
|
||
- **Reste ouvert** : activation du workflow n8n de purge Storage
|
||
(credentials à créer côté Kévin), documentation de création d'un
|
||
événement (encore manuel en SQL), remote Git à définir.
|
||
|
||
## 2026-09-15
|
||
|
||
- **Expiration des données** : suppression à **J+7 à partir de la date de
|
||
l'événement** (`date_evenement`), et non à partir de la date de création
|
||
de l'événement dans le système.
|
||
- **Sécurité admin (V1)** : accès à la galerie admin via un **token secret
|
||
dans l'URL** (`admin_token`), pas de système de login/mot de passe. Réévaluer
|
||
ce choix avant V2/V3 si le nombre de clients augmente.
|
||
- **Suppression des données** : effective à J+7 **dans tous les cas**, y
|
||
compris si l'organisateur a déjà téléchargé le ZIP d'export des photos.
|
||
- **Hébergement** : utilisation du **VPS existant de Kévin**
|
||
(148.230.114.175), pas de nouvel hébergement dédié pour l'instant.
|
||
|
||
## 2026-09-16
|
||
|
||
- **Compression image côté client** : utilisation de la lib
|
||
**`browser-image-compression`**, plutôt qu'une implémentation maison via
|
||
Canvas API. Doit gérer l'orientation EXIF et les formats HEIC (iPhone).
|
||
|
||
## 2026-09-15 (bis)
|
||
|
||
- **Préfixage des tables** : le projet Supabase de photobooth-qr sera
|
||
mutualisé avec les autres projets de Kévin (KOMI, KAZA...). Tables
|
||
préfixées `pq_` (`pq_events`, `pq_photos`), conformément à la convention
|
||
du CLAUDE.md global. Les fonctions Postgres exposées au front
|
||
(`get_public_event`, `event_accepts_uploads`) restent sans préfixe : ce
|
||
sont des points de contrat public, pas des tables internes.
|
||
- **Bucket Supabase Storage `event-photos`** : bucket **privé** (pas de
|
||
lecture publique). Convention de chemin : `{event_id}/{uuid}.{ext}`.
|
||
Consultation admin exclusivement via URLs signées générées par l'Edge
|
||
Function `service_role`. Aucune policy SELECT/UPDATE/DELETE publique sur
|
||
`storage.objects`. Limité à `file_size_limit = 6 Mo` et
|
||
`allowed_mime_types = image/jpeg` (aligné sur la sortie de compression
|
||
du front, qui force tout en JPEG y compris les HEIC convertis).
|
||
- **`pq_photos.url_storage`** : contrainte `CHECK` garantissant que le
|
||
chemin commence par `event_id/`, pour empêcher qu'une ligne de l'event A
|
||
pointe vers un fichier de l'event B (isolation multi-tenant), trouvé lors
|
||
de la relecture sécurité du 2026-09-15.
|
||
- **`get_public_event`** : renvoie l'événement même si son statut n'est pas
|
||
`actif` (expiré/archivé), pour permettre au front d'afficher un message
|
||
adapté. Risque jugé faible : les slugs sont partagés via QR code, donc
|
||
non secrets par nature.
|
||
|
||
## 2026-09-16 (quater)
|
||
|
||
- **Limite de photos par invité** : nouvelle colonne
|
||
`photobooth.events.max_photos_per_guest` (NULL = illimité par défaut),
|
||
réglable uniquement en SQL à la création de l'event pour l'instant (pas
|
||
d'UI admin dédiée). Appliquée via un `guest_id` anonyme généré et
|
||
persisté côté client (localStorage) — **pas une identité vérifiée**,
|
||
contournable en changeant d'appareil ou en vidant le storage. Fait
|
||
respecter côté serveur (RPC `insert_public_photo`, source de vérité) et
|
||
côté client de façon proactive (évite un envoi pour se le faire refuser
|
||
à la dernière étape).
|
||
|
||
## 2026-09-16 (ter)
|
||
|
||
- **Domaine de production (V1)** : `photobooth.assistantaikev.eu`, sous-domaine
|
||
du domaine déjà utilisé pour n8n. Décision explicitement temporaire : à
|
||
déplacer vers un domaine dédié en V2/V3 si le produit est vendu sous sa
|
||
propre marque. Front servi par un container nginx sur le VPS existant
|
||
(Traefik/Let's Encrypt déjà en place pour n8n), config dans `deploy/`.
|
||
`APP_BASE_URL` configurée comme secret sur les 2 Edge Functions pour le
|
||
CORS. Déploiement testé en conditions réelles le 2026-09-16 (upload +
|
||
galerie admin fonctionnels depuis le domaine public).
|
||
|
||
## 2026-09-16 (bis)
|
||
|
||
- **Déclenchement de la purge Storage à J+7** : **option n8n retenue**
|
||
(plutôt que `pg_cron`+`pg_net`). Un workflow n8n planifié quotidien
|
||
appelle l'Edge Function `expire-events` avec la `service_role` key
|
||
(Credentials Store n8n), avec notification Telegram en cas d'échec.
|
||
Cohérent avec la stack n8n déjà utilisée pour KOMI/KAZA, et le VPS n8n
|
||
existant sert de point d'orchestration commun. Conception du workflow :
|
||
`n8n/workflows/purge-storage-j7.json` (JSON importable, **non testé sur
|
||
l'instance n8n réelle**, credentials à relier manuellement avant
|
||
activation).
|