Docs: regrouper livraisons par familles fonctionnelles dans chaque mois

docs/LIVRAISONS_PAR_MOIS.md

@@ -2,138 +2,324 @@
 
 ## Janvier 2026 (8 commits)
 
-- Site public affichant le contenu de la DB + fichiers
+### Structure initiale
-- Formulaire de soumission séparé → écriture en base
+- Schéma SQLite : tables theses, auteurs, formats, langues, tags, fichiers
-- Première version des contrôleurs TFE (création, édition)
+- Monorepo : organisation en dossiers (formulaire, templates, src, admin)
-- Structure initiale du projet : routing, templates, DB SQLite
+- Justfile, .gitignore, documentation (READMEs)
-- Schéma de base de données (theses, auteurs, formats, langues, etc.)
+- Nginx config + déploiement fonctionnel
+- Système de recherche sécurisé
 
 ## Février 2026 (29 commits)
 
-- Formulaire admin + formulaire étudiant (partage)
+### Formulaire & soumission
-- Soumissions étudiant via liens de partage (share links)
+- Formulaire admin (ajout/édition TFE)
-- Système de visibilité : Libre / Interne / Interdit
+- Formulaire étudiant via liens de partage (share links)
-- Pages statiques éditables (À propos) → début du CMS
+- Structure formulaire : champs obligatoires, validation
-- Gestion des fichiers uploadés (stockage, affichage)
+- Uploads de fichiers (stockage, affichage)
-- Export CSV des TFE
+
-- Import CSV des TFE
+### Visibilité & accès
-- Structure admin : index, navigation, table listant les TFE
+- Système à 3 niveaux : Libre / Interne / Interdit
-- Base du système de licences (CC2r)
+- Protection par mot de passe des fichiers « Interne »
+- Authentification admin (login / session PHP)
+
+### Pages statiques (début CMS)
+- Pages éditables : À propos (Markdown → HTML)
+- Templates header/footer, mise en page responsive
+- Cards en grille sur la page d'accueil
+
+### Admin
+- Index admin : liste des TFE, pagination, stats
+- Export / import CSV
+- Navigation admin dynamique
+- CSS admin : composants réutilisables
+
+### Sécurité
+- Auth guard pour le panneau admin
+- Correction des failles HIGH et LOW (TODO.SECURITY.md)
 
 ## Mars 2026 (74 commits)
 
-- Édition / correction / suppression des entrées TFE dans l'admin
+### Contrôleurs & architecture
-- Récapitulatif admin après soumission
+- ThesisCreateController, ThesisEditController : extraction depuis add.php/edit.php (530 lignes → contrôleurs dédiés)
-- Affichage public des TFE (page tfe.php)
+- TfeController, SearchController, HomeController : extraction depuis les pages publiques
-- Moteur de recherche dans le répertoire (par nom)
+- SystemController : unifie status + logs en un onglet système
-- Filtres par orientation, AP, année, langue, finalité
+- App.php : classe fondation + flash messages unifiés
-- Système d'authentification admin (login / mot de passe / session)
+
-- Protection par mot de passe des fichiers « Interne »
+### Répertoire & recherche
-- Données internes : points du jury, remarques, lien BAIU, exemplaires
+- Répertoire en 6 colonnes : années, orientations, AP, mots-clés, noms, compte
-- Colonnes du répertoire : années, orientations, AP, mots-clés, noms
+- Filtres combinables (AP + mot-clé + orientation simultanément)
-- Rework CSS majeur (variables, typographie, thème clair/sombre)
+- Filtres HTMX sans rechargement de page, URL partageable
-- Intégration HTMX pour les interactions dynamiques
+- Tri matched-first dans les colonnes de filtre
-- Upload de fichiers avec queues JS (avant FilePond)
+- Popover étudiant·e (pré-rendu serveur, lazy load)
-- Structure formulaire : champs conditionnels selon les formats
+
-- PDF obligatoire / optionnel selon les formats
+### Page TFE publique
-- Jury (promoteurices, lecteurices) dans le formulaire admin
+- Layout complet : auteur > titre > meta + synopsis > fichiers > jury
+- Jury interne / externe affiché séparément
+- Liens hypertextes vers le répertoire sur les métadonnées
+- Open Graph / Twitter Card meta tags
+
+### Base de données
+- Migrations : superviseurs multi-rôles, tags renommés depuis keywords
+- Vues SQL (v_theses_full, v_smtp_active)
+- WAL mode pour SQLite
+- Index composites (is_published, year) pour la perf
+- Auto-migration au démarrage du serveur
+
+### Sémantique HTML & accessibilité
+- Refactor sémantique complet de toutes les pages publiques
+- Head partagé, nav sémantique, aria-current, skip links
+- Status badges non dépendants de la couleur (WCAG 1.4.1)
+- Autofocus premier champ invalide (WCAG 3.3.1)
+- Sous-titres WebVTT pour vidéos (WCAG 4.1.2)
+- Cibles tactiles 44×44px (WCAG 2.5.5)
+
+### CSS & design
+- Suppression de tous les assets externes (self-hosting)
+- Polices : Combined (titres) → Ductus, corps en BBBDMSans
+- Variables de couleur standardisées
+- Dark mode prefers-color-scheme
+- Header plus dense, recherche pleine largeur
+- Remplacement EasyMDE (333KB) → OverType (118KB)
+- Cache-busting par filemtime
+
+### Admin
+- Pagination serveur (25/page)
+- Tri des colonnes dans l'index
+- Merge status + logs → system.php avec onglets fetch()
+- Paramètres : maintenance + compte
+- Dialogue d'import CSV inline
+- Gestion des fichiers dans l'édition TFE (couverture, TFE, etc.)
+
+### Formulaire
+- Partials de champs de formulaire réutilisables (fieldset-academic, fieldset-metadata, etc.)
+- Jury fieldset partagé add/edit
+- Aide contextuelle Markdown dans le formulaire
+- Mode étudiant simulé dans l'admin (?mode=student)
+
+### Email & SMTP
+- SmtpRelay : client SMTP natif (socket), AUTH PLAIN, TLS
+- Test SMTP, vérification des credentials à la sauvegarde
+- Champs from_name, notify_email
+- Email de notification admin après soumission
+
+### Ops
+- Déploiement : scripts unifiés, justfile
+- Renommage Posterg → XAMXAM (code, nginx, docs)
+- Rate limiting sur les endpoints partage
+- Exclusion du fichier DB et des uploads du rsync
 
 ## Avril 2026 (207 commits)
 
