Backend Wiki

Backend Team Wiki

이 문서는 백엔드 팀의 기술, 규칙, 결정사항, 운영 방식을 기록하고 공유하기 위한 위키입니다.
모든 변경 사항은 문서화 및 날짜 기록을 원칙으로 합니다.

---

1. 프로젝트 개요

1-1 목적

• 서비스의 핵심 도메인 로직 및 API 제공
• 안정적인 인증/인가 및 데이터 무결성 보장
• 확장 가능한 아키텍처로 운영/성능/장애 대응 역량 확보

1-2 주요 기능

• 인증/인가 (JWT 기반 + OAuth_kakao )
• 핵심 도메인 API 제공 (CRUD + 상태 관리)
• 데이터 저장/조회 (RDB 중심 + NoSQL 보조) 및 트랜잭션 처리
• 예외/응답 표준화 및 운영 관측(로깅/모니터링 Grafana)

---

2. 기술 스택

2-1 기본 스택

구분	기술
Language	Java 25
Framework	Spring Boot 4.0.1
Build	Gradle
DB	PostgreSQL + MongoDB
ORM	Spring Data JPA (Hibernate)
API Docs	Swagger
Auth	JWT (Access/Refresh) + OAuth
Cache	Redis
Message Queue	Kafka
Container	Docker, Docker Compose
Monitoring	Prometheus + Grafana

2-2 스택 선정 이유

• Spring Boot
  • 빠른 개발 생산성과 풍부한 생태계(Starter, Actuator, Security 등)
  • 계층 구조(Controller/Service/Repository)로 역할 분리가 명확함
• Java 25
  • 최신 LTS로 장기 유지보수에 유리
  • 성능/가독성 개선 및 최신 언어 기능 활용 가능

---

3. JAVA & Spring Boot 버전 선정 및 이유

---

4. 아키텍처 & 코드 구조

4-1 패키지 구조 규칙

• domain: Entity/Repository 및 도메인 모델
• service: 유스케이스(비즈니스 로직)
• controller: API 엔드포인트
• dto: Request/Response DTO
• global: 공통 응답/예외/설정/유틸