📸 ReStory - AI 사진 복원 서비스

손상된 사진을 AI로 복원해주는 무료 웹 서비스입니다. Google Gemini AI를 활용해 보수적/모던/하이브리드 스타일의 복원 결과를 제공하며, 직관적인 비교 UI와 다양한 사용자 편의 기능을 갖추고 있습니다. 🔗 사이트 바로가기 ｜ GitHub 바로가기

✨ 주요 기능

• 🧠 Gemini AI 기반 손상 사진 복원 (보수적/모던/하이브리드 스타일)
• 📂 드래그 앤 드롭 파일 업로드 및 타입/크기 검증 (최대 10MB)
• 🪞 복원 전후 이미지 비교 뷰어 (확대/다운로드 지원)
• 🖼️ JPG/PNG 등 다양한 이미지 포맷 지원
• 💡 실시간 복원 진행 상태 및 에러 안내
• 🌗 다크모드 및 PWA 지원 (모바일 대응 포함)

🛠 기술 스택

• Frontend: Next.js, React, TypeScript, TailwindCSS
• UI 라이브러리: Radix UI
• AI 모델 연동: Replicate API (Cloudflare Workers AI fallback)
• 이미지 처리: Sharp
• 데이터베이스: MongoDB (Mongoose)
• 배포: Vercel

💡 핵심 기능 설명

🔄 사진 복원 파이프라인

1. 이미지 업로드 및 검증

   • Drag & Drop 또는 파일 선택으로 이미지 업로드
   • 파일 타입(JPG/PNG) 및 크기(최대 10MB) 검증
   • 개발 모드 시뮬레이션 (USE_REAL_AI_IN_DEV=true로 실제 AI 테스트 가능)

2. Rate Limiting

   • IP 기반 요청 제한으로 서버 부하 방지
   • MongoDB에 요청 로그 저장 및 관리

3. AI 복원 엔진 선택

   • 1순위: Replicate FLUX Kontext 모델 (고화질 복원)
     • 동적으로 최신 모델 버전 해시 획득
     • 예측 생성 및 상태 폴링 (최대 40초)
     • 성공 시 고화질 복원 이미지 반환
   • 2순위 (Fallback): Cloudflare Workers AI (무료 대체)
     • Stable Diffusion v1.5 Img2Img 모델 사용
     • 부드러운 아날로그 감성 복원
   • 실패 시: 에러 메시지 및 재시도 안내

4. 이미지 후처리

   • Sharp를 이용한 이미지 포맷 변환
   • 저해상도 이미지 자동 업스케일링 (개발 모드)
   • Base64 인코딩하여 프론트엔드 전송

5. 결과 반환

   • 복원된 이미지 데이터 (Base64)
   • 사용된 엔진 정보
   • 복원 스타일 및 설명

AI 사진 복원 시스템

• Replicate API를 활용한 AI 기반 사진 복원 (Cloudflare Workers AI fallback 지원)
• Sharp를 이용한 이미지 처리 및 고화질 업스케일링
• Rate Limiting 기능으로 서버 부하 방지
• 고해상도 이미지 지원 (서버 부하 제한을 위한 10MB 제한 적용)

직관적인 이미지 관리

• Drag & Drop 기반 업로드 및 미리보기
• 이미지 전후 비교 슬라이더 UI
• 이미지 확대/저장/재복원 기능 제공

사용자 경험 및 보안

• 복원 중/완료/실패 등 다양한 상태 안내 및 토스트 피드백
• 서버 임시 처리 후 이미지 자동 폐기 (개인정보 미저장)
• 파일 타입/사이즈 검증 및 개인정보 처리방침 제공

성능 및 접근성 최적화

• PWA 지원: 오프라인 접근 및 홈화면 설치 기능
• 반응형 웹 디자인: 다양한 디바이스에 최적화된 UI
• 접근성 고려: 명확한 피드백, 키보드 탐색 등 UI 개선