Javna baza znanja

Javna baza znanja (Public KB) je deo vaše baze znanja koji je dostupan bez prijavljivanja preko direktnog linka, vidžeta ili iframe-a. Ovde dospevaju članci koje ste izričito označili kao javne.

Zašto:

• Samoposluživanje klijenata — klijenti sami pronalaze odgovore, bez obraćanja podršci
• SEO — javni članci se indeksiraju od strane Google-a i drugih pretraživača
• Demo — potencijalni klijenti čitaju dokumentaciju pre kupovine
• Partneri — pristup tehničkoj dokumentaciji bez potrebe za kreiranjem naloga

#Kako članak postaje javan

Javnost se uključuje pomoću dva podešavanja — jednog na nivou članka i jednog na nivou organizacije. Dok oba nisu na mestu, anonimni posetioci neće videti članak.

Ne postoji TIP prostora „javan“. Prostori su samo Korporativni / Privatni. Članak postaje vidljiv ne premeštanjem u poseban prostor, već pomoću zastavice publish_state=public (u korporativnom prostoru) zajedno sa uključenim javnim režimom pristupa organizacije.

#Stanja publish_state (ADR 0029)

LiKE koristi polje publish_state (ono zamenjuje staro polje visibility). Četiri stanja:

U interfejsu je boja stanja prikazana tačkastim indikatorom:

Iste oznake su vidljive u listi članaka u odeljku Upravljanje člancima.

#Virtuelni prostor __public__

Kada anonimni korisnik otvori javnu bazu znanja preko direktnog linka ili vidžeta, tehnički se ne nalazi ni u jednom od vaših prostora. Umesto toga, LiKE koristi virtuelni „prostor“ __public__ — sentinel vrednost koja:

• Ne postoji u bazi podataka kao stvarni ArticleCollection.type='public'
• Uključuje članke koji su javni sami po sebi ili po nasleđivanju od javne fascikle
• Koristi se za filtriranje u RAG pretrazi anonimnog korisnika
• Prikazuje se u SpaceSwitcher-u kao „ Javni članci“ (ako korisnik ima i privatne prostore)

Ako ste autorizovani član, prebacite se na __public__ u SpaceSwitcher-u da biste videli tačno isti skup članaka koji vidi anonimni posetilac — to je zgodno za proveru „šta sam slučajno objavio“.

#Podešavanje (korak po korak)

#Korak 1 — Smestite članke u korporativni prostor

Članke možete spoljno objaviti samo iz korporativnog prostora (u privatnim prostorima objavljivanje je blokirano). Ako su vaši članci u drugom prostoru, premestite ih u korporativni: jedan po jedan preko kontekstnog menija članka → Premesti, ili grupno (kućice → Premesti). Tipovi prostora su Korporativni i Privatni; ne postoji poseban tip „Lični“ — prostor ostaje privatan dok nikoga ne pozovete.

#Korak 2 — Učinite članke javnim

Prebacite članke koji su vam potrebni na publish_state = public (pogledajte Upravljanje člancima):

• Grupno — izaberite pomoću kućica → dugme globus () na traci akcija → Javno
• Pojedinačni članak — meni „⋮“ → „Vidljivost: …“ → Javno; u režimu „Stablo“ — kontekstni meni → „Učini javnim“
• U uredniku — oznaka pristupa pored naslova članka

Nakon toga, indikator statusa postaje zelen i pojavljuje se oznaka Javno. Ako članak sadrži lične podatke, otvara se dijalog za potvrdu — pogledajte „Provera ličnih podataka pre objavljivanja“ ispod.

#Korak 3 — Uključite javni režim organizacije

Podešavanja → Organizacija → Režim pristupa → izaberite „Javno“.

• Javno — anonimni korisnici na javnoj adresi vide članke označene kao javne; privatni prostori ostaju dostupni samo uz pozivnicu.
• Korporativno — sve je dostupno samo prijavljenim članovima; spoljni korisnici bez prijave ne vide ništa, čak ni članke označene kao javne.

Bez uključenog režima „Javno“ javna adresa je zatvorena — ovaj korak je obavezan.

Javni režim radi samo na planovima na kojima je uključen. Ako javni pristup nije deo plana, dugme „Javno“ nije dostupno, uz napomenu „Javni pristup nije uključen u vaš tarifni paket: anonimni posetioci ne vide portal.“. Pri snižavanju plana portal se za anonimne posetioce sam zatvara, a pri povratku na odgovarajući plan ponovo otvara — izabrani režim se ne poništava.

