사용자 가이드

0. 사이트 구성 한눈에 보기

1. 시작하기 — 로그인과 회원 등급

• 사이트에 처음 들어오면 자동으로 익명 로그인되어 감상·좋아요·댓글·방명록을 이름 없이 바로 이용할 수 있습니다.
• 화면 우측 상단 메뉴(≡) 또는 상단바의 "로그인"으로 Google 로그인하면 실명(구글 이름) 표시, 관심 작가 팔로우, 마이페이지 등 회원 전용 기능이 열립니다.
• 작가로 등록되면(신청 방법은 12장 참고) 작품·이야기·굿즈를 게시하고 예명을 쓸 수 있으며, 등급에 따라 관리 권한도 생깁니다.

회원 등급

2. 피드 (/)

로그인 화면 대신 열리는 첫 화면입니다. 진행 중인 여러 갤러리의 게시물이 하나의 목록으로 섞여 나옵니다.

상단

• 필터 탭: 전체 / 작품 / 이야기 / 굿즈 / 갤러리 / 팔로잉 — 원하는 종류만 걸러 볼 수 있습니다("갤러리"는 갤러리 자체 소개, "팔로잉"은 내가 팔로우한 작가·갤러리의 게시물만)
• 지금 핫한 전시: 활동 중인 전시를 가로로 스크롤하는 칩 목록. "오픈 예정"인 갤러리도 같은 줄에 뜹니다.
• 상단바 아이콘: 카드/격자 보기 전환, 굿즈 샵 바로가기, 검색(작가 이름), 만들기, 메뉴(로그인 상태·마이페이지·로그아웃)
• 데스크탑 화면에서는 상단에 홈/갤러리 찾기/MY/갤러리 관리/굿즈 텍스트 메뉴가 추가로 보입니다.

게시물 카드

• 좋아요·댓글·공유 — 클릭 시 링크 복사(지원 기기는 시스템 공유 시트)
• 입장하기 / 샵에서 보기 배지 — 작품은 그 작품이 걸린 3D 공간으로, 굿즈는 그 상품 상세로 바로 이동
• 팔로우 버튼 — 아직 팔로우하지 않은 작가/갤러리에만 보임(이미 팔로우 중이면 버튼 자체가 사라짐)
• 운영자다운로드 버튼 — 그 게시물을 SNS(인스타그램 등)에 올릴 수 있는 1080×1080 홍보 이미지를 즉시 만들어 다운로드. 동시에 그 게시물이 가리키는 링크(작품이면 해당 갤러리·작품, 굿즈면 그 상품)를 클립보드에도 복사해줍니다 — 인스타그램은 게시물 캡션/댓글에서 URL을 클릭 가능하게 만들어주지 않으므로, 프로필 "웹사이트" 필드나 스토리 링크 스티커, DM에 붙여넣어 쓰세요.
• 운영자편집·삭제 버튼

만들기 (+)

작가 계정으로 로그인하면 상단바의 "만들기"로 새 게시물을 올릴 수 있습니다.

1. 작품 게시 — 내가 관리하는 갤러리의 작품 하나를 골라 소개 문구와 함께 피드에 공유(3D 공간으로 바로 이동하는 링크 포함)
2. 이야기 쓰기 — 특정 작품에 매이지 않는 자유 형식 글(+ 선택적 사진)
3. 굿즈 게시 — 내가 관리하는 갤러리 굿즈(큐레이터) 또는 Foresto 브랜드 굿즈(운영자)를 피드에 소개

관리하는 갤러리가 없는 방문자가 "만들기"를 누르면 작가 신청 안내로 이동합니다.

3. 갤러리 입장 — 3D 워크쓰루

피드의 "입장하기" 배지, 지금 핫한 전시 칩, 또는 foresto.co.kr/@{갤러리ID}로 직접 입장합니다.

조작 방법 — 모바일(터치)

조작 방법 — 데스크탑(키보드 + 마우스)

화면 구성

