# 자료 모듈 개요

> 6가지 진입로의 역할, 통합 인스펙터, 색상과 엔티티 식별, 모듈 간 연결 방식 및 기능 경계를 설명합니다.

Source: https://loomworld.ai/ko/docs/modules-overview

## 자료 모듈이 필요한 이유

장편 창작에서 가장 큰 비용이 드는 것은 타이핑이 아니라 기억하는 일입니다. 3장에 등장한 조연 인물이 30장에 이르러 갑자기 성격이 바뀌어서는 안 되며, 1막에서 던져둔 복선은 5막에서 적절히 회수되어야 합니다. “오래된 찻집”과 “월래 찻집”이 동일한 장소인지 기억력 테스트를 치르듯 고민할 필요도 없어야 합니다. 자료 모듈은 작가가 내린 이러한 설정 결정을 안전하게 보관합니다: 6가지 범주의 콘텐츠가 각자의 사실을 전담하며, 본문에서 자유롭게 인용되고, 집필 내용에 따라 자동 통계가 집계되며, AI 어시스턴트에게도 정확히 전달됩니다.

하나의 판단 기준이 있습니다: 각본 본문은 “실제로 일어난 일”을 적는 곳이고, 자료 보관함은 “작가가 명확히 인정한 사실”을 보관하는 곳입니다. 따라서 자료는 저절로 증식하지 않습니다 — 두 가지 실제 연동 경로(인물 행 입력 시 인물 등록, 대괄호 입력 시 소품 등록)를 제외한 모든 카드는 작가가 직접 등록하고 관리합니다.

## 6가지 진입로와 담당 기능

인물

명부 및 관계도: 5단계 중요도 티어, 직접 구축하는 관계선, 소속 세력, 장별 상태 변화, 등장 횟수 통계.

장소

데이터와 지도의 2개 레이어: 상하 계층이 단일 진실 공급원 역할을 하며, 지도는 3D 또는 평면으로 구성하거나 지도 없이 관리할 수도 있습니다.

소품

손에서 손으로 이동하는 사물: 분류 및 태그, 5단계 서사 가중치, 소유자 및 관계 메모, 각본 등장 기록.

세계관 설정

5가지 항목 분류: 세력 및 조직 분류는 인물 소속의 진실 공급원을 겸하며, 우측에 랭킹 사이드바가 배치됩니다.

타임라인

다중 플롯 관리: 전후 순서를 다루는 카드 플로우, 연도와 기간을 다루는 스케일 축, 각본의 특정 위치에 연결 가능한 사건.

복선

리듬 패널의 복선 관리 보드: 설치, 강화, 회수의 3대 앵커와 전개 간격 및 장기 방치 경고 자동 계산.

처음 5가지 모듈은 좌측 내비게이션에 독립된 페이지를 가지며, 복선은 “리듬” 패널 아래에 위치합니다. 리듬 페이지는 작품 전체의 건강 상태를 점검하는 종합 대시보드이기도 합니다: 장별 컬러 블록 위의 전개 밀도 곡선, 인물 등장 히트맵, 소품 등장 히트맵, 복선 관리 보드가 한 화면에 표시됩니다. 밀도 곡선은 글자 수, 씬 전환 횟수, 등장인물 수, 장소 변화, 소품 참조 데이터를 종합하여 하나의 시각적 선으로 표현할 뿐, 어디가 클라이맥스인지 자의적으로 판정하지 않습니다.

## 어느 위치에서든 카드를 여는 통합 인스펙터

세계관 텍스트 속의 참조 태그, 히트맵의 이름, 밀도 곡선 아래의 장별 블록 등 어디를 클릭하든 동일한 인터페이스가 열립니다: 우측에 요약 정보를 보여주는 플로팅 인스펙터가 나타나며, “Expand Details →”(상세 보기)를 클릭하여 정식 편집 창으로 전환할 수 있습니다. 인물, 소품, 장소, 장, 세계관 설정 카드 모두 이 단일 방식을 공유하므로 조작법을 여러 개 익힐 필요가 없습니다.

- **간략히 보기(Peek)**플로팅 인스펙터는 해당 카드의 핵심 요점과 직접적인 하위 장소 등 최소한의 맥락을 보여줍니다. 이름이 입력되지 않은 카드는 '이름 없는 인물', '이름 없는 장소', '이름 없는 소품', '이름 없는 설정', '이름 없는 장'으로 표시됩니다.

