공개 지식 베이스

**공개 지식 베이스(Public KB)**는 직접 링크, 위젯 또는 iframe을 통해 로그인 없이 접근할 수 있는 지식 베이스의 일부입니다. 명시적으로 공개로 표시한 문서만 여기에 포함됩니다.

이유:

• 고객 셀프 서비스 — 고객이 지원팀에 문의하지 않고 스스로 답을 찾습니다
• SEO — 공개 문서는 Google 및 기타 검색 엔진에 색인됩니다
• 데모 — 잠재 고객이 구매 전에 문서를 읽습니다
• 파트너 — 계정을 만들 필요 없이 기술 문서에 접근합니다

#문서가 공개되는 방법

공개 여부는 두 가지 설정으로 활성화됩니다 — 하나는 문서 수준, 다른 하나는 조직 수준입니다. 두 가지가 모두 갖춰지기 전까지는 익명 방문자에게 문서가 표시되지 않습니다.

"공개" 스페이스 유형은 존재하지 않습니다. 스페이스는 Corporate / Private / Personal뿐입니다. 문서는 특수한 스페이스로 이동해서 공개되는 것이 아니라, (Corporate 스페이스에서) publish_state=public 플래그와 조직의 공개 접근 모드가 함께 켜져 있어야 공개됩니다.

#publish_state 상태(ADR 0029)

LiKE는 publish_state 필드를 사용합니다(이전의 visibility 필드를 대체합니다). 네 가지 상태:

UI에서 상태의 색상은 점 표시기로 나타납니다:

동일한 배지가 문서 관리의 문서 목록에도 표시됩니다.

#가상 __public__ 스페이스

익명 사용자가 직접 링크 또는 위젯을 통해 공개 지식 베이스를 열면, 기술적으로 그들은 여러분의 어떤 스페이스에도 속해 있지 않습니다. 대신 LiKE는 다음과 같은 가상 "스페이스" __public__ 를 사용합니다 — 이는 센티널 값으로:

• 실제 ArticleCollection.type='public'으로 데이터베이스에 존재하지 않습니다
• 조직의 Corporate 스페이스에서 publish_state='public'인 모든 문서를 포함합니다
• 익명 사용자의 RAG 검색에서 필터링에 사용됩니다
• (사용자에게 비공개 스페이스도 있는 경우) SpaceSwitcher에 "🌐 공개 문서"로 표시됩니다

인증된 구성원이라면 SpaceSwitcher에서 __public__으로 전환하여 익명 방문자가 보는 것과 정확히 동일한 문서 집합을 확인할 수 있습니다 — 이는 "내가 실수로 무엇을 게시했는지" 확인하는 데 편리합니다.

#설정(단계별)

#1단계 — Corporate 스페이스에 문서 배치

외부 게시는 Corporate 스페이스에서만 가능합니다(Private 및 Personal 스페이스에서는 게시가 차단됩니다). 문서가 다른 스페이스에 있다면 Corporate 스페이스로 이동하세요: 개별로는 문서의 컨텍스트 메뉴 → 이동, 일괄로는(체크박스 → 이동). 스페이스를 만들 때 사용할 수 있는 유형은 Corporate와 Private입니다; "Personal"은 시스템 스페이스입니다.

#2단계 — 문서를 공개로 만들기

필요한 문서를 publish_state = public으로 전환합니다(문서 관리 참조):

• 일괄 — 체크박스로 선택 → 작업 표시줄의 지구본(🌐) 버튼 → Public
• 단일 문서 — "⋮" 메뉴 → "가시성: …" → Public; "트리" 모드에서는 — 컨텍스트 메뉴 → "공개로 만들기"
• 편집기에서 — 헤더의 "게시" 버튼

그 후 상태 표시기가 녹색으로 바뀌고 🌐 Public 배지가 나타납니다. 문서에 개인정보가 포함되어 있으면 확인 대화 상자가 열립니다 — 아래 "게시 전 개인정보 확인"을 참조하세요.

#3단계 — 조직의 공개 모드 켜기

설정 → 조직 → 접근 모드 → **"공개"**를 선택합니다.

• 공개 — 익명 사용자는 공개 주소에서 공개로 표시된 문서를 봅니다; 비공개 스페이스는 초대를 통해서만 계속 이용할 수 있습니다.
• 기업용 — 모든 것이 로그인한 구성원에게만 제공됩니다; 로그인하지 않은 외부 사용자는 공개로 표시된 문서라도 아무것도 볼 수 없습니다.

"공개" 모드가 활성화되지 않으면 공개 주소는 닫혀 있습니다 — 이 단계는 필수입니다.

