Inventario delle funzionalità
Questo documento è l'inventario di riferimento per rendere individuabili le funzionalità del prodotto WebBlocks CMS. È un inventario di visibilità di prodotto e operativa, non un contratto di runtime. I contratti tecnici dettagliati restano nella documentazione collegata.
L'inventario aiuta i nuovi utenti e i flussi di lavoro di IA/operatore a capire quali capacità del CMS esistono, in quali superfici di amministrazione, pubbliche o API compaiono e quali pagine di documentazione rivolte all'utente mancano ancora. È adatto anche come pagina sorgente Markdown per una futura pagina di documentazione del CMS collegata alla sorgente.
Colonne dell'inventario
- Funzionalità: la capacità di prodotto o la direzione documentata.
- Area: l'area di prodotto proprietaria della funzionalità.
- Stato: implementato, direzione documentata, solo pianificato o necessita di documentazione più chiara.
- Percorso di amministrazione: la superficie di amministrazione nel browser, quando esiste.
- Comportamento pubblico: ciò che sperimentano i visitatori pubblici o i siti renderizzati.
- Supporto API: se l'Internal Content API o le superfici di discovery la espongono.
- Note su sorgente / implementazione: breve contesto di sorgente o implementazione.
- Documentazione esistente: link di documentazione attuali relativi al repository.
- Lacuna documentale / prossima pagina di documentazione: la prossima esigenza documentale.
Modello di contenuto di base e Page Builder
| Funzionalità | Area | Stato | Percorso di amministrazione | Comportamento pubblico | Supporto API | Note su sorgente / implementazione | Documentazione esistente | Lacuna documentale / prossima pagina di documentazione |
|---|---|---|---|---|---|---|---|---|
| Siti | Contenuti di base | Implementato | /webadmin/sites | Routing pubblico, branding, lingue (locale), variabili e contenuti con ambito di sito | Individuabile tramite Internal Content API | Ambito radice dei contenuti per pagine, domini, lingue (locale), media e navigazione | docs/multisite.md, docs/core-concepts.md | coperto |
| Lingue (locale) / Localizzazione | Contenuti di base | Implementato | /webadmin/locales, lingue nella modifica del sito | Pagine e URL pubblici consapevoli della lingua | Individuabile tramite Internal Content API | Traduzioni di pagina localizzate e routing per lingua | docs/localization.md, docs/multisite.md | coperto |
| Pagine | Page Builder | Implementato | /webadmin/pages | Le pagine pubblicate vengono renderizzate tramite il routing pubblico del CMS | Lettura delle pagine e supporto ai piani di contenuto | Pagine, traduzioni, slot e blocchi relazionali | docs/core-concepts.md, docs/internal-content-api.md | serve una guida utente |
| Page Layouts | Page Builder | Implementato | /webadmin/page-layouts, impostazioni di Edit Page | Comportamento della shell pubblica e dei wrapper degli slot | Individuabile per la pianificazione dei contenuti | Layout gestiti con slot di layout e classi body | docs/page-layouts.md | coperto |
| Slot | Page Builder | Implementato | editor degli slot in Edit Page | Le regioni degli slot renderizzano contenuti di proprietà della pagina o condivisi | I piani di contenuto puntano agli slot di proprietà della pagina | Gli slot separano le regioni di pagina dal contenuto dei blocchi | docs/core-concepts.md, docs/page-layouts.md | serve una panoramica di Page Builder |
| Shared Slots | Page Builder | Implementato | /webadmin/shared-slots, sorgente dello slot in Edit Page | Gli alberi di blocchi degli slot riutilizzabili con ambito di sito vengono renderizzati nelle pagine | Fondamenta dell'API degli Shared Slot e supporto all'assegnazione | Riferimenti a contenuti condivisi, non modelli copiati | docs/core-concepts.md, docs/internal-content-api.md | serve una guida utente |
| Blocchi | Page Builder | Implementato | editor dei blocchi degli slot in Edit Page | I blocchi renderizzano il contenuto pubblico della pagina | Discovery di blocchi/contenuti e piani di contenuto | Alberi di blocchi relazionali con traduzioni e impostazioni | docs/core-concepts.md, docs/public-block-render-markup.md | serve una panoramica di Page Builder |
| Contratti dei tipi di blocco | Page Builder | Implementato | modale del contratto in /webadmin/block-types | Guida un comportamento sicuro di renderer ed editor | Le superfici di contratto dei contenuti e di discovery espongono i contratti dei blocchi | Il registro dei contratti definisce campi, impostazioni e capacità | docs/block-type-contracts.md, docs/api-discovery.md | coperto |
| Page Builder | Page Builder | Implementato | Edit Page | Consente di comporre pagine pubbliche a partire da layout, slot e blocchi | Validazione/applicazione dei contenuti sicura in bozza | Modello di editing di base per i contenuti di proprietà della pagina | docs/core-concepts.md, docs/ai-page-building-guide.md | serve una panoramica di Page Builder |
| Page Assets | Page Builder | Implementato | Edit Page -> Page Management -> Assets | CSS e JS con ambito di pagina vengono caricati solo nella pagina proprietaria | Non è una superficie primaria per i piani di contenuto | Asset di pagina relazionali sotto percorsi pubblici con ambito di sito | docs/public-assets.md, README.md | serve una guida utente |
| Libreria media | Asset dei contenuti | Implementato | /webadmin/media | I file media pubblici possono essere referenziati da blocchi e asset | I riferimenti media esistenti sono previsti per un uso successivo via API | Gestione dei media con ambito di sito e controlli d'uso | docs/core-concepts.md, docs/public-assets.md | serve una guida ai media |
| Navigazione | Struttura pubblica | Implementato | /webadmin/navigation | I blocchi e i menu di navigazione renderizzano la navigazione pubblica | Fondamenta dell'API di navigazione | Menu ed elementi con ambito di sito, con gruppi e icone | docs/internal-content-api.md, README.md | serve una guida utente |
| Composizione di navbar / intestazione | Struttura pubblica | Implementato | selettore di blocchi di Page Builder | Navbar, marchio, navigazione e azioni di intestazione compongono le intestazioni pubbliche | Creabili quando vengono individuati nei contratti dei blocchi | Primitive della navbar di proprietà del sistema e figli componibili | docs/public-block-render-markup.md, README.md | serve una panoramica di Page Builder |
| Anteprima di pagina | Editoriale | Implementato | Edit Page -> Preview | Anteprima autenticata per pagine in bozza, in revisione e pubblicate | I flussi di lavoro dell'operatore possono riportare gli URL di anteprima | Usa il rendering pubblico con un banner di anteprima noindex | docs/editorial-workflow.md, docs/internal-content-api.md | coperto |
| Revisioni di pagina | Editoriale | Implementato | revisioni in Edit Page | Ripristina in sicurezza contenuti precedenti della pagina per gli editor | Non è una superficie primaria di scrittura API | Snapshot di revisione della pagina con metadati di attore/sorgente | docs/revisions.md | coperto |
| Revisioni degli Shared Slot | Editoriale | Implementato | revisioni degli Shared Slot | Ripristina contenuti condivisi riutilizzabili | Non è una superficie primaria di scrittura API | Cronologia delle revisioni e ripristino degli Shared Slot | docs/revisions.md | coperto |
| Page Converter | Page Builder | Implementato | /webadmin/pages, flussi Import/Convert | Crea pagine CMS in bozza a partire dall'analisi rivista di HTML statico | Usa concetti interni di pianificazione dei contenuti, non un'API pubblica | Analisi HTML circoscritta e piani di conversione firmati | docs/page-converter-roadmap.md, README.md | serve una guida utente |
| Importazione di una singola pagina | Page Builder | Implementato | /webadmin/pages -> Import Page | Crea una pagina in bozza a partire da un payload JSON documentato | Separata dall'Internal Content API | Flusso in modale di amministrazione per l'importazione rivista di una singola pagina JSON | README.md | serve una guida utente |
Flusso di lavoro editoriale e permessi
| Funzionalità | Area | Stato | Percorso di amministrazione | Comportamento pubblico | Supporto API | Note su sorgente / implementazione | Documentazione esistente | Lacuna documentale / prossima pagina di documentazione |
|---|---|---|---|---|---|---|---|---|
| Flusso di lavoro Draft / In Review / Published / Archived | Editoriale | Implementato | Edit Page -> Overview | Le rotte pubbliche renderizzano solo pagine pubblicate | L'API resta orientata alla bozza per le scritture di contenuto | Gli stati della pagina separano redazione, revisione, pubblicazione e archiviazione | docs/editorial-workflow.md | coperto |
| Ruolo editor | Permessi | Implementato | /webadmin/users, gestione dei ruoli | Gli editor possono gestire i contenuti assegnati nei limiti dei permessi | L'autorizzazione incide sull'accesso ad amministrazione e API | Ruolo del CMS distinto dallo stato di amministratore del prodotto host | docs/users-and-permissions.md | coperto |
| Ruolo di amministratore del sito | Permessi | Implementato | /webadmin/users, gestione dei ruoli | Gli amministratori del sito gestiscono i contenuti del sito assegnato | L'autorizzazione incide sull'accesso ad amministrazione e API | Ruolo amministrativo con ambito di sito | docs/users-and-permissions.md | coperto |
| Ruolo di super admin | Permessi | Implementato | /webadmin/users, gestione dei ruoli | Amministrazione del CMS a livello di installazione | Necessario per le operazioni su token e di sistema | Il super admin del CMS è un ruolo del CMS, non lo stato di amministratore dell'host | docs/users-and-permissions.md, ARCHITECTURE_DECISIONS.md | coperto |
| Accesso ai siti assegnati | Permessi | Implementato | gestione utenti | Limita il lavoro di amministrazione ai siti assegnati | Si applica all'autorizzazione API | Le appartenenze ai siti limitano l'accesso al CMS | docs/users-and-permissions.md, docs/multisite.md | coperto |
| Transizioni del flusso di lavoro | Editoriale | Implementato | Edit Page -> Overview | Controlla quando le pagine possono diventare pubbliche o uscire dalla pubblicazione | Il flusso di pubblicazione resta separato dai normali piani di contenuto | I permessi di transizione proteggono i cambi di stato editoriale | docs/editorial-workflow.md | coperto |
| Permessi di pubblicazione | Permessi | Implementato | permessi di ruolo/utente | Determina chi può pubblicare pagine pubbliche | La capacità di pubblicazione via API è avanzata e separata | La pubblicazione non è intenzionalmente il comportamento predefinito per le scritture di IA/operatore | docs/editorial-workflow.md, docs/internal-content-api.md | serve un esempio di IA/operatore |
| Permessi di archiviazione | Permessi | Implementato | permessi di ruolo/utente | Controlla la rimozione dalla pubblicazione pubblica | Non è un comportamento normale dei piani di contenuto | L'archiviazione è flusso di lavoro editoriale, non una cancellazione distruttiva | docs/editorial-workflow.md | coperto |
| Permessi di ripristino delle revisioni | Permessi | Implementato | schermate delle revisioni di pagina e degli Shared Slot | I contenuti ripristinati incidono sul futuro rendering pubblico dopo la pubblicazione | Non è un comportamento normale dei piani di contenuto | I flussi di ripristino richiedono l'autorizzazione del CMS | docs/revisions.md | coperto |
| Pagina del profilo CMS | UX di amministrazione | Implementato | /webadmin/profile | Nessun comportamento pubblico diretto | Non orientato alle API | Gli amministratori autenticati gestiscono il proprio profilo | README.md | serve una guida utente |
| Utenti a livello di installazione | Permessi | Implementato | /webadmin/users | Nessun comportamento pubblico diretto | L'autorizzazione incide sui token API e sull'accesso | La gestione utenti del CMS associa ruoli CMS agli utenti dell'host | docs/users-and-permissions.md | coperto |
Funzionalità del sito pubblico
| Funzionalità | Area | Stato | Percorso amministrativo | Comportamento pubblico | Supporto API | Note su sorgente / implementazione | Documentazione esistente | Lacuna di documentazione / prossima pagina di documentazione |
|---|---|---|---|---|---|---|---|---|
| Rendering delle pagine pubbliche | Sito pubblico | Implementato | Page Builder e impostazioni pubbliche | Renderizza le pagine CMS pubblicate a partire da layout, slot e blocchi | I piani di contenuto possono creare pagine renderizzabili in bozza | Il presenter pubblico risolve siti, pagine, slot, Shared Slot e blocchi | docs/core-concepts.md, docs/public-block-render-markup.md | necessita di una panoramica del Page Builder |
| Ricerca pubblica | Sito pubblico | Implementato | Maintenance -> Search Rebuild, impostazioni di ricerca pubblica | Risultati di ricerca pubblica limitati a sito/lingua | Non è un'API di delivery | Indice di ricerca basato su database | docs/search.md | coperto |
| Modale di ricerca | Sito pubblico | Implementato | Blocco Header Actions e asset pubblici | Modale di ricerca attivato dall'header | Non orientato alle API | Usa il runtime del modale di ricerca pubblico di proprietà del CMS | docs/search.md, README.md | coperto |
| Blocco Search Form | Blocchi pubblici | Implementato | Selettore di blocchi del Page Builder | Renderizza il modulo di ricerca pubblico | Creabile quando viene rilevato nei contratti dei blocchi | Punto di ingresso della ricerca basato sui blocchi | docs/search.md, docs/public-block-render-markup.md | coperto |
| Visitor Reports | Analytics | Implementato | /webadmin/visitor-reports | Report sul traffico pubblico rispettosi della privacy | Non è un'API pubblica di delivery | Aggregati di eventi dei visitatori e reportistica | README.md | necessita di una guida utente |
| Branding del sito / valori SEO predefiniti | Sito pubblico | Implementato | Edit Site -> Branding, SEO Defaults | Fallback dei metadati pubblici e asset di marchio | Le superfici di discovery dei siti espongono il contesto | Nome visualizzato, slogan, valori SEO predefiniti, favicon e immagine social di proprietà del sito | docs/core-concepts.md, README.md | necessita di una guida utente |
| Override SEO a livello di pagina | Sito pubblico | Implementato | Impostazioni di traduzione della pagina | Override dei metadati di pagina in base alla lingua | Le superfici di lettura delle pagine includono il contesto dei metadati di pagina | I valori SEO risiedono nelle traduzioni di pagina | README.md, docs/localization.md | necessita di una guida utente |
| Favicon / immagine social | Sito pubblico | Implementato | Edit Site -> Branding | Favicon pubblica e fallback dell'anteprima social | Non è una superficie principale di scrittura via API | Supporto dei media di marchio a livello di sito | README.md | necessita di una guida utente |
| Variabili del sito | Sito pubblico | Implementato | Edit Site -> Variables | Sostituisce i token {{ site.variable_key }} nel rendering pubblico supportato | Non è una superficie principale di scrittura via API | Token di testo relazionali e riutilizzabili con ambito sito | README.md | necessita di una guida utente |
| Routing multisito | Sito pubblico | Implementato | /webadmin/sites, gestione dei domini | Instrada le richieste al sito/dominio corrispondente | La discovery dei siti supporta il contesto dell'operatore | Dominio principale e alias per ogni sito | docs/multisite.md, docs/coexistence.md | coperto |
| URL pubblici localizzati | Sito pubblico | Implementato | Locales e traduzioni di pagina | Percorsi di pagina e fallback in base alla lingua | La discovery delle lingue supporta il contesto dell'operatore | Traduzioni di pagina e routing per lingua | docs/localization.md | coperto |
Moduli e messaggi
Contact Form e Contact Messages sono funzionalità di prima classe di WebBlocks CMS. La guida rivolta agli utenti su configurazione, invio, gestione dello spam, fallback e-mail e risoluzione dei problemi risiede ora in docs/contact-forms-and-messages.md.
| Funzionalità | Area | Stato | Percorso amministrativo | Comportamento pubblico | Supporto API | Note su sorgente / implementazione | Documentazione esistente | Lacuna di documentazione / prossima pagina di documentazione |
|---|---|---|---|---|---|---|---|---|
| Blocco Contact Form | Moduli | Implementato | Selettore di blocchi del Page Builder | Renderizza un modulo pubblico e memorizza gli invii | Creabile tramite i piani di contenuto quando viene rilevato contact_form | Blocco di prima classe con supporto del destinatario di fallback | docs/contact-forms-and-messages.md, docs/block-type-contracts.md, docs/public-block-render-markup.md | coperto |
| Schermata amministrativa Contact Messages | Moduli | Implementato | /webadmin/contact-messages | Nessun elenco pubblico; gli amministratori esaminano gli invii | Non è un'API pubblica di delivery | La tabella amministrativa include lo stato di consegna e di spam | docs/contact-forms-and-messages.md, README.md | coperto |
| Archiviazione degli invii del modulo di contatto | Moduli | Implementato | Contact Messages | Memorizza gli invii pubblici reali per la revisione | Non orientato alle API | Gli invii vengono memorizzati prima dei tentativi di notifica via e-mail | docs/contact-forms-and-messages.md | coperto |
| Scarto tramite controllo antispam | Moduli | Implementato | Renderer di Contact Form e gestione degli invii | Gli invii con il campo di controllo generato compilato ricevono il consueto redirect di successo e vengono scartati | Non orientato alle API | Wrapper nascosto .wb-form-check di proprietà del CMS, generato dal renderer nativo | docs/contact-forms-and-messages.md | coperto |
| Punteggio di spam / quarantena | Moduli | Implementato | Contact Messages | Gli invii sospetti possono essere messi in quarantena per la revisione amministrativa | Non orientato alle API | Segnali di spam conservativi per link, schemi commerciali e IP ripetuti | docs/contact-forms-and-messages.md | coperto |
| Catena di fallback della notifica e-mail | Moduli | Implementato | Blocco Contact Form, Edit Site -> Contact, posta dell'ambiente | Tenta di risolvere il destinatario a partire dal blocco, dal sito e dal fallback di posta sicuro | Non orientato alle API | I tentativi di consegna avvengono dopo l'archiviazione durevole; le indicazioni di configurazione coprono .env, i destinatari del sito e la pulizia della cache | docs/contact-forms-and-messages.md, docs/installation.md, docs/getting-started.md | coperto |
| Comando di diagnosi della posta di contatto | Operazioni | Implementato | Diagnostica lato operatore | Nessun comportamento pubblico | Non orientato alle API | Diagnostica della configurazione di posta senza esporre segreti e controlli di invio SMTP controllati | docs/contact-forms-and-messages.md, docs/operations.md, README.md | coperto |
| Stato di consegna / dettagli dell'errore | Moduli | Implementato | Contact Messages | Nessuna divulgazione pubblica degli errori | Non orientato alle API | I messaggi salvati includono lo stato di notifica visibile agli amministratori | docs/contact-forms-and-messages.md | coperto |
API interna dei contenuti e operazioni di IA
L'API interna dei contenuti è destinata a strumenti di IA/operatore fidati. Non è un'API pubblica di delivery, non è un'integrazione con un fornitore di IA e non sostituisce l'esportazione/importazione. Gli strumenti di IA/operatore devono usare la discovery in tempo reale e non devono indovinare gli handle dei blocchi.
Documentazione aggiuntiva consigliata:
docs/ai-page-building-overview.md- docs/contact-forms-and-messages.md ora esiste.
- docs/markdown-docs-to-cms-sync.md esiste già.
| Funzionalità | Area | Stato | Percorso in amministrazione | Comportamento pubblico | Supporto API | Note su sorgente / implementazione | Documentazione esistente | Lacuna nella documentazione / prossima pagina |
|---|---|---|---|---|---|---|---|---|
| API Tokens | Operazioni IA | Implementato | /webadmin/system/api-tokens | Nessun comportamento pubblico | Autenticazione tramite token Bearer | I token sono sottoposti ad hash e mostrati una sola volta | docs/internal-content-api.md, docs/api-discovery.md | coperto |
| Capacità dei token | Operazioni IA | Implementato | Creazione/modifica dei token API | Nessun comportamento pubblico | Autorizzazione API limitata alle capacità | Le capacità di pubblicazione ed eliminazione sono opzioni avanzate da attivare | docs/internal-content-api.md | serve un esempio per IA/operatore |
| Endpoint di discovery dell'API | Operazioni IA | Implementato | Nessun percorso nell'amministrazione via browser | Nessun comportamento pubblico | Radice di discovery per strumenti attendibili | Parte dall'URL base dell'API e dal token | docs/api-discovery.md | coperto |
| Endpoint OpenAPI | Operazioni IA | Implementato | Nessun percorso nell'amministrazione via browser | Nessun comportamento pubblico | Contratto API leggibile dalle macchine | Collegato dal discovery | docs/api-discovery.md, docs/internal-content-api.md | coperto |
| Endpoint della guida per l'IA | Operazioni IA | Implementato | Nessun percorso nell'amministrazione via browser | Nessun comportamento pubblico | Link alla guida dal discovery | Aiuta gli operatori a costruire in modo sicuro | docs/ai-page-building-guide.md | serve una panoramica |
| Endpoint del contratto di contenuto | Operazioni IA | Implementato | Nessun percorso nell'amministrazione via browser | Nessun comportamento pubblico | Discovery del contratto di blocchi e contenuti | Necessario prima della pianificazione dei contenuti | docs/api-discovery.md, docs/block-type-contracts.md | coperto |
| Endpoint degli esempi | Operazioni IA | Implementato | Nessun percorso nell'amministrazione via browser | Nessun comportamento pubblico | Discovery dei piani di contenuto di esempio | Collegato dal discovery | docs/api-discovery.md | serve un esempio per IA/operatore |
| API di lettura delle pagine | Operazioni IA | Implementato | Nessun percorso nell'amministrazione via browser | Nessun comportamento pubblico | Ispezione delle pagine in sola lettura | Endpoint in stile risorsa all'interno dell'API interna | docs/internal-content-api.md | coperto |
| Discovery di blocchi e contenuti | Operazioni IA | Implementato | Nessun percorso nell'amministrazione via browser | Nessun comportamento pubblico | Ispezione del contratto dei blocchi e dei contenuti | Evita di indovinare gli handle dei blocchi | docs/block-type-contracts.md, docs/api-discovery.md | coperto |
| Validazione del contenuto | Operazioni IA | Implementato | Nessun percorso nell'amministrazione via browser | Nessun comportamento pubblico | Valida i piani di contenuto prima dell'applicazione | Passaggio di sicurezza obbligatorio nei flussi di lavoro dell'operatore | docs/internal-content-api.md, docs/ai-page-building-guide.md | coperto |
| Applicazione del contenuto | Operazioni IA | Implementato | Nessun percorso nell'amministrazione via browser | Crea contenuti CMS in bozza, non pubblici per impostazione predefinita | Applica i piani di contenuto approvati | Prima la bozza e non distruttivo per impostazione predefinita | docs/internal-content-api.md, docs/ai-page-building-guide.md | coperto |
| Creazione di pagine sicura in bozza | Operazioni IA | Implementato | La pagina risultante compare in Pages | Le pagine in bozza possono essere viste in anteprima prima della pubblicazione | Supportata tramite i piani di contenuto | Crea pagine, slot, traduzioni e alberi di blocchi | docs/internal-content-api.md | serve un esempio per IA/operatore |
| replace_existing_draft_page / modello di sostituzione sicuro in bozza | Operazioni IA | Implementato | Pagina in bozza esistente in Pages | Sostituisce solo gli slot gestiti di proprietà della pagina in bozza | Modalità validate/apply supportata | Usa protezioni basate sul percorso atteso o sulla data di aggiornamento | docs/internal-content-api.md, docs/markdown-docs-to-cms-sync.md | serve un esempio per IA/operatore |
| Fondamenta dell'API di navigazione | Operazioni IA | Implementato | Risorse di navigazione in amministrazione | I contenuti pianificati possono influire sulla navigazione pubblica dopo l'approvazione | Fondamenta dei menu di navigazione e dei relativi elementi | Fondamenta sicure senza comportamenti distruttivi ampi | docs/internal-content-api.md | serve un esempio per IA/operatore |
| Fondamenta dell'API Shared Slots | Operazioni IA | Implementato | Amministrazione Shared Slots | I contenuti condivisi possono essere resi su più pagine dopo l'approvazione | Fondamenta degli Shared Slot e delle assegnazioni | Supporto per assegnazioni compatibili all'interno dello stesso sito | docs/internal-content-api.md | serve un esempio per IA/operatore |
| Errori solo in JSON | Operazioni IA | Implementato | Nessun percorso nell'amministrazione via browser | Nessun comportamento pubblico | Gli errori dell'API restituiscono JSON | Separa l'API per operatori dalle risposte dell'amministrazione via browser | docs/internal-content-api.md | coperto |
| Scritture API con Bearer senza CSRF | Operazioni IA | Implementato | Nessun percorso nell'amministrazione via browser | Nessun comportamento pubblico | Le scritture con Bearer non dipendono dal CSRF del browser | Contratto di token attendibile per gli strumenti dell'operatore | docs/internal-content-api.md | coperto |
| Comunicazione dell'URL di anteprima | Operazioni IA | Implementato | Anteprima in Edit Page | Gli operatori possono rivedere le anteprime delle bozze | Le risposte di apply possono riportare il contesto di anteprima | L'anteprima resta autenticata e sicura per le bozze | docs/ai-page-building-guide.md, docs/editorial-workflow.md | coperto |
| Flusso di creazione pagine con IA che parte dalla bozza | Operazioni IA | Implementato | Schermate Pages e di anteprima | Le pagine create dall'IA restano bozze fino all'approvazione | Flusso di discovery, validazione e applicazione | Richiede discovery in tempo reale e contratti esatti | docs/ai-page-building-guide.md | serve docs/ai-page-building-overview.md |
| Runbook di sincronizzazione della documentazione Markdown con il CMS | Documentazione | Direzione documentata | Nessun percorso di amministrazione a runtime | Le future pagine di documentazione collegate al codice sorgente potranno pubblicare contenuti derivati da Markdown | Userebbe i flussi di discovery, validazione e applicazione approvata e sicura in bozza | La sorgente Markdown resta autoritativa e i file modificati in docs/ guidano la pianificazione di IA e operatore | docs/markdown-docs-to-cms-sync.md | coperto |
Operazioni
| Funzionalità | Area | Stato | Percorso in amministrazione | Comportamento pubblico | Supporto API | Note su sorgente / implementazione | Documentazione esistente | Lacuna nella documentazione / prossima pagina |
|---|---|---|---|---|---|---|---|---|
| System Updates | Operazioni | Implementato | /webadmin/system/updates | Aggiorna il codice CMS installato e gli asset del pacchetto | Non è un'API di distribuzione pubblica | Flusso di aggiornamento nativo del pacchetto | docs/updates.md, docs/operations.md | serve una guida per l'operatore |
| Aggiornamenti del pacchetto di rilascio | Operazioni | Implementato | System Updates | Il comportamento del sito pubblico cambia dopo un aggiornamento approvato | Non orientato alle API | Consuma gli artefatti di rilascio del pacchetto | docs/updates.md, docs/package-architecture.md | serve una guida per l'operatore |
| Radice di aggiornamento nativa del pacchetto | Operazioni | Implementato | System Updates | Nessun comportamento pubblico diretto | Non orientato alle API | La radice canonica del pacchetto è vendor/fklavyenet/webblocks-cms | docs/package-architecture.md, ARCHITECTURE_DECISIONS.md | coperto |
| Migrazioni di aggiornamento | Operazioni | Implementato | System Updates | Mantiene allineato lo schema richiesto a runtime | Non orientato alle API | Le migrazioni di aggiornamento del pacchetto supportano le installazioni esistenti | docs/updates.md, ARCHITECTURE_DECISIONS.md | coperto |
| Prontezza all'aggiornamento | Operazioni | Implementato | System Updates | Nessun comportamento pubblico | Non orientato alle API | Controlli di prontezza e dei dettagli di rilascio prima dell'aggiornamento | docs/updates.md | serve una guida per l'operatore |
| Ultima esecuzione di aggiornamento | Operazioni | Implementato | System Updates | Nessun comportamento pubblico | Non orientato alle API | Report dell'ultima esecuzione per gli operatori | docs/updates.md, README.md | serve una guida per l'operatore |
| Report di supporto | Operazioni | Implementato | System Updates | Nessun comportamento pubblico | Non orientato alle API | Diagnostica di supporto scaricabile per i problemi di aggiornamento | docs/updates.md | serve una guida per l'operatore |
| Backups | Operazioni | Implementato | /webadmin/backups | Protegge i contenuti del sito e lo stato dell'installazione | Non orientato alle API | Record dei backup e disco di archiviazione | docs/operations.md | coperto |
| Restore | Operazioni | Implementato | /webadmin/backups, flusso di ripristino | I contenuti ripristinati possono influire sul sito pubblico | Non orientato alle API | Flusso controllato di ripristino dei backup | docs/operations.md | coperto |
| Site Export / Import | Operazioni | Implementato | /webadmin/site-transfers/exports, /webadmin/site-transfers/imports | Sposta i contenuti del sito tra installazioni | Separato dall'Internal Content API | Impacchetta contenuti, media, navigazione e dati correlati del sito | docs/operations.md, README.md | serve una guida utente |
| Clonazione / promozione dei siti | Operazioni | Implementato / documentato | Flussi di lavoro di sito e promozione | I contenuti di un sito clonato o promosso possono diventare pubblici | Non è un'API di distribuzione pubblica | Concetti di trasferimento e promozione dei siti basati sul pacchetto | docs/operations.md, README.md | serve una guida per l'operatore |
| Search Rebuild | Operazioni | Implementato | Maintenance -> Search Rebuild | Aggiorna l'indice di ricerca pubblico | Non orientato alle API | Ricostruisce la ricerca pubblica basata su database | docs/search.md, docs/operations.md | coperto |
| Comandi di riparazione dei cataloghi | Operazioni | Implementato | Manutenzione lato operatore | Ripara i cataloghi del CMS usati da amministrazione e rendering | Non orientato alle API | Comandi di manutenzione per la coerenza dei cataloghi | docs/operations.md, README.md | serve una guida per l'operatore |
| Procedura guidata di installazione | Installazione | Implementato | Schermate di installazione al primo avvio | Crea lo stato iniziale di installazione del CMS | Non orientato alle API | Configurazione iniziale guidata dal browser | docs/installation.md | coperto |
| Installazione per i consumatori del pacchetto | Installazione | Implementato | Flusso di installazione del pacchetto | Abilita le rotte pubbliche e di amministrazione del CMS in un'applicazione host | Non orientato alle API | L'installer del pacchetto prepara schema, asset e primo utente | docs/installation.md, README.md | coperto |
| Sviluppo locale nativo | Sviluppo | Documentazione implementata | Solo sviluppo locale | Ambiente di sviluppo con domini .test locali | Non orientato alle API | Linee guida per lo sviluppo locale solo in HTTPS | docs/native-local-development.md | coperto |
| Strategia di test | Sviluppo | Documentazione implementata | Flusso di lavoro di sviluppo | Nessun comportamento pubblico diretto | Non orientato alle API | Script di test basati sul rischio e linee guida di validazione | docs/testing-strategy.md | coperto |
Sistema di plugin
| Funzionalità | Area | Stato | Percorso di amministrazione | Comportamento pubblico | Supporto API | Sorgente / note di implementazione | Documentazione esistente | Lacuna di documentazione / prossima pagina di documentazione |
|---|---|---|---|---|---|---|---|---|
| Architettura host dei plugin | Plugins | Fondamenta implementate | /webadmin/system/plugins | I plugin possono aggiungere comportamento pubblico quando sono abilitati | Non è un'API pubblica generica | Il core del CMS è un host di plugin | docs/plugin-system.md, ARCHITECTURE_DECISIONS.md | coperto |
| Installazione manuale del plugin da ZIP | Plugins | Implementato | System -> Plugins -> Upload | I plugin installati sono disabilitati per impostazione predefinita | Non orientato alle API | Percorso di installazione di proprietà dello storage e validazione del pacchetto | docs/plugin-system.md | serve una guida al ciclo di vita dei plugin |
| Ciclo di vita del plugin disabilitato per impostazione predefinita | Plugins | Implementato | System -> Plugins | I plugin disabilitati sono inerti | Non orientato alle API | I pacchetti installati devono essere abilitati esplicitamente | docs/plugin-system.md | coperto |
| Abilitare / disabilitare | Plugins | Implementato | System -> Plugins | Abilita o rimuove il comportamento attivo del plugin | Non orientato alle API | I controlli di compatibilità e configurazione proteggono l'attivazione | docs/plugin-system.md | serve una guida al ciclo di vita dei plugin |
| Configurazione / migrazioni del plugin | Plugins | Fondamenta implementate | Schermate di dettaglio/configurazione del plugin | Il comportamento del plugin può richiedere una configurazione prima che le rotte funzionino | Non orientato alle API | Le tabelle di proprietà del plugin mancanti mostrano indicazioni di configurazione controllate | docs/plugin-system.md | serve una guida al ciclo di vita dei plugin |
| Permessi del plugin | Plugins | Implementato | Gestione dei permessi di ruoli/utenti | Controlla l'accesso alle rotte di amministrazione del plugin | Non orientato alle API | I permessi hanno il prefisso dell'handle | docs/plugin-system.md | coperto |
| Rotte di amministrazione del plugin | Plugins | Implementato | /webadmin/plugins/{plugin-handle} | Comportamento di amministrazione del plugin nel browser quando è abilitato | Non orientato alle API | Le rotte esistono solo se abilitato e sono protette dal namespace | docs/plugin-system.md | coperto |
| Salute/stato del plugin | Plugins | Implementato | System -> Plugins | Nessun comportamento pubblico diretto | Non orientato alle API | Controlli di integrità e stato di compatibilità | docs/plugin-system.md | coperto |
| Blocchi/pacchetti di blocchi di proprietà del plugin | Plugins | Fondamenta implementate | Selettore di blocchi quando il plugin è attivo | I blocchi del plugin possono renderizzare contenuto pubblico | Rilevabili quando i contratti di blocco li espongono | Gli handle dei blocchi del plugin appartengono al plugin | docs/plugin-system.md, docs/block-type-contracts.md | serve una guida al ciclo di vita dei plugin |
| Hook per asset pubblici | Plugins | Fondamenta implementate | Registrazione del plugin | I plugin possono contribuire asset pubblici sicuri | Non orientato alle API | Hook sicuri di contributo in head e a fine body | docs/plugin-system.md | coperto |
| Browser di Plugin Catalog | Plugins | Implementato | System -> Plugins -> Browse Plugin Catalog | Nessun comportamento diretto sul sito pubblico | Legge i metadati del catalogo, non è un'API pubblica di distribuzione | Esplorazione dei metadati del catalogo pubblico | docs/plugin-system.md, docs/plugin-ecosystem-and-catalog.md | serve una guida al ciclo di vita dei plugin |
| Installazione dal catalogo | Plugins | Implementato | Dettaglio di Plugin Catalog | Il plugin installato resta disabilitato finché non viene abilitato | Non orientato alle API | Installazione di artefatti del catalogo verificata tramite checksum | docs/plugin-system.md | serve una guida al ciclo di vita dei plugin |
| Aggiornamenti dei plugin basati sul catalogo | Plugins | Implementato | System -> Plugins | Comportamento del plugin aggiornato dopo un aggiornamento approvato | Non orientato alle API | Riutilizza il percorso di validazione checksum e pacchetto | docs/plugin-system.md | serve una guida al ciclo di vita dei plugin |
| Disinstallazione manuale | Plugins | Implementato | System -> Plugins | Rimuove il pacchetto del plugin caricato e disabilitato | Non orientato alle API | Conserva le tabelle di database di proprietà del plugin | docs/plugin-system.md | coperto |
| WebBlocks UI Manager come plugin per l'operatore, non funzionalità inclusa nel core del CMS | Plugins | Architettura implementata | Installato solo quando caricato/abilitato manualmente | Nessun comportamento ordinario nel runtime del CMS | Non orientato alle API | Il plugin operatore first-party resta fuori dal core incluso | docs/plugin-system.md, ARCHITECTURE_DECISIONS.md | coperto |
Prontezza della documentazione e del sito di prodotto
La documentazione attuale è tecnicamente ricca, ma la scopribilità delle funzionalità è incompleta. Questo inventario dovrebbe aiutare a decidere quali pagine di documentazione rivolte all'utente mancano e quali pagine sorgente potranno in seguito essere pubblicate come pagine di documentazione collegate alla sorgente in un sito di documentazione di destinazione.
Pagine di documentazione prioritarie:
- Panoramica della creazione di pagine con l'IA
- Panoramica del Page Builder
- Inventario delle funzionalità
- Risoluzione dei problemi di Forms / Messages
- Guida al ciclo di vita dei plugin
- Guida dell'operatore a System Updates
I contenuti di marketing di webblocksui.com dovrebbero restare separati dalla documentazione tecnica. Le pagine di marketing possono riassumere il valore del prodotto, mentre la documentazione in Markdown dovrebbe restare la fonte per le indicazioni tecniche e operative.