Finders BE

     

---

🟧 About Finders

Finders는 필름 카메라 사용자가 현상소를 탐색하고, 예약하고, 결제까지 한 번에 처리할 수 있는 서비스입니다.
AI 사진 복원, 커뮤니티 피드, 필름카메라 가이드 등 필름 생활 전반을 아우르는 기능을 제공합니다.

UMC 9기 대학교 연합 IT 동아리 프로젝트 · 11명의 팀원 · 실제 수익을 목표로 하는 서비스

---

🟧 프로젝트 기간

2025.12.19 ~ ing

---

🟧 핵심 기능

1. 소셜 로그인 (Kakao, Apple) + JWT 인증
2. 현상소 검색/상세/즐겨찾기/거리 기반 정렬
3. 현상 예약 및 주문 상태 관리
4. 결제 처리 및 웹훅 검증 (PortOne)
5. AI 사진 복원 (Replicate)
6. 커뮤니티 게시글/댓글/좋아요
7. 파일 업로드 및 이미지 스토리지 연동 (GCS)

---

---

🟧 Team

김덕환

이승주

이지영

주보경

장지요

Backend 역할 분담

이름	담당 역할
김덕환	인프라 구축 / AI 사진 복원 / 1:1 문의 API 담당
이승주	현상소 예약 API / 현상소 로직 담당
이지영	커뮤니티 API /Redis cache 처리 담당
주보경	현상소 등록 / 현상소 조회 API 담당
장지요	로그인 / 회원가입 / 인프라 구축 담당

---

🟧 Tech Stack

Category	Stack
Backend
Database / Cache
Infra / DevOps
External Services
API Docs

---

🟧 System Architecture

---

🟧 프로젝트 구조

• domain: 도메인 중심 비즈니스 로직
• infra: 외부 서비스 연동 (OAuth, 결제, AI, 스토리지)
• global: 보안, 예외, 응답 포맷, 공통 설정

src/main/java/com/finders/api
├─ 🗂domain
│  ├─ auth
│  ├─ member
│  ├─ store
│  ├─ reservation
│  ├─ photo
│  ├─ payment
│  ├─ community
│  ├─ inquiry
│  └─ terms
├─ 🗂infra
│  ├─ oauth
│  ├─ payment
│  ├─ replicate
│  ├─ storage
│  └─ redis
└─ 🗂global
   ├─ config
   ├─ security
   ├─ exception
   └─ response

---

🟧 ERD

• 상세 스키마 문서: docs/architecture/ERD.md

---

🟧 배포 환경

Environment	Branch	Domain
Dev	develop	dev-api.finders.it.kr
Prod	main	api.finders.it.kr

---

🟧 Docs 정의

API Runtime Docs

• Local Swagger: http://localhost:8080/api/swagger-ui.html
• Local OpenAPI: http://localhost:8080/api/v3/api-docs
• Dev Swagger: https://dev-api.finders.it.kr/api/swagger-ui.html

docs/ 패키지 구조 (링크 + 주석 설명)

docs/
├─ README.md // docs 전체 인덱스
├─ architecture/
│  ├─ ARCHITECTURE.md // 백엔드 아키텍처/레이어/패키지 구조
│  ├─ ERD.md // 도메인별 ERD, DDL, 인덱스, enum 정의
│  └─ INFRASTRUCTURE.md // GCP 인프라 구성, 환경/배포 전략
├─ development/
│  ├─ API.md // API 엔드포인트 명세
│  ├─ CODE_STYLE.md // Java/Spring 코드 스타일 가이드
│  └─ CONVENTIONS.md // 브랜치/커밋/네이밍 컨벤션
├─ guides/
│  ├─ AUTHENTICATION_PRINCIPAL.md // 인증 principal/보안 컨텍스트 가이드
│  ├─ ENV_VARIABLES.md // 환경변수/시크릿 관리 가이드
│  ├─ GCS_SETUP.md // GCS 설정/권한/사용법
│  ├─ LOCAL_DEVELOPMENT.md // 로컬 개발 환경 세팅
│  └─ REMOTE_DB_ACCESS.md // 원격 DB 접속 방법
└─ infra/
   ├─ README.md // 인프라 문서 인덱스
   ├─ GCP_LOGGING_GUIDE.md // GCP 로그 조회/운영 가이드
   ├─ IAC_TERRAFORM_INTRO.md // Terraform IaC 입문
   ├─ SECRET_MANAGEMENT.md // Secret Manager 운영 가이드
   └─ TERRAFORM_OPERATIONS.md // Terraform 실무 운영 절차

---

🟧 실행 방법

Prerequisites

• Java 21+
• Docker / Docker Compose
• Gradle 8+

Local Run

git clone https://github.com/Finders-Official/BE.git
cd BE
cp .env.example .env
docker compose up -d
./gradlew bootRun

Test & Build

./gradlew test
./gradlew build

---

_{UMC 9th · Finders · 2025}