문화발자국 v1.0.0

🎉 문발 백엔드 API v1.0.0

서울시 문화행사 정보 및 방문 기록 서비스 문발의 백엔드 API 첫 번째 릴리즈입니다.

🚀 구현된 API

🔐 인증 관련

• OAuth2 로그인: 카카오, 네이버 소셜 로그인 지원
• JWT 토큰: Access Token + Refresh Token 기반 인증
• 사용자 관리: 회원가입, 로그인, 로그아웃, 회원탈퇴

🎭 문화행사 관련

• 행사 목록 조회: 페이징, 검색, 필터링 지원
• 행사 상세 조회: 위치, 시간, 요금 등 상세 정보
• 카테고리/지역 목록: 검색 필터용 마스터 데이터

📍 방문 인증 관련

• 위치 기반 방문 인증: GPS 좌표로 실제 방문 확인
• 방문 기록 관리: 재방문 제한
• 발자국 지도: 지도 범위별 방문 위치 조회

💙 좋아요 관련

• 행사 좋아요: 관심 행사 북마크 기능
• 좋아요 목록: 사용자별 관심 행사 목록 조회

🏆 배지 시스템

• 배지 목록: 전체 배지 및 획득 여부 조회
• 자동 배지 획득: 방문 조건 달성 시 실시간 배지 부여
• 진행률 추적: 다음 목표 배지까지의 진행 상황

📊 통계 관련

• 방문 통계: 총 방문 횟수, 월별 통계, 장르/지역별 분석
• 방문 목록: 개인별 방문 기록 목록 (페이징 지원)

🛠️ 기술 스택

• Spring Boot 3.x + Java 17
• Spring Security + JWT + OAuth2
• Spring Data JPA + MySQL
• RESTful API 설계
• Docker 컨테이너화

🌐 배포 정보

API 서버: https://moonbaar.o-r.kr/api
프론트엔드: https://moonbaar.o-r.kr

📋 API 문서

자세한 API 명세는 API 명세서를 참고해주세요.

주요 엔드포인트

• GET /events - 문화행사 목록 조회
• POST /events/{eventId}/visit - 방문 인증
• GET /users/me/statistics - 사용자 방문 통계
• GET /users/me/badges - 배지 목록 조회
• 기타 20+ 개 API 엔드포인트

---

서비스 URL: https://moonbaar.o-r.kr
이슈 신고: GitHub Issues