Inventaire des fonctionnalités
Ce document est l'inventaire source servant à rendre les fonctionnalités du produit WebBlocks CMS découvrables. C'est un inventaire de visibilité produit et opérationnelle, non un contrat d'exécution. Les contrats techniques détaillés restent dans la documentation liée.
L'inventaire aide les nouveaux utilisateurs et les flux de travail d'IA/d'opérateur à comprendre quelles capacités du CMS existent, sur quelles surfaces d'administration, publiques ou d'API elles apparaissent, et quelles pages de documentation destinées aux utilisateurs manquent encore. Il convient également comme page source Markdown pour une future page de documentation du CMS reliée à sa source.
Colonnes de l'inventaire
- Fonctionnalité : la capacité produit ou l'orientation documentée.
- Domaine : le domaine produit propriétaire de la fonctionnalité.
- Statut : implémenté, orientation documentée, seulement planifié ou documentation à clarifier.
- Chemin d'administration : la surface d'administration dans le navigateur, lorsqu'elle existe.
- Comportement public : ce que vivent les visiteurs publics ou les sites rendus.
- Prise en charge API : si l'Internal Content API ou les surfaces de découverte l'exposent.
- Notes de source / implémentation : bref contexte de source ou d'implémentation.
- Documentation existante : liens de documentation actuels relatifs au dépôt.
- Manque de documentation / prochaine page de documentation : le prochain besoin documentaire.
Modèle de contenu de base et Page Builder
| Fonctionnalité | Domaine | Statut | Chemin d'administration | Comportement public | Prise en charge API | Notes de source / implémentation | Documentation existante | Manque de documentation / prochaine page de documentation |
|---|---|---|---|---|---|---|---|---|
| Sites | Contenu de base | Implémenté | /webadmin/sites | Routage public, image de marque, langues (locales), variables et contenu à portée de site | Découvrable via l'Internal Content API | Périmètre racine du contenu pour les pages, domaines, langues (locales), médias et navigation | docs/multisite.md, docs/core-concepts.md | couvert |
| Langues (locales) / Localisation | Contenu de base | Implémenté | /webadmin/locales, langues dans l'édition du site | Pages et URL publiques tenant compte de la langue | Découvrable via l'Internal Content API | Traductions de page localisées et routage par langue | docs/localization.md, docs/multisite.md | couvert |
| Pages | Page Builder | Implémenté | /webadmin/pages | Les pages publiées sont rendues via le routage public du CMS | Lecture des pages et prise en charge des plans de contenu | Pages, traductions, slots et blocs relationnels | docs/core-concepts.md, docs/internal-content-api.md | guide utilisateur à écrire |
| Page Layouts | Page Builder | Implémenté | /webadmin/page-layouts, réglages de Edit Page | Comportement de la coque publique et des conteneurs de slot | Découvrable pour la planification de contenu | Layouts gérés avec slots de layout et classes body | docs/page-layouts.md | couvert |
| Slots | Page Builder | Implémenté | éditeur de slots de Edit Page | Les zones de slot affichent du contenu appartenant à la page ou partagé | Les plans de contenu ciblent les slots appartenant à la page | Les slots séparent les zones de page du contenu des blocs | docs/core-concepts.md, docs/page-layouts.md | vue d'ensemble de Page Builder à écrire |
| Shared Slots | Page Builder | Implémenté | /webadmin/shared-slots, source du slot dans Edit Page | Les arbres de blocs de slot réutilisables à portée de site s'affichent dans les pages | Fondations de l'API Shared Slot et prise en charge de l'affectation | Références à du contenu partagé, et non modèles copiés | docs/core-concepts.md, docs/internal-content-api.md | guide utilisateur à écrire |
| Blocs | Page Builder | Implémenté | éditeur de blocs de slot de Edit Page | Les blocs affichent le contenu public de la page | Découverte des blocs/contenus et plans de contenu | Arbres de blocs relationnels avec traductions et réglages | docs/core-concepts.md, docs/public-block-render-markup.md | vue d'ensemble de Page Builder à écrire |
| Contrats de type de bloc | Page Builder | Implémenté | fenêtre de contrat dans /webadmin/block-types | Oriente un comportement sûr du moteur de rendu et de l'éditeur | Les surfaces de contrat de contenu et de découverte exposent les contrats de bloc | Le registre des contrats définit champs, réglages et capacités | docs/block-type-contracts.md, docs/api-discovery.md | couvert |
| Page Builder | Page Builder | Implémenté | Edit Page | Permet de composer des pages publiques à partir de layouts, slots et blocs | Validation/application de contenu sûre en brouillon | Modèle d'édition de base pour le contenu appartenant à la page | docs/core-concepts.md, docs/ai-page-building-guide.md | vue d'ensemble de Page Builder à écrire |
| Page Assets | Page Builder | Implémenté | Edit Page -> Page Management -> Assets | Le CSS et le JS à portée de page ne se chargent que sur la page propriétaire | Ce n'est pas une surface principale des plans de contenu | Ressources de page relationnelles sous des chemins publics à portée de site | docs/public-assets.md, README.md | guide utilisateur à écrire |
| Médiathèque | Ressources de contenu | Implémenté | /webadmin/media | Les fichiers médias publics peuvent être référencés par les blocs et les ressources | Les références média existantes sont prévues pour un usage ultérieur via API | Gestion des médias à portée de site et contrôles d'utilisation | docs/core-concepts.md, docs/public-assets.md | guide des médias à écrire |
| Navigation | Structure publique | Implémenté | /webadmin/navigation | Les blocs et menus de navigation affichent la navigation publique | Fondations de l'API de navigation | Menus et éléments à portée de site, avec groupes et icônes | docs/internal-content-api.md, README.md | guide utilisateur à écrire |
| Composition de la navbar / de l'en-tête | Structure publique | Implémenté | sélecteur de blocs de Page Builder | Navbar, marque, navigation et actions d'en-tête composent les en-têtes publics | Créables lorsqu'ils sont découverts dans les contrats de bloc | Primitives de navbar appartenant au système et enfants composables | docs/public-block-render-markup.md, README.md | vue d'ensemble de Page Builder à écrire |
| Aperçu de page | Éditorial | Implémenté | Edit Page -> Preview | Aperçu authentifié pour les pages en brouillon, en revue et publiées | Les flux de travail de l'opérateur peuvent remonter les URL d'aperçu | Utilise le rendu public avec une bannière d'aperçu noindex | docs/editorial-workflow.md, docs/internal-content-api.md | couvert |
| Révisions de page | Éditorial | Implémenté | révisions dans Edit Page | Restaure en toute sécurité un contenu de page antérieur pour les éditeurs | Ce n'est pas une surface d'écriture API principale | Instantanés de révision de page avec métadonnées d'acteur/de source | docs/revisions.md | couvert |
| Révisions de Shared Slot | Éditorial | Implémenté | révisions de Shared Slot | Restaure du contenu partagé réutilisable | Ce n'est pas une surface d'écriture API principale | Historique des révisions et restauration des Shared Slots | docs/revisions.md | couvert |
| Page Converter | Page Builder | Implémenté | /webadmin/pages, flux Import/Convert | Crée des pages CMS en brouillon à partir d'une analyse revue de HTML statique | Utilise des concepts internes de planification de contenu, pas une API publique | Analyse HTML délimitée et plans de conversion signés | docs/page-converter-roadmap.md, README.md | guide utilisateur à écrire |
| Import d'une seule page | Page Builder | Implémenté | /webadmin/pages -> Import Page | Crée une page en brouillon à partir d'une charge utile JSON documentée | Distinct de l'Internal Content API | Flux en fenêtre d'administration pour l'import revu d'une seule page JSON | README.md | guide utilisateur à écrire |
Flux de travail éditorial et permissions
| Fonctionnalité | Domaine | Statut | Chemin d'administration | Comportement public | Prise en charge API | Notes de source / implémentation | Documentation existante | Manque de documentation / prochaine page de documentation |
|---|---|---|---|---|---|---|---|---|
| Flux de travail Draft / In Review / Published / Archived | Éditorial | Implémenté | Edit Page -> Overview | Les routes publiques n'affichent que les pages publiées | L'API reste orientée brouillon pour les écritures de contenu | Les statuts de page séparent rédaction, revue, publication et archivage | docs/editorial-workflow.md | couvert |
| Rôle éditeur | Permissions | Implémenté | /webadmin/users, gestion des rôles | Les éditeurs peuvent gérer le contenu qui leur est attribué dans la limite de leurs permissions | L'autorisation conditionne l'accès à l'administration et à l'API | Rôle CMS distinct du statut d'administrateur du produit hôte | docs/users-and-permissions.md | couvert |
| Rôle administrateur de site | Permissions | Implémenté | /webadmin/users, gestion des rôles | Les administrateurs de site gèrent le contenu du site qui leur est attribué | L'autorisation conditionne l'accès à l'administration et à l'API | Rôle administratif à portée de site | docs/users-and-permissions.md | couvert |
| Rôle super admin | Permissions | Implémenté | /webadmin/users, gestion des rôles | Administration du CMS au niveau de l'installation | Requis pour les opérations de jetons et de système | Le super admin du CMS est un rôle CMS, pas le statut d'administrateur de l'hôte | docs/users-and-permissions.md, ARCHITECTURE_DECISIONS.md | couvert |
| Accès aux sites attribués | Permissions | Implémenté | gestion des utilisateurs | Limite le travail d'administration aux sites attribués | S'applique à l'autorisation de l'API | Les appartenances aux sites limitent l'accès au CMS | docs/users-and-permissions.md, docs/multisite.md | couvert |
| Transitions du flux de travail | Éditorial | Implémenté | Edit Page -> Overview | Détermine quand les pages peuvent devenir publiques ou quitter la publication | Le flux de publication reste distinct des plans de contenu ordinaires | Les permissions de transition encadrent les changements d'état éditorial | docs/editorial-workflow.md | couvert |
| Permissions de publication | Permissions | Implémenté | permissions de rôle/d'utilisateur | Détermine qui peut publier des pages publiques | La capacité de publication par API est avancée et distincte | La publication n'est intentionnellement pas le comportement par défaut des écritures d'IA/d'opérateur | docs/editorial-workflow.md, docs/internal-content-api.md | exemple IA/opérateur à écrire |
| Permissions d'archivage | Permissions | Implémenté | permissions de rôle/d'utilisateur | Contrôle le retrait de la publication publique | Ce n'est pas un comportement normal des plans de contenu | L'archivage relève du flux éditorial, pas d'une suppression destructive | docs/editorial-workflow.md | couvert |
| Permissions de restauration de révision | Permissions | Implémenté | écrans de révisions de page et de Shared Slot | Le contenu restauré influe sur le rendu public futur après publication | Ce n'est pas un comportement normal des plans de contenu | Les flux de restauration exigent une autorisation du CMS | docs/revisions.md | couvert |
| Page de profil du CMS | UX d'administration | Implémenté | /webadmin/profile | Aucun comportement public direct | Non orienté API | Les administrateurs connectés gèrent leur propre profil | README.md | guide utilisateur à écrire |
| Utilisateurs au niveau de l'installation | Permissions | Implémenté | /webadmin/users | Aucun comportement public direct | L'autorisation conditionne les jetons d'API et l'accès | La gestion des utilisateurs du CMS attache des rôles CMS aux utilisateurs de l'hôte | docs/users-and-permissions.md | couvert |
Fonctionnalités du site public
| Fonctionnalité | Domaine | Statut | Chemin d'administration | Comportement public | Prise en charge API | Notes de source / implémentation | Documentation existante | Lacune de documentation / prochaine page de documentation |
|---|---|---|---|---|---|---|---|---|
| Rendu des pages publiques | Site public | Implémenté | Page Builder et paramètres publics | Restitue les pages CMS publiées à partir des layouts, slots et blocs | Les plans de contenu peuvent créer des pages brouillon rendables | Le présentateur public résout les sites, pages, slots, Shared Slots et blocs | docs/core-concepts.md, docs/public-block-render-markup.md | nécessite une présentation du Page Builder |
| Recherche publique | Site public | Implémenté | Maintenance -> Search Rebuild, paramètres de recherche publique | Résultats de recherche publique limités au site et à la langue | Ce n'est pas une API de diffusion | Index de recherche adossé à la base de données | docs/search.md | couvert |
| Fenêtre modale de recherche | Site public | Implémenté | Bloc Header Actions et assets publics | Modale de recherche déclenchée depuis l'en-tête | Non orienté API | Utilise le runtime de la modale de recherche publique appartenant au CMS | docs/search.md, README.md | couvert |
| Bloc Search Form | Blocs publics | Implémenté | Sélecteur de blocs du Page Builder | Restitue le formulaire de recherche public | Créable lorsqu'il est découvert dans les contrats de blocs | Point d'entrée de recherche basé sur des blocs | docs/search.md, docs/public-block-render-markup.md | couvert |
| Visitor Reports | Analytique | Implémenté | /webadmin/visitor-reports | Rapports de trafic public respectueux de la vie privée | Ce n'est pas une API publique de diffusion | Agrégats d'événements de visiteurs et rapports | README.md | nécessite un guide utilisateur |
| Image de marque du site / valeurs SEO par défaut | Site public | Implémenté | Edit Site -> Branding, SEO Defaults | Métadonnées publiques de repli et assets de marque | Les surfaces de découverte des sites exposent le contexte | Nom d'affichage, accroche, valeurs SEO par défaut, favicon et image sociale appartenant au site | docs/core-concepts.md, README.md | nécessite un guide utilisateur |
| Surcharges SEO au niveau de la page | Site public | Implémenté | Paramètres de traduction de page | Surcharges des métadonnées de page selon la langue | Les surfaces de lecture de page incluent le contexte des métadonnées de page | Les valeurs SEO résident dans les traductions de page | README.md, docs/localization.md | nécessite un guide utilisateur |
| Favicon / image sociale | Site public | Implémenté | Edit Site -> Branding | Favicon publique et replis d'aperçu social | Ce n'est pas une surface d'écriture API principale | Prise en charge des médias de marque au niveau du site | README.md | nécessite un guide utilisateur |
| Variables de site | Site public | Implémenté | Edit Site -> Variables | Remplace les jetons {{ site.variable_key }} dans le rendu public pris en charge | Ce n'est pas une surface d'écriture API principale | Jetons de texte relationnels et réutilisables limités au site | README.md | nécessite un guide utilisateur |
| Routage multisite | Site public | Implémenté | /webadmin/sites, gestion des domaines | Achemine les requêtes vers le site ou le domaine correspondant | La découverte des sites prend en charge le contexte opérateur | Domaines principal et alias par site | docs/multisite.md, docs/coexistence.md | couvert |
| URL publiques localisées | Site public | Implémenté | Locales et traductions de page | Chemins de page et replis selon la langue | La découverte des langues prend en charge le contexte opérateur | Traductions de page et routage par langue | docs/localization.md | couvert |
Formulaires et messages
Contact Form et Contact Messages sont des fonctionnalités de premier plan de WebBlocks CMS. Le guide destiné aux utilisateurs sur la configuration, l'envoi, la gestion du spam, le repli e-mail et le dépannage se trouve désormais dans docs/contact-forms-and-messages.md.
| Fonctionnalité | Domaine | Statut | Chemin d'administration | Comportement public | Prise en charge API | Notes de source / implémentation | Documentation existante | Lacune de documentation / prochaine page de documentation |
|---|---|---|---|---|---|---|---|---|
| Bloc Contact Form | Formulaires | Implémenté | Sélecteur de blocs du Page Builder | Restitue un formulaire public et enregistre les soumissions | Créable via les plans de contenu lorsque contact_form est découvert | Bloc de premier plan avec prise en charge du destinataire de repli | docs/contact-forms-and-messages.md, docs/block-type-contracts.md, docs/public-block-render-markup.md | couvert |
| Écran d'administration Contact Messages | Formulaires | Implémenté | /webadmin/contact-messages | Aucune liste publique ; les administrateurs examinent les soumissions | Ce n'est pas une API publique de diffusion | Le tableau d'administration indique le statut de remise et de spam | docs/contact-forms-and-messages.md, README.md | couvert |
| Stockage des soumissions du formulaire de contact | Formulaires | Implémenté | Contact Messages | Enregistre les soumissions publiques réelles pour examen | Non orienté API | Les soumissions sont enregistrées avant toute tentative de notification par e-mail | docs/contact-forms-and-messages.md | couvert |
| Rejet par le contrôle anti-spam | Formulaires | Implémenté | Moteur de rendu de Contact Form et traitement des soumissions | Les soumissions dont le champ de contrôle généré est rempli reçoivent la redirection de succès habituelle et sont rejetées | Non orienté API | Conteneur masqué .wb-form-check appartenant au CMS, généré par le moteur de rendu natif | docs/contact-forms-and-messages.md | couvert |
| Score de spam / mise en quarantaine | Formulaires | Implémenté | Contact Messages | Les soumissions suspectes peuvent être mises en quarantaine pour examen par l'administration | Non orienté API | Signaux de spam prudents pour les liens, les schémas commerciaux et les IP répétées | docs/contact-forms-and-messages.md | couvert |
| Chaîne de repli de la notification e-mail | Formulaires | Implémenté | Bloc Contact Form, Edit Site -> Contact, messagerie de l'environnement | Tente de résoudre le destinataire à partir du bloc, du site et du repli de messagerie sûr | Non orienté API | Les tentatives de remise ont lieu après le stockage durable ; les consignes de configuration couvrent .env, les destinataires du site et le vidage du cache | docs/contact-forms-and-messages.md, docs/installation.md, docs/getting-started.md | couvert |
| Commande de diagnostic de la messagerie de contact | Exploitation | Implémenté | Diagnostic côté opérateur | Aucun comportement public | Non orienté API | Diagnostic de la configuration de messagerie sans exposer de secrets et vérifications d'envoi SMTP contrôlées | docs/contact-forms-and-messages.md, docs/operations.md, README.md | couvert |
| Statut de remise / détails de l'échec | Formulaires | Implémenté | Contact Messages | Aucune divulgation publique des échecs | Non orienté API | Les messages enregistrés incluent le statut de notification visible par l'administration | docs/contact-forms-and-messages.md | couvert |
API de contenu interne et opérations d'IA
L'API de contenu interne est destinée aux outils d'IA/opérateur de confiance. Ce n'est pas une API publique de diffusion, ni une intégration avec un fournisseur d'IA, ni un remplacement de l'export/import. Les outils d'IA/opérateur doivent utiliser la découverte en direct et ne doivent pas deviner les handles de blocs.
Documentation supplémentaire recommandée :
docs/ai-page-building-overview.md- docs/contact-forms-and-messages.md existe désormais.
- docs/markdown-docs-to-cms-sync.md existe déjà.
| Fonctionnalité | Domaine | Statut | Chemin dans l'administration | Comportement public | Prise en charge par l'API | Notes sur le code / l'implémentation | Documentation existante | Lacune de documentation / prochaine page |
|---|---|---|---|---|---|---|---|---|
| API Tokens | Opérations IA | Implémenté | /webadmin/system/api-tokens | Aucun comportement public | Authentification par jeton Bearer | Les jetons sont hachés et affichés une seule fois | docs/internal-content-api.md, docs/api-discovery.md | couvert |
| Capacités des jetons | Opérations IA | Implémenté | Création/modification de jetons d'API | Aucun comportement public | Autorisation d'API limitée aux capacités | Les capacités de publication et de suppression sont des options avancées à activer | docs/internal-content-api.md | nécessite un exemple IA/opérateur |
| Point de terminaison de découverte de l'API | Opérations IA | Implémenté | Aucun chemin dans l'administration navigateur | Aucun comportement public | Racine de découverte pour les outils de confiance | Part de l'URL de base de l'API et du jeton | docs/api-discovery.md | couvert |
| Point de terminaison OpenAPI | Opérations IA | Implémenté | Aucun chemin dans l'administration navigateur | Aucun comportement public | Contrat d'API lisible par machine | Lié depuis la découverte | docs/api-discovery.md, docs/internal-content-api.md | couvert |
| Point de terminaison du guide IA | Opérations IA | Implémenté | Aucun chemin dans l'administration navigateur | Aucun comportement public | Lien vers le guide depuis la découverte | Aide les opérateurs à construire en toute sécurité | docs/ai-page-building-guide.md | nécessite une vue d'ensemble |
| Point de terminaison du contrat de contenu | Opérations IA | Implémenté | Aucun chemin dans l'administration navigateur | Aucun comportement public | Découverte du contrat de blocs et de contenu | Requis avant la planification du contenu | docs/api-discovery.md, docs/block-type-contracts.md | couvert |
| Point de terminaison des exemples | Opérations IA | Implémenté | Aucun chemin dans l'administration navigateur | Aucun comportement public | Découverte de plans de contenu d'exemple | Lié depuis la découverte | docs/api-discovery.md | nécessite un exemple IA/opérateur |
| API de lecture des pages | Opérations IA | Implémenté | Aucun chemin dans l'administration navigateur | Aucun comportement public | Inspection des pages en lecture seule | Point de terminaison de type ressource dans l'API interne | docs/internal-content-api.md | couvert |
| Découverte des blocs et du contenu | Opérations IA | Implémenté | Aucun chemin dans l'administration navigateur | Aucun comportement public | Inspection du contrat de blocs et du contenu | Évite de deviner les identifiants de blocs | docs/block-type-contracts.md, docs/api-discovery.md | couvert |
| Validation du contenu | Opérations IA | Implémenté | Aucun chemin dans l'administration navigateur | Aucun comportement public | Valide les plans de contenu avant application | Étape de sécurité obligatoire dans les flux de travail de l'opérateur | docs/internal-content-api.md, docs/ai-page-building-guide.md | couvert |
| Application du contenu | Opérations IA | Implémenté | Aucun chemin dans l'administration navigateur | Crée du contenu CMS en brouillon, non public par défaut | Applique les plans de contenu approuvés | Brouillon d'abord et non destructif par défaut | docs/internal-content-api.md, docs/ai-page-building-guide.md | couvert |
| Création de pages sûre en brouillon | Opérations IA | Implémenté | La page obtenue apparaît dans Pages | Les pages en brouillon peuvent être prévisualisées avant publication | Pris en charge via les plans de contenu | Crée des pages, des slots, des traductions et des arbres de blocs | docs/internal-content-api.md | nécessite un exemple IA/opérateur |
| replace_existing_draft_page / modèle de remplacement sûr en brouillon | Opérations IA | Implémenté | Page en brouillon existante dans Pages | Remplace uniquement les slots gérés appartenant à la page en brouillon | Mode validate/apply pris en charge | Utilise des garde-fous basés sur le chemin attendu ou la date de mise à jour | docs/internal-content-api.md, docs/markdown-docs-to-cms-sync.md | nécessite un exemple IA/opérateur |
| Fondations de l'API de navigation | Opérations IA | Implémenté | Ressources de navigation dans l'administration | Le contenu planifié peut affecter la navigation publique après approbation | Fondations des menus de navigation et de leurs éléments | Fondations sûres sans comportement destructif étendu | docs/internal-content-api.md | nécessite un exemple IA/opérateur |
| Fondations de l'API Shared Slots | Opérations IA | Implémenté | Administration Shared Slots | Le contenu partagé peut s'afficher sur plusieurs pages après approbation | Fondations des Shared Slot et de leurs affectations | Prise en charge des affectations compatibles au sein du même site | docs/internal-content-api.md | nécessite un exemple IA/opérateur |
| Erreurs uniquement en JSON | Opérations IA | Implémenté | Aucun chemin dans l'administration navigateur | Aucun comportement public | Les erreurs de l'API renvoient du JSON | Sépare l'API opérateur des réponses de l'administration navigateur | docs/internal-content-api.md | couvert |
| Écritures d'API par Bearer sans CSRF | Opérations IA | Implémenté | Aucun chemin dans l'administration navigateur | Aucun comportement public | Les écritures Bearer ne dépendent pas du CSRF du navigateur | Contrat de jeton de confiance pour les outils de l'opérateur | docs/internal-content-api.md | couvert |
| Communication de l'URL de prévisualisation | Opérations IA | Implémenté | Prévisualisation dans Edit Page | Les opérateurs peuvent examiner les prévisualisations de brouillons | Les réponses d'application peuvent indiquer le contexte de prévisualisation | La prévisualisation reste authentifiée et sûre pour les brouillons | docs/ai-page-building-guide.md, docs/editorial-workflow.md | couvert |
| Flux de création de pages par IA privilégiant le brouillon | Opérations IA | Implémenté | Écrans Pages et de prévisualisation | Les pages créées par IA restent des brouillons jusqu'à approbation | Flux de découverte, de validation et d'application | Nécessite une découverte en direct et des contrats exacts | docs/ai-page-building-guide.md | nécessite docs/ai-page-building-overview.md |
| Runbook de synchronisation de la documentation Markdown vers le CMS | Documentation | Orientation documentée | Aucun chemin d'administration à l'exécution | Les futures pages de documentation liées au code source pourront publier du contenu issu de Markdown | Utiliserait les flux de découverte, de validation et d'application approuvée et sûre en brouillon | La source Markdown reste la référence et les fichiers modifiés de docs/ orientent la planification IA/opérateur | docs/markdown-docs-to-cms-sync.md | couvert |
Opérations
| Fonctionnalité | Domaine | Statut | Chemin dans l'administration | Comportement public | Prise en charge par l'API | Notes sur le code / l'implémentation | Documentation existante | Lacune de documentation / prochaine page |
|---|---|---|---|---|---|---|---|---|
| System Updates | Opérations | Implémenté | /webadmin/system/updates | Met à jour le code CMS installé et les ressources du paquet | Ce n'est pas une API de diffusion publique | Flux de mise à jour natif du paquet | docs/updates.md, docs/operations.md | nécessite un guide opérateur |
| Mises à jour du paquet de version | Opérations | Implémenté | System Updates | Le comportement du site public change après une mise à jour approuvée | Non orienté API | Consomme les artefacts de version du paquet | docs/updates.md, docs/package-architecture.md | nécessite un guide opérateur |
| Racine de mise à jour native du paquet | Opérations | Implémenté | System Updates | Aucun comportement public direct | Non orienté API | La racine canonique du paquet est vendor/fklavyenet/webblocks-cms | docs/package-architecture.md, ARCHITECTURE_DECISIONS.md | couvert |
| Migrations de mise à jour | Opérations | Implémenté | System Updates | Maintient aligné le schéma requis à l'exécution | Non orienté API | Les migrations de mise à jour du paquet prennent en charge les installations existantes | docs/updates.md, ARCHITECTURE_DECISIONS.md | couvert |
| État de préparation à la mise à jour | Opérations | Implémenté | System Updates | Aucun comportement public | Non orienté API | Vérifications de préparation et des détails de version avant la mise à jour | docs/updates.md | nécessite un guide opérateur |
| Dernière exécution de mise à jour | Opérations | Implémenté | System Updates | Aucun comportement public | Non orienté API | Rapport de la dernière exécution pour les opérateurs | docs/updates.md, README.md | nécessite un guide opérateur |
| Rapport d'assistance | Opérations | Implémenté | System Updates | Aucun comportement public | Non orienté API | Diagnostics d'assistance téléchargeables pour les problèmes de mise à jour | docs/updates.md | nécessite un guide opérateur |
| Backups | Opérations | Implémenté | /webadmin/backups | Protège le contenu du site et l'état de l'installation | Non orienté API | Enregistrements de sauvegarde et disque de stockage | docs/operations.md | couvert |
| Restore | Opérations | Implémenté | /webadmin/backups, flux de restauration | Le contenu restauré peut affecter le site public | Non orienté API | Flux contrôlé de restauration des sauvegardes | docs/operations.md | couvert |
| Site Export / Import | Opérations | Implémenté | /webadmin/site-transfers/exports, /webadmin/site-transfers/imports | Déplace le contenu du site entre installations | Distinct de l'Internal Content API | Empaquette le contenu, les médias, la navigation et les données de site associées | docs/operations.md, README.md | nécessite un guide utilisateur |
| Clonage / promotion de sites | Opérations | Implémenté / documenté | Flux de travail de site et de promotion | Le contenu d'un site cloné ou promu peut devenir public | Ce n'est pas une API de diffusion publique | Concepts de transfert et de promotion de sites basés sur le paquet | docs/operations.md, README.md | nécessite un guide opérateur |
| Search Rebuild | Opérations | Implémenté | Maintenance -> Search Rebuild | Actualise l'index de recherche public | Non orienté API | Reconstruit la recherche publique adossée à la base de données | docs/search.md, docs/operations.md | couvert |
| Commandes de réparation des catalogues | Opérations | Implémenté | Maintenance côté opérateur | Répare les catalogues du CMS utilisés par l'administration et le rendu | Non orienté API | Commandes de maintenance pour la cohérence des catalogues | docs/operations.md, README.md | nécessite un guide opérateur |
| Assistant d'installation | Installation | Implémenté | Écrans d'installation au premier lancement | Crée l'état initial d'installation du CMS | Non orienté API | Configuration initiale guidée depuis le navigateur | docs/installation.md | couvert |
| Installation pour les consommateurs du paquet | Installation | Implémenté | Flux d'installation du paquet | Active les routes publiques et d'administration du CMS dans une application hôte | Non orienté API | L'installateur du paquet prépare le schéma, les ressources et le premier utilisateur | docs/installation.md, README.md | couvert |
| Développement local natif | Développement | Documentation implémentée | Développement local uniquement | Environnement de développement avec des domaines .test locaux | Non orienté API | Recommandations de développement local en HTTPS uniquement | docs/native-local-development.md | couvert |
| Stratégie de test | Développement | Documentation implémentée | Flux de travail de développement | Aucun comportement public direct | Non orienté API | Scripts de test basés sur le risque et recommandations de validation | docs/testing-strategy.md | couvert |
Système de plugins
| Fonctionnalité | Zone | État | Chemin d'administration | Comportement public | Prise en charge de l'API | Source / notes d'implémentation | Documentation existante | Manque de documentation / prochaine page de documentation |
|---|---|---|---|---|---|---|---|---|
| Architecture hôte de plugins | Plugins | Fondations implémentées | /webadmin/system/plugins | Les plugins peuvent ajouter du comportement public lorsqu'ils sont activés | Ce n'est pas une API publique générique | Le cœur du CMS est un hôte de plugins | docs/plugin-system.md, ARCHITECTURE_DECISIONS.md | couvert |
| Installation manuelle de plugin par ZIP | Plugins | Implémenté | System -> Plugins -> Upload | Les plugins installés sont désactivés par défaut | Non orienté API | Chemin d'installation détenu par le stockage et validation du paquet | docs/plugin-system.md | nécessite un guide du cycle de vie des plugins |
| Cycle de vie du plugin désactivé par défaut | Plugins | Implémenté | System -> Plugins | Les plugins désactivés sont inertes | Non orienté API | Les paquets installés doivent être activés explicitement | docs/plugin-system.md | couvert |
| Activer / désactiver | Plugins | Implémenté | System -> Plugins | Active ou supprime le comportement actif du plugin | Non orienté API | Des contrôles de compatibilité et de configuration protègent l'activation | docs/plugin-system.md | nécessite un guide du cycle de vie des plugins |
| Configuration / migrations du plugin | Plugins | Fondations implémentées | Écrans de détail/configuration du plugin | Le comportement du plugin peut exiger une configuration avant que les routes fonctionnent | Non orienté API | Les tables détenues par le plugin manquantes affichent des instructions de configuration contrôlées | docs/plugin-system.md | nécessite un guide du cycle de vie des plugins |
| Permissions du plugin | Plugins | Implémenté | Gestion des permissions rôles/utilisateurs | Contrôle l'accès aux routes d'administration du plugin | Non orienté API | Les permissions sont préfixées par le handle | docs/plugin-system.md | couvert |
| Routes d'administration du plugin | Plugins | Implémenté | /webadmin/plugins/{plugin-handle} | Comportement d'administration du plugin dans le navigateur lorsqu'il est activé | Non orienté API | Les routes n'existent que s'il est activé et sont protégées par namespace | docs/plugin-system.md | couvert |
| État/santé du plugin | Plugins | Implémenté | System -> Plugins | Aucun comportement public direct | Non orienté API | Contrôles de santé et état de compatibilité | docs/plugin-system.md | couvert |
| Blocs/packs de blocs détenus par le plugin | Plugins | Fondations implémentées | Sélecteur de blocs lorsque le plugin est actif | Les blocs du plugin peuvent rendre du contenu public | Détectables lorsque les contrats de bloc les exposent | Les handles des blocs du plugin appartiennent au plugin | docs/plugin-system.md, docs/block-type-contracts.md | nécessite un guide du cycle de vie des plugins |
| Hooks d'assets publics | Plugins | Fondations implémentées | Enregistrement du plugin | Les plugins peuvent fournir des assets publics sûrs | Non orienté API | Hooks de contribution sûrs dans head et en fin de body | docs/plugin-system.md | couvert |
| Navigateur de Plugin Catalog | Plugins | Implémenté | System -> Plugins -> Browse Plugin Catalog | Aucun comportement direct sur le site public | Lit les métadonnées du catalogue, ce n'est pas une API publique de diffusion | Exploration des métadonnées du catalogue public | docs/plugin-system.md, docs/plugin-ecosystem-and-catalog.md | nécessite un guide du cycle de vie des plugins |
| Installation depuis le catalogue | Plugins | Implémenté | Détail de Plugin Catalog | Le plugin installé reste désactivé jusqu'à son activation | Non orienté API | Installation d'artefacts du catalogue vérifiée par somme de contrôle | docs/plugin-system.md | nécessite un guide du cycle de vie des plugins |
| Mises à jour de plugins adossées au catalogue | Plugins | Implémenté | System -> Plugins | Comportement du plugin mis à jour après une mise à jour approuvée | Non orienté API | Réutilise le chemin de validation par somme de contrôle et de paquet | docs/plugin-system.md | nécessite un guide du cycle de vie des plugins |
| Désinstallation manuelle | Plugins | Implémenté | System -> Plugins | Supprime le paquet de plugin téléversé et désactivé | Non orienté API | Conserve les tables de base de données détenues par le plugin | docs/plugin-system.md | couvert |
| WebBlocks UI Manager comme plugin d'opérateur, et non fonctionnalité intégrée au cœur du CMS | Plugins | Architecture implémentée | Installé uniquement lorsqu'il est téléversé/activé manuellement | Aucun comportement ordinaire dans l'exécution du CMS | Non orienté API | Le plugin d'opérateur first-party reste en dehors du cœur intégré | docs/plugin-system.md, ARCHITECTURE_DECISIONS.md | couvert |
Maturité de la documentation et du site produit
La documentation actuelle est techniquement riche, mais la découvrabilité des fonctionnalités reste incomplète. Cet inventaire doit aider à décider quelles pages de documentation destinées aux utilisateurs manquent et quelles pages sources pourront ensuite être publiées comme pages de documentation liées à la source dans un site de documentation cible.
Pages de documentation prioritaires :
- Vue d'ensemble de la création de pages par IA
- Vue d'ensemble du Page Builder
- Inventaire des fonctionnalités
- Dépannage de Forms / Messages
- Guide du cycle de vie des plugins
- Guide de l'opérateur pour System Updates
Le contenu marketing de webblocksui.com doit rester séparé de la documentation technique. Les pages marketing peuvent résumer la valeur du produit, tandis que la documentation en Markdown doit rester la source des indications techniques et opérationnelles.