move api spec

.claude/settings.local.json

@@ -8,9 +8,18 @@
       "Bash(./gradlew:*)",
       "Bash(docker-compose up:*)",
       "Bash(docker-compose:*)",
-      "Bash(docker logs:*)"
+      "Bash(docker logs:*)",
+      "mcp__serena__get_current_config",
+      "mcp__serena__check_onboarding_performed",
+      "mcp__serena__onboarding",
+      "mcp__serena__list_dir",
+      "mcp__serena__find_file",
+      "mcp__serena__write_memory",
+      "mcp__serena__think_about_whether_you_are_done",
+      "mcp__serena__search_for_pattern",
+      "Bash(cat:*)"
     ],
     "deny": [],
     "ask": []
   }
-}
+}

.github/linters/.redocly.yaml

@@ -0,0 +1,5 @@
+apis:
+  main:
+    root: api-spec/root.json
+rules:
+  no-unresolved-refs: off

.github/workflows/ci.yml

@@ -19,9 +19,11 @@ jobs:
           filters: |
             backend:
               - 'backend/**'
+              - 'api-spec/**'
               - '.github/workflows/**'
             frontend:
               - 'frontend/**'
+              - 'api-spec/**'
               - '.github/workflows/**'
 
   backend_lint:

.gitignore

@@ -1 +1,2 @@
-.serena
+# Serena memory files (local AI assistant context)
+.serena/

backend/src/main/resources/api-spec/model/accountLink.json → api-spec/model/accountLink.json

