# Analyse du template `cms_portfolio` — cahier des charges fonctionnel Analyse du rendu public de `ancien-code/sandbox/cms_portfolio/` (`index.php`, `prestation.php`, `inc/*.php`) et inventaire fonctionnel de son admin (`_data/admin.php`, `_data/save.php`). Sert de matière première à la section 4 de `cdc-fonctionnel.md`. **Hors périmètre de cette analyse** (non lus en détail, mentionnés seulement quand ils recoupent un champ) : `mentions-legales.php`, `rdv-valide.php`, `forms/*.php`, `HhfYihN/save.php`, `assets/js/main.js`, les fichiers `*_back_*.php` (versions de sauvegarde, non le code actif). En particulier, `ent_siret`, `ent_tva`, `ent_adeli`, `ent_rpps` et `ent_cp_ville` sont bien affichés quelque part — sur `mentions-legales.php` — mais pas sur les pages analysées ici ; ce n'est donc pas un écart "champ jamais affiché", juste un affichage hors du périmètre demandé. Le composant `inc/portfolio.php` a un fonctionnement suffisamment différent du schéma cible pour mériter sa propre lecture attentive — voir la section dédiée plus bas et le tableau d'écarts. --- ## 1. Sections visuelles, dans l'ordre d'apparition ### Page d'accueil (`index.php`) #### 1.1 Header / nav (`inc/header.php`) - Champs : `prenom`, `nom` (logo texte) · `telephone` (icône mobile) · `prestations[].nom`, `prestations[].slug` (sous-menu déroulant "Tarifs & Prestations", une entrée par prestation définie) - Un bloc de liens réseaux sociaux existe dans le HTML mais est désactivé (`d-none`, `href="#"` factices, pas de classe qui l'affiche) — markup mort, ne correspond à aucun champ JSON actuellement. - Bibliothèques : Bootstrap (grille, icônes `bi-telephone`/`bi-geo-alt`/ `bi-envelope`/`bi-chevron-down`/`bi-list`). Le sous-menu ne porte aucun attribut `data-bs-*` — son ouverture/fermeture est probablement pilotée par `assets/js/main.js` (hors périmètre), pas par le JS de Bootstrap lui-même : l'usage réel de `bootstrap.bundle.min.js` ici n'est pas confirmé par les fichiers analysés. #### 1.2 Hero (`
` de l'article, `id="hero"`) - Image principale : `assets/img/{slug_image}-1.webp` → correspond en position à `photos_accueil[0].image` (position 1 = hero, selon `client-json-explication.md`). **Écart de mécanisme** : l'attribut `alt` n'est pas lu depuis un champ stocké — il est recalculé à chaque affichage à partir de `prenom` + `nom` + dénomination + ville, alors que le schéma cible prévoit un `photos_accueil[].alt` librement saisi. - Titre (h1) : `prenom`, `nom` (spans `givenName`/`familyName`) · dénomination professionnelle (voir écart ci-dessous) rendue **en HTML brut** (balise ``). - Spécialités : boucle sur des clés numérotées → `metier.specialites[]`. - Bouton CTA (`inc/cta-button.php`) : lien + libellé → `cta.lien`, `cta.label`. **Écart de mécanisme** : l'icône n'est jamais stockée, elle est déduite à l'affichage du préfixe du lien (`tel:` / `mailto:` / sinon calendrier), alors que le schéma cible stocke `cta.icone` comme champ à part entière (avec valeur par défaut `bi-calendar-date`). - Boutons d'accès rapide (`inc/quick-access-buttons.php`, réutilisé aussi en section Approche) : liens statiques codés en dur vers `#faq` et `#alt-services`, aucun champ JSON — simple aide à la navigation. - 3 blocs "Pourquoi moi" (C-A-B) : titre+texte → `metier.description`, `metier.caracteristiques`, `metier.avantages`, `metier.benefices` (chacun `{titre, texte}`). - Un bloc "Recommandation" (partage Messenger/WhatsApp/SMS) existe en commentaire HTML dans le code — inactif, ne s'affiche jamais. - Bibliothèques : AOS (`fade-in`, `fade-down`, `zoom-out` sur presque tous les blocs), Bootstrap (grille, icônes, pictos métier statiques en PNG hors JSON). #### 1.3 Biographie (`id="biographie"`) - Photo : `assets/img/{slug_image}-2.webp` → `photos_accueil[1].image` (position 2 = illustration biographie, conforme à l'ordre documenté). Même écart d'`alt` recalculé que le hero (jamais lu depuis `photos_accueil[].alt`). - Titre de section "Formation et parcours" : texte statique du template, pas un champ client. - Intro : `biographie.intro` (HTML brut). - Items en accordéon (nombre libre) : `biographie.items[].titre`, `biographie.items[].texte`. - Bibliothèques : AOS uniquement. #### 1.4 Citation (bloc global, `inc/citation.php`) - Texte + auteur d'une citation globale, réutilisée telle quelle en repli dans les pages prestation quand celles-ci n'ont pas leur propre citation (voir 1.10). **Correspondance déduite, pas nommée à l'identique** : la structure et la description de `metier.citation` dans `client-json-explication.md` ("même structure que la citation d'une prestation, pour ne pas perdre l'attribution") correspondent exactement à ce rôle de citation globale/de repli → `metier.citation.texte`, `metier.citation.auteur`. À confirmer avec Christophe avant de l'acter, puisque la clé n'est jamais nommée `metier_citation` dans l'ancien système. - Aucune bibliothèque JS, image statique (pictogramme citation, non lié au JSON). #### 1.5 Approche métier (`id="approche"`) - Titre de section "Mon approche" : statique, pas un champ. - Intro, Vision, Mission, Valeurs : `approche.intro`, `approche.vision`, `approche.mission`, `approche.valeurs` (chacun `{titre, texte}` sauf intro). - Photo : `assets/img/{slug_image}-3.webp` → `photos_accueil[2].image` (position 3 = illustration approche, conforme à l'ordre documenté). Même écart d'`alt` recalculé. - Boutons d'accès rapide (réutilisation du composant 1.2). - Bibliothèques : AOS. #### 1.6 Prestations — grille de cartes (`id="alt-services"`) - Boucle sur 6 emplacements fixes (`prest_01` à `prest_06`, jamais plus) → `prestations[]`. **Écart** : le schéma cible n'impose aucune limite de longueur au tableau `prestations` ; le template plafonne à 6 par construction (boucle bornée, pas de détection dynamique de fin de liste comme ailleurs). - Champs par carte : `prestations[].nom`, `prestations[].slug` (URL), `prestations[].descriptif_court`. - Microdonnées schema.org `Service` par carte : réutilise `ent_ville` / `adresse.ville` pour `areaServed`, rien de nouveau côté champs. - Bibliothèques : AOS (`zoom-in`), Bootstrap (grille). #### 1.7 Témoignages (`inc/testimonials.php`, inclus aussi sur `prestation.php`) - Champs : `avis[].prenom`, `avis[].nom`, `avis[].texte`. - **Écart** : les 5 étoiles affichées sont codées en dur pour chaque avis (toujours 5 pleines), jamais lues depuis une donnée — alors que le schéma cible prévoit `avis[].note` (1 à 5) comme champ optionnel. Ce champ n'a aucun support dans le template ni dans l'admin actuels. - **Écart** : `avis[].qualification` (schéma cible) n'existe pas non plus dans le template ni dans l'admin — aucune donnée de ce type n'est aujourd'hui saisie ni affichée. - Bibliothèques : Swiper (carrousel, config JSON embarquée). Pas d'AOS sur cette section (le carrousel gère sa propre animation). #### 1.8 FAQ page d'accueil (`id="faq"`) - Paragraphe d'intro statique du template (pas un champ). - Champs : `faq[].question`, `faq[].reponse` (boucle non bornée, contrairement au JSON-LD FAQPage du `` qui, lui, est plafonné à 10 — voir 1.11). - Bibliothèques : AOS. #### 1.9 Contact (`id="contact"`) - Bloc "Rendez-vous" : utilise `ent_lien_rdv`, une clé **distincte** de `cta_lien` utilisé dans le hero. Le schéma cible n'a qu'un seul objet `cta` — `client-json-explication.md` documente déjà explicitement cette consolidation ("Remplace toutes les anciennes conventions concurrentes... `ent_lien_rdv`..."), donc ce n'est pas une découverte nouvelle mais une confirmation que la fusion prévue couvre bien ce cas rencontré dans le template. - Téléphone, email : `telephone`, `email` → l'email est obfusqué en base64 et décodé en JS au clic/affichage (anti-scraping) ; comportement à reproduire si on veut garder cette protection, l'ancien code ne se contente pas d'un simple `mailto:` en clair. - Adresse structurée (microdonnées cachées) : `adresse.rue`, `adresse.ville`, `adresse.code_postal`, `adresse.pays`. - Carte 1 : `ent_googlemap_iframe` (code iframe complet, rendu en HTML brut) → `google_maps_embed` (nouveau schéma : uniquement l'URL `src`, le template porte la balise `