#Korak 4 — Javna adresa i kanali

Postoje tri načina da otvorite gotovu javnu bazu znanja:

• Javni portal — koren vaše adrese https://<vaš-slug>.lynkora.pro: pretraga, AI odgovori i čitanje članaka bez prijavljivanja. Pojedinačni članak je na /kb/<article-slug>.
• JS vidžet — ugrađen na vaš veb-sajt; kod vidžeta se preuzima iz Integracije → Kanali (kartica „JS vidžet“).
• iframe — ugradnja punog interfejsa pretrage u stranicu.

U podešavanjima više ne postoji zasebna kartica „Public KB“ (ADR 0029): javnost se sada postavlja zastavicom članka + režimom organizacije, a ne belom listom izvora. Vidžeti se upravljaju u Integracije → Kanali.

#Provera ličnih podataka pre objavljivanja

Kada članak prebacite na Javni, LiKE ga automatski skenira na lične podatke (PII). Ako se neki pronađu, objavljivanje se pauzira i pojavljuje se dijalog „Otkriveni lični podaci“ — pre nego što članak postane dostupan svima bez prijave.

Kada se pokreće: kada članak postane dostupan anonimno — prebacivanjem na public ili preko inherit unutar javne fascikle. Za internal i draft provera se ne izvršava. Primenjuje se na svim putanjama, a ne samo na dugmetu „Objavi“: oznaka pristupa u editoru, „Učini javnim“ u listi i stablu, grupna promena vidljivosti, objavljivanje fascikle (uključujući i zajedno sa sadržajem), premeštanje članka ili fascikle u javnu fasciklu, kopiranje, vraćanje iz korpe i uključivanje članka.

Šta se otkriva (deterministički, na osnovu obrazaca):

• Imejl
• Telefon
• Platna kartica (Luhn kontrolna suma)
• IBAN (provera kontrolne sume)
• IP adresa
• Datum rođenja

Posebne kategorije (zdravlje, biometrija itd., GDPR Art. 9) se još uvek ne otkrivaju automatski — dijalog samo prikazuje upozorenje o povećanoj odgovornosti za njihovo objavljivanje.

Grupa članaka se pita jednom. Grupna promena vidljivosti, objavljivanje fascikle, premeštanje i vraćanje prikazuju jedan dijalog „Lični podaci u člancima koji se objavljuju“: pregled po tipovima podataka (koliko pojavljivanja i u koliko članaka), spisak članaka sa pretragom po naslovu, „Označi sve“ / „Ukloni oznake“ i brojač označenih.

• Označeni članci se objavljuju. Pri otvaranju su označeni svi — skinite oznaku sa onih koje ne treba objaviti: oni ostaju interni i neće pratiti fasciklu.
• Dugmad su „Objavi N“ i „Otkaži“. Pri otkazivanju se ništa ne dešava, i LiKE to kaže otvoreno.
• Potvrda data u grupnom dijalogu beleži se u dnevniku za svaki članak posebno.

Članci koje je preuzeo konektor veb-sajta ne traže potvrdu jedan po jedan: pri povezivanju vlasnik potvrđuje prava na sajt i zakonitost objavljivanja ličnih podataka sa njega. Povežite sajt ponovo sa odgovorom „Interno“ — saglasnost se povlači, i provera ponovo radi kao obično.

Pozadinske radnje — sinhronizacija konektora, uvoz, ponovna izgradnja strukture — ne mogu nikoga da pitaju, pa članak sa nepotvrđenim ličnim podacima ne objavljuju: on ostaje interni, a u dnevniku se pojavljuje zapis o tome. Objaviti ga možete ručno, uz uobičajenu proveru.

Kako izgleda dijalog za jedan članak:

• Naslov „Otkriveni lični podaci“ i spisak otkrivenih tipova sa brojačima (objedinjeno za sve članke koji se objavljuju).
• Obavezno polje za potvrdu: alat pomaže u otkrivanju PII, ali ne garantuje potpunost; Vi, kao rukovalac podataka, ostajete odgovorni za zakonitost objavljivanja i za postojanje pravnog osnova ili saglasnosti.
• Dugmad Otkaži i Objavi (Objavi je aktivno tek nakon što se polje za potvrdu označi).

