CLAP-125 Feature : 1차 카테고리 추가 API

<footer>
- 관련: #90

Author: hyoseong-Choi

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

@@ -0,0 +1,36 @@
+package clap.server.adapter.inbound.web.admin;
+
+import clap.server.adapter.inbound.security.SecurityUserDetails;
+import clap.server.adapter.inbound.web.dto.admin.AddMainCategoryRequest;
+import clap.server.application.port.inbound.management.AddMainCategoryUsecase;
+import clap.server.common.annotation.architecture.WebAdapter;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import lombok.RequiredArgsConstructor;
+import org.springframework.security.access.annotation.Secured;
+import org.springframework.security.core.annotation.AuthenticationPrincipal;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+
+@Tag(name = "카테고리 추가")
+@WebAdapter
+@RequiredArgsConstructor
+public class addCategoryController {
+    private final AddMainCategoryUsecase addMainCategoryUsecase;
+
+    @Operation(summary = "1차 카테고리 추가")
+    @PostMapping("/api/maincategory")
+    @Secured("ROLE_ADMIN")
+    public void addMainCategory(@AuthenticationPrincipal SecurityUserDetails userInfo, @Validated @RequestBody AddMainCategoryRequest addMainCategoryRequest) {
+        addMainCategoryUsecase.addMainCategory(userInfo.getUserId(), addMainCategoryRequest.code(), addMainCategoryRequest.name());
+    }
+
+//    @Operation(summary = "2차 카테고리 추가")
+//    @PostMapping("/api/subcategory")
+//    @Secured("ROLE_ADMIN")
+//    public void addSubCategory(@Validated @RequestBody AddCategoryRequest addCategoryRequest) {
+//        addMainCategoryUsecase.addSubCategory(addCategoryRequest.code(), addCategoryRequest.name());
+//    }
+
+}

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

@@ -0,0 +1,13 @@
+package clap.server.adapter.inbound.web.dto.admin;
+
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.Pattern;
+import org.hibernate.validator.constraints.Length;
+
+public record AddMainCategoryRequest(
+        @NotBlank @Length(max = 20)
+        String name,
+        @NotBlank @Pattern(regexp = "^[A-Z]{1,2}$", message = "올바른 카테고리 코드 형식이 아닙니다.")
+        String code
+) {
+}

src/main/java/clap/server/adapter/inbound/web/statistics/FindStatisticsController.java

@@ -18,6 +18,7 @@
 import java.util.List;
 
 import static clap.server.exception.code.StatisticsErrorCode.STATISTICS_BAD_REQUEST;
+import static io.swagger.v3.oas.annotations.enums.ParameterIn.QUERY;
 
 @Tag(name = "작업 관련 통계")
 @WebAdapter
