Gestione Contenuti e Workflow Editoriale

Panoramica

La Knowledge Base della piattaforma utilizza un workflow editoriale strutturato per garantire la qualita dei contenuti. Ogni articolo attraversa fasi definite dalla creazione alla pubblicazione, con revisione e approvazione intermedie. Il workflow e gestito dal servizio knowledge-items nel database pos_platform.

Ciclo di Vita di un Articolo

Ogni articolo segue un workflow a cinque stati:

draft → in_review → approved → published → archived

Stato	Descrizione	Chi puo modificarlo
draft	Bozza in lavorazione	Autore originale
in_review	Sottomesso per revisione	Revisori assegnati
approved	Approvato, pronto per pubblicazione	Responsabile editoriale
published	Visibile nella Knowledge Base e all'assistente AI	Solo per correzioni minori
archived	Rimosso dalla vista pubblica, consultabile nello storico	Responsabile editoriale

Creazione di un Articolo

Dalla Console Admin

1. Accedere a Knowledge Base > Nuovo Articolo
2. Compilare i campi obbligatori:
   • Titolo: descrittivo e conciso (massimo 100 caratteri)
   • Corpo: contenuto in formato Markdown con sezioni ##
   • Audience: pubblico di destinazione (utente, admin, installer, developer, reseller)
   • Categorie: classificazione tematica (configurazione, operazioni, troubleshooting)
   • Tag: parole chiave per la ricerca e il raggruppamento
3. Campi opzionali:
   • Lingua: lingua dell'articolo (default: italiano)
   • Priorita: importanza relativa per il ranking nelle ricerche

Linee Guida per la Scrittura

Per articoli ottimizzati per la ricerca AI (RAG):

• Ogni sezione ## deve contenere meno di 800 token (circa 600 parole)
• Usare titoli di sezione descrittivi e unici
• Includere una sezione FAQ con le domande piu frequenti
• Aggiungere Vedi Anche con link ad articoli correlati
• Evitare blocchi di testo lunghi: preferire elenchi puntati e tabelle

Sottomissione per Revisione

Quando l'articolo e completo:

1. Cliccare Invia per Revisione dalla scheda articolo
2. Lo stato cambia da draft a in_review
3. I revisori assegnati ricevono una notifica
4. L'articolo compare nella coda di revisione

Processo di Revisione

I revisori possono:

• Approvare: l'articolo passa allo stato approved
• Richiedere modifiche: l'articolo torna a draft con note di revisione
• Rifiutare: l'articolo viene archiviato con motivazione

Le note di revisione sono visibili all'autore nella cronologia dell'articolo.

Pubblicazione

Un articolo approvato puo essere pubblicato dal responsabile editoriale:

1. Dalla coda di approvazione, selezionare l'articolo
2. Verificare l'anteprima del rendering finale
3. Cliccare Pubblica
4. L'articolo diventa immediatamente visibile nella Knowledge Base e consultabile dall'assistente AI

La pubblicazione genera automaticamente gli embedding vettoriali (Voyage AI) per la ricerca semantica e li salva nella collection knowledge_vectors.

Metriche di Qualita

Il sistema calcola automaticamente metriche per ogni articolo:

Metrica	Descrizione
Quality score	Punteggio 0-100 basato su completezza, struttura e leggibilita
Tempo di lettura	Stima in minuti basata sul conteggio parole
Feedback ratio	Rapporto tra feedback positivi e negativi dall'assistente AI
Visualizzazioni	Numero di consultazioni dirette e tramite assistente

Matrice di Copertura

La matrice di copertura mostra la distribuzione degli articoli per audience e categoria, evidenziando le aree con copertura insufficiente. Le lacune vengono segnalate con un indicatore rosso e suggerimenti per nuovi articoli.

Archiviazione

Per rimuovere un articolo dalla Knowledge Base pubblica:

1. Dalla scheda articolo, cliccare Archivia
2. Specificare il motivo (obsoleto, sostituito, errato)
3. L'articolo non e piu visibile al pubblico ma resta consultabile nello storico
4. Gli embedding vettoriali vengono rimossi dalla ricerca semantica

FAQ

D: Chi puo creare articoli nella Knowledge Base? R: Gli utenti con ruolo "contributor" (team interno, reseller, installatori) possono creare bozze. Solo i revisori possono approvare e solo i responsabili editoriali possono pubblicare.

D: Come aggiorno un articolo gia pubblicato? R: Modificare l'articolo pubblicato lo riporta allo stato draft. Le modifiche devono attraversare nuovamente il ciclo di revisione prima di essere ripubblicate.

D: Gli articoli archiviati influenzano le risposte dell'assistente AI? R: No, gli articoli archiviati vengono rimossi dagli embedding vettoriali e non sono piu consultabili dall'assistente AI.

Vedi Anche

• Assistente AI -- Come usare l'assistente AI integrato
• Panoramica Console -- Navigazione console admin