PHOTO LINER API > 서비스 바로가기
여행의 모든 순간을 지도 위에 그리다
Photo Liner는 사진에 담긴 순간들을 지도 위에서 직관적으로 되살려 주는 위치 기반 사진 서비스입니다.
이 레포지토리는 Photo Liner 서비스의 백엔드 API 서버입니다.
Photo Liner는 단순한 사진 보관함이 아니라, 여행 타임라인을 지도 위에 그려주는 서비스입니다.
- 스마트폰/카메라에서 찍은 사진을 업로드하면
- 메타데이터에서 촬영 위치와 날짜를 읽어오고,
- 누락된 정보는 사용자가 지도에서 직접 위치를 선택하여 보정합니다.
- 사진은 촬영 날짜별로 자동 그룹화되며,
- 지도 위에는
- 개별 사진 마커,
- 다수의 사진을 모아 표시하는 클러스터 마커가 함께 보여집니다.
- 선택한 앨범에 대해서는
- 촬영 순서대로 경로를 그리고,
- 슬라이더를 활용해 하루 여행 동선을 따라가듯 재생할 수 있습니다.
- 다중 사진 선택 후 한 번에 업로드
- 사진 선택 모달에서 업로드 대상 선택/해제
- 업로드 이후, 사진별로
- 촬영 위치가 없으면 지도에서 클릭하여 위치 지정
- 촬영 날짜가 없거나 잘못된 경우 직접 수정
- 모든 사진의 정보가 준비되면 한 번에 저장
- 좌측 패널: 날짜별로 그룹화된 썸네일 리스트
- 우측 지도: 네이버 지도 위에 사진 썸네일 마커 표시
- 줌 레벨에 따라 자동으로 마커 클러스터링
- “3개”, “2개”와 같이 사진 개수 표시
- 클러스터 클릭 시 해당 영역으로 줌인
- 원하는 사진들을 묶어서 앨범 생성
- 앨범 뷰에서는
- 지도 위에 앨범 내 사진들만 표시
- 촬영 시각 기준으로 정렬 된 경로 라인을 점선으로 표시
- 시작/끝 지점, 이동 순서 등 동선이 한눈에 보이도록 UI 제공
- 하단 컨트롤에서
1 / 5형식의 인덱스와 날짜를 보여주며,- 좌우 화살표로 사진 순회 & 동선 따라가기 가능
- 지도 위의 사진 마커 또는 썸네일을 클릭 시
- 큰 이미지와 함께 촬영 날짜, 위치 정보 등 메타데이터가 표시되는 모달 팝업
- 위치 정보가 있는 경우 “위치 정보 있음” 형태로 표기
- 개별 이미지의 날짜 및 위치 수정
- 카카오톡 계정 기반 로그인
- 로그인 후 개인별 사진 보관함 및 앨범 관리
아래는 Photo Liner의 인프라 구조입니다.
-
Users
- 브라우저에서 React 앱 접속
- 지도/이미지/앨범 관련 API 호출
-
CloudFront
- 정적 리소스(React 번들) 및 이미지 캐싱
- S3 및 EC2의 콘텐츠를 전 세계에 빠르게 전달
-
S3
- 원본/리사이즈된 사진 파일 저장소
- EC2 백엔드로부터 Pre-signed URL을 발급 받아 클라이언트에서 직접 업로드
-
Lambda
- S3 업로드 이벤트 기반 트리거
- 원본 이미지 리사이징, 썸네일 생성 등 비동기 이미지 처리
-
EC2
- Spring Boot 기반 PHOTO_LINER_API 서버
- React 앱 서빙 및 REST API 제공
- RDS, SSM, S3 등과 통신
-
RDS
- 사진/위치/앨범/사용자 정보를 저장하는 관계형 DB
- 위치 정보는
POINT타입으로 저장하여 공간 쿼리 지원
-
Systems Manager (Parameter Store)
- DB 비밀번호, 외부 API 키 등 민감 정보 관리
-
GitHub
- 코드 저장소
- CI/CD 파이프라인 트리거 → EC2 배포
-
KakaoTalk (OAuth)
- 카카오 로그인을 통한 사용자 인증 연동
- Java 21
- Spring Boot 3.5.7
- Spring Web (REST API)
- Spring Data JPA
- Spring Validation
- Hibernate Spatial
- 위도/경도
Point타입 매핑 - 지도 뷰포트 내 사진 조회 등 공간 쿼리 처리
- 위도/경도
- Flyway
- DB 마이그레이션 관리
- AWS EC2 – 애플리케이션 서버
- AWS RDS (MySQL 8.1) – 메인 데이터베이스
- AWS S3 – 원본/썸네일 이미지 저장소
- AWS Lambda – 이미지 리사이징 자동화
- AWS CloudFront – 정적 파일 및 이미지 CDN
- AWS Systems Manager (Parameter Store) – 설정/보안 값 관리
PHOTO_LINER_API
├── .github/
├── gradle/
├── src
│ ├── main
│ │ ├── java/kr/kro/photoliner
│ │ │ ├── common/model # 공통 모델 (BaseEntity)
│ │ │ ├── domain
│ │ │ │ ├── album # 앨범 도메인
│ │ │ │ ├── photo # 사진 도메인
│ │ │ │ └── user # 사용자 도메인
│ │ │ └── global
│ │ │ ├── auth # JWT 인증
│ │ │ ├── code # API 응답 코드
│ │ │ ├── config # 설정 (S3, Swagger, WebMvc 등)
│ │ │ ├── exception # 전역 예외 처리
│ │ │ └── kakao/login # 카카오 로그인 연동
│ │ └── resources
│ │ ├── application-*.yml # 프로필 별 설정
│ │ └── db/migration # Flyway 스크립트 (V1~V9)
│ └── test
├── build.gradle
├── settings.gradle
└── gradlew / gradlew.bat
각 도메인(album, photo, user)은 동일한 레이어 구조를 따릅니다:
domain/{name}
├── controller # API 엔드포인트
├── dto # 요청/응답 DTO
├── model # 엔티티
├── repository # JPA Repository
├── service # 비즈니스 로직
└── infra # 외부 연동
 |
 |
|---|---|
| 강인화 | 박희찬 |
 |
 |
 |
|---|---|---|
| [Claud] | [Cursor] | [AntiGravity] |