-- Refonte complète des uploads : FilePond remplace les queues custom
+### Uploads & fichiers
-- Architecture d'upload asynchrone FilePond (process/revert/load/remove)
+- **FilePond** remplace les queues custom (495 lignes de JS supprimées)
-- Pool unique TFE acceptant tous les formats (vidéo, audio, etc.)
+- Architecture upload asynchrone : process / revert / load / remove
-- Upload de masse avec barre de progression
+- Pool unique TFE (tous formats : PDF, vidéo, audio)
-- Intégration PeerTube pour vidéos / audio (upload API, embed)
+- Barre de progression d'upload
-- Système de brouillon automatique (autosave) pour le formulaire partage
+- Intégration **PeerTube** : upload API, OAuth2, embed iframe
-- Fragments HTMX partagés admin / partage (formats, fichiers, licence)
+- Vidéos/audio auto-upload vers PeerTube quand activé
-- Extraction du JS inline en modules externes (admin-logs, clipboard, pill-search, etc.)
+- Chiffrement credentials PeerTube + SMTP (AES-256-GCM)
-- Composant pill-search pour mots-clés et langues (autocomplete HTMX)
+
-- Gestion des mots-clés et langues dans l'admin (rename, merge, delete)
+### Fragments HTMX
-- TOC sidebar dans les pages admin (IntersectionObserver)
+- Fragments partagés admin / partage : formats + fichiers, licence, langue-autre
-- Tri des colonnes dans l'index admin (Auteur, Accès, etc.)
+- Fragments conditionnels selon les formats cochés (Site web → URL, Vidéo → upload ou PeerTube)
-- Liens de partage : nom éditable, expiration, dialogue d'édition
+- Aide contextuelle Markdown via HTMX
-- Obfuscation des emails en entités HTML (EmailObfuscator)
+- Fragments admin wrappés avec auth guard
-- Récapitulatif exhaustif (partage + admin)
+
-- Champs conditionnels : website URL, annexes, PeerTube vs. upload direct
+### Formulaire
-- Promoteurices multiples (interne + ULB) avec ajout/suppression dynamique
+- Partials de champs unifiés : text-field, select-field, checkbox-list
-- Formulaire mobile responsive
+- Jury : promoteurices multiples avec ajout/suppression dynamique
+- Jury ULB conditionnel (finalité Approfondi)
+- Annexes : checkbox + fichier conditionnel
 - Contact visible / contact interne découplés