- **편집을 위한 확장(Expand to edit)**“Expand Details →”(상세 보기)를 누르면 해당 모듈 고유의 서랍이나 대화상자 형태로 전체 편집 창이 열립니다.

- **우측 서랍은 인물 전용(Only characters use the right drawer)**소품, 세계관 설정, 장소 등은 클릭 시 기본적으로 화면 중앙에 대화상자가 팝업됩니다. 오직 인물 상세 정보와 인물 관계 편집기만 우측의 비모달 서랍을 유지하는데, 이는 캔버스 관계망을 눈으로 확인하면서 동시에 편집해야 하기 때문입니다.

## 색상과 엔티티 식별

소품 대표색, 장 색상, 복선 색상, 장소 색상은 모두 동일한 64색 그리드 팔레트(8가지 색조 × 8가지 명도, 현재 색상 견본 클릭 시 팝업)에서 선택합니다. 새 소품, 장, 복선 생성 시에는 색상표 중간 행을 기준으로 순환 배정되므로 매번 직접 색을 고를 필요가 거의 없습니다. 장소와 복선은 색상을 지우는 것도 허용되며, 지우면 장소는 무색으로 남고 복선은 중요도에 따라 자동 색상이 지정됩니다. 인물에는 별도의 색상 필드가 없으며 인물의 중요도 티어가 카드의 색상을 결정합니다.

이름, 별칭, 티어, 소속 관계는 문자열이 아닌 고유 식별값(엔티티 ID)으로 저장되므로, 이름을 변경하더라도 본문을 찾아 바꾸기(Find & Replace)할 필요가 전혀 없습니다. 다른 모듈에 직접적인 영향을 미치는 것은 삭제 동작입니다: 인물을 삭제하면 해당 인물의 관계선이 함께 제거되고, 각본에서 참조 중인 장소는 삭제가 차단되며, 줄거리 라인을 삭제하면 그 라인에 속한 사건들이 연쇄 삭제됩니다.

## 모듈 간의 상호 연결 구조

6가지 모듈은 고립된 섬이 아닙니다: 인물은 특정 장소에 머물며 세력에 소속되고, 소품은 인물의 손에서 손으로 전달되며, 사건은 각본의 특정 위치에 연결되어 관련 인물과 사물을 명시하고, 복선은 장과 씬에 단단히 닻을 내립니다. 연결은 두 가지 유형으로 나뉘며 서로 다른 규칙이 적용됩니다:

- 식별형 연결(인물-세력, 장소-상위 장소, 씬-장소, 인용-설정 항목): 엔티티 객체 자체를 저장하므로 이름을 바꾸어도 자동 반영되며 삭제 보호가 적용됩니다.
- 정보형 연결(장, 씬, 시공간, 본문 블록, 설정, 타임라인, 복선 간의 포인터): 위치 식별과 바로가기 이동만 담당하며 대상 모듈을 임의로 덮어쓰지 않습니다.

상세한 연결 규칙은 [엔티티 참조와 @](https://loomworld.ai/ko/docs/references) 및 [모듈 간 연동](https://loomworld.ai/ko/docs/cross-sync)에 나와 있습니다; 모듈별 실무 가이드는 [인물](https://loomworld.ai/ko/docs/module-characters), [장소](https://loomworld.ai/ko/docs/module-locations), [소품](https://loomworld.ai/ko/docs/module-props), [세계관 설정](https://loomworld.ai/ko/docs/module-lore), [타임라인](https://loomworld.ai/ko/docs/module-timeline) 및 [복선](https://loomworld.ai/ko/docs/module-foreshadowing)에서 확인하실 수 있습니다.

## 기능적 경계

자료 모듈이 수행하지 않는 작업: 줄거리의 극적 효과를 자동 판정하지 않으며, 특정 인물이 너무 오래 등장하지 않았다고 간섭하거나 잔소리하지 않습니다. 설정 항목이나 분류를 제멋대로 자동 완성하지 않으며, 누가 주인공인지 대신 결정하지도 않습니다. 모든 통계 수치는 작가가 직접 작성한 각본 본문에서 산출되며, 모든 사실 데이터는 작가가 명시적으로 저장한 내용에 근거합니다.