Photonemo Kiosk

설치 가이드

Photonemo Kiosk 설치 방법

Photonemo Kiosk를 설치하는 방법을 안내합니다. 키오스크 데스크톱 앱 설치와 개발자용 설치로 구분됩니다.

시스템 요구사항

Photonemo Kiosk를 실행하기 위해 다음 환경이 필요합니다.

항목요구사항
운영체제Windows 10 이상 (64비트)
디스플레이물리 해상도 1920x1200, 배율(DPR) 150% 설정 권장 (CSS 기준 1280x800)
카메라USB 웹캠 1대 이상
프린터포토 프린터 (선택사항)
네트워크인터넷 연결 필수 (백엔드 서버 통신, QR 코드 생성 등)

키오스크 데스크톱 앱 설치

하드웨어에 키오스크를 설치할 때 사용하는 방법입니다. 설치 파일을 통해 간편하게 설치할 수 있습니다.

  1. 제공받은 설치 파일(PHOTONEMO-COLOR-INSTALL-{버전}-x64.exe)을 실행합니다.
  2. 설치 마법사의 안내에 따라 설치를 진행합니다.
  3. 설치가 완료되면 바탕화면에 PHOTONEMO-COLOR 바로가기가 생성됩니다.
  4. 바로가기를 더블클릭하여 앱을 실행합니다.

설치 후 앱이 자동으로 실행됩니다. 이후 컴퓨터를 켤 때마다 앱이 자동으로 시작되도록 설정할 수 있습니다.

앱 업데이트

앱은 인앱 업데이트를 지원합니다. 업데이트 절차는 다음과 같습니다.

  1. 관리자 모드 진입 후 사이드바에서 버전 정보를 선택합니다.
  2. 업데이트 확인 버튼을 눌러 새 버전이 있는지 확인합니다.
  3. 새 버전이 있으면 지금 다운로드 버튼을 눌러 업데이트 파일을 받습니다.
  4. 다운로드 완료 후 재시작 및 설치 버튼을 누르면 앱이 재시작되며 업데이트가 적용됩니다.

업데이트는 데스크톱 앱 환경에서만 동작합니다. 재시작 시 진행 중인 촬영이 없는지 확인 후 진행하세요.

앱 제거

Windows 설정의 앱 및 기능에서 PHOTONEMO-COLOR을 찾아 제거할 수 있습니다. 제거 시 앱 데이터도 함께 삭제됩니다.

개발 환경 설치 (개발자용)

Photonemo Kiosk를 직접 빌드하거나 개발에 참여하시는 분을 위한 안내입니다.

사전 준비

다음 도구들이 설치되어 있어야 합니다.

도구버전용도
Node.js24.x런타임 환경
pnpm9.15 이상패키지 매니저 (npm 사용 불가)
Docker & Docker Compose최신 버전백엔드 서비스(DB, 스토리지) 실행
Git최신 버전소스 코드 관리

의존성 설치

프로젝트 루트 디렉터리에서 다음 명령어를 실행합니다.

pnpm install

공유 패키지를 먼저 빌드합니다. 이 단계를 건너뛰면 다른 앱의 빌드가 실패할 수 있습니다.

pnpm -F @photonemo/shared build

백엔드 서비스 실행

백엔드 API가 사용하는 데이터베이스(PostgreSQL)와 파일 저장소(MinIO)를 Docker로 실행합니다.

docker compose up -d

이 명령어를 실행하면 다음 서비스가 시작됩니다.

서비스포트설명
PostgreSQL5432데이터베이스
MinIO S3 API9000파일 저장소
MinIO Console9001파일 저장소 관리 화면

서비스가 정상적으로 시작되면 최초 실행 시에만 데이터베이스 마이그레이션을 실행합니다.

pnpm -F @photonemo/backend migration:run

마이그레이션이 완료되면 백엔드 개발 서버를 실행합니다.

pnpm -F @photonemo/backend dev

백엔드 서버는 포트 4000에서 실행되며, /api-docs 경로에서 API 문서를 확인할 수 있습니다.

개발 서버 실행

용도에 따라 다음 명령어 중 하나를 선택하여 실행합니다.

# 웹 + 백엔드 동시 실행 (가장 일반적)
pnpm dev

# 웹 프론트엔드만 실행 (포트 3000)
pnpm dev:web

# 웹 + 백엔드 + Electron 한번에 실행
pnpm dev:full

웹 개발 서버가 시작되면 브라우저에서 http://localhost:3000으로 접속하여 키오스크 화면을 확인할 수 있습니다.

pnpm dev:full은 Next.js가 준비된 후 자동으로 Electron을 실행하므로, 별도 터미널에서 수동으로 실행할 필요가 없습니다.

Electron 앱 빌드

Windows용 설치 파일을 직접 빌드하려면 다음 명령어를 실행합니다.

pnpm run dist:win

빌드가 완료되면 apps/electron/dist/ 폴더에 설치 파일이 생성됩니다.

On this page

시스템 요구사항키오스크 데스크톱 앱 설치앱 업데이트앱 제거개발 환경 설치 (개발자용)사전 준비의존성 설치백엔드 서비스 실행개발 서버 실행Electron 앱 빌드