-- CC2r renommé (ex-CC4r), restructuration des licences
+- CC4r → CC2r renommé
-- Pages statiques : Charte, Licence, À propos avec TOC sticky
+- Identifiant TFE régénéré automatiquement au changement d'année
-- Checkboxes admin en auto-save HTMX avec toasts de feedback
+- Validation inline des fichiers (MIME, taille) via HTMX
-- Backups SQLite automatisés (horaire + quotidien, cron)
+
-- Déploiement : recettes justfile, vérification permissions, migrations incrémentales
+### Pages statiques CMS
-- Content-Security-Policy, HSTS, SameSite cookies
+- À propos, Charte, Licence : Markdown → HTML, édition admin
-- Script de scan passif de sécu (pentest)
+- TOC sticky dans la sidebar
-- Chiffrement du mot de passe SMTP (AES-256-GCM)
+- Contenus-edit : OverType, auto-save, liens sidebar dynamiques
-- Rate limiting sur les endpoints sensibles
+- Contacts admin : grille 3 colonnes, ajout/suppression
+
+### Accessibilité
+- aria-errormessage, aria-invalid, aria-describedby sur tout le formulaire
+- Cibles tactiles 44×44px minimum (WCAG 2.5.5)
+- Formulaire responsive mobile (colonnes empilées)
+
+### Gestion des données
+- Mots-clés : recherche, rename, merge, delete dans l'admin
+- Langues : recherche, rename, merge bulk, dédoublonnage
+- Tri des colonnes Auteur et Accès dans l'index admin
+- Liens de partage : nom éditable, expiration, dialogue d'édition
+
+### Sécurité
+- Obfuscation des emails en entités HTML (EmailObfuscator)
+- Content-Security-Policy, HSTS, SameSite cookies, COOP/CORP
+- Script de scan passif de sécurité
+- Rate limiting, flash messages sur partage
+- Corrections non-constant-time (hash_equals)
+
+### CSS & refactoring
+- Architecture CSS en couches : reset → colors → typography → base → components
+- Suppression de toutes les classes BEM au profit de sélecteurs sémantiques
+- Tokens de design unifiés (couleurs, typographie, espacement)
+- Échelle fluide utopia pour typographie et espacement
+- Suppression du dark mode, unification des thèmes
+- Extraction de tous les styles inline vers CSS
+
+### Logs & monitoring
+- Logging structuré pour les soumissions admin/partage
+- AdminLogger : JSON-lines
+
+### Ops & déploiement
+- Déploiement automatisé (justfile) : code, dépendances, migrations
+- Vérification des permissions post-déploiement
+- Backups SQLite cron (horaire + quotidien)
+- Merge de toutes les migrations dans schema.sql
+
+### Architecture code
+- Extraction des contrôleurs (create, edit, search, TFE, system)
+- Partials de formulaire réutilisables
+- Dispatcher + front controller (index.php)
+- Configuration externalisée (config/apropos.php → SQLite)
 
 ## Mai 2026 (156 commits)
 
-- FilePond : correction crash « can't access property main », tailles en bytes
+### FilePond — corrections & hardening
-- Fichiers temporaires FilePond survivent au rechargement de page
+- Correction crash « can't access property main, n.status is undefined »
-- Relink de fichiers orphelins (file browser + FilePond integration)
+- Tailles de fichiers en bytes (plus de confusion toInt('1GB') = 1)
-- Trash policy : suppression → tmp/_trash avec traçabilité
+- Fichiers temporaires survivent au rechargement de page (session-track)
+- Guard no-JS : filepond_mode désactivé par défaut, fallback serveur
+- Relink fichiers orphelins (file browser + intégration FilePond)
+- Trash policy : suppression → tmp/_trash avec traçabilité DB
 - Storage prefix : theses/ → documents/
-- Recap admin : sections → fieldsets, fichiers en table
+
-- Extraction de FormBootstrap pour DRY add/edit
+### Autosave & brouillons
-- Système de colonnes thesis_status (two-phase commit lifecycle)
+- Brouillon automatique formulaire partage (HTMX POST/GET session)
-- Draft autosave avec persistence session (HTMX POST/GET fragments)
+- Auto-save admin checkboxes avec toasts de feedback
-- Guard no-JS file uploads (filepond_mode désactivé par défaut)
-- Accessibilité formulaire : aria-errormessage, aria-invalid, aria-describedby
-- Cibles tactiles 44×44px minimum (WCAG 2.5.5)
 - Nettoyage périodique des brouillons orphelins (cron)
