Base di conoscenza pubblica

La Base di conoscenza pubblica (Public KB) è la parte della Sua base di conoscenza accessibile senza accesso tramite un link diretto, un widget o un iframe. Qui finiscono gli articoli che ha esplicitamente contrassegnato come pubblici.

Perché:

• Self-service del cliente — i clienti trovano le risposte da soli, senza contattare l'assistenza
• SEO — gli articoli pubblici sono indicizzati da Google e da altri motori di ricerca
• Demo — i potenziali clienti leggono la documentazione prima dell'acquisto
• Partner — accesso alla documentazione tecnica senza dover creare account

#Come un articolo diventa pubblico

La pubblicità è abilitata da due impostazioni — una a livello di articolo e una a livello di organizzazione. Finché entrambe non sono attive, i visitatori anonimi non vedranno l'articolo.

Non esiste un TIPO di spazio "pubblico". Gli spazi sono solo Corporate / Private. Un articolo diventa visibile non spostandolo in uno spazio speciale, ma tramite il flag publish_state=public (in uno spazio corporate) insieme alla modalità di accesso pubblico dell'organizzazione attiva.

#Stati di publish_state (ADR 0029)

LiKE usa il campo publish_state (sostituisce il vecchio campo visibility). Quattro stati:

Nell'interfaccia, il colore dello stato è indicato da un indicatore a puntino:

Gli stessi badge sono visibili nell'elenco degli articoli in Gestione degli articoli.

#Lo spazio virtuale __public__

Quando un utente anonimo apre la Public KB tramite un link diretto o un widget, tecnicamente non si trova in nessuno dei Suoi spazi. LiKE usa invece uno "spazio" virtuale __public__ — un valore sentinella che:

