콘텐츠
Information 화면을 이루는 상시 활성 Knowledge·Document Library·Communications 기능을 설명합니다.
콘텐츠
App에서 Knowledge나 통제 문서를 참조할 때 아래의 안정적인 Resource key를 사용하세요. Content 모델을 import하지 않고 Resource Reference로 참조를 해석합니다. 결과에는 게시·대상자·레코드 권한이 계속 적용되며 App 설치가 이 Core 기능을 활성화하거나 권한을 부여하지 않습니다.
제공하는 기능
Content는 Shell의 Information 화면을 이루는 Core 소유 기능군입니다. 같은 navigation·권한 기반을 사용하지만 서로 다른 레코드와 lifecycle 규칙을 가진 세 상시 활성 기능을 묶어 설명하는 이름입니다.
| 기능 | 소유하는 것 | 안정적인 Resource key |
|---|---|---|
| Knowledge | 비정형 article, locale revision, taxonomy, audience, feedback, 통제된 Agent 검색 | knowledge.article |
| Document Library | 통제 문서, immutable version, acknowledgement, hold, retention | document.record, document.version |
| Communications | Board와 게시글·banner·popup을 통한 tenant 전체 전달 | communication.board, communication.board_post, communication.banner, communication.popup |
화면 경로와 접근 권한
내부 domain은 Knowledge, Document Library, Communications지만 제품 화면 이름은 Information입니다.
| 계층 | Knowledge | Document Library | Communications |
|---|---|---|---|
| Reader route | /content/knowledge | /content/documents | /content/boards와 전달 화면 |
| 관리 route | /content/management/knowledge | /content/management/documents | /content/management/{boards,board-posts,banners,popups} |
| 운영 route | 관리 화면 안 editorial 상태 | /content/operations/documents | 각 전달 Resource의 audience·receipt 증거 |
| 기본 읽기 권한 | knowledge.article.read | document.record.read | Communications Resource별 read 권한 |
Shell은 /content/* layout과 navigation context를 소유합니다. 각 domain은 자기
API와 model, Policy, lifecycle service, Resource 전용 React 화면을 소유합니다.
Route middleware가 tenant-wide permission이 없는 actor를 먼저 거부하고, Policy와
domain query가 record visibility, confidentiality, publication window, audience,
lifecycle 규칙을 적용합니다.
안정적인 Resource key 덕분에 교차 기능이 Core model 이름 없이 콘텐츠를 참조할
수 있습니다. Knowledge는 GET /api/knowledge/agent-search에서 citation이 포함된
read-only Agent 검색을 제공합니다. Document Library는 표준 Resource Reference
envelope로 App 레코드 링크를 보존할 수 있습니다. Communications는 audience를
해석하고 전달·읽기 증거를 기록하지만 audience 정의를 별도 권한 범위로 만들지
않습니다.
연동 규칙
Content는 상시 활성 Core 기능이지 App Package가 아닙니다. Production App 코드는
App\Core\Knowledge, App\Core\DocumentLibrary, App\Core\Communications나 그
frontend 소스를 import하면 안 됩니다. App은 안정적인 Resource Reference,
Core-governed event·projection, 또는 가장 작은 App 중립 SDK capability로 경계를
넘습니다.
Content 기능군은 설치 콘텐츠와도 다릅니다. 설치 콘텐츠는 App이 운영 상태가 되기 위해 필요한 schema나 seed data입니다. Knowledge, Document Library, Communications는 자체 레코드와 lifecycle을 가진 제품 runtime입니다.
일반 Media·Attachment primitive는 보통 파일을 저장하지만, 통제 문서 binary는 Document Library의 stage 검사·추출·binding·retention 경로를 사용합니다. 또한 Communications receipt는 전달된 post·banner·popup에 관한 증거입니다. Notification row나 lifecycle을 공유하지 않습니다.
Frontend visibility는 backend authority를 부여하지 않습니다. 관리 route나 action을 숨기는 것은 interface만 바꿉니다. API middleware와 Policy, tenant context, Resource별 규칙이 모든 읽기·쓰기를 계속 결정합니다.
Knowledge 검색 예시
Knowledge의 Agent 검색은 이 계층들이 함께 작동하는 사례입니다. 조회 과정은 다음과 같습니다.
KnowledgeAgentContributor는GET /api/knowledge/agent-search에knowledge.article.search라는 read-only tool 하나를 공개합니다.- Tool은
knowledge.article.read를 요구하고 API route도 같은 middleware 권한을 사용합니다. - 통제된 조회는 publication window 안의 사용 가능한 locale revision만 고르고 Article audience 규칙을 적용합니다.
- 결과는 안정적인 article·revision identity와 citation data를 담습니다. Draft, expired, archived, audience-excluded revision은 나오지 않습니다.
App이나 Agent는 Article model을 import하거나 authoring 상태에 접근하지 않고도 통제된 Knowledge를 소비할 수 있습니다. 안정적인 API와 Resource identity만 경계를 넘고 publication·audience truth는 Core에 남습니다.
관련 문서
- Shell 레이아웃 영역 — Tenant Shell에서 Information route가 놓이는 곳
- 권한과 역할 — 콘텐츠 접근 전에 검사하는 tenant-wide authority
- Resource Reference — model을 import하지 않고 콘텐츠나 App 레코드 참조
- 이벤트와 비동기 작업 처리하기 — 직접 package 의존 없이 통제된 변경 소비