@@ -9,7 +9,7 @@
     },
     "linking": {
       "type": "boolean",
-      "example": "true"
+      "example": true
     }
   },
   "required": [

backend/src/main/resources/api-spec/model/error/error400.json → api-spec/model/error/error400.json

@@ -8,11 +8,11 @@
   "properties": {
     "status": {
       "type": "integer",
-      "const": 400
+      "enum": [400]
     },
     "description": {
       "type": "string",
-      "const": "BadRequest"
+      "enum": ["BadRequest"]
     }
   },
   "required": [

backend/src/main/resources/api-spec/model/error/error401.json → api-spec/model/error/error401.json

@@ -8,11 +8,11 @@
   "properties": {
     "status": {
       "type": "integer",
-      "const": 401
+      "enum": [401]
     },
     "description": {
       "type": "string",
-      "const": "Unauthorized"
+      "enum": ["Unauthorized"]
     }
   },
   "required": [

api-spec/model/error/error403.json

@@ -0,0 +1,25 @@
+{
+  "allOf": [
+    {
+      "$ref": "./errorBase.json"
+    }
+  ],
+  "type": "object",
+  "properties": {
+    "status": {
+      "type": "integer",
+      "enum": [403]
+    },
+    "description": {
+      "type": "string",
+      "enum": ["Forbidden"]
+    },
+    "cause": {
+      "$ref": "./error403Cause.json"
+    }
+  },
+  "required": [
+    "status",
+    "description"
+  ]
+}

api-spec/model/error/error403Cause.json

@@ -0,0 +1,16 @@
+{
+  "type": "object",
+  "properties": {
+    "kind": {
+      "type": "string",
+      "enum": [
+        "CsrfTokenRequired",
+        "CsrfHeaderRequired",
+        "InvalidOrigin"
+      ]
+    }
+  },
+  "required": [
+    "kind"
+  ]
+}

backend/src/main/resources/api-spec/model/error/error404.json → api-spec/model/error/error404.json

@@ -8,11 +8,11 @@
   "properties": {
     "status": {
       "type": "integer",
-      "const": 404
+      "enum": [404]
     },
     "description": {
       "type": "string",
-      "const": "NotFound"
+      "enum": ["NotFound"]
     }
   },
   "required": [

backend/src/main/resources/api-spec/model/error/error409.json → api-spec/model/error/error409.json

@@ -8,11 +8,11 @@
   "properties": {
     "status": {
       "type": "integer",
-      "const": 409
+      "enum": [409]
     },
     "description": {
       "type": "string",
-      "const": "Conflict"
+      "enum": ["Conflict"]
     }
   },
   "required": [

backend/src/main/resources/api-spec/model/error/errorBase.json → api-spec/model/error/errorBase.json

@@ -4,7 +4,7 @@
     "status": {
       "type": "integer",
       "minimum": 400,
-      "exclusiveMaximum": 600,
+      "maximum": 599,
       "example": 401
     },
     "description": {

backend/src/main/resources/api-spec/path/entries/_serialNumber/_serialNumber.json → api-spec/path/entries/_serialNumber/_serialNumber.json

@@ -52,6 +52,7 @@
         "description": "unauthorized or not signed in"
       },
       "403": {
+        "description": "Forbidden",
         "content": {
           "application/json": {
             "schema": {

backend/src/main/resources/api-spec/path/entries/_serialNumber/comments/_commentId/_commentId.json → api-spec/path/entries/_serialNumber/comments/_commentId/_commentId.json

@@ -12,6 +12,7 @@
         "description": "unauthorized or not signed in"
       },
       "403": {
+        "description": "Forbidden",
         "content": {
           "application/json": {
             "schema": {

backend/src/main/resources/api-spec/path/entries/_serialNumber/comments/comments.json → api-spec/path/entries/_serialNumber/comments/comments.json

@@ -28,7 +28,7 @@
         "content": {
           "application/json": {
             "schema": {
-              "$ref": "#/components/schemas/Comments"
+              "$ref": "../../../../model/comments.json"
             }
           }
         }
@@ -42,7 +42,7 @@
       "content": {
         "application/json": {
           "schema": {
-            "$ref": "path/entries/_serialNumber/comments/commentsPostRequest.json"
+            "$ref": "./commentsPostRequest.json"
           }
         }
       }
@@ -53,7 +53,7 @@
         "content": {
           "application/json": {
             "schema": {
-              "$ref": "#/components/schemas/Comment"
+              "$ref": "../../../../model/comment.json"
             }
           }
         }
@@ -65,6 +65,7 @@
         "description": "unauthorized to create a new comment"
       },
       "403": {
+        "description": "Forbidden",
         "content": {
           "application/json": {
             "schema": {

backend/src/main/resources/api-spec/path/entries/entries.json → api-spec/path/entries/entries.json

@@ -79,6 +79,7 @@
         }
       },
       "403": {
+        "description": "Forbidden",
         "content": {
           "application/json": {
             "schema": {

backend/src/main/resources/api-spec/path/sign-in/sign-in.json → api-spec/path/sign-in/sign-in.json

@@ -29,6 +29,7 @@
         }
       },
       "403": {
+        "description": "Forbidden",
         "content": {
           "application/json": {
             "schema": {
@@ -38,6 +39,7 @@
         }
       },
       "404": {
+        "description": "Not Found",
         "content": {
           "application/json": {
             "schema": {
@@ -47,6 +49,7 @@
         }
       },
       "409": {
+        "description": "Conflict",
         "content": {
           "application/json": {
             "schema": {

backend/src/main/resources/api-spec/path/sign-out/sign-out.json → api-spec/path/sign-out/sign-out.json

@@ -12,9 +12,12 @@
         }
       },
       "403": {
+        "description": "Forbidden",
         "content": {
           "application/json": {
-            "$ref": "../../model/error/error403.json"
+            "schema": {
+              "$ref": "../../model/error/error403.json"
+            }
           }
         }
       }

backend/src/main/resources/api-spec/path/users/_id/_id.json → api-spec/path/users/_id/_id.json

@@ -58,9 +58,12 @@
         "description": "unauthorized or not signed in"
       },
       "403": {
+        "description": "Forbidden",
         "content": {
           "application/json": {
-            "$ref": "../../../model/error/error403.json"
+            "schema": {
+              "$ref": "../../../model/error/error403.json"
+            }
           }
         }
       }
@@ -84,9 +87,12 @@
         "description": "unauthorized or not signed in"
       },
       "403": {
+        "description": "Forbidden",
         "content": {
           "application/json": {
-            "$ref": "../../../model/error/error403.json"
+            "schema": {
+              "$ref": "../../../model/error/error403.json"
+            }
           }
         }
       }

backend/src/main/resources/api-spec/path/users/admins/admins.json → api-spec/path/users/admins/admins.json

@@ -39,9 +39,12 @@
         "description": "Bad Request"
       },
       "403": {
+        "description": "Forbidden",
         "content": {
           "application/json": {
-            "$ref": "../../../model/error/error403.json"
+            "schema": {
+              "$ref": "../../../model/error/error403.json"
+            }
           }
         }
       }

backend/src/main/resources/api-spec/path/users/users.json → api-spec/path/users/users.json

@@ -54,9 +54,12 @@
         "description": "Bad Request. Maybe screen name is duplicated"
       },
       "403": {
+        "description": "Forbidden",
         "content": {
           "application/json": {
-            "$ref": "../../model/error/error403.json"
+            "schema": {
+              "$ref": "../../model/error/error403.json"
+            }
           }
         }
       }

backend/build.gradle.kts

@@ -45,7 +45,7 @@ application {
 // https://github.com/OpenAPITools/openapi-generator/blob/master/docs/generators/kotlin-server.md
 openApiGenerate {
     generatorName.set("kotlin-server")
-    inputSpec.set("$rootDir/src/main/resources/api-spec/root.json")
+    inputSpec.set("$rootDir/../api-spec/root.json")
     val generatedDirPath =
         layout
             .buildDirectory

backend/src/main/kotlin/com/github/hmiyado/kottage/application/plugins/statuspages/ErrorFactory.kt

@@ -8,14 +8,14 @@ import com.github.hmiyado.kottage.openapi.models.Error409
 object ErrorFactory {
     fun create400(description: String = "BadRequest") =
         Error400(
-            status = 400,
-            description = description,
+            status = Error400.Status._400,
+            description = Error400.Description.BadRequest,
         )
 
     fun create403(kind: Error403Cause.Kind? = null) =
         Error403(
-            status = 403,
-            description = "Forbidden",
+            status = Error403.Status._403,
+            description = Error403.Description.Forbidden,
             cause =
                 kind?.let {
                     Error403Cause(
@@ -26,7 +26,7 @@ object ErrorFactory {
 
     fun create409() =
         Error409(
-            status = 409,
-            description = "Conflict",
+            status = Error409.Status._409,
+            description = Error409.Description.Conflict,
         )
 }

frontend/.gitignore

@@ -53,3 +53,6 @@ yarn-error.log*
 # switch tsconfig.json by environment and replace default config
 tsconfig.json
 tsconfig.tsbuildinfo
+
+# OpenAPI Generator metadata
+src/repository/openapi/generated/.openapi-generator/