사용자등록 추가, 추론결과 dashboard 수정

src/main/java/com/kamco/cd/kamcoback/auth/AuthApiController.java

@@ -1,15 +1,55 @@
 package com.kamco.cd.kamcoback.auth;
 
+import com.kamco.cd.kamcoback.auth.dto.AuthDto;
+import com.kamco.cd.kamcoback.auth.service.AuthService;
+import com.kamco.cd.kamcoback.config.api.ApiResponseDto;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.media.Content;
+import io.swagger.v3.oas.annotations.media.Schema;
+import io.swagger.v3.oas.annotations.responses.ApiResponse;
+import io.swagger.v3.oas.annotations.responses.ApiResponses;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.validation.Valid;
+import lombok.RequiredArgsConstructor;
 import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
 
+@Tag(name = "사용자 관리", description = "사용자 관리 API")
 @RestController
+@RequiredArgsConstructor
 @RequestMapping("/api/auth")
 public class AuthApiController {
 
-  @PostMapping("/signup")
-  public void signup() {
+  private final AuthService authService;
 
+  @Operation(summary = "사용자 등록", description = "사용자를 등록 합니다.")
+  @ApiResponses(
+      value = {
+        @ApiResponse(
+            responseCode = "201",
+            description = "사용자 등록 성공",
+            content =
+                @Content(
+                    mediaType = "application/json",
+                    schema = @Schema(implementation = Long.class))),
+        @ApiResponse(responseCode = "400", description = "잘못된 요청 데이터", content = @Content),
+        @ApiResponse(responseCode = "404", description = "코드를 찾을 수 없음", content = @Content),
+        @ApiResponse(responseCode = "500", description = "서버 오류", content = @Content)
+      })
+  @PostMapping("/signup")
+  public ApiResponseDto<Long> signup(
+      @io.swagger.v3.oas.annotations.parameters.RequestBody(
+              description = "사용자 정보",
+              required = true,
+              content =
+                  @Content(
+                      mediaType = "application/json",
+                      schema = @Schema(implementation = AuthDto.Signup.class)))
+          @RequestBody
+          @Valid
+          AuthDto.Signup signup) {
+    return ApiResponseDto.createOK(authService.signup(signup));
   }
 }