-- Durée TFE : colonnes DB, champs formulaire, affichage XhYm
+- Contenus-edit : auto-save avec debounce, toolbar OverType
-- Déploiement : split deploy-code/deploy-deps/deploy-migrate
+
-- Intégration Monolog : 4 canaux PSR-3 remplaçant 4 systèmes de log
+### Build & assets
-- Tests PHPUnit : 228 tests, couverture 21,27%
+- **Biome** : linting + formatting CSS/JS
-- Remplacement Parsedown → league/commonmark
+- **Rolldown** : bundling JS par entrée
-- Remplacement client HTTP custom → Guzzle
+- **LightningCSS** : résolution @import, minification CSS
-- Remplacement SMTP socket → PHPMailer
+- Pipeline build orchestré (build.mjs)
-- Composer.json et autoloader
+- Dev-watch avec chokidar-cli (reconstruction ~200ms)
-- Refactor architecture CSS : layers (reset → colors → typography → base → components)
+- dist/ pour les assets minifiés, .gitignore
-- Composants CSS dédiés par fichier (links, focus, forms, tables, dialog, etc.)
+
-- SVG icons inline via helper PHP (icon()) — plus de <img> pour icônes
+### Gzip & extraction JS
-- Style global : liens regular, body light, hover violet, police BBB DM Sans
+- Gzip activé dans nginx
-- Page TFE : layout auteur > titre > meta + synopsis 2-col > fichiers flex
+- ~730 lignes de JS inline → 15 fichiers externes
-- Répertoire : colonnes triées (match first), scrollbars discrètes, pas de chip bar mobile
+- Modules : admin-logs, clipboard, pill-search, access-request
-- Accordéon mobile pour les filtres du répertoire
+
-- Détails/summary TOC pour pages statiques (responsive)
+### Tests
-- Contenus-edit : auto-save, toolbar OverType, liens sidebar dynamiques
+- PHPUnit setup : 228 tests, couverture 21,27%
-- Gestion des contacts admin (grille 3 colonnes, suppression, réindexation)
+- Tests unitaires : Crypto, EmailObfuscator, SystemController, StudentEmail, TfeController
-- Corrections d'identifiants (year-prefix mismatch), migrations PHP
+- Tests intégration : Database, ShareLink, RateLimit
-- Fix contact_interne / contact_visible (découplage complet)
+- Tests validation : ThesisCreate, ThesisEdit, AutofocusField
-- Author name casing (COLLATE NOCASE, idHint lookup)
+- PHPStan + PHP-CS-Fixer + Biome pour le linting
-- Finalité master affichée sur la page publique TFE
+
-- Suppression vidéos PeerTube lors de la suppression d'un TFE
+### Dépendances & modernisation
-- Nettoyage logs, gitignore vendor/, icône de recherche
+- Composer.json avec autoloader
-- Build pipeline : biome + rolldown + lightningcss (bundling/minification)
+- Parsedown → league/commonmark
-- Dev-watch avec chokidar-cli (reconstruction live)
+- Client HTTP custom → Guzzle
-- Gzip activé dans nginx + ~730 lignes de JS inline → 15 fichiers externes
+- SMTP socket → PHPMailer
-- Scroll-position memory sur les swaps HTMX du répertoire
+
-- Correctifs sécu (open redirect, CSRF partage, gate session, verifyCsrf)
+### Logging
-- Biome lint fixes (duplicate CSS, arrow functions)
+- **Monolog** : 4 canaux PSR-3 (app, admin, error, audit)
+- Rotation 30 jours, format JSON préservé
+- Remplace 4 systèmes de log distincts
+- LOG_LEVEL par variable d'environnement
+
+### CSS — refactor architecture
+- Split en couches nommées (reset, colors, typography, base, components, utilities)
+- Un fichier par composant (links, focus, forms, tables, dialog, etc.)
+- Compatibilité backward (variables.css, common.css wrappers)
+
+### UI / UX
+- SVG icons inline via helper PHP (icon()) — plus aucun <img> pour les icônes
+- Build pipeline CSS/JS
+- Dev-watch avec reconstruction live
+- Scroll-position memory sur swaps HTMX (répertoire)
+- Transition + swap fluide sur le répertoire
+- Correctifs sécurité (open redirect, CSRF partage, gate session)
+
+### Divers
+- Recap admin : sections → fieldsets, fichiers en table
+- FormBootstrap : DRY entre add/edit
+- Colonne thesis_status (two-phase commit lifecycle)
+- Déploiement : split deploy-code/deploy-deps/deploy-migrate, lockfile checksum
+- Export fichiers ZIP avec LINK.txt (URLs PeerTube)
+- Correctifs : identifier year-prefix mismatch, author name casing, contact découplage v2
+- CSV import : AP aliases, OUI/NON sanitization
+- Rate limits relevés (30→300/min sur certains endpoints)
 
 ## Juin 2026 (82 commits)
 
