Јавна база знања (Public KB) је део ваше базе знања који је доступан без пријављивања преко директног линка, виџета или iframe-а. Овде доспевају само чланци које сте изричито означили као јавне.

Зашто:

  • Самопослуживање клијената — клијенти сами проналазе одговоре, без обраћања подршци
  • SEO — јавни чланци се индексирају од стране Google-а и других претраживача
  • Демо — потенцијални клијенти читају документацију пре куповине
  • Партнери — приступ техничкој документацији без потребе за креирањем налога

#Како чланак постаје јаван

Јавност се укључује помоћу два подешавања — једног на нивоу чланка и једног на нивоу организације. Док оба нису на месту, анонимни посетиоци неће видети чланак.

Ниво чланка
publish_state = public
Само чланци са public доспевају у анонимни приступ; internal / draft / inherit остају скривени. Чланак се може означити као јаван само у корпоративном простору — у приватним и личним просторима објављивање је блокирано.
Ниво организације
Режим приступа = „Јавно“
У одељку Подешавања → Организација → Режим приступа. Ако је организација у режиму „Корпоративно“, јавна адреса је затворена и анонимни корисници не виде ништа — чак ни чланке са статусом public.

Не постоји ТИП простора „јаван“. Простори су само Корпоративни / Приватни / Лични. Чланак постаје видљив не премештањем у посебан простор, већ помоћу заставице publish_state=public (у корпоративном простору) заједно са укљученим јавним режимом приступа организације.

#Стања publish_state (ADR 0029)

LiKE користи поље publish_state (оно замењује старо поље visibility). Четири стања:

Стање Ко га види Напомена
draft Само аутор и уредници простора Нацрт — није видљив тиму и није укључен у претрагу
inherit Наслеђује ниво видљивости од родитељске колекције/простора ADR 0029
internal Сви ауторизовани чланови простора Видљив тиму (подразумевана вредност за нове чланке)
public Сви, укључујући анонимне кориснике преко јавне базе знања Дугме „Објави“ у уреднику — само у корпоративном простору

У интерфејсу је боја стања приказана тачкастим индикатором:

Нацрт — видљив само аутору и уредницима
Интерно — за ауторизовани тим
🌐 Јавно — анонимни приступ преко јавне базе знања
Има необјављене измене — приказује се претходна верзија, нова је у уреднику

Исте ознаке су видљиве у листи чланака у одељку Управљање чланцима.

#Виртуелни простор __public__

Када анонимни корисник отвори јавну базу знања преко директног линка или виџета, технички се не налази ни у једном од ваших простора. Уместо тога, LiKE користи виртуелни „простор“ __public__ — sentinel вредност која:

  • Не постоји у бази података као стварни ArticleCollection.type='public'
  • Укључује све чланке са publish_state='public' из корпоративних простора организације
  • Користи се за филтрирање у RAG претрази анонимног корисника
  • Приказује се у SpaceSwitcher-у као „🌐 Јавни чланци“ (ако корисник има и приватне просторе)

Ако сте ауторизовани члан, пребаците се на __public__ у SpaceSwitcher-у да бисте видели тачно исти скуп чланака који види анонимни посетилац — то је згодно за проверу „шта сам случајно објавио“.

#Подешавање (корак по корак)

#Корак 1 — Сместите чланке у корпоративни простор

Чланке можете спољно објавити само из корпоративног простора (у приватним и личним просторима објављивање је блокирано). Ако су ваши чланци у другом простору, преместите их у корпоративни: један по један преко контекстног менија чланка → Премести, или групно (кућице → Премести). При креирању простора доступни типови су Корпоративни и Приватни; „Лични“ је системски простор.

#Корак 2 — Учините чланке јавним

Пребаците чланке који су вам потребни на publish_state = public (погледајте Управљање чланцима):

  • Групно — изаберите помоћу кућица → дугме глобус (🌐) на траци акција → Јавно
  • Појединачни чланак — мени „⋮“ → „Видљивост: …“ → Јавно; у режиму „Стабло“ — контекстни мени → „Учини јавним“
  • У уреднику — дугме „Објави“ у заглављу