• Non esiste nel database come un vero ArticleCollection.type='public'
• Include gli articoli pubblici di per sé o per eredità da una cartella pubblica
• Viene usato per il filtraggio nella ricerca RAG dell'utente anonimo
• È mostrato nello SpaceSwitcher come " Articoli pubblici" (se l'utente ha anche spazi privati)

Se è un membro autorizzato, passi a __public__ nello SpaceSwitcher per vedere esattamente lo stesso insieme di articoli che vede un visitatore anonimo — è comodo per verificare "cosa ho pubblicato per sbaglio".

#Configurazione (passo dopo passo)

#Passo 1 — Collocare gli articoli in uno spazio corporate

Può pubblicare all'esterno solo da uno spazio corporate (negli spazi privati la pubblicazione è bloccata). Se i Suoi articoli si trovano in un altro spazio, li sposti in uno corporate: uno per uno tramite il menu contestuale dell'articolo → Sposta, oppure in blocco (caselle di spunta → Sposta). I tipi di spazio sono Corporate e Private; non esiste un tipo "Personal" a sé — uno spazio resta privato finché non invita qualcuno.

#Passo 2 — Rendere pubblici gli articoli

Commuti gli articoli che desidera in publish_state = public (vedi Gestione degli articoli):

• In blocco — selezioni con le caselle di spunta → il pulsante globo () sulla barra delle azioni → Pubblico
• Un singolo articolo — il menu "⋮" → "Visibilità: …" → Pubblico; in modalità "Albero" — il menu contestuale → "Rendi pubblico"
• Nell'editor — il contrassegno di accesso accanto al titolo dell'articolo

Dopodiché, l'indicatore di stato diventa verde e compare un badge Pubblico. Se l'articolo contiene dati personali, si apre una finestra di dialogo di conferma — vedi "Verifica dei dati personali prima della pubblicazione" più sotto.

#Passo 3 — Attivare la modalità pubblica dell'organizzazione

Impostazioni → Organizzazione → Modalità di accesso → scelga «Pubblico».

• Pubblico — gli utenti anonimi vedono, all'indirizzo pubblico, gli articoli contrassegnati come pubblici; gli spazi privati restano disponibili solo su invito.
• Aziendale — tutto è disponibile solo ai membri che hanno effettuato l'accesso; gli utenti esterni senza accesso non vedono nulla, nemmeno gli articoli contrassegnati come pubblici.

Senza la modalità «Pubblico» attiva, l'indirizzo pubblico è chiuso — questo passo è obbligatorio.

La modalità pubblica funziona solo sui piani in cui è inclusa. Se l'accesso pubblico non è incluso nel piano, il pulsante «Pubblico» non è disponibile e mostra il suggerimento «L'accesso pubblico non è incluso nel tuo piano: i visitatori anonimi non vedono il portale.». Con il passaggio a un piano inferiore il portale si chiude da solo ai visitatori anonimi, e tornando a un piano adeguato si riapre: la modalità scelta non viene reimpostata.

#Passo 4 — Indirizzo pubblico e canali

Ci sono tre modi per aprire la base di conoscenza pubblica pronta:

• Portale pubblico — la radice del Suo indirizzo https://<your-slug>.lynkora.pro: ricerca, risposte AI e lettura degli articoli senza accesso. Un singolo articolo si trova su /kb/<article-slug>.
• Widget JS — incorporato sul Suo sito web; il codice del widget si trova in Integrazioni → Canali (la scheda "Widget JS").
• iframe — incorporamento dell'interfaccia di ricerca completa in una pagina.

Non esiste più una scheda "Public KB" separata nelle impostazioni (ADR 0029): la pubblicità ora è impostata dal flag dell'articolo + la modalità dell'organizzazione, invece che da una whitelist di fonti. I widget sono gestiti in Integrazioni → Canali.

#Verifica dei dati personali prima della pubblicazione

Quando imposta un articolo su Pubblico, LiKE lo analizza automaticamente alla ricerca di dati personali (PII). Se ne vengono rilevati, la pubblicazione viene sospesa e compare una finestra di dialogo "Dati personali rilevati" — prima che l'articolo diventi accessibile a chiunque senza autenticazione.

Quando si attiva: quando un articolo diventa accessibile in forma anonima — per passaggio a public oppure tramite inherit all'interno di una cartella pubblica. Non viene eseguita per internal e draft. Si applica a tutti i percorsi, non solo al pulsante «Pubblica»: il contrassegno di accesso nell'editor, «Rendi pubblico» nell'elenco e nell'albero, i cambi di visibilità in blocco, la pubblicazione di una cartella (anche insieme al suo contenuto), lo spostamento di un articolo o di una cartella in una cartella pubblica, la copia, il ripristino dal cestino e l'attivazione di un articolo.

Cosa viene rilevato (in modo deterministico, basato su pattern):

• Email
• Telefono
• Carta di pagamento (checksum di Luhn)
• IBAN (con checksum validato)
• Indirizzo IP
• Data di nascita

Le categorie particolari (salute, dati biometrici, ecc., GDPR Art. 9) non vengono ancora rilevate automaticamente — la finestra di dialogo mostra soltanto un avviso sulla maggiore responsabilità che comporta la loro pubblicazione.

Un gruppo di articoli viene chiesto una volta sola. I cambi di visibilità in blocco, la pubblicazione di una cartella, lo spostamento e il ripristino mostrano un'unica finestra «Dati personali negli articoli da pubblicare»: il riepilogo per tipo di dato (quante occorrenze e in quanti articoli), l'elenco degli articoli con la ricerca per titolo, «Segna tutto» / «Deseleziona tutto» e il contatore dei segnati.

• Vengono pubblicati gli articoli segnati. All'apertura sono segnati tutti — tolga il segno a quelli che non vanno pubblicati: resteranno interni e non seguiranno la cartella.
• I pulsanti sono «Pubblica N» e «Annulla». Con l'annullamento non accade nulla, e LiKE lo dice esplicitamente.
• La conferma prestata nella finestra di gruppo viene registrata nel registro separatamente per ciascun articolo.

Gli articoli acquisiti dal connettore del sito non richiedono una conferma per ciascuno: al momento del collegamento la persona proprietaria conferma i diritti sul sito e la liceità della pubblicazione dei dati personali che vi si trovano. Ricolleghi il sito scegliendo «Interne» — il consenso viene revocato e la verifica torna a funzionare come di consueto.

Le azioni in background — la sincronizzazione del connettore, l'importazione, la ristrutturazione — non possono chiedere nulla a nessuno, quindi un articolo con dati personali non confermati non viene pubblicato: resta interno e nel registro compare una voce a riguardo. Può pubblicarlo manualmente, passando dalla verifica consueta.

Come si presenta la finestra di un singolo articolo:

• Il titolo "Dati personali rilevati" e un elenco dei tipi rilevati con i relativi conteggi (aggregati su tutti gli articoli in pubblicazione).
• Una casella di conferma obbligatoria: lo strumento aiuta a rilevare i PII ma non ne garantisce la completezza; Lei, in qualità di titolare del trattamento, resta responsabile della liceità della pubblicazione e della sussistenza di una base giuridica o del consenso.
• I pulsanti Annulla e Pubblica (Pubblica è attivo solo dopo aver spuntato la casella).

Dopo la conferma: l'articolo viene pubblicato e la presa d'atto viene registrata nel Registro attività (pii_public_ack) con i tipi di dati rilevati — senza memorizzare il testo dei PII stessi (privacy-by-design). La presa d'atto è legata alla versione corrente dell'articolo: se ne modifica il testo successivamente, dovrà confermare di nuovo.

Chi può prestare la conferma: gli stessi ruoli che possono pubblicare — Editor e superiori nello spazio dell'articolo. Il Proprietario dell'organizzazione sempre; l'Amministratore dell'organizzazione negli spazi aziendali e in quelli privati di cui è membro con il ruolo Editor o Amministratore. La pubblicazione in blocco di tutti gli articoli di una fonte è riservata a Proprietario/Amministratore.

#Widget per la Public KB (dual-auth, ADR 0032)

LiKE supporta due modalità di autenticazione per i widget — scelte quando crea un widget in Integrazioni → Canali → JS Widget:

#Modalità 1 — Percorsi consentiti (per siti pubblici)

Un widget incorporato sul sito pubblico dell'azienda (una landing page, pagine di marketing, un centro assistenza). Non è richiesta alcuna autenticazione — il widget è disponibile a qualsiasi visitatore.

Protezione dagli abusi:

• Indirizzi del sito — dove funziona il widget. Per esempio, yoursite.com, docs.yoursite.com (a un indirizzo senza schema viene aggiunto https://). L'asterisco non è accettato; le richieste da altri indirizzi vengono rifiutate.
• Public umbrella scope — il widget ha accesso solo allo spazio __public__ + a raccolte specifiche di quello spazio, definite alla creazione.
• Rate limit sull'api-key — protezione dai bot.

#Modalità 2 — Session JWT (per un sito corporate con autenticazione)

Un widget incorporato sul portale interno dell'azienda, dove gli utenti hanno già l'autenticazione. Il widget accetta un session JWT e vede esattamente ciò che vede quell'utente.

Casi d'uso:

• Un widget su un'intranet aziendale → ogni dipendente vede i propri spazi
• Incorporamento in un'applicazione SaaS (per esempio, in un CRM) — l'utente vede la documentazione per il proprio ruolo

#Multi-widget per tenant (ADR 0029 Stage 4)

All'interno di un'organizzazione può creare più widget con scope diversi:

• Uno — pubblico, per il sito di marketing (allowed paths)
• Un altro — corporate, per l'intranet (session JWT)
• Un terzo — per una raccolta specifica (per esempio, solo le FAQ per il centro assistenza)

Ogni widget ha la propria api-key, il proprio scope e la propria modalità di autenticazione. Vedi Integrazioni e API e widget per i dettagli.

#Cosa vedono i visitatori anonimi

La ricerca anonima usa per impostazione predefinita un cookie di fingerprint del client per un rate limiting di base, ma non lega la richiesta a un account utente.

#Nascondere singole raccolte

In uno spazio corporate, non tutte le raccolte devono necessariamente essere visibili agli utenti anonimi. Può nascondere raccolte specifiche:

1. Il menu contestuale della raccolta → «Rendi pubblica» / «Rendi interna»
2. Lo stato della raccolta:
   • inherit — segue la cartella genitore più vicina con uno stato esplicito; se non ce n'è nessuna — interna (predefinito)
   • internal — nascosta agli utenti anonimi, visibile al team
   • public — esplicitamente pubblica (solo in uno spazio corporate, altrimenti bloccata)

Ciò dà flessibilità: per esempio, in uno spazio corporate "Documentazione" può tenere le bozze in una raccolta Internal Drafts con publish_state=internal — sono invisibili all'esterno ma disponibili per i Suoi editor.

#Incorporamento su un sito web

La Public KB può essere integrata in un sito web in tre modi:

Dettagli su ciascuno — API e widget e Integrazioni.

#White-label e un dominio personalizzato

La base di conoscenza pubblica è disponibile all'indirizzo predefinito slug.lynkora.pro. Le funzionalità avanzate del portale — white-label (senza il branding di LiKE) e la connessione di un dominio personalizzato (Impostazioni → Dominio; in sviluppo) — sono incluse nei piani in cui il white-label è abilitato. Non c'è un add-on a pagamento separato per questo.

Quali funzionalità sono disponibili su quali piani e a quale prezzo — vedi la pagina Prezzi e il Suo pannello di amministrazione.