-- Migration icônes <img> → SVG inline (26 templates, helper icon())
+### Icônes SVG
-- Cleanup dialog : suppression doublons, hx-confirm sur delete
+- Migration complète <img> → SVG inline via icon() helper PHP
-- Refonte pages statiques (layout partagé, TOC sticky)
+- 26 templates modifiés
-- PHP upload limits → 8GB pour vidéos
+- 12 icônes SVG corrigées (fill="#000000" → fill="currentColor")
-- Debug leftover crash HTMX FormData(fieldset)
+- Icône recherche remplacée (Phosphor fill-based magnifying glass)
+
+### Pages statiques & TOC
+- Refonte À propos / Charte / Licence : layout partagé en grille
+- TOC sticky → details/summary responsive (collapsible sur mobile)
+- Ancres de titres stables (CommonMark HeadingPermalinkExtension)
+- Styles liens standardisés
+
+### Répertoire — polissage UX
+- Accordéon mobile pour les colonnes de filtre (≤640px)
+- Toggle, chevron, badge compteur de filtres actifs
+- Tri des colonnes : matched first, puis unmatched, puis alphabétique
+- Mots-clés : résultats viables en haut
+- Suppression de la chip bar mobile
+- Correction re-init accordéon après swap HTMX (bug DOM détaché)
+- Scroll colonnes répertoire : min-height: 0, overflow-y: auto
+- Scroll-position memory sur swaps HTMX
+
+### Formulaire — accessibilité & robustesse
+- aria-errormessage, aria-invalid, aria-describedby sur tous les champs
+- Layout mobile responsive (champs empilés, 44×44px touch targets)
+- Autosave brouillon formulaire partage (session persistence)
+- Guard no-JS (filepond_mode désactivé par défaut)
+- Preserve fichiers temporaires FilePond après redirection validation
+
+### Uploads & fichiers
+- PHP upload limits → 8GB (vidéos)
+- Nettoyage dialog : suppression doublons, hx-confirm sur delete
 - Type hint adminOld corrigé (string → string|array)
-- Index SQLite pour requêtes langues/tags
+
-- Accordéon mobile répertoire : toggle, chevron, badge actif
+### Build & performance
-- Remplacement sticky nav par details/summary TOC responsive
+- Pipeline build CSS/JS (biome + rolldown + lightningcss)
-- Icône recherche corrigée
+- Dev-watch chokidar-cli
-- Scroll colonnes répertoire + admin TOC duplication
+- Gzip nginx + extraction JS inline (730 lignes → 15 fichiers)
-- Filtres répertoire : tri matched-first, mot-clés en haut
+- Biome lint fixes (CSS duplicate properties, JS arrow functions)
-- Suppression chip bar mobile
+
-- Accordéon re-init après HTMX swap (bug DOM détaché)
+### Contenus & CMS
-- Gzip + extraction JS inline
+- Auto-save avec OverType toolbar sur contenus-edit
-- Build pipeline CSS/JS
+- Liens sidebar dynamiques (site ERG, code source)
-- Dev-watch
+- Markdown cheatsheet : rendu réel dans la colonne d'exemple
-- Transition scroll + swap fluide sur répertoire
+- Page Charte ajoutée (publique + admin)
-- Correctifs sécu (csrf partage, open redirect, verifyCsrf)
+
-- TODO et tasks de sécu complétés
+### TFE — métadonnées
+- Durée : colonnes DB, champs formulaire, affichage XhYm
+- Finalité master affichée sur la page publique
+- Identifiant régénéré si mismatch année
+- Author name casing corrigé (COLLATE NOCASE, idHint lookup)
+- Suppression vidéos PeerTube lors de la suppression d'un TFE
+
+### Sécurité
+- Open redirect fix : rejet des URLs protocol-relative (//evil.com)
+- CSRF sur retry-email POST
+- Gate partage fragments sur session share_active
+- Suppression App::verifyCsrf() mort
+
+### Divers
+- Index SQLite pour requêtes langues/tags (contenus page)
+- Correctif logs capturés
+- Nettoyage .gitignore, vendor/
+- Cleanup dialog
+- TFE page : CC2r + licence, formatage contact court
+- Recherche : filtres finalité + format, bouton Réinitialiser neutre