Release v0.0.39

application/main-app/build.gradle

@@ -28,9 +28,6 @@ dependencies {
 	// Security
 	implementation "org.springframework.boot:spring-boot-starter-security"
 
-	// swagger
-	implementation 'org.springdoc:springdoc-openapi-starter-webmvc-ui:2.8.3'
-
 	// aws
 	implementation 'io.awspring.cloud:spring-cloud-aws-starter-s3:3.0.0'
 

application/main-app/src/main/java/org/mainapp/aws/s3/controller/LegacyS3Controller.java

@@ -0,0 +1,42 @@
+package org.mainapp.aws.s3.controller;
+
+import org.mainapp.aws.s3.controller.response.CreatePutUrlResponse;
+import org.mainapp.aws.s3.service.S3Service;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import lombok.RequiredArgsConstructor;
+
+@Deprecated
+@RestController
+@RequiredArgsConstructor
+@RequestMapping("/presigned-url")
+@Tag(name = "Pre-signed URL API", description = "pre-signed URL 발급 관련 API입니다.")
+public class LegacyS3Controller {
+
+	private final S3Service s3Service;
+
+	@Operation(
+		summary = "게시물 그룹 이미지 pre-signed URL 발급 API",
+		description = "게시물 그룹에 포함되어 게시물 생성에 사용되는 이미지에 대한 pre-signed URL을 발급합니다.\n\n"
+			+ "해당 URL로 업로드하면 서버에서 설정한 파일명으로 업로드되므로, 응답에 포함된 imageUrl 값을 사용하시면 됩니다."
+	)
+	@GetMapping("/post-group")
+	public ResponseEntity<CreatePutUrlResponse> getPreSignedPutUrlForPostGroup() {
+		return ResponseEntity.ok(s3Service.createPreSignedPutUrl("post-group/"));
+	}
+
+	@Operation(
+		summary = "게시물 이미지 pre-signed URL 발급 API",
+		description = "게시물에 실제로 포함되는 이미지에 대한 pre-signed URL을 발급합니다.\n\n"
+			+ "해당 URL로 업로드하면 서버에서 설정한 파일명으로 업로드되므로, 응답에 포함된 imageUrl 값을 사용하시면 됩니다."
+	)
+	@GetMapping("/post")
+	public ResponseEntity<CreatePutUrlResponse> getPreSignedPutUrlForPost() {
+		return ResponseEntity.ok(s3Service.createPreSignedPutUrl("post/"));
+	}
+}

application/main-app/src/main/java/org/mainapp/aws/s3/controller/S3Controller.java

@@ -13,7 +13,7 @@
 
 @RestController
 @RequiredArgsConstructor
-@RequestMapping("/presigned-url")
+@RequestMapping("/v1/presigned-url")
 @Tag(name = "Pre-signed URL API", description = "pre-signed URL 발급 관련 API입니다.")
 public class S3Controller {
 

application/main-app/src/main/java/org/mainapp/domain/agent/controller/AgentController.java → application/main-app/src/main/java/org/mainapp/domain/v1/agent/controller/AgentController.java

@@ -1,10 +1,10 @@
-package org.mainapp.domain.agent.controller;
+package org.mainapp.domain.v1.agent.controller;
 
-import org.mainapp.domain.agent.controller.request.UpdateAgentPersonalSettingRequest;
-import org.mainapp.domain.agent.controller.response.GetAgentPlanResponse;
-import org.mainapp.domain.agent.controller.response.GetAgentsResponse;
-import org.mainapp.domain.agent.controller.response.GetDetailAgentResponse;
-import org.mainapp.domain.agent.service.AgentService;
+import org.mainapp.domain.v1.agent.controller.request.UpdateAgentPersonalSettingRequest;
+import org.mainapp.domain.v1.agent.controller.response.GetAgentPlanResponse;
+import org.mainapp.domain.v1.agent.controller.response.GetAgentsResponse;
+import org.mainapp.domain.v1.agent.controller.response.GetDetailAgentResponse;
+import org.mainapp.domain.v1.agent.service.AgentService;
 import org.springframework.http.ResponseEntity;
 import org.springframework.validation.annotation.Validated;
 import org.springframework.web.bind.annotation.GetMapping;
@@ -19,7 +19,7 @@
 import lombok.RequiredArgsConstructor;
 
 @RestController
-@RequestMapping("/agents")
+@RequestMapping("/v1/agents")
 @RequiredArgsConstructor
 @Tag(name = "Agent API", description = "사용자가 연동한 SNS 계정(에이전트)에 대한 요청을 처리하는 API입니다.")
 public class AgentController {

application/main-app/src/main/java/org/mainapp/domain/v1/agent/controller/LegacyAgentController.java

@@ -0,0 +1,65 @@
+package org.mainapp.domain.v1.agent.controller;
+
+import org.mainapp.domain.v1.agent.controller.request.UpdateAgentPersonalSettingRequest;
+import org.mainapp.domain.v1.agent.controller.response.GetAgentPlanResponse;
+import org.mainapp.domain.v1.agent.controller.response.GetAgentsResponse;
+import org.mainapp.domain.v1.agent.controller.response.GetDetailAgentResponse;
+import org.mainapp.domain.v1.agent.service.AgentService;
+import org.springframework.http.ResponseEntity;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import lombok.RequiredArgsConstructor;
+
+@Deprecated
+@RestController
+@RequestMapping("/agents")
+@RequiredArgsConstructor
+@Tag(name = "Agent API", description = "사용자가 연동한 SNS 계정(에이전트)에 대한 요청을 처리하는 API입니다.")
+public class LegacyAgentController {
+
+	private final AgentService agentService;
+
+	@Operation(summary = "계정 목록 조회 API", description = "사용자가 연동한 SNS 계정 목록을 조회합니다.")
+	@GetMapping
+	public ResponseEntity<GetAgentsResponse> getAgents() {
+		return ResponseEntity.ok(agentService.getAgents());
+	}
+
+	@Operation(summary = "계정 상세 조회 API", description = "사용자가 연동한 SNS 계정의 상세 정보를 조회합니다.")
+	@GetMapping("/{agentId}")
+	public ResponseEntity<GetDetailAgentResponse> getDetailAgent(@PathVariable Long agentId) {
+		return ResponseEntity.ok(agentService.getDetailAgent(agentId));
+	}
+
+	@Operation(
+		summary = "계정 개인화 설정 수정 API",
+		description = """
+			사용자가 연동한 SNS 계정의 개인화 설정을 변경합니다.
+
+			**변경되는 필드만 채워주시면 됩니다!**
+
+			빈 문자열로는 변경할 수 없습니다."""
+	)
+	@PutMapping("/{agentId}/personal-setting")
+	public ResponseEntity<Void> updateAgentPersonalSetting(
+		@PathVariable Long agentId,
+		@Validated @RequestBody UpdateAgentPersonalSettingRequest request
+	) {
+		agentService.updateAgentPersonalSetting(agentId, request);
+		return ResponseEntity.ok().build();
+	}
+
+	@Operation(summary = "계정 요금제 플랜 조회", description = "사용자가 연동한 SNS 계정의 요금제를 조회합니다.")
+	@GetMapping("/{agentId}/agent-plan")
+	public ResponseEntity<GetAgentPlanResponse> getAgentPlan(@PathVariable Long agentId) {
+		return ResponseEntity.ok(agentService.getAgentPlan(agentId));
+	}
+}

application/main-app/src/main/java/org/mainapp/domain/agent/controller/request/UpdateAgentPersonalSettingRequest.java → application/main-app/src/main/java/org/mainapp/domain/v1/agent/controller/request/UpdateAgentPersonalSettingRequest.java

@@ -1,4 +1,4 @@
-package org.mainapp.domain.agent.controller.request;
+package org.mainapp.domain.v1.agent.controller.request;
 
 import org.domainmodule.agent.entity.AgentPersonalSetting;
 import org.domainmodule.agent.entity.type.AgentToneType;

application/main-app/src/main/java/org/mainapp/domain/agent/controller/response/GetAgentPlanResponse.java → application/main-app/src/main/java/org/mainapp/domain/v1/agent/controller/response/GetAgentPlanResponse.java

@@ -1,4 +1,4 @@
-package org.mainapp.domain.agent.controller.response;
+package org.mainapp.domain.v1.agent.controller.response;
 
 import org.domainmodule.agent.entity.Agent;
 import org.domainmodule.agent.entity.type.AgentPlanType;

application/main-app/src/main/java/org/mainapp/domain/agent/controller/response/GetAgentsResponse.java → application/main-app/src/main/java/org/mainapp/domain/v1/agent/controller/response/GetAgentsResponse.java

@@ -1,9 +1,9 @@
-package org.mainapp.domain.agent.controller.response;
+package org.mainapp.domain.v1.agent.controller.response;
 
 import java.util.List;
 
 import org.domainmodule.agent.entity.Agent;
-import org.mainapp.domain.agent.controller.response.type.AgentResponse;
+import org.mainapp.domain.v1.agent.controller.response.type.AgentResponse;
 
 import io.swagger.v3.oas.annotations.media.Schema;
 

application/main-app/src/main/java/org/mainapp/domain/agent/controller/response/GetDetailAgentResponse.java → application/main-app/src/main/java/org/mainapp/domain/v1/agent/controller/response/GetDetailAgentResponse.java

@@ -1,9 +1,9 @@
-package org.mainapp.domain.agent.controller.response;
+package org.mainapp.domain.v1.agent.controller.response;
 
 import org.domainmodule.agent.entity.Agent;
 import org.domainmodule.agent.entity.AgentPersonalSetting;
-import org.mainapp.domain.agent.controller.response.type.AgentPersonalSettingResponse;
-import org.mainapp.domain.agent.controller.response.type.AgentResponse;
+import org.mainapp.domain.v1.agent.controller.response.type.AgentPersonalSettingResponse;
+import org.mainapp.domain.v1.agent.controller.response.type.AgentResponse;
 
 import io.swagger.v3.oas.annotations.media.Schema;
 

application/main-app/src/main/java/org/mainapp/domain/agent/controller/response/type/AgentPersonalSettingResponse.java → application/main-app/src/main/java/org/mainapp/domain/v1/agent/controller/response/type/AgentPersonalSettingResponse.java

@@ -1,4 +1,4 @@
-package org.mainapp.domain.agent.controller.response.type;
+package org.mainapp.domain.v1.agent.controller.response.type;
 
 import org.domainmodule.agent.entity.AgentPersonalSetting;
 import org.domainmodule.agent.entity.type.AgentToneType;

application/main-app/src/main/java/org/mainapp/domain/agent/controller/response/type/AgentResponse.java → application/main-app/src/main/java/org/mainapp/domain/v1/agent/controller/response/type/AgentResponse.java

@@ -1,4 +1,4 @@
-package org.mainapp.domain.agent.controller.response.type;
+package org.mainapp.domain.v1.agent.controller.response.type;
 
 import java.time.LocalDateTime;
 

application/main-app/src/main/java/org/mainapp/domain/agent/exception/AgentErrorCode.java → application/main-app/src/main/java/org/mainapp/domain/v1/agent/exception/AgentErrorCode.java

@@ -1,4 +1,4 @@
-package org.mainapp.domain.agent.exception;
+package org.mainapp.domain.v1.agent.exception;
 
 import org.mainapp.global.error.ErrorCodeStatus;
 import org.springframework.http.HttpStatus;

application/main-app/src/main/java/org/mainapp/domain/agent/service/AgentService.java → application/main-app/src/main/java/org/mainapp/domain/v1/agent/service/AgentService.java

@@ -1,4 +1,4 @@
-package org.mainapp.domain.agent.service;
+package org.mainapp.domain.v1.agent.service;
 
 import java.util.List;
 
@@ -9,12 +9,12 @@
 import org.domainmodule.agent.repository.AgentPersonalSettingRepository;
 import org.domainmodule.agent.repository.AgentRepository;
 import org.domainmodule.user.entity.User;
-import org.mainapp.domain.agent.controller.request.UpdateAgentPersonalSettingRequest;
-import org.mainapp.domain.agent.controller.response.GetAgentPlanResponse;
-import org.mainapp.domain.agent.controller.response.GetAgentsResponse;
-import org.mainapp.domain.agent.controller.response.GetDetailAgentResponse;
-import org.mainapp.domain.agent.exception.AgentErrorCode;
-import org.mainapp.domain.user.service.UserService;
+import org.mainapp.domain.v1.agent.controller.request.UpdateAgentPersonalSettingRequest;
+import org.mainapp.domain.v1.agent.controller.response.GetAgentPlanResponse;
+import org.mainapp.domain.v1.agent.controller.response.GetAgentsResponse;
+import org.mainapp.domain.v1.agent.controller.response.GetDetailAgentResponse;
+import org.mainapp.domain.v1.agent.exception.AgentErrorCode;
+import org.mainapp.domain.v1.user.service.UserService;
 import org.mainapp.global.error.CustomException;
 import org.mainapp.global.util.SecurityUtil;
 import org.snsclient.twitter.dto.response.TwitterUserInfoDto;

application/main-app/src/main/java/org/mainapp/domain/agent/service/AgentTransactionService.java → application/main-app/src/main/java/org/mainapp/domain/v1/agent/service/AgentTransactionService.java

@@ -1,4 +1,4 @@
-package org.mainapp.domain.agent.service;
+package org.mainapp.domain.v1.agent.service;
 
 import org.domainmodule.agent.entity.Agent;
 import org.domainmodule.agent.entity.AgentPersonalSetting;

application/main-app/src/main/java/org/mainapp/domain/auth/controller/AuthController.java → application/main-app/src/main/java/org/mainapp/domain/v1/auth/controller/AuthController.java

@@ -1,6 +1,6 @@
-package org.mainapp.domain.auth.controller;
+package org.mainapp.domain.v1.auth.controller;
 
-import org.mainapp.domain.auth.service.AuthServiceImpl;
+import org.mainapp.domain.v1.auth.service.AuthServiceImpl;
 import org.mainapp.global.constants.HeaderConstants;
 import org.mainapp.global.util.ResponseUtil;
 import org.springframework.http.ResponseEntity;
@@ -14,15 +14,16 @@
 import lombok.RequiredArgsConstructor;
 
 @RestController
-@RequestMapping("/auth")
+@RequestMapping("/v1/auth")
 @RequiredArgsConstructor
 @Tag(name = "Auth API", description = "로그인/회원가입에 대한 요청을 처리하는 API입니다.")
 public class AuthController {
 	private final AuthServiceImpl authService;
 	private final ResponseUtil responseUtil;
 
 	@DeleteMapping("/logout")
-	public ResponseEntity<Void> logout(@RequestHeader("Authorization") String accessToken,  HttpServletResponse response) {
+	public ResponseEntity<Void> logout(@RequestHeader("Authorization") String accessToken,
+		HttpServletResponse response) {
 		authService.logout(accessToken);
 		responseUtil.expireHttpOnlyCookie(response, HeaderConstants.REFRESH_TOKEN_HEADER);
 		return ResponseEntity.noContent().build();

application/main-app/src/main/java/org/mainapp/domain/v1/auth/controller/LegacyAuthController.java

@@ -0,0 +1,32 @@
+package org.mainapp.domain.v1.auth.controller;
+
+import org.mainapp.domain.v1.auth.service.AuthServiceImpl;
+import org.mainapp.global.constants.HeaderConstants;
+import org.mainapp.global.util.ResponseUtil;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.RequestHeader;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.servlet.http.HttpServletResponse;
+import lombok.RequiredArgsConstructor;
+
+@Deprecated
+@RestController
+@RequestMapping("/auth")
+@RequiredArgsConstructor
+@Tag(name = "Auth API", description = "로그인/회원가입에 대한 요청을 처리하는 API입니다.")
+public class LegacyAuthController {
+	private final AuthServiceImpl authService;
+	private final ResponseUtil responseUtil;
+
+	@DeleteMapping("/logout")
+	public ResponseEntity<Void> logout(@RequestHeader("Authorization") String accessToken,
+		HttpServletResponse response) {
+		authService.logout(accessToken);
+		responseUtil.expireHttpOnlyCookie(response, HeaderConstants.REFRESH_TOKEN_HEADER);
+		return ResponseEntity.noContent().build();
+	}
+}

application/main-app/src/main/java/org/mainapp/domain/auth/exception/AuthErrorCode.java → application/main-app/src/main/java/org/mainapp/domain/v1/auth/exception/AuthErrorCode.java

@@ -1,4 +1,4 @@
-package org.mainapp.domain.auth.exception;
+package org.mainapp.domain.v1.auth.exception;
 
 import org.mainapp.global.error.ErrorCodeStatus;
 import org.springframework.http.HttpStatus;

application/main-app/src/main/java/org/mainapp/domain/auth/service/AuthService.java → application/main-app/src/main/java/org/mainapp/domain/v1/auth/service/AuthService.java

@@ -1,11 +1,13 @@
-package org.mainapp.domain.auth.service;
+package org.mainapp.domain.v1.auth.service;
 
 import org.domainmodule.user.entity.User;
 import org.mainapp.global.oauth2.userinfo.OAuth2UserInfo;
 
 public interface AuthService {
 	void createAndSaveOauth(OAuth2UserInfo oAuth2Response, User user);
+
 	User loginOrRegisterUser(OAuth2UserInfo oAuth2Response);
+
 	void logout(String accessToken);
 }
 

application/main-app/src/main/java/org/mainapp/domain/auth/service/AuthServiceImpl.java → application/main-app/src/main/java/org/mainapp/domain/v1/auth/service/AuthServiceImpl.java

@@ -1,13 +1,13 @@
-package org.mainapp.domain.auth.service;
+package org.mainapp.domain.v1.auth.service;
 
 import java.util.Optional;
 
 import org.domainmodule.user.entity.Oauth;
 import org.domainmodule.user.entity.User;
 import org.domainmodule.user.entity.type.ProviderType;
 import org.domainmodule.user.repository.OauthRepository;
-import org.mainapp.domain.token.service.TokenServiceImpl;
-import org.mainapp.domain.user.service.UserServiceImpl;
+import org.mainapp.domain.v1.token.service.TokenServiceImpl;
+import org.mainapp.domain.v1.user.service.UserServiceImpl;
 import org.mainapp.global.oauth2.userinfo.OAuth2UserInfo;
 import org.mainapp.global.util.JwtUtil;
 import org.springframework.stereotype.Service;
@@ -48,7 +48,6 @@ private Optional<User> findUserByOAuthInfo(OAuth2UserInfo oAuth2Response) {
 			});
 	}
 
-
 	// 회원가입
 	private User registerUser(OAuth2UserInfo oAuth2Response) {
 		// 유저 생성

application/main-app/src/main/java/org/mainapp/domain/v1/newscategory/controller/LegacyNewsCategoryController.java

@@ -0,0 +1,30 @@
+package org.mainapp.domain.v1.newscategory.controller;
+
+import java.util.List;
+
+import org.mainapp.domain.v1.newscategory.controller.response.NewsCategoryResponse;
+import org.mainapp.domain.v1.newscategory.service.NewsCategoryService;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import lombok.RequiredArgsConstructor;
+
+@Deprecated
+@RestController
+@RequestMapping("/news-categories")
+@RequiredArgsConstructor
+@Tag(name = "NewsCategory API", description = "뉴스 카테고리에 대한 요청을 처리하는 API입니다.")
+public class LegacyNewsCategoryController {
+
+	private final NewsCategoryService newsCategoryService;
+
+	@Operation(summary = "뉴스 카테고리 목록 조회 API", description = "서비스의 전체 뉴스 카테고리 목록을 조회합니다.")
+	@GetMapping
+	public ResponseEntity<List<NewsCategoryResponse>> getNewsCategories() {
+		return ResponseEntity.ok().body(newsCategoryService.getNewsCategories());
+	}
+}

application/main-app/src/main/java/org/mainapp/domain/newscategory/controller/NewsCategoryController.java → application/main-app/src/main/java/org/mainapp/domain/v1/newscategory/controller/NewsCategoryController.java

@@ -1,9 +1,9 @@
-package org.mainapp.domain.newscategory.controller;
+package org.mainapp.domain.v1.newscategory.controller;
 
 import java.util.List;
 
-import org.mainapp.domain.newscategory.controller.response.NewsCategoryResponse;
-import org.mainapp.domain.newscategory.service.NewsCategoryService;
+import org.mainapp.domain.v1.newscategory.controller.response.NewsCategoryResponse;
+import org.mainapp.domain.v1.newscategory.service.NewsCategoryService;
 import org.springframework.http.ResponseEntity;
 import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.RequestMapping;
@@ -14,7 +14,7 @@
 import lombok.RequiredArgsConstructor;
 
 @RestController
-@RequestMapping("/news-categories")
+@RequestMapping("/v1/news-categories")
 @RequiredArgsConstructor
 @Tag(name = "NewsCategory API", description = "뉴스 카테고리에 대한 요청을 처리하는 API입니다.")
 public class NewsCategoryController {