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 solo 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 / Personal. 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 tutti gli articoli con publish_state='public' dagli spazi corporate dell'organizzazione
• 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 e personali 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). Alla creazione di uno spazio, i tipi disponibili sono Corporate e Private; "Personal" è uno spazio di sistema.

#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 pulsante "Pubblica" nell'intestazione

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.

#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: solo alla pubblicazione (passaggio a public, accesso anonimo). Non viene eseguita per internal, draft o inherit. Si applica a ogni percorso di pubblicazione: il pulsante "Pubblica" nell'editor, "Rendi pubblico" nell'elenco/albero, i cambi di visibilità in blocco e la pubblicazione di una raccolta/spazio.

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.

Cosa mostra la finestra di dialogo:

• 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 (Proprietario e Amministratore sempre). 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 → 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:

• Un elenco di URL consentiti (allowed paths) — dove questa api-key è valida. Per esempio, https://yoursite.com/* e https://docs.yoursite.com/*. Le richieste da altri domini vengono rifiutate (CORS + controllo).
• 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 → Widget 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 → Proprietà
2. Il campo publish_state della raccolta:
   • inherit — eredita dallo spazio (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) — 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.