Operator's Codex

보이지 않는 계산은 어떻게 세계를 움직이는가.
이 사이트는 15개의 제너러티브 아트를 하나의 우주로 연결한 디지털 관측소(Observatory)다.

방문자는 블랙홀 오프닝에서 EMBARK를 눌러 우주로 진입하고, 원하는 작품을 선택하여 각기 다른 수학적 우주로 항해(Voyage)한다. 모든 화면은 Black 기반 컬러 시스템과 Graphite 계조, Swiss 타이포그래피, Breathing motion이라는 하나의 비주얼 언어를 공유한다.

전체 관람 흐름은 네 개의 단계(Stage)로 구성된다.
모든 화면 상태는 sessionStorage를 기반으로 복원되며, 브라우저 뒤로가기(bfcache)를 지원한다.

입력 방식에 따라 조작 방식이 자동으로 나뉜다.
입력 장치가 마우스인 경우 호버 중심으로, 터치인 경우 두 번 탭 방식으로 동작한다.

키보드만으로도 모든 기능을 사용할 수 있다.
접근성 포커스 링이 표시되며, reduce-motion 사용자에게는 모든 워프 애니메이션이 축약된다.

상태 전이와 타이밍, 마커 동작의 기준 사양. 운영 중 동작을 검증하거나 재현할 때 참조한다.

사용자 상태는 서버가 아닌 브라우저 sessionStorage에서 관리하며, 탭을 닫으면 초기화된다. 딥링크 파라미터로 특정 상태에 바로 진입할 수 있다.

모든 작품 목록의 단일 관리 지점(Single Source of Truth)은 index.html의 works 배열이다. 새 작품은 반드시 이 배열에 등록하며, 배열 순서는 작품 번호를 결정한다. 등록 즉시 목록 UI, Preview, 방문 마커가 자동으로 갱신된다. 단, 각 작품 하단의 항해 타임라인(voyage-line)과 Archive(all/index.html)의 카드는 별도로 갱신해야 한다.

{ title:"Kerr Plasma Cathedral",
  poetic:"모든 입자는 결국 침묵 속으로 사라진다.",
  formula:"ds² = −(1 − rₛr/ρ²)dt² + …",
  file:"15-Kerr_Plasma.html" },

Archive 모드는 좌상단 토글의 all/index.html로 연결된다. Cinematic이 큐레이션된 관람 동선이라면, Archive는 전작을 한눈에 보는 목록으로 설계되었다.

기기 등급을 감지해 셰이더 옥타브·별 파티클 수·전력 프로파일을 자동 조절한다. 저사양 디바이스·WebGL 미지원 환경에서도 기본 화면은 항상 안정적으로 유지된다.

정적 호스팅 환경에서는 별도의 빌드 과정 없이 업로드만으로 배포할 수 있다. 공유 시 미리보기 카드가 뜨도록 메타 자산을 함께 관리한다.

프로젝트 유지보수를 위한 핵심 원칙.

전시장에서 사람이 상주하지 않아도 화면이 스스로 관람객을 부르고, 방치되면 처음 상태로 되돌아온다.

Cinematic(루트) 진입 주소에 ?kiosk=1 을 붙여 실행한다
예: kimgunwoo.kr/19th/index.html?kiosk=1.
키오스크 상태는 sessionStorage(odyssey_kiosk) 에 저장되어 작품 페이지까지 이어지며, 브라우저 탭을 닫으면 해제된다.
운영 중 해제하려면 index.html?kiosk=0.