folio/CHANGELOG.md

Changelog — varlog

[Unreleased] — 2026-05-13

Performances

• Cache multi-niveaux pour les vues d'articles : temps de chargement réduit de +5 s à ~0,4 s sur 1 062 articles.
  • Mémoïsation de getAll() et getSearchIndex() dans la requête PHP ($allCache, $searchIndexCache) — évite les appels répétés.
  • Cache disque par article (_cache/articles/{uuid}.json) avec invalidation par comparaison mtime — 1 lecture au lieu de 2 par article.
  • Slug index (_cache/slug_index.json) : getBySlug() en O(1) sans scanner tous les articles ; construit depuis search_index.json en un seul fichier.
  • getCategories() et $_allPublished chargés depuis search_index.json au lieu de getAll() — 1 fichier lu quelle que soit la taille du catalogue.
  • search_index.json enrichi avec cover, created_at, author ; rebuild automatique si le format est obsolète.
  • SearchEngine::scorePool() : tokenise chaque article une seule fois pour N mots de titre (vs N passes séparées qui retokenisaient chaque article N fois et calculaient la similarité trigramme sur le contenu).
  • Le nombre de lectures de fichiers par vue d'article est désormais constant (~4), indépendamment du nombre total d'articles.
  • Documentation : docs/cache-architecture.md.

Corrigé

• Upload de fichiers (#48) : les fichiers > 8 Mo étaient rejetés silencieusement. Le serveur utilise mod_php (non PHP-FPM) ; les limites ont été corrigées dans /etc/php/8.3/apache2/php.ini : upload_max_filesize = 500M, post_max_size = 2048M. Le handler add_files détecte désormais le dépassement et affiche un message d'erreur explicite au lieu de rediriger sans rien faire.

Fonctionnalités

• Réactions visiteurs : trois boutons (👍 Utile / 🔥 Important / 🤔 À creuser) affichés sous chaque article. Toggle : recliquer retire la réaction. Accessible sans compte via un cookie UUID (vl_vid, 1 an, HttpOnly). Comportement async fetch avec fallback formulaire natif (compatible CSP script-src 'self'). Routes : POST /react. Table BDD : article_reactions.

• Commentaires avec vérification email : formulaire nom + email (non publié) + texte (2 000 caractères max). Protection honeypot + CSRF en session. Un code à 6 chiffres est envoyé par email (expire 24 h) ; le commentaire est auto-publié au clic sur le lien de confirmation. Routes : POST /comment, GET /verify-comment/<6chiffres>. Table BDD : comments.

• Modération commentaires : onglet Commentaires dans /admin/comments listant tous les commentaires avec statut (vérifié / publié) et actions masquer/republier. Route : POST /comment-moderate.

• Page de confirmation à l'enregistrement : cliquer sur "Enregistrer" affiche une page intermédiaire avec le diff du contenu, le slug (déplacé ici depuis le formulaire, avec suggestion auto si le titre a changé), un commentaire de révision pré-rempli d'après les modifications détectées, et un aperçu SEO (snippet Google). La sauvegarde effective n'a lieu qu'après confirmation.

• URLs propres : toutes les routes internes migrent vers des chemins lisibles. Les anciennes URLs /?action=… restent fonctionnelles (compatibilité).

  Ancienne URL	Nouvelle URL
  /?action=edit&uuid=<u>	/edit/<u>
  /?action=sources&uuid=<u>	/sources/<u>
  /?action=diff&uuid=<u>&rev=<n>	/diff/<u>/<n>
  /?action=create	/new
  /?action=admin[&tab=<t>]	/admin[/<t>]
  /?action=categories	/categories
  /?action=profile	/profile
  /?action=about|legal|licenses|contact	/about, /legal…
  /?action=regen_thumbs	/admin/regen-thumbs
  /?action=add_files&uuid=<u>	/files/<u>/add
  /?action=import_image&uuid=<u>	/import/<u>
  /?cat=<cat>	/categorie/<cat>
  /?cursor=<uuid>	/page/<uuid>

• Moteur de recherche : index trigram+substring pré-construit (search_index.json, reconstruit à chaque écriture), accessible depuis la navbar.

Corrections

• Métadonnées fichiers (sources) : addFileMeta() ne sauvegardait pas l'auteur et l'URL source en raison d'un guard file_exists() trop strict — supprimé.
• Authentification OIDC (State invalide.) : session_start() était appelé avant bootstrap.php dans les fichiers OIDC, écrasant les paramètres de cookie (SameSite=Lax, Secure, HttpOnly) — corrigé dans start.php, callback.php et me.php.
• Sidebar droite de l'article : classe Bootstrap flex-nowrap-lg inexistante, remplacée par flex-lg-nowrap — la sidebar ne tombe plus en bas de page.
• Date d'affichage en liste : created_at affiché à la place de published_at — corrigé avec fallback approprié.
• Formulaire d'édition : "Fichiers existants" déplacé dans la colonne de droite ; attribution auteur/source étendue à tous les types de fichiers (pas seulement images).
• Historique des révisions : plus de révision créée si le contenu et le titre sont inchangés. Ajout des boutons de suppression par révision et suppression globale.
• Canonical URL catégorie : passe de /?cat=… à /categorie/….
• Flux RSS : /rss et /rss.xml redirigent en 301 vers /feed (URL canonique) ; les articles des catégories privées sont exclus du flux ; la description est convertie depuis Markdown en texte brut.

---

2026-05-09

Fonctionnalités

• SEO : balises canonical, sitemap.xml, robots.txt, JSON-LD (BlogPosting / WebSite), noindex sur les pages d'administration.
• Recherche : page de résultats avec score de pertinence, mise en évidence des termes, lien vers la catégorie depuis les résultats.
• Support HEIC/HEIF : conversion automatique en JPEG à l'upload.
• Support SVG : upload autorisé, servi avec Content-Type correct.
• Avant-première : article visible en liste mais verrouillé avant sa date de publication.
• Pagination curseur : navigation par UUID de dernier article vu, sans offset SQL.
• Layout article 3 colonnes : sidebar gauche (catégorie), contenu central, sidebar droite (pièces jointes, liens externes, articles liés).
• Import depuis URL : téléchargement de fichiers distants avec extraction automatique des métadonnées (EXIF, OpenGraph, PDF).
• Gestion des pièces jointes dans le formulaire d'édition, avec attribution auteur/source affichée dans la vue article.

Corrections

• Login intégré dans layout.php, chemins CSS en absolu.
• Redéclaration de url() dans config.php — fatal error corrigée.
• Correction permissions www-data sur data/.

---

2026-04 et antérieur

• Flux RSS paginé (/feed, /rss, /rss.xml) avec autodiscovery.
• Stockage des articles en fichiers Markdown (migration depuis base de données).
• SSO via Keycloak/OIDC avec PKCE.
• Images de couverture (liste, vue article, og:image).
• Brouillons visibles uniquement par l'auteur.
• Formulaire de contact (CSRF, honeypot, rate-limit).
• Pages : mentions légales (LCEN/RGPD), licences, à propos.
• Auto-hébergement Bootstrap 5, police Inter, favicon SVG.
• Headers HTTP de sécurité, CSP stricte.