[Release] 운영 서버 최신 버전 릴리즈

README.md

@@ -0,0 +1,133 @@
+# 찾아유 - 유기동물 관련 종합 애플리케이션
+
+## 👋 Project Overview
+**WHAT?**  
+유실동물을 찾고 보호하는 것을 돕는 통합 플랫폼입니다. 실종 신고, 목격 제보부터 보호 센터 정보, AI 품종 분석까지 반려동물을 잃어버린 슬픔을 덜고 빠른 구조를 돕습니다.
+
+**HOW?**  
+공공데이터 포털의 전국 유기동물/보호소 데이터와 사용자의 실시간 제보(위치, 사진)를 매핑하여 지도 기반 서비스를 제공합니다. OpenAI 기반의 품종 자동 분석을 도입하여 검색 정확도를 높였습니다.
+
+**WHY?**  
+가족 같은 반려동물을 잃어버렸을 때의 막막함을 해소하고, 골든타임을 놓치지 않도록 기술적으로 지원하며, 나아가 성숙한 반려동물 문화를 만들기 위해 시작되었습니다.
+
+<br>
+
+## 🧑‍🧑‍🧒 Team Member
+<table>
+  <tbody>
+    <tr>
+      <td align="center"><a href="https://github.com/JangIkhwan">
+      <img width=140px src="https://avatars.githubusercontent.com/u/87964632?s=64&v=4" alt=""/><br />
+      <sub><b>[Server] 장익환</b></sub></a><br /></td>
+      <td align="center"><a href="https://github.com/ksg1227">
+      <img width=140px src="https://avatars.githubusercontent.com/u/66379250?v=4" alt=""/><br />
+      <sub><b>[Server] 김상균</b></sub></a><br /></td>
+      <td align="center"><a href="https://github.com/JJUYAAA">
+      <img width=140px src="https://avatars.githubusercontent.com/u/121420399?v=4" alt=""/><br />
+      <sub><b>[Server] 정주연</b></sub></a><br /></td>
+    </tr>
+  </tbody>
+</table>
+
+<br>
+
+## ⚒️ Tech Stack
+<img src="assets/tech_stack.png" width="700">
+
+### Backend
+| Tech | Version / Description |
+| --- | --- |
+| **Java** | JDK 17 |
+| **Spring Boot** | 3.5.0 |
+| **Spring Data JPA** | ORM / Hibernate |
+| **Spring Security** | Authentication & Authorization |
+| **Spring AI** | OpenAI (GPT-4o) Integration |
+| **Gradle** | Build Tool |
+
+### Database & Storage
+| Tech | Description |
+| --- | --- |
+| **MySQL** | Main RDBMS (v8.0) |
+| **Redis** | Cache & Session Store |
+| **Flyway** | DB Migration Tool |
+| **AWS S3** | Image Storage |
+
+### Infra & DevOps
+| Tech | Description |
+| --- | --- |
+| **Docker** | Containerization |
+| **AWS EC2** | (Expected Deployment Target) |
+| **GitHub Actions** | CI/CD (Workflows configured) |
+
+### Tools
+- **Swagger (OpenAPI)**: API Documentation
+- **Actuator & Prometheus/Loki/Grafana/Alloy**: Monitoring
+
+<br>
+
+## 🏗️ Architecture
+<img src="assets/system_architecture.png" width="700">
+
+<br>
+
+## 📍 ERD
+<img src="assets/erd.png" width="700">
+
+<br>
+
+## 📜 Convention
+
+### Code Convention
+| 항목 | 규칙 | 예시 |
+| --- | --- | --- |
+| **Class** | PascalCase | `UserProfile` |
+| **Function** | camelCase | `getUserInfo` |
+| **Variable** | camelCase | `userId` |
+| **DB Table** | snake_case | `user_profile` |
+| **Enum / Constant** | UPPER_SNAKE_CASE | `MAX_RETRY` |
+
+### Git Convention
+
+#### Commit Message
+`[Prefix] #IssueNumber Description`  
+예시: `[Feat] #123 로그인 API 구현`
+
+| Prefix | Description |
+| --- | --- |
+| `Feat` | 새로운 기능 추가 |
+| `Fix` | 버그 수정 |
+| `Refactor` | 코드 리팩토링 |
+| `Chore` | 빌드 업무 수정, 패키지 매니저 수정 |
+| `Docs` | 문서 수정 |
+| `Infra` | 인프라 설정 |
+| `Test` | 테스트 코드 |
+
+#### Branch Strategy
+`prefix/#issue-description`  
+예시: `feat/#123-login-api`, `fix/#45-bug-fix`
+
+<br>
+
+## 🗂️ Project Structure
+```
+com.kuit.findyou
+├── 📂 domain              // 도메인별 비즈니스 로직 (Feature Packaging)
+│   ├── 📂 auth            // 인증 (Login, Token)
+│   ├── 📂 breed           // 품종 정보
+│   ├── 📂 city            // 시/도, 시/군/구 지역 정보
+│   ├── 📂 home            // 홈 화면 (통계, 추천)
+│   ├── 📂 image           // 이미지 업로드/처리
+│   ├── 📂 information     // 동물보호센터, 봉사활동 정보
+│   ├── 📂 inquiry         // 문의하기
+│   ├── 📂 notification    // 알림
+│   ├── 📂 report          // 실종/목격 신고
+│   └── 📂 user            // 사용자 관리 (MyPage)
+│
+└── 📂 global              // 전역 공유 모듈
+    ├── 📂 common          // 공통 Response, Exception
+    ├── 📂 config          // 설정 (Security, Swagger, S3, Redis...)
+    ├── 📂 external        // 외부 API 클라이언트 (Kakao, Public Data...)
+    ├── 📂 infrastructure  // 인프라 구현체 (ImageUploader...)
+    ├── 📂 jwt             // JWT 관련 유틸리티 및 필터
+    └── 📂 logging         // 로깅 설정
+```