#4단계 — 공개 주소 및 채널

준비된 공개 지식 베이스를 여는 방법은 세 가지입니다:

• 공개 포털 — 주소의 루트 https://<your-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_public_ack) — 개인정보 텍스트 자체는 저장하지 않고(privacy-by-design) 말입니다. 확인은 문서의 현재 버전에 연결됩니다: 이후 텍스트를 편집하면 다시 확인해야 합니다.

확인 권한: 게시할 수 있는 것과 동일한 역할 — 문서 스페이스의 Editor 이상(Owner 및 Admin은 항상 가능). 소스의 모든 문서를 일괄 게시하는 것은 Owner/Admin만 가능합니다.

#공개 지식 베이스용 위젯(dual-auth, ADR 0032)

LiKE는 위젯에 대해 두 가지 인증 모드를 지원합니다 — 통합 → 위젯에서 위젯을 만들 때 선택합니다:

#모드 1 — 허용된 경로(공개 사이트용)

회사의 공개 사이트(랜딩 페이지, 마케팅 페이지, 헬프 센터)에 삽입된 위젯. 인증이 필요하지 않습니다 — 위젯은 모든 방문자에게 제공됩니다.

남용 방지:

• 허용된 URL 목록(allowed paths) — 이 api-key가 유효한 곳. 예: https://yoursite.com/* 및 https://docs.yoursite.com/*. 다른 도메인의 요청은 거부됩니다(CORS + 검사).
• Public umbrella scope — 위젯은 __public__ 스페이스 + 생성 시 정의된 해당 스페이스의 특정 컬렉션에만 접근합니다.
• api-key에 대한 Rate limit — 봇에 대한 방지책.

#모드 2 — 세션 JWT(인증이 있는 기업 사이트용)

사용자가 이미 인증되어 있는 회사의 내부 포털에 삽입된 위젯. 위젯은 세션 JWT를 받아들이고 해당 사용자가 보는 것을 정확히 봅니다.

사용 사례:

• 기업 인트라넷의 위젯 → 각 직원이 자신의 스페이스를 봄
• SaaS 애플리케이션(예: CRM)에 삽입 — 사용자가 자신의 역할에 맞는 문서를 봄

#테넌트당 다중 위젯(ADR 0029 Stage 4)

조직 내에서 서로 다른 범위를 가진 여러 위젯을 만들 수 있습니다:

• 하나는 — 공개, 마케팅 사이트용(allowed paths)
• 다른 하나는 — 기업용, 인트라넷용(session JWT)
• 세 번째는 — 특정 컬렉션용(예: 지원 센터를 위한 FAQ만)

각 위젯에는 자체 api-key, 범위 및 인증 모드가 있습니다. 자세한 내용은 통합 → 위젯 및 API 및 위젯을 참조하세요.

#익명 방문자가 보는 것

익명 검색은 기본적으로 기본 rate limiting을 위해 클라이언트 핑거프린트 쿠키를 사용하지만, 요청을 사용자 계정과 연결하지는 않습니다.

#개별 컬렉션 숨기기

Corporate 스페이스에서 모든 컬렉션이 반드시 익명 사용자에게 표시되어야 하는 것은 아닙니다. 특정 컬렉션을 숨길 수 있습니다:

1. 컬렉션의 컨텍스트 메뉴 → 속성
2. 컬렉션의 publish_state 필드:
   • inherit — 스페이스로부터 상속(기본값)
   • internal — 익명 사용자에게는 숨겨지고 팀에게는 표시됨
   • public — 명시적으로 공개(Corporate 스페이스에서만, 그렇지 않으면 차단됨)

이는 유연성을 제공합니다: 예를 들어 공개 "문서" 스페이스에서 publish_state=internal인 Internal Drafts 컬렉션에 초안을 보관할 수 있습니다 — 외부에는 보이지 않지만 편집자에게는 제공됩니다.

#웹사이트에 삽입하기

공개 지식 베이스는 세 가지 방법으로 웹사이트에 통합할 수 있습니다:

각 방법에 대한 자세한 내용은 API 및 위젯 및 통합을 참조하세요.

#White-label 및 커스텀 도메인

공개 지식 베이스는 기본 주소 slug.lynkora.pro에서 제공됩니다. 고급 포털 기능 — white-label(LiKE 브랜딩 없음) 및 커스텀 도메인 연결(설정 → 도메인) — 은 white-label이 활성화된 요금제에 포함되어 있습니다. 이를 위한 별도의 유료 애드온은 없습니다.

어떤 요금제에서 어떤 기능이 어떤 가격에 제공되는지는 요금제 페이지와 관리자 패널을 참조하세요.