Aller au contenu
JoeCMS Télécharger 3.1.5
Manuel · 00

Index et carte des capacités

Ce manuel documente les capacités du système : ni l'histoire du projet (qui se trouve dans PANORAMICA_JOECMS.md) ni les corrections individuelles (FIX_FUNZIONAMENTO.md), mais ce qu'on peut construire sur ce CMS et comment faire.

Une partie des connaissances réunies ici vient des projets jumeaux construits sur la même stack (JoeSING, JoeQUIZ, JoeSMTP) : des mécanismes généraux offerts par le CMS qui n'étaient jusqu'ici documentés que dans le projet qui les avait utilisés en premier.

Les chapitres

#DocumentContenu
01Cycle d'une requête et routagebootstrap, routage à trois niveaux, chemins réservés, remontée du routeur, $schema["request"]
02Pages, templates et appletscontents/, ffTemplate et les marqueurs de bloc, applets, layout, CSS/JS
03Services HTTP et webhooks/srv, contrat JSON, bus de services, Jobs, réception de webhooks
04API interne et publiqueREST interne, api/1.0 avec Bearer, conventions du contrat, pièges
05Cron, jobs et workerscron HTTP, file de jobs, worker CLI, maintenance
06Email, notifications, SMS et pushprocess_mail, Mailer, Notifier, OneSignal, JoeSMTP, Twilio
07Données, base de données et contenusffDB_Sql et ses quatre pièges, Storage, modèle vgallery, migrations
08Authentification, utilisateurs et permissionsmodule auth, session, profils, ACL, cookies
09Backend et sectionsffGrid/ffRecord, ajouter une section, popups et toolbar
10Modules et services tiersstructure d'un module, modules fonctionnels, tags tiers, consentement aux cookies
11Médias, images et fichiersshowfiles, modes d'image, upload, gestionnaire de fichiers
12Cache et performancesles quatre caches, niveaux, invalidation, quoi surveiller
13Observabilité, diagnostic et CLIgestion des erreurs, ?__debug__, logs, Sentry, exécution en ligne de commande
14Environnements, installation et déploiementconfig d'environnement, assistant, déploiement de la branche active avec bin/deploy.sh, paquet (avec le manuel en instantané), checklist, mise à jour automatique du manuel

Carte des capacités

Légende : ✅ en production · 🟡 présent, à configurer ou à tester · ⚪ échafaudage upstream, à vérifier avant de compter dessus.