build.gradle

@@ -16,6 +16,12 @@ java {
 	}
 }
 
+test {
+    testLogging {
+        showStandardStreams = project.hasProperty("showLogs")
+    }
+}
+
 configurations {
 	compileOnly {
 		extendsFrom annotationProcessor

src/main/java/com/kuit/findyou/domain/auth/controller/AuthController.java

@@ -1,10 +1,12 @@
 package com.kuit.findyou.domain.auth.controller;
 
+import com.kuit.findyou.domain.auth.dto.ReissueTokenRequest;
+import com.kuit.findyou.domain.auth.dto.ReissueTokenResponse;
 import com.kuit.findyou.domain.auth.dto.request.GuestLoginRequest;
 import com.kuit.findyou.domain.auth.dto.response.GuestLoginResponse;
 import com.kuit.findyou.domain.auth.dto.request.KakaoLoginRequest;
 import com.kuit.findyou.domain.auth.dto.response.KakaoLoginResponse;
-import com.kuit.findyou.domain.auth.service.AuthService;
+import com.kuit.findyou.domain.auth.service.AuthServiceFacade;
 import com.kuit.findyou.global.common.annotation.CustomExceptionDescription;
 import com.kuit.findyou.global.common.response.BaseResponse;
 import io.swagger.v3.oas.annotations.Operation;
@@ -16,36 +18,44 @@
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
 
-import static com.kuit.findyou.global.common.swagger.SwaggerResponseDescription.GUEST_LOGIN;
-import static com.kuit.findyou.global.common.swagger.SwaggerResponseDescription.KAKAO_LOGIN;
+import static com.kuit.findyou.global.common.swagger.SwaggerResponseDescription.*;
 
 @Tag(name = "Login", description = "로그인 관련 API")
 @Slf4j
 @RequiredArgsConstructor
 @RequestMapping("api/v2/auth")
 @RestController
 public class AuthController {
-    private final AuthService authService;
+    private final AuthServiceFacade authServiceFacade;
 
     @Operation(
             summary = "카카오 로그인 API",
             description = "카카오 사용자 식별자를 이용해서 유저 정보와 엑세스 토큰을 얻을 수 있습니다. 가입된 회원인지 여부를 반환합니다."
     )
-    @PostMapping("/login/kakao")
     @CustomExceptionDescription(KAKAO_LOGIN)
+    @PostMapping("/login/kakao")
     public BaseResponse<KakaoLoginResponse> kakaoLogin(@RequestBody KakaoLoginRequest request){
-        log.info("[kakaoLogin]");
-        return BaseResponse.ok(authService.kakaoLogin(request));
+        return BaseResponse.ok(authServiceFacade.kakaoLogin(request));
     }
 
     @Operation(
             summary = "게스트 로그인 API",
             description = "디바이스id 식별자를 이용해서 유저 정보와 엑세스 토큰을 얻을 수 있습니다. 기존 게스트가 아니면 별도의 가입 API 호출 없이 정보가 자동으로 저장됩니다."
     )
-    @PostMapping("/login/guest")
     @CustomExceptionDescription(GUEST_LOGIN)
+    @PostMapping("/login/guest")
     public BaseResponse<GuestLoginResponse> guestLogin(@RequestBody GuestLoginRequest request){
         log.info("[guestLogin] deviceId = {}", request.deviceId());
-        return BaseResponse.ok(authService.guestLogin(request));
+        return BaseResponse.ok(authServiceFacade.guestLogin(request));
+    }
+
+    @Operation(
+            summary = "토큰 재발급 API",
+            description = "만료되지 않은 리프레시 토큰으로 요청하면 새로운 엑세스 토큰과 리프레시 토큰을 얻을 수 있습니다."
+    )
+    @CustomExceptionDescription(REISSUE_TOKEN)
+    @PostMapping("/reissue/token")
+    public BaseResponse<ReissueTokenResponse> reissueToken(@RequestBody ReissueTokenRequest request){
+        return BaseResponse.ok(authServiceFacade.reissueToken(request));
     }
 }

src/main/java/com/kuit/findyou/domain/auth/dto/ReissueTokenRequest.java

@@ -0,0 +1,6 @@
+package com.kuit.findyou.domain.auth.dto;
+
+public record ReissueTokenRequest(
+        String refreshToken
+) {
+}

src/main/java/com/kuit/findyou/domain/auth/dto/ReissueTokenResponse.java

@@ -0,0 +1,7 @@
+package com.kuit.findyou.domain.auth.dto;
+
+public record ReissueTokenResponse(
+        String accessToken,
+        String refreshToken
+) {
+}

src/main/java/com/kuit/findyou/domain/auth/dto/response/GuestLoginResponse.java

@@ -7,6 +7,8 @@ public record GuestLoginResponse (
         @Schema(description = "유저 식별자")
         Long userId,
         @Schema(description = "엑세스 토큰")
-        String accessToken
+        String accessToken,
+        @Schema(description = "리프레시 토큰")
+        String refreshToken
 ){
 }

src/main/java/com/kuit/findyou/domain/auth/dto/response/KakaoLoginResponse.java

@@ -10,12 +10,12 @@ public record KakaoLoginResponse(
         @Schema(description = "첫 로그인 여부 = 회원가입 여부", example = "false")
         Boolean isFirstLogin
 ) {
-    public static KakaoLoginResponse fromUserAndAccessToken(User user, String accessToken) {
-        UserInfoDto userInfo = new UserInfoDto(user.getId(), user.getName(), accessToken);
+    public static KakaoLoginResponse fromUserAndTokens(User user, String accessToken, String refreshToken) {
+        UserInfoDto userInfo = new UserInfoDto(user.getId(), user.getName(), accessToken, refreshToken);
         return new KakaoLoginResponse(userInfo, false);
     }
 
-    public static KakaoLoginResponse notFound() {
+    public static KakaoLoginResponse firstLogin() {
         return new KakaoLoginResponse(null, true);
     }
 
@@ -25,7 +25,9 @@ public record UserInfoDto(
             @Schema(description = "사용자 닉네임", example = "유저1")
             String nickname,
             @Schema(description = "찾아유 엑세스 토큰", example = "token1234token1234token1234")
-            String accessToken
+            String accessToken,
+            @Schema(description = "찾아유 리프레시 토큰", example = "token1234token1234token1234")
+            String refreshToken
     ) {
     }
 }

src/main/java/com/kuit/findyou/domain/auth/repository/RedisRefreshTokenRepository.java

@@ -0,0 +1,9 @@
+package com.kuit.findyou.domain.auth.repository;
+
+import java.util.Optional;
+
+public interface RedisRefreshTokenRepository {
+    Optional<String> findByUserId(Long userId);
+
+    void save(Long id, String refreshToken);
+}

src/main/java/com/kuit/findyou/domain/auth/repository/RedisRefreshTokenRepositoryImpl.java

@@ -0,0 +1,33 @@
+package com.kuit.findyou.domain.auth.repository;
+
+import lombok.RequiredArgsConstructor;
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.data.redis.core.RedisTemplate;
+import org.springframework.stereotype.Repository;
+
+import java.time.Duration;
+import java.util.Optional;
+
+@RequiredArgsConstructor
+@Repository
+public class RedisRefreshTokenRepositoryImpl implements RedisRefreshTokenRepository {
+    private final RedisTemplate<String, String> redisTemplate;
+    private final String refreshTokenKeyPrefix = "refresh-token:";
+    @Value("${findyou.jwt.expiration-ms.refresh-token}")
+    private Long refreshTokenExpireMs;
+
+    private String key(Long userId) {
+        return refreshTokenKeyPrefix + userId;
+    }
+
+    @Override
+    public Optional<String> findByUserId(Long userId) {
+        String value = redisTemplate.opsForValue().get(key(userId));
+        return Optional.ofNullable(value);
+    }
+
+    @Override
+    public void save(Long userId, String refreshToken) {
+        redisTemplate.opsForValue().set(key(userId), refreshToken, Duration.ofMillis(refreshTokenExpireMs));
+    }
+}

src/main/java/com/kuit/findyou/domain/auth/service/AuthServiceFacade.java

@@ -0,0 +1,29 @@
+package com.kuit.findyou.domain.auth.service;
+
+import com.kuit.findyou.domain.auth.dto.ReissueTokenRequest;
+import com.kuit.findyou.domain.auth.dto.ReissueTokenResponse;
+import com.kuit.findyou.domain.auth.dto.request.GuestLoginRequest;
+import com.kuit.findyou.domain.auth.dto.request.KakaoLoginRequest;
+import com.kuit.findyou.domain.auth.dto.response.GuestLoginResponse;
+import com.kuit.findyou.domain.auth.dto.response.KakaoLoginResponse;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+
+@RequiredArgsConstructor
+@Service
+public class AuthServiceFacade {
+    private final LoginService loginService;
+    private final ReissueTokenService reissueTokenService;
+
+    public KakaoLoginResponse kakaoLogin(KakaoLoginRequest request) {
+        return loginService.kakaoLogin(request);
+    }
+
+    public GuestLoginResponse guestLogin(GuestLoginRequest request) {
+        return loginService.guestLogin(request);
+    }
+
+    public ReissueTokenResponse reissueToken(ReissueTokenRequest request) {
+        return reissueTokenService.reissueToken(request);
+    }
+}

src/main/java/com/kuit/findyou/domain/auth/service/IssueTokenService.java

@@ -0,0 +1,8 @@
+package com.kuit.findyou.domain.auth.service;
+
+import com.kuit.findyou.domain.user.model.Role;
+
+public interface IssueTokenService {
+    String issueAccessToken(Long userId, Role role);
+    String issueRefreshToken(Long userId);
+}

src/main/java/com/kuit/findyou/domain/auth/service/IssueTokenServiceImpl.java

@@ -0,0 +1,26 @@
+package com.kuit.findyou.domain.auth.service;
+
+import com.kuit.findyou.domain.auth.repository.RedisRefreshTokenRepository;
+import com.kuit.findyou.domain.user.model.Role;
+import com.kuit.findyou.global.jwt.util.JwtUtil;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+
+@RequiredArgsConstructor
+@Service
+public class IssueTokenServiceImpl implements IssueTokenService {
+    private final JwtUtil jwtUtil;
+    private final RedisRefreshTokenRepository redisRefreshTokenRepository;
+
+    @Override
+    public String issueAccessToken(Long userId, Role role) {
+        return jwtUtil.createAccessJwt(userId, role);
+    }
+
+    @Override
+    public String issueRefreshToken(Long userId) {
+        String refreshToken = jwtUtil.createRefreshJwt(userId);
+        redisRefreshTokenRepository.save(userId, refreshToken);
+        return refreshToken;
+    }
+}

src/main/java/com/kuit/findyou/domain/auth/service/AuthService.java → src/main/java/com/kuit/findyou/domain/auth/service/LoginService.java

@@ -5,7 +5,7 @@
 import com.kuit.findyou.domain.auth.dto.request.KakaoLoginRequest;
 import com.kuit.findyou.domain.auth.dto.response.KakaoLoginResponse;
 
-public interface AuthService {
+public interface LoginService {
     KakaoLoginResponse kakaoLogin(KakaoLoginRequest request);
 
     GuestLoginResponse guestLogin(GuestLoginRequest request);