Након тога, индикатор статуса постаје зелен и појављује се ознака 🌐 Јавно. Ако чланак садржи личне податке, отвара се дијалог за потврду — погледајте „Провера личних података пре објављивања“ испод.

#Корак 3 — Укључите јавни режим организације

Подешавања → Организација → Режим приступа → изаберите „Јавно“.

  • Јавно — анонимни корисници на јавној адреси виде чланке означене као јавне; приватни простори остају доступни само уз позивницу.
  • Корпоративно — све је доступно само пријављеним члановима; спољни корисници без пријаве не виде ништа, чак ни чланке означене као јавне.

Без укљученог режима „Јавно“ јавна адреса је затворена — овај корак је обавезан.

#Корак 4 — Јавна адреса и канали

Постоје три начина да отворите готову јавну базу знања:

  • Јавни портал — корен ваше адресе https://<ваш-slug>.lynkora.pro: претрага, AI одговори и читање чланака без пријављивања. Појединачни чланак је на /kb/<article-slug>.
  • JS виџет — уграђен на ваш веб-сајт; код виџета се преузима из Интеграције → Канали (картица „JS виџет“).
  • iframe — уградња пуног интерфејса претраге у страницу.

У подешавањима више не постоји засебна картица „Public KB“ (ADR 0029): јавност се сада поставља заставицом чланка + режимом организације, а не белом листом извора. Виџети се управљају у Интеграције → Канали.

#Провера личних података пре објављивања

Када чланак пребаците на Јавни, LiKE га аутоматски скенира на личне податке (PII). Ако се неки пронађу, објављивање се паузира и појављује се дијалог „Откривени лични подаци“ — пре него што чланак постане доступан свима без пријаве.

Када се покреће: само при објављивању (пребацивање на public, анонимни приступ). Не покреће се за internal, draft или inherit. Примењује се на сваки начин објављивања: дугме „Објави“ у едитору, „Учини јавним“ у листи/стаблу, групне промене видљивости и објављивање колекције/простора.

Шта се открива (детерминистички, на основу образаца):

  • Имејл
  • Телефон
  • Платна картица (Luhn контролна сума)
  • IBAN (провера контролне суме)
  • IP адреса
  • Датум рођења

Посебне категорије (здравље, биометрија итд., GDPR Art. 9) се још увек не откривају аутоматски — дијалог само приказује упозорење о повећаној одговорности за њихово објављивање.

Шта дијалог приказује:

  • Наслов „Откривени лични подаци“ и списак откривених типова са бројачима (обједињено за све чланке који се објављују).
  • Обавезно поље за потврду: алат помаже у откривању PII, али не гарантује потпуност; Ви, као руковалац података, остајете одговорни за законитост објављивања и за постојање правног основа или сагласности.
  • Дугмад Откажи и Објави (Објави је активно тек након што се поље за потврду означи).

Након потврде: чланак се објављује, а потврда се бележи у дневнику активности (pii_public_ack) заједно са откривеним типовима података — без чувања самог текста PII (privacy-by-design). Потврда је везана за тренутну верзију чланка: ако касније измените текст, биће потребно да поново потврдите.

Ко може да потврди: исте улоге које могу да објављују — Едитор и више у простору чланка (Власник и Админ увек). Групно објављивање свих чланака извора могу само Власник/Админ.

#Виџети за јавну базу знања (dual-auth, ADR 0032)

LiKE подржава два режима аутентификације за виџете — бирају се при креирању виџета у Интеграције → Виџети:

#Режим 1 — Дозвољене путање (за јавне сајтове)

Виџет уграђен на јавни сајт компаније (лендинг страница, маркетиншке странице, центар за помоћ). Аутентификација није потребна — виџет је доступан сваком посетиоцу.

