docs: provide schemas useful for frontend development (#94)

docs/openapi/_index.yaml

@@ -5,3 +5,6 @@ info:
   description: App to Create Graphically-Summarized Notes in Three Steps
 paths:
   $ref: ./paths/_index.yaml
+components:
+  schemas:
+    $ref: ./schemas/_index.yaml

docs/openapi/schemas/_index.yaml

@@ -0,0 +1,9 @@
+# List of unused schemas. These are not used in API definitions but useful for frontend development.
+PaperWithoutAutofield:
+  $ref: ./entity/paper/PaperWithoutAutofield.yaml
+PaperWithoutAutofieldError:
+  $ref: ./entity/paper/PaperWithoutAutofieldError.yaml
+GraphContentWithoutAutofield:
+  $ref: ./entity/graph/GraphContentWithoutAutofield.yaml
+GraphContentWithoutAutofieldError:
+  $ref: ./entity/graph/GraphContentWithoutAutofieldError.yaml

docs/openapi/schemas/entity/graph/GraphContent.yaml

@@ -14,5 +14,4 @@ properties:
       This is the introduction of the paper.
 required:
   - id
-  - name
   - paragraph

docs/openapi/schemas/entity/graph/GraphContentWithoutAutofield.yaml

@@ -0,0 +1,12 @@
+type: object
+description: Graph object with only content fields without auto-generated fields
+properties:
+  paragraph:
+    type: string
+    maxLength: 40000
+    description: Graph paragraph
+    example: |
+      ## Introduction
+      This is the introduction of the paper.
+required:
+  - paragraph

docs/openapi/schemas/entity/graph/GraphContentWithoutAutofieldError.yaml

@@ -0,0 +1,7 @@
+type: object
+description: Error Message for GraphContentWithoutAutofield object
+properties:
+  paragraph:
+    type: string
+    description: Error message for graph paragraph
+    example: graph paragraph must be less than or equal to 40000 bytes

docs/openapi/schemas/entity/paper/PaperWithoutAutofield.yaml

@@ -0,0 +1,15 @@
+type: object
+description: Paper object without auto-generated fields
+properties:
+  content:
+    type: string
+    maxLength: 40000
+    description: Paper content
+    example: |
+      ## Introduction
+      This is the introduction of the paper.
+
+      ## What is note apps?
+      Note apps is a web application that allows users to create, read, update, and delete notes.
+required:
+  - content

docs/openapi/schemas/entity/paper/PaperWithoutAutofieldError.yaml

@@ -0,0 +1,7 @@
+type: object
+description: Error Message for PaperWithoutAutofield object
+properties:
+  content:
+    type: string
+    description: Error message for paper content
+    example: paper content must be less than or equal to 40000 bytes

internal/model/model_graph_content_without_autofield.go

@@ -0,0 +1,17 @@
+/*
+ * Web API of kNODEledge
+ *
+ * App to Create Graphically-Summarized Notes in Three Steps
+ *
+ * API version: 0.1.0
+ * Generated by: OpenAPI Generator (https://openapi-generator.tech)
+ */
+
+package model
+
+// GraphContentWithoutAutofield - Graph object with only content fields without auto-generated fields
+type GraphContentWithoutAutofield struct {
+
+	// Graph paragraph
+	Paragraph string `json:"paragraph"`
+}

internal/model/model_graph_content_without_autofield_error.go

@@ -0,0 +1,17 @@
+/*
+ * Web API of kNODEledge
+ *
+ * App to Create Graphically-Summarized Notes in Three Steps
+ *
+ * API version: 0.1.0
+ * Generated by: OpenAPI Generator (https://openapi-generator.tech)
+ */
+
+package model
+
+// GraphContentWithoutAutofieldError - Error Message for GraphContentWithoutAutofield object
+type GraphContentWithoutAutofieldError struct {
+
+	// Error message for graph paragraph
+	Paragraph string `json:"paragraph,omitempty"`
+}

internal/model/model_paper_without_autofield.go

@@ -0,0 +1,17 @@
+/*
+ * Web API of kNODEledge
+ *
+ * App to Create Graphically-Summarized Notes in Three Steps
+ *
+ * API version: 0.1.0
+ * Generated by: OpenAPI Generator (https://openapi-generator.tech)
+ */
+
+package model
+
+// PaperWithoutAutofield - Paper object without auto-generated fields
+type PaperWithoutAutofield struct {
+
+	// Paper content
+	Content string `json:"content"`
+}

internal/model/model_paper_without_autofield_error.go

@@ -0,0 +1,17 @@
+/*
+ * Web API of kNODEledge
+ *
+ * App to Create Graphically-Summarized Notes in Three Steps
+ *
+ * API version: 0.1.0
+ * Generated by: OpenAPI Generator (https://openapi-generator.tech)
+ */
+
+package model
+
+// PaperWithoutAutofieldError - Error Message for PaperWithoutAutofield object
+type PaperWithoutAutofieldError struct {
+
+	// Error message for paper content
+	Content string `json:"content,omitempty"`
+}