• 상단 바: 전시 제목, 언어 선택, 기능 버튼들, 현재 홀 이름·작품 수
• 하단 탭: 홀 간 이동(홀 수는 갤러리마다 다를 수 있음)
• 미니맵(나침반): 좌측 하단, 현재 위치·방향 실시간 표시, 탭하면 확대 지도

상단 버튼

• 로그인 — Google 계정, 다시 탭하면 로그아웃 확인
• BGM — 탭으로 켜기/끄기(홀별로 다른 곡, crossfade), 길게 누르기/우클릭으로 볼륨 슬라이더
• 방명록 — 닉네임(선택)+메시지, 다른 방문자 글도 열람 가능
• 후원하기 — 프리셋 금액 또는 직접 입력 + 응원 메시지(실제 결제는 아직 준비 중)
• 화질 전환(HD/SD) — 저사양 기기는 SD 권장, 설정은 브라우저에 저장

작품 감상

작품을 탭/클릭하면 상세 드로어가 열립니다.

• 이미지(또는 서문 텍스트), 작품명·작가명·설명, 촬영일·촬영지·크기·태그
• 좋아요·코멘트·공유 버튼(순서대로 배치되어 있어 스크롤 없이 바로 보임)
• 굿즈 버튼 — 이 작품과 연결된 굿즈가 있을 때만 나타나며, 누르면 바로 아래에 그 상품(들)이 펼쳐짐
• 댓글 목록·입력창도 "코멘트" 버튼을 눌러야 펼쳐짐(평소엔 최신 댓글 1줄 미리보기만 표시)

다국어

상단 언어 선택(한국어/English/中文)으로 전환. UI와 작품 메타데이터가 함께 바뀌며, 해당 언어 데이터가 없으면 한국어로 표시됩니다. 설정은 브라우저에 저장됩니다.

첫 방문 안내

처음 접속하면 온보딩 코치마크가 상단 버튼들을 순서대로 안내합니다. 한 번 완료하면 이후 방문 시 표시되지 않습니다.

4. 마이페이지 (/mypage)

Google 로그인 후 이용할 수 있습니다.

• 프로필 — 아바타·이름·이메일, 내 UID 복사(운영자에게 계정 등록 요청 시 필요)
• 관심 작가 — 팔로우한 작가·갤러리 목록, 새 게시물 수 표시, 여기서 언팔로우
• 관심 작품 — 좋아요한 작품 목록
• 내가 쓴 글 — 작가 계정일 때만, 내가 게시한 작품·이야기·굿즈 게시물 모음
• 예명 — 작품·이야기·댓글에 표시될 이름(작가 계정 전용)
• 소개 — 작가 프로필 페이지(/artist/{uid})에 표시될 한 줄 소개
• 커뮤니티 링크 — 로그인하면 누구나 노출
• 작가 시작 가이드 링크 — 작가 계정이면 노출
• 큐레이터·운영자굿즈 관리 링크
• 운영자작가 신청 관리·관리자 계정 관리 링크

5. 갤러리 찾기 (/exhibitions)

Foresto에 등록된 모든 갤러리를 카드로 모아 봅니다. 필터: 전체 / 활동중 / 오픈 예정 / 종료.

6. 통합 샵 (/shop)

모든 갤러리의 굿즈와 Foresto 브랜드 굿즈를 한곳에서 봅니다.

• 카드를 누르면 갤러리로 바로 넘어가지 않고 상세 모달(큰 이미지, 가격, 설명, 판매 상태)이 먼저 열립니다.
• 판매 링크가 등록된 상품은 "구매하러 가기" 버튼이 나타나 등록된 외부 판매처(스마트스토어 등)로 이동합니다 — 사이트 내 결제 기능은 아직 없습니다.
• 갤러리 굿즈는 상세 모달 안에 그 갤러리로 가는 링크가 함께 있습니다.

7. 작가 프로필 페이지 (/artist/{uid})

한 작가가 올린 이야기·소개(소개는 마이페이지에서 등록)를 모아 보여줍니다. 피드나 게시물 카드의 작가 이름을 눌러 이동합니다.

8. 커뮤니티 (/community)

