사진 아카이브 시스템

Outline

승인된 사용자만 사진을 업로드하고, 개인 갤러리 및 공유 데이터를 관리할 수 있는 사진 아카이브 애플리케이션입니다 공개형 SNS가 아니라, "인증된 사용자 기반으로 사진을 저장하고 관리하는 내부형 시스템"에 가깝습니다

What it solves

• 인증된 사용자만 접근 가능한 사진 저장소가 필요할 때
• 서버를 거치지 않고 파일을 직접 스토리지로 업로드하고 싶을 때
• 개인 사진과 공유 사진을 구분해서 관리하고 싶을 때
• 단순 업로드가 아니라 업로드시 자동 분류/운영 가능한 구조가 필요할 때

Core Features

• 승인 기반 인증 시스템 (activation / approved flow)
• 사진 업로드 (direct-to-storage presigned URL)
• 개인 갤러리 조회
• 공유 사진 조회
• 사진 visibility 전환 (private / shared)
• 사진 삭제
• EXIF 기반 메타데이터 추출 (촬영 시각, 위치)
• 슈퍼 관리자용 전체 데이터셋 관리
• 미완료 업로드 정리 (worker cleanup)

Tech Stack

• Language: TypeScript
• Frontend: Next.js (App Router, React)
• Backend: NestJS (Fastify, Node.js)
• Database: PostgreSQL (Drizzle ORM)
• Auth: Custom session (DB + cookie), email verification, password login
• Storage: MinIO object storage with presigned URL-based direct upload
• Worker: Node.js background worker
• Infra: On-premise (self-hosted physical server)

Architecture

• Web / API / Worker 분리 구조
• 클라이언트가 스토리지로 직접 업로드하는 direct-to-storage 방식
• 업로드 전 DB에 pending 상태 기록 후 완료 시 ready 전환

특징적인 흐름

업로드:
upload session 생성 → presigned URL 발급 → 직접 PUT → 완료 API 호출

완료 처리:
storage HeadObject로 객체 존재 확인 후 상태 변경

정리:
일정 시간 지난 pending 업로드를 abandoned로 전환

Design Decisions

• 파일은 서버를 거치지 않고 스토리지로 직접 업로드
• 업로드 상태는 DB 기반으로 관리 (pending → ready)
• 실패 복구 대신 cleanup 기반 단순 모델 선택
• 관리자 기능은 동일 API 레이어에서 확장

Security Notes

• 인증된 사용자만 업로드 및 조회 가능
• 세션 기반 인증 + 권한 체크 (approved / admin)
• presigned URL 기반 제한된 업로드 권한

Limitations

• multipart upload 미구현
• 업로드 resume / partial retry 없음
• 업로드 진행률 추적 없음
• 대용량 업로드에 최적화된 구조는 아님
• 상태 모델이 단순 (pending / ready / abandoned)

Why this structure

이 프로젝트는 확장성보다는 "단순하고 명확한 업로드 흐름"에 초점을 맞췄습니다.

• 서버 부하 최소화 (direct upload)
• 구현 복잡도 낮춤
• 기본적인 운영 기능 확보

Summary

direct-to-storage 업로드 구조를 기반으로 한 인증형 사진 아카이브 시스템입니다.

구조는 확장 방향을 갖고 있지만, 현재는 단일 PUT 기반의 간단한 업로드 모델로 구현되어 있습니다.