자료

TongFlow에 업로드하는 모든 파일 — 이미지, 영상, 오디오, 문서, 3D 모델 — 이 **자료(material)**입니다. 자료는 스튜디오를 실행하는 컴퓨터에 로컬로 저장되며, 포트폴리오 대화상자를 통해 여러 워크플로에서 재사용할 수 있습니다.

자료 라이브러리의 위치

왼쪽 사이드바(워크스페이스 왼쪽 상단)를 봅니다. 세 번째 아이콘 FolderOpen이 포트폴리오 대화상자를 엽니다. 이것이 자료 라이브러리입니다.

[Workflow]  [Tasks (⚡)]  [Portfolio (📁)]   ← three buttons, left-to-right

포트폴리오 대화상자는 스마트 아일랜드에 없습니다. 스마트 아일랜드는 새 노드 추가와 워크플로 실행을, 포트폴리오는 파일 라이브러리를 담당합니다.

업로드할 수 있는 것

정확한 허용 목록은 각 Add 노드의 입력 선택기가 정합니다. 현재 적용 중인 타입 필터는 Add 노드 안의 파일 선택기에서 확인하세요.

파일이 저장되는 방식

• 파일은 로컬 디스크의 data/uploads/ 아래에 저장됩니다.
• 메타데이터(파일명, 크기, 모달리티, MIME 타입)는 data/tongflow.db의 materials 테이블에 있습니다.
• 중앙 CDN은 없습니다. 나중에 자료를 CDN으로 제공하고 싶다면 .env의 NEXT_PUBLIC_FILE_BASE_URL을 해당 CDN으로 설정하세요.

자료 추가하기

자료를 추가하는 방법은 두 가지입니다:

Add 노드 안에서 (가장 흔한 방법)

1. 스마트 아일랜드로 Add 노드를 캔버스에 놓습니다(예: Image 아이콘).
2. 노드 안에 선택기가 나타납니다 — 클릭해서 파일을 고르면 자료가 업로드됩니다.
3. 자료는 그 노드에 연결되는 동시에 포트폴리오에도 등록되어, 나중에 다시 쓸 수 있습니다.

오디오/영상의 경우 Add 노드에서 파일 선택 대신 카메라/마이크 녹음도 가능합니다.

포트폴리오 대화상자에서

1. 포트폴리오를 엽니다(왼쪽 사이드바의 FolderOpen).
2. Upload를 클릭하고 파일을 하나 이상 고릅니다.
3. 자료는 특정 노드에 붙지 않은 채로 등록됩니다 — 나중에 캔버스로 드래그하면 됩니다.

워크플로 간 자료 재사용

자료는 워크플로 단위가 아니라 설치 전체에서 공유됩니다. 재사용하려면:

1. 포트폴리오 대화상자를 엽니다.
2. 자료를 찾습니다(필요하면 모달리티로 필터링).
3. 포트폴리오에서 캔버스로 드래그하거나, 또는 Add 노드의 선택기를 열어 “From Portfolio”를 고릅니다.

자료 자체가 디스크에 복제되지는 않습니다 — 새 노드가 같은 파일을 참조합니다.

자료 삭제하기

포트폴리오 대화상자에서 자료 위에 마우스를 올리고 삭제를 클릭합니다. 파일이 data/uploads/에서 지워지고 데이터베이스 행도 삭제됩니다. 그 자료를 참조하던 노드는 다시 연결하기 전까지 링크 끊김 상태로 표시됩니다.

변환에서 자료가 다뤄지는 방식

변환이 Modal에서 실행될 때 자료는 작업당 한 번 업로드되어 그곳에서 처리됩니다. 출력은 내 컴퓨터로 돌아와 다시 data/uploads/에 저장됩니다. Modal이 파일을 보관하는 범위는 Modal 자체 보존 정책이 정한 것 이상을 넘지 않습니다.

관련 문서

• 스마트 아일랜드 — 노드 추가하기 (자료가 저장되는 곳은 아님)
• 노드 유형 — 어떤 변환이 어떤 자료 종류를 받는지
• 시작하기 — NEXT_PUBLIC_FILE_BASE_URL을 포함한 환경 변수