용어집

이 문서에서 사용되는 각 용어에 대한 단일 표준 정의입니다.

Artifact

컴파일된 objectstack.json 파일. 앱에 대한 자체 완결형이며 변경 불가능한 설명 — 매니페스트, 객체, 뷰, 앱, 플로우, 권한, 번역. os compile로 생성됩니다. ObjectOS가 실제로 실행하는 대상입니다.

Action

메타데이터에 선언된 이름 있는 작업으로, REST (/api/v1/data/<object>/actions/<action>), Console 버튼, 또는 플로우 단계를 통해 호출할 수 있습니다. 호출자의 권한을 상속합니다.

Adapter

ObjectStack를 호스트 런타임과 통합하는 프레임워크 패키지 — Express, Fastify, Hono, Next.js, Nuxt, SvelteKit, NestJS. 대부분의 ObjectOS 배포에는 어댑터가 필요하지 않습니다. ObjectOS는 자체 HTTP 서버를 번들로 제공합니다.

App

Console에서 하나의 탐색 가능한 애플리케이션으로 표현되는 객체 + 뷰 + 권한의 묶음입니다. 하나의 런타임에 여러 앱이 공존할 수 있습니다 (예: CRM + Helpdesk + Setup).

Better Auth

@objectstack/plugin-auth를 구동하는 인증 라이브러리입니다. Better Auth를 직접 구성하지 않으며, 플러그인이 이를 감쌉니다.

Capability

아티팩트가 자신의 requires 목록에 선언하는 선택적 런타임 기능입니다. 패키지에 매핑됩니다 — 예: audit → @objectstack/plugin-audit. ObjectOS가 필요에 따라 로드합니다. 다음을 참조하세요: Runtime Capabilities.

CEL

Common Expression Language — Google의 안전하고 샌드박스화된 표현식 구문입니다. 수식, 유효성 검사 규칙, 권한 술어, 공유 규칙, 플로우 조건에서 사용됩니다.

Console

/_console/의 시스템 UI — 사용자, 역할, 권한 집합, 감사 로그, 세션, API 키, 시스템 설정을 관리합니다. Console (비즈니스 UI)와 구별됩니다.

Control Plane

버전 관리된 아티팩트를 ObjectOS 인스턴스에 게시하는 선택적 서비스입니다. ObjectStack Cloud로 호스팅되거나 자체 호스팅됩니다. 대부분의 배포에는 필요하지 않으며, 파일 기반 모드로 단일 앱 프로덕션을 운영할 수 있습니다.

Driver

데이터 백엔드 구현체입니다: driver-sql (Postgres, MySQL, SQLite, Turso/libSQL), driver-mongodb, driver-memory. 부팅 시 데이터베이스 URL을 통해 선택됩니다.

Embedder

RAG / 시맨틱 검색을 위해 텍스트를 벡터로 변환하는 서비스입니다. 여러 공급자에 걸쳐 교체 가능합니다 (OpenAI, Azure, 硅基流动, Ollama, …). 다음을 참조하세요: AI Service.

Environment

자체 데이터베이스와 ID로 뒷받침되는 테넌트별 런타임 인스턴스입니다. v4.x에서는 때때로 Project라고 불렸습니다 (별칭 유지). v5.0은 CLI, HTTP, 환경 변수, 스키마 전반에서 Environment로 표준화합니다.

Field

Object의 형식 지정 속성입니다. 약 48개의 기본 제공 타입: text, select, lookup, markdown, file, formula, summary 등. 다음을 참조하세요: Data Model.

Flow

선언적 비즈니스 로직 — 자동 실행(레코드 트리거), 예약 실행 (cron), 또는 수동 실행(버튼 / API). 조건/루프/재시도/병렬 프리미티브를 갖춘 DAG로 실행됩니다. 다음을 참조하세요: Flows & Automation.

Formula field

값이 읽기 시점에 평가되는 CEL 표현식인 계산 필드입니다. 저장되지 않습니다.

Hook

객체 수명 주기(beforeInsert, afterUpdate, …)에 삽입되는 함수입니다. TypeScript로 작성됩니다. 플로우와는 다릅니다: 훅은 일급 코드이고, 플로우는 메타데이터입니다.

Kernel

플러그인을 로드하고, DI 컨테이너를 보유하며, 이벤트를 디스패치하고, 단일 Environment의 메타데이터를 제공하는 ObjectOS 내부의 마이크로커널입니다. 하나의 프로세스는 LRU 방식으로 여러 캐시된 커널(Environment당 하나)을 보유할 수 있습니다.

Manifest

