🎉 문발 백엔드 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