Nakon potvrde: članak se objavljuje, a potvrda se beleži u dnevniku aktivnosti (pii_public_ack) zajedno sa otkrivenim tipovima podataka — bez čuvanja samog teksta PII (privacy-by-design). Potvrda je vezana za trenutnu verziju članka: ako kasnije izmenite tekst, biće potrebno da ponovo potvrdite.

Ko može da potvrdi: iste uloge koje mogu da objavljuju — Editor i više u prostoru članka. Vlasnik organizacije — uvek; Admin organizacije — u korporativnim prostorima i u privatnim u kojima je član sa ulogom Editor ili Admin. Grupno objavljivanje svih članaka izvora mogu samo Vlasnik/Admin.

#Vidžeti za javnu bazu znanja (dual-auth, ADR 0032)

LiKE podržava dva režima autentifikacije za vidžete — biraju se pri kreiranju vidžeta u Integracije → Kanali → JS Widget:

#Režim 1 — Dozvoljene putanje (za javne sajtove)

Vidžet ugrađen na javni sajt kompanije (lending stranica, marketinške stranice, centar za pomoć). Autentifikacija nije potrebna — vidžet je dostupan svakom posetiocu.

Zaštita od zloupotrebe:

• Adrese sajta — gde vidžet radi. Na primer, yoursite.com, docs.yoursite.com (adresa bez šeme dobija https://). Zvezdica se ne prihvata; zahtevi sa drugih adresa se odbijaju.
• Public umbrella scope — vidžet ima pristup samo prostoru __public__ + određenim kolekcijama iz tog prostora, definisanim pri kreiranju.
• Rate limit na api-key — zaštita od botova.

#Režim 2 — Sesijski JWT (za korporativni sajt sa autentifikacijom)

Vidžet ugrađen na interni portal kompanije, gde korisnici već imaju autentifikaciju. Vidžet prihvata sesijski JWT i vidi tačno ono što taj korisnik vidi.

Slučajevi upotrebe:

• Vidžet na korporativnom intranetu → svaki zaposleni vidi sopstvene prostore
• Ugradnja u SaaS aplikaciju (na primer, u CRM) — korisnik vidi dokumentaciju za svoju ulogu

#Multi-widget po tenant-u (ADR 0029 Stage 4)

Unutar organizacije možete kreirati nekoliko vidžeta sa različitim scope-ovima:

• Jedan — javan, za marketinški sajt (allowed paths)
• Drugi — korporativni, za intranet (sesijski JWT)
• Treći — za određenu kolekciju (na primer, samo FAQ za centar podrške)

Svaki vidžet ima sopstveni api-key, scope i režim autentifikacije. Pogledajte Integracije i API i vidžet za detalje.

#Šta vide anonimni posetioci

Anonimna pretraga podrazumevano koristi client-fingerprint kolačić za osnovno ograničavanje brzine, ali ne vezuje zahtev za korisnički nalog.

#Skrivanje pojedinačnih kolekcija

U korporativnom prostoru ne moraju sve kolekcije obavezno biti vidljive anonimnim korisnicima. Možete sakriti određene kolekcije:

1. Kontekstni meni kolekcije → „Učini javnom“ / „Učini internom“
2. Stanje kolekcije:
   • inherit — prati najbližu roditeljsku fasciklu sa izričitim stanjem; ako takve nema — interna je (podrazumevano)
   • internal — skriveno od anonimnih korisnika, vidljivo timu
   • public — izričito javno (samo u korporativnom prostoru, inače blokirano)

Ovo daje fleksibilnost: na primer, u korporativnom prostoru „Dokumentacija“ možete čuvati nacrte u kolekciji Internal Drafts sa publish_state=internal — oni su nevidljivi spolja ali dostupni vašim urednicima.

#Ugradnja na veb-sajt

Javna baza znanja može se integrisati u veb-sajt na tri načina:

Detalji o svakom — API i vidžet i Integracije.

#White-label i prilagođeni domen

Javna baza znanja je dostupna na podrazumevanoj adresi slug.lynkora.pro. Napredne mogućnosti portala — white-label (bez LiKE brendiranja) i povezivanje prilagođenog domena (Podešavanja → Domen; u izradi) — uključene su u tarifama gde je white-label omogućen. Za ovo ne postoji zaseban plaćeni dodatak.

Koje su mogućnosti dostupne na kojim tarifama i po kojoj ceni — pogledajte stranicu Cene i vaš administrativni panel.