LocoMap Backend

위치 기반 실시간 소셜 플랫폼 LocoMap의 백엔드 서버입니다. 지오해시(Geohash)를 핵심 인프라로 활용하여 사용자 위치 기반 채팅, 피드, 대피소 정보를 제공합니다.

기술 스택

분류	기술
Language	Java 21
Framework	Spring Boot 4.0.2
Build	Gradle
Database	MySQL
Cache	Redis
ORM	Spring Data JPA (Hibernate)
WebSocket	STOMP + SockJS
Monitoring	Prometheus + Micrometer + Grafana
Load Test	k6

---

프로젝트 구조

src/main/java/com/locomap/backend/
├── domain/
│   ├── user/        # 사용자 관리 (회원가입, 로그인, 위치)
│   ├── feed/        # 피드 (포스트 CRUD)
│   ├── chat/        # 위치 기반 실시간 채팅
│   └── shelter/     # 공공 대피소 정보
└── global/
    ├── config/      # WebSocket, Redis, CORS, 메트릭 설정
    ├── exception/   # 글로벌 예외 처리
    └── util/        # GeohashUtil (지오해시 인코딩/디코딩/거리 계산)

---

주요 기능

사용자 (User)

• 회원가입 / 로그인
• 사용자 프로필 조회
• 온보딩 완료 처리 (위치 동의 및 초기 위치 저장)

피드 (Feed)

• 포스트 CRUD
• 감정(emotion) 태그 및 위치 정보 포함
• 전체 피드 최신순 조회

채팅 (Chat)

• 지오해시 기반 채팅방 자동 생성 및 조회
• STOMP / SockJS WebSocket 실시간 메시지 송수신
• 주변 채팅방 조회 (Geohash prefix 필터링 → Haversine 거리 계산 2단계 방식)

쉘터 (Shelter)

• 공공 API(safetydata.go.kr) 연동 대피소 정보 조회
• Redis Geo 캐싱으로 위치 기반 주변 쉘터 빠른 검색 (TTL 24h)

---

API 목록

User

Method	Endpoint	설명
POST	/api/users	회원가입
POST	/api/users/login	로그인
GET	/api/users/{userId}	프로필 조회
POST	/api/users/{userId}/onboarding	온보딩 완료

Feed

Method	Endpoint	설명
GET	/api/posts	전체 피드 최신순 조회
POST	/api/posts	포스트 생성
GET	/api/posts/{postId}	포스트 상세 조회
PUT	/api/posts/{postId}	포스트 수정
DELETE	/api/posts/{postId}	포스트 삭제

Chat

Method	Endpoint	설명
GET	/api/chat/room/{geohash}	채팅방 조회 / 없으면 생성
GET	/api/chat/room/{geohash}/messages	메시지 목록 조회
GET	/api/chat/rooms/nearby?lat=&lng=&radius=	주변 채팅방 조회 (기본 반경 5km)
WS	/ws (STOMP)	실시간 메시지 전송

WebSocket 메시지 경로: /app/chat/{geohash} → /topic/chat/{geohash}

Shelter

Method	Endpoint	설명
GET	/api/shelters?page=&pageNo=	대피소 목록 조회 (페이징)
GET	/api/shelters/nearby?lat=&lng=&limit=	주변 대피소 조회