CLAP-318 Fix : 2차카테고리 입력 양식(설명 예시) 추가

<footer>
- 관련: #392

Author: hyoseong-Choi

src/main/java/clap/server/adapter/inbound/web/admin/AddCategoryController.java

@@ -35,7 +35,11 @@ public void addMainCategory(@AuthenticationPrincipal SecurityUserDetails userInf
     @PostMapping("/sub-category")
     @Secured("ROLE_ADMIN")
     public void addSubCategory(@AuthenticationPrincipal SecurityUserDetails userInfo, @Valid @RequestBody AddSubCategoryRequest addCategoryRequest) {
-        addSubCategoryUsecase.addSubCategory(userInfo.getUserId(), addCategoryRequest.mainCategoryId(), addCategoryRequest.code(), addCategoryRequest.name());
+        addSubCategoryUsecase.addSubCategory(userInfo.getUserId(),
+                addCategoryRequest.mainCategoryId(),
+                addCategoryRequest.code(),
+                addCategoryRequest.name(),
+                addCategoryRequest.descriptionExample());
     }
 
 }

src/main/java/clap/server/adapter/inbound/web/admin/UpdateCategoryController.java

@@ -27,6 +27,10 @@ public class UpdateCategoryController {
     @Secured("ROLE_ADMIN")
     public void updateCategory(@AuthenticationPrincipal SecurityUserDetails userInfo, @PathVariable Long categoryId,
                                @Valid @RequestBody UpdateCategoryRequest updateCategoryRequest) {
-        updateCategoryUsecase.updateCategory(userInfo.getUserId(), categoryId, updateCategoryRequest.name(), updateCategoryRequest.code());
+        updateCategoryUsecase.updateCategory(userInfo.getUserId(),
+                categoryId,
+                updateCategoryRequest.name(),
+                updateCategoryRequest.code(),
+                updateCategoryRequest.descriptionExample());
     }
 }

src/main/java/clap/server/adapter/inbound/web/dto/admin/request/AddSubCategoryRequest.java

@@ -11,5 +11,6 @@ public record AddSubCategoryRequest(
         @NotBlank @Length(max = 20)
         String name,
         @NotBlank @Pattern(regexp = "^[A-Z]{1,2}$", message = "올바른 카테고리 코드 형식이 아닙니다.")
-        String code) {
+        String code,
+        String descriptionExample) {
 }

src/main/java/clap/server/adapter/inbound/web/dto/admin/request/UpdateCategoryRequest.java

@@ -8,6 +8,7 @@ public record UpdateCategoryRequest(
         @NotBlank @Length(max = 20)
         String name,
         @NotBlank @Pattern(regexp = "^[A-Z]{1,2}$", message = "올바른 카테고리 코드 형식이 아닙니다.")
-        String code
+        String code,
+        String descriptionExample
 ) {
 }

src/main/java/clap/server/adapter/inbound/web/dto/admin/response/FindSubCategoryResponse.java

@@ -4,6 +4,7 @@ public record FindSubCategoryResponse(
         Long id,
         Long mainCategoryId,
         String name,
-        String code
+        String code,
+        String descriptionExample
 ) {
 }

src/main/java/clap/server/application/mapper/CategoryResponseMapper.java

@@ -22,6 +22,6 @@ public static FindMainCategoryResponse toFindMainCategoryResponse(Category categ
     }
 
     public static FindSubCategoryResponse toFindSubCategoryResponse(Category category) {
-        return new FindSubCategoryResponse(category.getCategoryId(), category.getMainCategory().getCategoryId(), category.getName(), category.getCode());
+        return new FindSubCategoryResponse(category.getCategoryId(), category.getMainCategory().getCategoryId(), category.getName(), category.getCode(), category.getDescriptionExample());
     }
 }

src/main/java/clap/server/application/port/inbound/admin/AddSubCategoryUsecase.java

@@ -1,5 +1,5 @@
 package clap.server.application.port.inbound.admin;
 
 public interface AddSubCategoryUsecase {
-    void addSubCategory(Long adminId, Long mainCategoryId, String code, String name);
+    void addSubCategory(Long adminId, Long mainCategoryId, String code, String name, String descriptionExample);
 }

src/main/java/clap/server/application/port/inbound/admin/UpdateCategoryUsecase.java

@@ -1,5 +1,5 @@
 package clap.server.application.port.inbound.admin;
 
 public interface UpdateCategoryUsecase {
-    void updateCategory(Long adminId, Long categoryId, String name, String code);
+    void updateCategory(Long adminId, Long categoryId, String name, String code, String descriptionExample);
 }

src/main/java/clap/server/application/service/admin/AddCategoryService.java

@@ -36,14 +36,14 @@ public void addMainCategory(Long adminId, String code, String name) {
 
     @Override
     @Transactional
-    public void addSubCategory(Long adminId, Long mainCategoryId, String code, String name) {
+    public void addSubCategory(Long adminId, Long mainCategoryId, String code, String name, String descriptionExample) {
         Optional<Member> activeMember = loadMemberPort.findActiveMemberById(adminId);
         Optional<Category> mainCategory = loadCategoryPort.findById(mainCategoryId);
 
         Category subCategory = Category.createSubCategory(
                 activeMember.orElseThrow(() -> new ApplicationException(ACTIVE_MEMBER_NOT_FOUND)),
                 mainCategory.orElseThrow(() -> new ApplicationException(CATEGORY_NOT_FOUND)),
-                code, name);
+                code, name, descriptionExample);
         commandCategoryPort.save(subCategory);
     }
 }

src/main/java/clap/server/application/service/admin/UpdateCategoryService.java

@@ -23,11 +23,11 @@ public class UpdateCategoryService implements UpdateCategoryUsecase {
 
     @Override
     @Transactional
-    public void updateCategory(Long adminId, Long categoryId, String name, String code) {
+    public void updateCategory(Long adminId, Long categoryId, String name, String code, String descriptionExample) {
         Member admin = loadMemberPort.findActiveMemberById(adminId).orElseThrow(() -> new ApplicationException(ACTIVE_MEMBER_NOT_FOUND));
         Category category = loadCategoryPort.findById(categoryId)
                 .orElseThrow(() -> new ApplicationException(CATEGORY_NOT_FOUND));
-        category.updateCategory(admin, name, code);
+        category.updateCategory(admin, name, code, descriptionExample);
         commandCategoryPort.save(category);
     }
 }