Заштита од злоупотребе:

  • Листа дозвољених URL-ова (allowed paths) — где је овај api-key важећи. На пример, https://yoursite.com/* и https://docs.yoursite.com/*. Захтеви са других домена се одбијају (CORS + провера).
  • Public umbrella scope — виџет има приступ само простору __public__ + одређеним колекцијама из тог простора, дефинисаним при креирању.
  • Rate limit на api-key — заштита од ботова.

#Режим 2 — Сесијски JWT (за корпоративни сајт са аутентификацијом)

Виџет уграђен на интерни портал компаније, где корисници већ имају аутентификацију. Виџет прихвата сесијски JWT и види тачно оно што тај корисник види.

Случајеви употребе:

  • Виџет на корпоративном интранету → сваки запослени види сопствене просторе
  • Уградња у SaaS апликацију (на пример, у CRM) — корисник види документацију за своју улогу

#Multi-widget по tenant-у (ADR 0029 Stage 4)

Унутар организације можете креирати неколико виџета са различитим scope-овима:

  • Један — јаван, за маркетиншки сајт (allowed paths)
  • Други — корпоративни, за интранет (сесијски JWT)
  • Трећи — за одређену колекцију (на пример, само FAQ за центар подршке)

Сваки виџет има сопствени api-key, scope и режим аутентификације. Погледајте Интеграције → Виџети и API и виџет за детаље.

#Шта виде анонимни посетиоци

Елемент Видљиво?
Чланци са publish_state=public у корпоративним просторима ✅ Да
AI претрага по тим чланцима ✅ Да
Каталог јавних колекција ✅ Да
Кратак share / embed линк (ако је омогућен за чланак) ✅ Да
Банер „Пријавите се за пун приступ“ (ако је виџет анонимни) ✅ Да
Чланци internal, draft, inherit ❌ Не
Чланци из приватних простора ❌ Не
Историја упита / Препоруке (личне) ❌ Не
Административни панел, Корпа, Дневник, Аналитика ❌ Не

Анонимна претрага подразумевано користи client-fingerprint колачић за основно ограничавање брзине, али не везује захтев за кориснички налог.

#Скривање појединачних колекција

У корпоративном простору не морају све колекције обавезно бити видљиве анонимним корисницима. Можете сакрити одређене колекције:

  1. Контекстни мени колекције → Својства
  2. Поље publish_state колекције:
    • inherit — наслеђује од простора (подразумевано)
    • internal — скривено од анонимних корисника, видљиво тиму
    • public — изричито јавно (само у корпоративном простору, иначе блокирано)

Ово даје флексибилност: на пример, у корпоративном простору „Документација“ можете чувати нацрте у колекцији Internal Drafts са publish_state=internal — они су невидљиви споља али доступни вашим уредницима.

#Уградња на веб-сајт

Јавна база знања може се интегрисати у веб-сајт на три начина:

Метод Опис
Директан линк https://<slug>.lynkora.pro — пуноправан сајт-портал са листом чланака, AI претрагом и навигацијом
JS виџет Плутајуће дугме у углу било које странице; развија се у AI ћаскање и претрагу; понашање је подесиво, а на тарифама са white-label и брендирање
iframe Уграђени блок (на пример, страница „Помоћ“ унутар ваше апликације) — пун LiKE интерфејс у оквиру
REST API Директни захтеви са вашег бекенда преко api-key — за интеграцију у сопствене интерфејсе

Детаљи о сваком — API и виџет и Интеграције.

#White-label и прилагођени домен

Јавна база знања је доступна на подразумеваној адреси slug.lynkora.pro. Напредне могућности портала — white-label (без LiKE брендирања) и повезивање прилагођеног домена (Подешавања → Домен) — укључене су у тарифама где је white-label омогућен. За ово не постоји засебан плаћени додатак.

Које су могућности доступне на којим тарифама и по којој цени — погледајте страницу Цене и ваш административни панел.