아티팩트의 맨 앞에 있는 최상위 메타데이터입니다: id, namespace, version, type (app / plugin / service), name, description, requires 목록.

Marketplace

설치 가능한 앱의 Console 내 카탈로그입니다. 구성 가능한 패키지 레지스트리로 뒷받침됩니다. 다음을 참조하세요: Marketplace.

MCP (Model Context Protocol)

AI 에이전트가 도구를 검색하고 호출하기 위한 개방형 프로토콜입니다. ObjectOS는 @objectstack/plugin-mcp-server를 통해 자신의 객체 + 액션을 MCP로 노출할 수 있습니다.

Object

형식 지정된 비즈니스 엔터티입니다 — task, account, invoice. TypeScript 스키마로 선언되며, REST API, Console 뷰, 감사 항목, RBAC 체크포인트를 자동으로 생성합니다. 다음을 참조하세요: Data Model.

ObjectOS

런타임 — 앱을 제공하는 단일 Node.js 프로세스입니다. 오픈 소스, Apache-2.0. 이 문서 사이트는 ObjectOS를 위한 것입니다.

ObjectQL

데이터 계층 프로토콜 및 쿼리 엔진입니다. 선언적 쿼리를 네이티브 SQL / Mongo 쿼리로 컴파일합니다. REST 엔드포인트, Console, 플로우에서 사용되며 — 모두 동일한 엔진입니다.

ObjectStack

상위 프로젝트입니다: 프레임워크(@objectstack/* npm 패키지), 런타임(ObjectOS), 선택적 클라우드 서비스, 그리고 marketplace. 때때로 "플랫폼"이라고 불립니다.

ObjectUI

뷰 계층 프로토콜입니다 — 앱, 뷰, 페이지, 대시보드, 액션, 차트, 내비게이션. Console은 ObjectUI 선언을 렌더링합니다.

Permission Set

권한 부여의 묶음입니다 — 객체 권한, 필드 권한, 시스템 권한. 사용자에게 직접 또는 역할을 통해 연결됩니다. 기본 권한 부여 단위입니다. 다음을 참조하세요: Permissions.

Plugin

런타임을 하나의 기능으로 확장하는 프레임워크 패키지입니다 — plugin-auth, plugin-security, plugin-audit, plugin-webhooks, plugin-mcp-server 등. DI + 수명 주기 훅 (init → start → destroy)을 통해 활성화됩니다.

Project

Environment의 이전 이름입니다. v4.x CLI/환경에서 여전히 사용됩니다(별칭 처리). v5.0에서 제거되었습니다.

Record Share

특정 사용자 / 역할 / 그룹에 대해 특정 레코드에 대한 접근 권한을 직접 부여하는 것입니다. sys_record_share 행으로 저장됩니다. 공유 규칙(선언적 기준)과는 다릅니다.

Sharing Rule

기준에 따라 레코드 접근 권한을 부여하는 선언적 규칙입니다 ("지역 관리자는 자신의 지역에 있는 레코드를 볼 수 있다"). 쿼리 시점에 평가되어 행 수준 필터로 컴파일됩니다.

Console

/_console/의 비즈니스 UI — 레코드를 탐색, 생성, 편집하고, 뷰를 구성하며, marketplace에서 앱을 설치합니다. Console(시스템 UI)과 구별됩니다.

Surface

실행 중인 ObjectOS가 노출하는 네 가지 HTTP 진입점 중 하나입니다: / (REST API), /_console/, /_account/, /_console/.

System Context

보안 검사를 우회해야 하는 플러그인, 훅, 시드 스크립트가 사용하는 내부 실행 모드입니다. 감사 가능하며, 사용자 코드에는 노출되지 않습니다.

Tenant

멀티테넌트 배포에서의 논리적 격리 경계입니다. 하나의 테넌트는 일반적으로 하나의 Environment에 매핑됩니다. 쿠키와 세션은 호스트명별로 범위가 지정되고, 데이터는 Environment별로 범위가 지정됩니다.

Trigger

플로우를 실행하는 조건입니다 — 레코드 이벤트(after_insert), 예약(cron), 또는 수동 호출.

View

Object에 연결된 선언적 UI 구성입니다 — 목록, 폼, 칸반, 캘린더, 간트. Console이 이를 렌더링하며, 컴포넌트를 직접 작성하지 않습니다.

Zod schema

@objectstack/spec이 사용하는 런타임 + 컴파일 타임 타입 시스템입니다. 모든 객체, 필드, 뷰, 앱, 플로우는 Zod 스키마로 파싱되고 검증됩니다. JSON Schema, TypeScript 타입, REST 요청 검증기는 모두 동일한 Zod 정의에서 파생됩니다.