로그인(익명 제외)하면 작가든 아니든 누구나 볼 수 있는 게시판입니다. 자유롭게 글을 쓸 수 있고, 운영자는 공지사항으로 표시할 수 있습니다.

9. 관리자 기능 — 3D 갤러리 관리자 패널

큐레이터·운영자로 로그인한 상태로 갤러리에 입장하면 화면 우측 하단에 톱니바퀴 버튼이 나타납니다.

전시 제목 수정

• 전시 제목·부제를 3개 언어로 편집, 전시 상태(진행중/예정/종료) 설정
• 저장 즉시 상단 바·로딩 화면·브라우저 탭 제목에 반영

작품 관리

• 홀별 탭으로 전체 작품을 벽면별 그룹 썸네일 그리드로 조회
• 작품 클릭 → 교체 모달: 이미지 업로드(자동 리사이즈), 제목/작가/촬영지/설명 3개 언어 입력, 촬영일·크기·태그, 작품/서문 유형 전환, 좋아요·코멘트 초기화
• 작품 추가 / ◀·▶로 순서 맞바꾸기 / 전체 선택 후 일괄 삭제
• 운영자균등 배치(벽의 작품들을 좌→우 순서 유지한 채 균등 간격 재배치) / 벽 간 이동·교환(여러 작품을 다른 벽으로 한 번에 재배치) — 단체전에서 작가 간 배치를 조율하는 도구라 전체를 조율할 수 있는 운영자만 사용합니다
• 벽 수를 줄여 배치 벽이 사라진 작품은 "미배치" 그룹에서 재배치

홀 명칭 관리

• 각 홀 이름·탭 라벨을 3개 언어로 편집(큐레이터·운영자 공통)
• 운영자홀 형태 프리셋 — 미리 정의된 형태 버튼(벽 면 수·벽 열기가 세트로 묶여 있음)을 골라 홀 구조를 바꿉니다. 벽이 늘면 홀이 넓어지고, "벽 열기"로 지정한 방향은 그쪽으로 걸어 들어갈 수 있는 열린 공간이 됩니다. 형태를 바꾸면 그 자리에 있던 작품은 "미배치" 상태가 되어 다른 벽으로 재배치해야 합니다.
• 운영자준비중/완전히 숨김 토글 — 잘못 건드리면 전시 전체가 방문객에게 안 보이게 될 수 있어 큐레이터에게는 노출되지 않습니다

BGM 관리

홀별 BGM 파일(MP3) 업로드·제거, 업로드 진행률 표시

굿즈 관리(이 갤러리 소속)

• 상품명·설명(3개 언어), 가격, 판매 링크(선택, 외부 판매처), 판매 상태(판매중/품절/입고예정/준비중), 숨김 여부
• 이미지 최대 3장 업로드
• 연결할 작품(선택) — 특정 작품과 연결하면 그 작품 상세의 "굿즈" 버튼 아래에 노출됨

같은 내용을 /admin-goods(10장)에서도 관리할 수 있습니다 — 둘 다 같은 데이터를 보므로 편한 쪽을 쓰면 됩니다.

통계 운영자

• 전체 작품 수, 좋아요·코멘트 수, 평균 평점
• 총 방문 / 오늘 방문 / 최근 7일 / 최근 30일 방문자 수(세션당 1회 집계, 관리자 본인 접속 제외)
• 최근 14일 방문 추이 그래프
• 작품별 조회수(내림차순), 홀별 작품 수

다크 모드

관리자 패널을 다크 테마로 전환(브라우저에 저장)

드로어 내 관리 버튼

작품 상세 드로어에서 관리자에게만 표시됩니다.

• 편집 — 벽면, X 위치, 너비/높이, 수직 오프셋 조정
• 교체 — 작품 이미지 및 메타데이터 전체 교체
• 피드에 게시 — 이 작품을 피드에 바로 공유

10. 굿즈 관리 (/admin-goods)

브랜드 굿즈와 갤러리 굿즈를 한 화면에서 관리하는 통합 페이지입니다(2026-08-30 개편). Google 로그인 후 큐레이터 또는 운영자 계정이면 접근할 수 있습니다.