CapacitéÉtatOù
Pages dynamiques sans enregistrement (fichier → URL)✅02
Templates à tokens et blocs, multilingue par dictionnaire✅02
Routage déclaratif XML + modules✅01
Modèle de contenu à nœuds avec champs dynamiques✅07
Backend avec grilles et formulaires générés depuis la BD✅09
Comptes : connexion, inscription, récupération, activation✅08
Groupes, profils, permissions par nœud avec héritage✅08
Endpoints JSON de projet (/srv)✅03
API publique avec client credentials → Bearer✅ (auth seulement)04
Emails transactionnels avec templates et pièces jointes✅06
Langue préférée sur le profil : pages, emails et notifications dans la langue de l'utilisateur, même depuis cron✅12, 06 §2
Redimensionnement d'images à la volée avec cache✅11
Cache de page par utilisateur/groupe/anonyme et par langue✅12
Services tiers configurables + consentement aux cookies côté serveur✅10
Sitemap (une entrée par langue, avec hreflang) et version Markdown pour les LLM✅GUIDA_SITEMAP.md, GUIDA_INDICIZZAZIONE_AI.md, 12 §2
Suivi des erreurs (Sentry)✅ (DSN requis)13
Cron HTTP planifiables🟡 (schéma prêt, aucun job dans le dépôt de base)05
Réception de webhooks de fournisseurs🟡 (modèle, pas d'instances)03 §2
Notifications in-app avec programmation et expiration🟡06 §3
Push (OneSignal) et SMS (JoeSMTP, Twilio)🟡 (prêts, clés nécessaires)06 §4
Second facteur à la connexion🟡 (désactivé, AUTH_2FA)08 §5bis
File de jobs persistante (Jobs) et appels asynchrones🟡05 §4
Worker longue durée en CLI🟡 (shell + systemd nécessaires)05 §5
Constructeur de formulaires depuis le backend avec archive des réponses🟡10 §2
Recherche dans les contenus🟡10 §2
Storage multi-driver (MySQL, MongoDB, fichier)🟡07 §2
Cache applicatif sur Redis/Memcached/APCu🟡12 §4
Import/export, sauvegarde, clonage de schéma⚪07 §5
Paiements avec passerelles en drivers (Stripe : paiements uniques, abonnements, remboursements, webhooks)🟡 (clés nécessaires)10 §2
E-commerce (panier, wishlist, paiements)⚪10 §2
Serveur OAuth2 / apiserver⚪ (routes présentes, dossiers absents)08 §1
Broker de files (RabbitMQ)⚪ (bibliothèque présente, non câblée)05 §4
Mise à jour distante⚪ (abandonnée, rendue inerte)05 §3

Les règles non négociables

Synthèse des pièges qui ont déjà fait des dégâts dans l'écosystème. Le détail est dans les chapitres.

  1. Les marqueurs <!--BeginX--> / <!--EndX--> ne sont pas des commentaires. Pas d'espaces, pas de suppressions, pas de réordonnancement. → 02 §2.2
  2. use_cache(false) en tête de chaque service et de chaque page dynamique. → 12
  3. exit à la fin de chaque endpoint JSON, sinon le CMS ajoute le layout. → 03 §1
  4. execute() pour écrire, query() pour lire : après query(), getInsertID() ment. → 07 §1.1
  5. Les paramètres en query doivent être déclarés dans $schema["request"], sinon le kernel les écarte par une redirection silencieuse. → 01 §5
  6. Le routeur ne répond pas 404 : il remonte. Il faut une garde sur le résidu de chemin. → 01 §4
  7. Les paramètres du cookie de session se définissent avant session_start(), en un seul endroit. → 08 §6
  8. Auth::env() et Cms::env() lisent des buckets différents. → 08 §4
  9. Le tenant/propriétaire n'arrive jamais du body. → 03, 04
  10. Chaque migration va aussi dans database.sql, avec JC_SCHEMA_VERSION incrémentée, et la version le déclare dans le CHANGELOG (· schema **N**, ### Schema) : c'est là que joecms.it apprend s'il doit prévenir de mettre à jour la base de données. → 07 §4, 14 §5
  11. display_errors reste à 0 ; le debug se fait à la demande avec ?__debug__. → 13
  12. Lint après chaque modification de masse. → 13 §8
  13. Le logo dans les emails est un PNG, jamais un SVG. Par défaut il voyage comme URL absolue, et non plus comme pièce jointe cid: : certains relais rejettent tout le message s'il contient une pièce jointe. → 06 §2
  14. JC_APP_SECRET ne se régénère pas : il va dans la sauvegarde. → 14 §2
  15. Un code envoyé par email ne revient jamais dans la réponse au navigateur (activation, 2FA, récupération) : c'est le secret qui prouve l'accès à la boîte mail. → 08 §5
  16. Une adresse de retour prise dans l'URL n'est qu'un chemin du site : elle passe par Auth::redirectLocale(), sinon c'est un open redirect. → 08 §5
  17. Le sql_mode du serveur ne s'assouplit pas : on corrige la requête ou le schéma. Le code tourne sur les valeurs strict par défaut de MySQL 8 et MariaDB et sur le dialecte ANSI d'Aiven. → 07 §1
  18. Un texte que voit le visiteur ne s'écrit jamais dans une seule langue : dictionnaire dans les modèles, Auth::text() dans les messages du compte, tables par langue là où il n'y a pas de base de données. → 02 §2.3

Documents liés

FichierContenu
../../PANORAMICA_JOECMS.mdarchitecture et histoire des décisions
../../PRESENTAZIONE_JOECMS.mdprésentation non technique
../../FIX_FUNZIONAMENTO.mdcorrections qui changent le comportement
../../MIGLIORIE_ESTETICHE.mdinterventions CSS/UI uniquement
../../MIGRAZIONE_PHP7_PHP8.mdmigration vers PHP 8
../../INSTALLER_PIANO.mdplan détaillé de l'installeur
../../VGALLERY_NEXT_PIANO.mdnouvel espace de gestion des contenus
../../IGIENE_SEGRETI.mdgestion des secrets
../../GUIDA_INDICIZZAZIONE_AI.md, ../../GUIDA_SITEMAP.mdréglages par défaut réutilisables
../api-auth.mdréférence opérationnelle de l'API publique
../documentazione/cms-ricetta-portabile.mdla recette de travail sur la stack (origine JoeSMTP)
../documentazione/joesing-convenzioni.mdconventions et pièges (origine JoeSING)