@@ -31,8 +32,8 @@ public class FindStatisticsController {
     private final FindManagerTaskProcessUsecase findManagerTaskProcessUsecase;
 
     @Operation(summary = "기본 통계 API")
-    @Parameter(name = "periodType", description = "day, week, month", required = true)
-    @Parameter(name = "statisticsType", description = "request-by-period, process-by-period, request-by-category, process-by-manager", required = true)
+    @Parameter(name = "periodType", description = "day, week, month", required = true, in = QUERY)
+    @Parameter(name = "statisticsType", description = "request-by-period, process-by-period, request-by-category, process-by-manager", required = true, in = QUERY)
     @GetMapping
     public ResponseEntity<List<StatisticsResponse>> aggregateTaskStatistics(@RequestParam PeriodType periodType, @RequestParam StatisticsType statisticsType) {
         switch (statisticsType) {
@@ -68,8 +69,8 @@ public ResponseEntity<List<StatisticsResponse>> aggregateTaskStatistics(@Request
     }
 
     @Operation(summary = "1차 카테고리 하위 2차 카테고리별 통계 API")
-    @Parameter(name = "periodType", description = "day, week, month", required = true)
-    @Parameter(name = "mainCategory", description = "1차 카테고리 이름", required = true)
+    @Parameter(name = "periodType", description = "day, week, month", required = true, in = QUERY)
+    @Parameter(name = "mainCategory", description = "1차 카테고리 이름", required = true, in = QUERY)
     @GetMapping("/subcategory")
     public ResponseEntity<List<StatisticsResponse>> aggregateSubCategoryTaskRequest(@RequestParam PeriodType periodType, @RequestParam String mainCategory) {
         return ResponseEntity.ok(findSubCategoryTaskRequestUsecase

src/main/java/clap/server/adapter/outbound/persistense/CategoryPersistenceAdapter.java

@@ -3,6 +3,7 @@
 import clap.server.adapter.outbound.persistense.entity.task.CategoryEntity;
 import clap.server.adapter.outbound.persistense.mapper.CategoryPersistenceMapper;
 import clap.server.adapter.outbound.persistense.repository.task.CategoryRepository;
+import clap.server.application.port.outbound.task.CommandCategoryPort;
 import clap.server.application.port.outbound.task.LoadCategoryPort;
 import clap.server.common.annotation.architecture.PersistenceAdapter;
 import clap.server.domain.model.task.Category;
@@ -12,7 +13,7 @@
 
 @PersistenceAdapter
 @RequiredArgsConstructor
-public class CategoryPersistenceAdapter implements LoadCategoryPort {
+public class CategoryPersistenceAdapter implements LoadCategoryPort, CommandCategoryPort {
 
     private final CategoryRepository categoryRepository;
     private final CategoryPersistenceMapper categoryPersistenceMapper;
@@ -22,4 +23,9 @@ public Optional<Category> findById(Long id) {
         Optional<CategoryEntity> categoryEntity = categoryRepository.findById(id);
         return categoryEntity.map(categoryPersistenceMapper::toDomain);
     }
-}
+
+    @Override
+    public void save(Category category) {
+        categoryRepository.save(categoryPersistenceMapper.toEntity(category));
+    }
+}

src/main/java/clap/server/application/port/inbound/management/AddMainCategoryUsecase.java

@@ -0,0 +1,5 @@
+package clap.server.application.port.inbound.management;
+
+public interface AddMainCategoryUsecase {
+    void addMainCategory(Long adminId, String code, String name);
+}

src/main/java/clap/server/application/port/outbound/task/CommandCategoryPort.java

@@ -0,0 +1,7 @@
+package clap.server.application.port.outbound.task;
+
+import clap.server.domain.model.task.Category;
+
+public interface CommandCategoryPort {
+    void save(Category category);
+}

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

@@ -0,0 +1,30 @@
+package clap.server.application.service.admin;
+
+import clap.server.application.port.inbound.management.AddMainCategoryUsecase;
+import clap.server.application.port.outbound.member.LoadMemberPort;
+import clap.server.application.port.outbound.task.CommandCategoryPort;
+import clap.server.common.annotation.architecture.ApplicationService;
+import clap.server.domain.model.member.Member;
+import clap.server.domain.model.task.Category;
+import clap.server.exception.ApplicationException;
+import lombok.RequiredArgsConstructor;
+
+import java.util.Optional;
+
+import static clap.server.exception.code.MemberErrorCode.ACTIVE_MEMBER_NOT_FOUND;
+
+@ApplicationService
+@RequiredArgsConstructor
+public class AddMainCategoryService implements AddMainCategoryUsecase {
+    private final CommandCategoryPort commandCategoryPort;
+    private final LoadMemberPort loadMemberPort;
+
+    @Override
+    public void addMainCategory(Long adminId, String code, String name) {
+        Optional<Member> activeMember = loadMemberPort.findActiveMemberById(adminId);
+        Category mainCategory = Category.createMainCategory(
+                activeMember.orElseThrow(() -> new ApplicationException(ACTIVE_MEMBER_NOT_FOUND)),
+                code, name);
+        commandCategoryPort.save(mainCategory);
+    }
+}

src/main/java/clap/server/domain/model/task/Category.java

@@ -22,5 +22,13 @@ public class Category extends BaseTime {
    private String descriptionExample;
    private LocalDateTime createdAt; 
    private LocalDateTime updatedAt;
+
+   public static Category createMainCategory(Member admin, String code, String name) {
+      Category category = new Category();
+      category.admin = admin;
+      category.code = code;
+      category.name = name;
+      return category;
+   }
  }