feat: implement Project Create API (#32)

cmd/app/main.go

@@ -67,6 +67,7 @@ func main() {
 	projectApi := api.NewProjectApi(projectUseCase)
 
 	router.POST("/api/projects/list", projectApi.HandleList)
+	router.POST("/api/projects/create", projectApi.HandleCreate)
 
 	err = router.Run(":8080")
 	if err != nil {

docs/openapi/paths/_index.yaml

@@ -2,3 +2,5 @@
   $ref: ./hello-world.yaml
 /api/projects/list:
   $ref: ./projects/list.yaml
+/api/projects/create:
+  $ref: ./projects/create.yaml

docs/openapi/paths/projects/create.yaml

@@ -0,0 +1,29 @@
+post:
+  tags:
+    - Projects
+  operationId: create
+  summary: Create new project
+  requestBody:
+    content:
+      application/json:
+        schema:
+          $ref: ../../schemas/ProjectCreateRequest.yaml
+  responses:
+    "200":
+      description: OK - Returns newly created project
+      content:
+        application/json:
+          schema:
+            $ref: ../../schemas/ProjectCreateResponse.yaml
+    "400":
+      description: Bad Request - Invalid request
+      content:
+        application/json:
+          schema:
+            $ref: ../../schemas/ProjectCreateErrorResponse.yaml
+    "500":
+      description: Internal Server Error - Server error
+      content:
+        application/json:
+          schema:
+            $ref: ../../schemas/ApplicationErrorResponse.yaml

docs/openapi/schemas/ProjectCreateErrorResponse.yaml

@@ -0,0 +1,11 @@
+type: object
+description: Error Response Body for Project Create API
+properties:
+  message:
+    type: string
+    description: Error message when request body format is invalid
+    example: unexpected EOF
+  user:
+    $ref: ./UserError.yaml
+  project:
+    $ref: ./ProjectWithoutAutofieldError.yaml

docs/openapi/schemas/ProjectCreateRequest.yaml

@@ -0,0 +1,10 @@
+type: object
+description: Request Body for Project Create API
+properties:
+  user:
+    $ref: ./User.yaml
+  project:
+    $ref: ./ProjectWithoutAutofield.yaml
+required:
+  - user
+  - project

docs/openapi/schemas/ProjectCreateResponse.yaml

@@ -0,0 +1,7 @@
+type: object
+description: Response Body for Project Create API
+properties:
+  project:
+    $ref: ./Project.yaml
+required:
+  - project

docs/openapi/schemas/ProjectWithoutAutofield.yaml

@@ -0,0 +1,15 @@
+type: object
+description: Project object without auto-generated fields
+properties:
+  name:
+    type: string
+    maxLength: 100
+    description: Project name
+    example: My Project
+  description:
+    type: string
+    maxLength: 400
+    description: Project description
+    example: This is my project
+required:
+  - name

docs/openapi/schemas/ProjectWithoutAutofieldError.yaml

@@ -0,0 +1,11 @@
+type: object
+description: Error Message for ProjectWithoutAutofield object
+properties:
+  name:
+    type: string
+    description: Error message for project name
+    example: project name is required, but got ''
+  description:
+    type: string
+    description: Error message for project description
+    example: project description must be less than or equal to 400 characters

docs/openapi/schemas/_index.yaml

@@ -2,8 +2,16 @@ HelloWorldRequest:
   $ref: ./HelloWorldRequest.yaml
 HelloWorldResponse:
   $ref: ./HelloWorldResponse.yaml
+User:
+  $ref: ./User.yaml
+UserError:
+  $ref: ./UserError.yaml
 Project:
   $ref: ./Project.yaml
+ProjectWithoutAutofield:
+  $ref: ./ProjectWithoutAutofield.yaml
+ProjectWithoutAutofieldError:
+  $ref: ./ProjectWithoutAutofieldError.yaml
 ProjectListRequest:
   $ref: ./ProjectListRequest.yaml
 ProjectListResponse:

internal/api/error.go

@@ -5,15 +5,11 @@ import (
 	"github.com/sirupsen/logrus"
 )
 
-func JsonBindErrorToResponseMessage(err error) string {
+func JsonBindErrorToMessage(err error) string {
 	return "invalid request format"
 }
 
-func JsonBindErrorToResponseModel[ErrorModel any](err error, defaultModel ErrorModel) ErrorModel {
-	return defaultModel
-}
-
-func UseCaseErrorToResponseMessage[ErrorModel any](err *usecase.Error[ErrorModel]) string {
+func UseCaseErrorToMessage[ErrorResponse any](err *usecase.Error[ErrorResponse]) string {
 	switch err.Code() {
 	case usecase.InvalidArgumentError:
 		return "invalid request value"
@@ -23,9 +19,6 @@ func UseCaseErrorToResponseMessage[ErrorModel any](err *usecase.Error[ErrorModel
 	}
 }
 
-func UseCaseErrorToResponseModel[ErrorModel any](err *usecase.Error[ErrorModel], defaultModel ErrorModel) ErrorModel {
-	if err.Model() == nil {
-		return defaultModel
-	}
-	return *err.Model()
+func UseCaseErrorToResponse[ErrorResponse any](err *usecase.Error[ErrorResponse]) ErrorResponse {
+	return *err.Response()
 }

internal/api/project.go

@@ -10,6 +10,7 @@ import (
 
 type ProjectApi interface {
 	HandleList(c *gin.Context)
+	HandleCreate(c *gin.Context)
 }
 
 type projectApi struct {
@@ -24,30 +25,59 @@ func (api projectApi) HandleList(c *gin.Context) {
 	var request model.ProjectListRequest
 	if err := c.ShouldBindJSON(&request); err != nil {
 		c.JSON(http.StatusBadRequest, model.ProjectListErrorResponse{
-			Message: JsonBindErrorToResponseMessage(err),
-			User:    JsonBindErrorToResponseModel(err, model.UserError{}),
+			Message: JsonBindErrorToMessage(err),
 		})
 		return
 	}
 
-	projects, err := api.usecase.ListProjects(request.User)
+	res, err := api.usecase.ListProjects(request)
 
 	if err != nil && err.Code() == usecase.InvalidArgumentError {
+		resErr := UseCaseErrorToResponse(err)
 		c.JSON(http.StatusBadRequest, model.ProjectListErrorResponse{
-			Message: UseCaseErrorToResponseMessage(err),
-			User:    UseCaseErrorToResponseModel(err, model.UserError{}),
+			Message: UseCaseErrorToMessage(err),
+			User:    resErr.User,
 		})
 		return
 	}
 
 	if err != nil {
 		c.JSON(http.StatusInternalServerError, model.ApplicationErrorResponse{
-			Message: UseCaseErrorToResponseMessage(err),
+			Message: UseCaseErrorToMessage(err),
 		})
 		return
 	}
 
-	c.JSON(http.StatusOK, model.ProjectListResponse{
-		Projects: projects,
-	})
+	c.JSON(http.StatusOK, res)
+}
+
+func (api projectApi) HandleCreate(c *gin.Context) {
+	var request model.ProjectCreateRequest
+	if err := c.ShouldBindJSON(&request); err != nil {
+		c.JSON(http.StatusBadRequest, model.ProjectCreateErrorResponse{
+			Message: JsonBindErrorToMessage(err),
+		})
+		return
+	}
+
+	res, err := api.usecase.CreateProject(request)
+
+	if err != nil && err.Code() == usecase.InvalidArgumentError {
+		resErr := UseCaseErrorToResponse(err)
+		c.JSON(http.StatusBadRequest, model.ProjectCreateErrorResponse{
+			Message: UseCaseErrorToMessage(err),
+			User:    resErr.User,
+			Project: resErr.Project,
+		})
+		return
+	}
+
+	if err != nil {
+		c.JSON(http.StatusInternalServerError, model.ApplicationErrorResponse{
+			Message: UseCaseErrorToMessage(err),
+		})
+		return
+	}
+
+	c.JSON(http.StatusCreated, res)
 }