AI로 되살리는 인생 명장면, 프리미엄 포토에세이 제작 서비스
Scene Archive는 좋아하는 드라마, 영화, 아이돌의 장면을 포토북으로 제작하는 웹 서비스입니다.
사용자는 이미지를 업로드하고, 장면에 대한 키워드와 정보를 입력한 뒤, 포토북 생성 및 주문까지 한 번에 진행할 수 있습니다.
현재 프로젝트는 Sweetbook API 연동을 통한 기본적인 책 생성 및 주문 생성 기능 구현에 중점을 두고 있으며,
기획 단계에서 포함했던 일부 AI 기능은 아직 완성되지 않은 상태입니다.
- Sweetbook SDK/API를 이용해 책 생성 흐름을 연결했습니다.
- 표지 및 내지 구성에 필요한 데이터를 조합하여 실제 포토북 생성 요청이 가능하도록 구현했습니다.
- 생성된 책 정보를 바탕으로 주문 생성 API까지 연결했습니다.
- 배송 정보 입력 후 주문 요청이 가능한 기본 흐름을 구성했습니다.
- 주문번호와 연락처를 기준으로 주문 정보를 조회할 수 있도록 API를 연결했습니다.
- 생성된 주문 내역과 장면 정보를 다시 확인할 수 있는 흐름을 구성했습니다.
- 프론트엔드에서 사용자 흐름에 맞춰 페이지를 구성했습니다.
- 업로드 → 검토 → 주문 → 주문조회 흐름까지 구현했습니다.
- 원래 목표는 저해상도 캡처 이미지를 고해상도로 보정하는 기능이었으나,
- 현재 버전에서는 해당 AI 업스케일링 로직까지 완성하지 못했습니다.
- 사용자가 입력한 키워드를 바탕으로 장면의 맥락을 해석하고 문장을 생성하는 기능을 기획했으나,
- 현재는 해당 기능이 구현되지 않았습니다.
즉, 이 프로젝트는 AI 기능을 완성한 서비스라기보다, 포토북 제작/주문 API 연동을 중심으로 구현한 프로토타입에 가깝습니다.
- React 19 (Vite)
- TypeScript
- Zustand
- Tailwind CSS
- Lucide React
- React Router
- Python
- FastAPI
- SQLite
- Sweetbook API SDK
배포된 서비스는 아래 주소에서 바로 접속할 수 있습니다.
- 프론트엔드:
https://scene-archive.com - 백엔드 API:
https://api.scene-archive.com
배포 및 운영 방법은 DEPLOYMENT.md에서 별도로 관리합니다.
scene-archive/
├── backend/ # FastAPI 서버
│ ├── database.py # SQLite 및 데이터 처리
│ ├── main.py # API 엔드포인트 및 Sweetbook 연동
│ └── static/samples/ # 샘플 이미지
└── frontend/ # React 클라이언트
├── src/app/hooks/ # 커스텀 훅
├── src/app/store/ # Zustand 상태 관리
└── src/app/pages/ # 주요 페이지
본 프로젝트에서는 Sweetbook SDK / API를 활용해 책 생성, 주문 생성, 주문 조회 흐름을 연결했습니다.
| API | 용도 |
|---|---|
| POST /books | 새 포토북 생성 |
| POST /covers | 포토북 표지 생성 |
| POST /contents | 포토북 내지 생성 |
| POST /photos | 포토북에 사진 업로드 |
| POST /orders | 생성된 포토북 주문 생성 |
| GET /orders/{orderUid} | 주문 상세 조회 |
※(注記) 초기 기획에 포함되었던 이미지 업스케일링, 키워드 기반 내용 추출 관련 API는 현재 구현되지 않았습니다.
개발 과정에서 사용한 AI 도구와 활용 내용은 다음과 같습니다.
| AI 도구 | 활용 내용 |
|---|---|
| ChatGPT | 서비스 아이디어 정리, README 문서 작성 보조, 기능 설명 문장 다듬기 |
| Google Gemini | React 코드 리팩토링, FastAPI를 이용한 기능 개발 |
| Codex | GitHub Actions 배포 워크플로 구성, 프론트엔드 빌드 설정 보완, README 및 배포 문서 정리 |
| Figma make | 화면 UI/UX 생성 및 코드 작성 |
※(注記) AI를 활용해 문서화와 구조 정리를 보조받았지만, 실제 프로젝트 구현 범위는 포토북 생성 및 주문 생성 API 연동까지로 제한됩니다.
이 서비스를 선택한 이유는 단순 CRUD를 넘어서, 실제 외부 제작 API를 웹 서비스 흐름에 연결하는 경험을 해보고 싶었기 때문입니다.
사용자가 입력한 데이터를 바탕으로 결과물을 만들고, 그 결과가 실제 주문 단계까지 이어지는 구조를 구현하면서 프론트엔드와 백엔드 간의 역할 분리, 외부 API 연동, 사용자 흐름 설계 경험을 쌓는 데 집중했습니다.
또한 좋아하는 장면을 기록하고 소장하고 싶어 하는 사용자 니즈를 서비스 형태로 풀어보는 과정에서, 단순 기능 구현이 아니라 주제와 사용자 경험이 연결된 프로젝트를 만들고자 했습니다.
비록 초기 기획에 포함했던 AI 이미지 복원이나 에세이 생성 기능까지는 완성하지 못했지만, 현재 버전에서는 포토북 생성과 주문 생성이라는 핵심 흐름을 실제로 동작하게 만드는 것을 우선 목표로 두고 구현했습니다.
커밋 메시지는 아래 형식을 따릅니다.
<scope>/<type>: <한국어 커밋 메시지>
front: 프론트엔드 관련 변경back: 백엔드 관련 변경common: 공통 설정, 문서, 프로젝트 전반 변경
| type | 의미 |
|---|---|
| feat | 기능 개발 |
| fix | 버그 수정 |
| design | UI/UX 변경 (frontend 전용) |
| refactor | 코드 구조 개선 |
| docs | 문서 |
| test | 테스트 코드 |
| build | 빌드 파일 수정 |
| ci | CI 설정 파일 수정 |
| chore | 자잘한 수정이나 빌드 업데이트 |
| rename | 파일 혹은 폴더명 수정 |
| remove | 파일 삭제 |
| perf | 성능 개선 |
front/feat: 주문 조회 페이지 추가back/fix: 주문 생성 응답 예외 처리 수정common/docs: 배포 가이드 문서화