> ## Documentation Index
> Fetch the complete documentation index at: https://docs.starfort.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 모듈 인스턴스

> Starfort v1.4는 프로젝트 리소스를 모듈 인스턴스 모델로 일반화합니다. Project Type과 모듈 두 축, 엔타이틀먼트, Kill Switch 범위를 설명합니다 (Starfort v1.4 문서)

v1.4는 "Project 안의 Project Guardian(들)"이라는 기존 자원 모델을 **모듈 인스턴스(Module Instance)** 개념으로 일반화합니다. [Stratum](/ko/v1.4/concepts/stratum)을 기존 플랫폼에 얹는 방식의 근간이자, 이후 모듈 확장의 토대입니다.

## 두 직교 축 — Project Type × 모듈

플랫폼 자원은 서로 독립적인 두 축으로 표현됩니다.

| 축                | 정의                    | 값                              | 성격                     |
| ---------------- | --------------------- | ------------------------------ | ---------------------- |
| **Project Type** | 트래픽이 들어오는 방식(연동 형태)   | API · Desktop Agent            | Project 생성 시 확정, 변경 불가 |
| **모듈(Module)**   | 무엇을 검사하는가(capability) | Guardian(텍스트 입력) · Stratum(파일) | Project 안에서 생성·삭제      |

두 축이 독립이므로 "Desktop Agent Project이면서 Guardian과 Stratum을 함께 쓰는" 조합이 한 Project 안에서 자연스럽게 표현됩니다.

## 모듈과 모듈 인스턴스

**모듈**은 검사 종류를 나타내는 타입 레벨의 개념입니다 — Guardian은 텍스트 입력을, Stratum은 파일을 관할합니다. **모듈 인스턴스**는 Project 안에 생성된 모듈의 구체 인스턴스이며, 개별 지칭은 기존 관례대로 **Project Guardian**과 **Project Stratum**입니다. Project Guardian이 첫 사례이고 Project Stratum이 두 번째입니다.

한 Project는 여러 모듈 인스턴스를 가질 수 있습니다. 모듈은 `/aim`(System)에 모듈 타입으로 등록되고, Project가 이를 선택해 인스턴스화합니다 — System Guardian 등록 → Project Guardian 생성이라는 기존 2계층 구조를 그대로 재사용한 것입니다.

## 입력 유형별 라우팅

한 Project에 어떤 모듈 인스턴스가 있는지에 따라 입력 유형(텍스트/파일)별 담당이 정해집니다. Control Profile에는 모듈별로 인스턴스를 1개씩(Guardian 1개와 Stratum 1개, 둘 다 또는 한쪽만) 할당할 수 있고, 게이트웨이가 입력 유형에 따라 담당 모듈로 분기합니다. 모듈 간 결과는 교차 취합하지 않습니다.

| 모듈 구성              | 텍스트 입력         | 파일 입력                  |
| ------------------ | -------------- | ---------------------- |
| Guardian + Stratum | Guardian(가드레일) | Stratum(등급 판별)         |
| Guardian only      | Guardian       | Guardian(가드레일) — 기존 동작 |
| Stratum only       | (검사 없음)        | Stratum(등급 판별)         |

## 엔타이틀먼트 — 구매·라이선스 층

모듈의 사용 자격은 **엔타이틀먼트**로 통제되며, 이는 모듈 인스턴스 운용과 다른 층입니다.

| 층                      | 주체                            | 의미                                                                         |
| ---------------------- | ----------------------------- | -------------------------------------------------------------------------- |
| **엔타이틀먼트** (구매·라이선스)   | `/aim`의 System Admin(플랫폼 운영자) | "이 고객사가 이 모듈을 쓸 자격이 있는가" — 세일즈 합의로 부여되는 단독 구매 또는 번들. 고객사는 콘솔에서 조작할 수 없습니다  |
| **모듈 인스턴스 생성·삭제** (운영) | 고객사 콘솔(Admin)                 | 부여받은 자격 범위 안에서 Project에 모듈 인스턴스를 생성하거나 삭제 — 단순 on/off 토글이 아니라 자원의 생성·삭제입니다 |

엔타이틀먼트는 모듈별로 부여됩니다(Guardian만, Stratum만, 또는 둘 다). Stratum 엔타이틀먼트와 인스턴스만으로 Guardian 구매 없이 파일 등급 판별이 동작하므로, 모듈 단독 판매가 성립합니다.

## 인스턴스 생성·삭제와 Kill Switch

모듈을 통제하는 두 수단은 의미가 다릅니다.

* **인스턴스 생성·삭제** — 일반 운용입니다. 계획된 중단은 인스턴스 제거로, 판별 없는 운용은 정책 미할당 상태로 표현합니다.
* **[Kill Switch](/ko/v1.4/admin/kill-switch)** — 비상 차단 전용입니다. v1.4는 Kill Switch tier에 모듈 인스턴스(Project Guardian · Project Stratum) 단위를 포함해, **Organization / Project / 모듈 인스턴스** 단위로 발동할 수 있습니다. Project 전체를 멈추지 않고 특정 모듈만 비상 차단할 수 있습니다.

모듈 인스턴스에 별도의 일반 운용 토글(활성/비활성)은 없습니다 — Kill Switch는 비상 발동 전용이며, Guardian 인스턴스에 그런 토글이 없는 것과 동일합니다.

## 더 알아보기

<CardGroup cols={2}>
  <Card title="Guardian" icon="shield-halved" href="/ko/v1.4/concepts/guardian">
    텍스트 입력을 관할하는 모듈 — 콘텐츠를 검사하고 PASS / MASK / BLOCK을 판정합니다.
  </Card>

  <Card title="Stratum" icon="layer-group" href="/ko/v1.4/concepts/stratum">
    파일을 관할하는 모듈 — 문서를 등급으로 판별하고 외부 전송을 통제합니다.
  </Card>

  <Card title="조직 계층" icon="sitemap" href="/ko/v1.4/concepts/organization-hierarchy">
    Company › Organization › Project, 그리고 모듈 인스턴스가 놓이는 위치입니다.
  </Card>

  <Card title="Kill Switch 사용하기" icon="power-off" href="/ko/v1.4/admin/kill-switch">
    Organization / Project / 모듈 인스턴스 단위의 비상 차단입니다.
  </Card>
</CardGroup>
