feat: implement Graph Find API (#89)

cmd/app/main.go

@@ -85,6 +85,7 @@ func main() {
 	router.POST("/api/papers/update", paperApi.HandleUpdate)
 
 	graphApi := api.NewGraphApi(graphUseCase)
+	router.POST("/api/graphs/find", graphApi.HandleFind)
 	router.POST("/api/graphs/sectionalize", graphApi.HandleSectionalize)
 
 	err = router.Run(":8080")

docs/openapi/paths/_index.yaml

@@ -16,9 +16,9 @@
   $ref: ./papers/find.yaml
 /api/papers/update:
   $ref: ./papers/update.yaml
-/api/graphs/sectionalize:
-  $ref: ./graphs/sectionalize.yaml
 /api/graphs/find:
   $ref: ./graphs/find.yaml
 /api/graphs/update:
   $ref: ./graphs/update.yaml
+/api/graphs/sectionalize:
+  $ref: ./graphs/sectionalize.yaml

docs/openapi/schemas/entity/graph/GraphOnlyId.yaml → docs/openapi/schemas/entity/section/SectionOnlyId.yaml

@@ -1,9 +1,9 @@
 type: object
-description: Graph object with only ID
+description: Section object with only ID
 properties:
   id:
     type: string
-    description: Auto-generated graph ID
+    description: Auto-generated section ID
     example: 123e4567-e89b-12d3-a456-426614174000
 required:
   - id

docs/openapi/schemas/entity/section/SectionOnlyIdError.yaml

@@ -0,0 +1,7 @@
+type: object
+description: Error Message for SectionOnlyId object
+properties:
+  id:
+    type: string
+    description: Error message for section ID
+    example: "section id is required, but got ''"

docs/openapi/schemas/interface/graphs/find/GraphFindErrorResponse.yaml

@@ -11,5 +11,5 @@ properties:
     $ref: ../../../entity/project/ProjectOnlyIdError.yaml
   chapter:
     $ref: ../../../entity/chapter/ChapterOnlyIdError.yaml
-  graph:
-    $ref: ../../../entity/graph/GraphOnlyIdError.yaml
+  section:
+    $ref: ../../../entity/section/SectionOnlyIdError.yaml

docs/openapi/schemas/interface/graphs/find/GraphFindRequest.yaml

@@ -7,10 +7,10 @@ properties:
     $ref: ../../../entity/project/ProjectOnlyId.yaml
   chapter:
     $ref: ../../../entity/chapter/ChapterOnlyId.yaml
-  graph:
-    $ref: ../../../entity/graph/GraphOnlyId.yaml
+  section:
+    $ref: ../../../entity/section/SectionOnlyId.yaml
 required:
   - user
   - project
   - chapter
-  - graph
+  - section

internal/api/chapter_test.go

@@ -47,11 +47,11 @@ func TestChapterList(t *testing.T) {
 				"sections": []any{
 					map[string]any{
 						"id":   "SECTION_ONE",
-						"name": "Section One",
+						"name": "Introduction",
 					},
 					map[string]any{
 						"id":   "SECTION_TWO",
-						"name": "Section Two",
+						"name": "Section of Chapter One",
 					},
 				},
 			},

internal/api/graph.go

@@ -9,6 +9,7 @@ import (
 )
 
 type GraphApi interface {
+	HandleFind(c *gin.Context)
 	HandleSectionalize(c *gin.Context)
 }
 
@@ -20,6 +21,46 @@ func NewGraphApi(usecase usecase.GraphUseCase) GraphApi {
 	return graphApi{usecase: usecase}
 }
 
+func (api graphApi) HandleFind(c *gin.Context) {
+	var request model.GraphFindRequest
+	if err := c.ShouldBindJSON(&request); err != nil {
+		c.JSON(http.StatusBadRequest, model.GraphFindErrorResponse{
+			Message: JsonBindErrorToMessage(err),
+		})
+		return
+	}
+
+	res, ucErr := api.usecase.FindGraph(request)
+
+	if ucErr != nil && ucErr.Code() == usecase.DomainValidationError {
+		resErr := UseCaseErrorToResponse(ucErr)
+		c.JSON(http.StatusBadRequest, model.GraphFindErrorResponse{
+			Message: UseCaseErrorToMessage(ucErr),
+			User:    resErr.User,
+			Project: resErr.Project,
+			Chapter: resErr.Chapter,
+			Section: resErr.Section,
+		})
+		return
+	}
+
+	if ucErr != nil && ucErr.Code() == usecase.NotFoundError {
+		c.JSON(http.StatusNotFound, model.GraphFindErrorResponse{
+			Message: UseCaseErrorToMessage(ucErr),
+		})
+		return
+	}
+
+	if ucErr != nil {
+		c.JSON(http.StatusInternalServerError, model.ApplicationErrorResponse{
+			Message: UseCaseErrorToMessage(ucErr),
+		})
+		return
+	}
+
+	c.JSON(http.StatusOK, res)
+}
+
 func (api graphApi) HandleSectionalize(c *gin.Context) {
 	var request model.GraphSectionalizeRequest
 	if err := c.ShouldBindJSON(&request); err != nil {