• 상단 소스 탭으로 지금 관리할 대상을 고릅니다.
  • 큐레이터: 자신이 관리하는 갤러리(들)만 나타남
  • 운영자: "Foresto"(브랜드 굿즈) + 등록된 모든 갤러리가 나타남
• 탭을 바꾸면 그 소스의 굿즈 목록으로 바뀌고, "새 굿즈 추가"로 등록한 상품은 그 소스에 저장됩니다(갤러리 소스 → 그 갤러리 샵, 브랜드 소스 → 통합 샵에 "Foresto" 출처로 표시).
• 입력 항목은 9장의 "굿즈 관리"와 동일(이름·설명 3개 언어, 가격, 판매 링크, 판매 상태, 숨김, 이미지 최대 3장) — 갤러리 소스를 골랐을 때만 "연결할 작품" 선택란이 추가로 나타납니다.
• 마이페이지·"내 갤러리 관리" 화면 상단, /admin·/admin-accounts 상호 링크에서 바로 이동할 수 있습니다.

11. SNS 이미지 다운로드

피드의 각 게시물 카드에서(운영자 전용 버튼) 인스타그램 등에 바로 올릴 수 있는 1080×1080 정사각형 이미지를 그 자리에서 만들어 다운로드합니다(2장 "게시물 카드" 참고). 사진이 있으면 사진+그라디언트+제목 레이아웃, 없으면(이야기 등) 브랜드 컬러 배경에 글귀만 담은 레이아웃으로 자동 전환됩니다. 다운로드와 함께 그 게시물이 가리키는 링크도 클립보드에 복사되므로, 이미지와 함께 SNS 프로필 링크나 스토리에 붙여넣어 쓰면 됩니다.

12. 작가 신청 및 승인

신청 (/about#apply)

1. /about 하단 "작가 등록 신청" 섹션에서 Google 로그인
2. 신청 플랜(현재는 씨앗만 선택 가능), 갤러리 ID(영문, 예: hyangwon2), 이름, 연락처, 유입 경로, 소개 메시지, 샘플 이미지(선택)를 입력하고 이용 정책 동의 체크 후 제출
3. 씨앗 플랜은 운영자 검토 없이 제출 즉시 셀프 승인됩니다(landing/apply.js selfApprove()) — 계정에 이미 다른 갤러리가 있는 등 셀프 승인 조건을 못 채우면 그때만 아래 운영자 수동 승인으로 자동 전환됩니다

승인 (/admin, 운영자 전용) — 셀프 승인이 안 된 예외 건만

• 대기 중인 신청을 카드로 확인(신청 플랜·유입 경로, 샘플 이미지 확대 보기 포함)
• 승인하면 신청서의 플랜 값에 따라 홀이 생성되고(씨앗=1개, 그 외=3개) 해당 계정이 그 갤러리의 큐레이터로 등록됩니다
• 거절도 가능

13. 관리자 계정 관리 (/admin-accounts) 운영자

• 기존 관리자 계정별로 큐레이터/작품 작가로 소속된 갤러리를 체크박스로 조회·수정
• 새 관리자 계정을 UID+이메일로 직접 등록(소속 갤러리 체크박스 지정)
• 새 갤러리 만들기 — 갤러리 ID·운영 계정을 지정해 새 갤러리를 바로 생성

isOperator(운영자 권한) 자체는 이 화면에서 부여할 수 없습니다 — Firebase 콘솔에서 수동으로만 설정됩니다(악용 방지).

14. 오프라인 지원

• Service Worker가 등록되어 재방문 시 빠른 로딩을 지원합니다
• HTML: 네트워크 우선(오프라인 시 캐시) / 에셋·오디오: 캐시 우선
• Firebase 미연결 시 하드코딩된 기본 전시 데이터로 동작합니다

15. 시스템 요구사항

저사양 기기에서는 3D 갤러리 안의 SD 화질 모드를 사용하면 성능이 향상됩니다.