feat: invoiceのstatusの定義を共通スキーマInvoiceStatusに統一

openapi.yaml

@@ -1,4 +1,4 @@
 openapi: 3.1.0
 
 info:
   title: Checkin API
@@ -7,7 +7,7 @@
 
 paths:
   /verify-email:
     post:
       summary: isct メールアドレスの確認メールを送信
       tags:
         - Auth
@@ -32,7 +32,7 @@
         '500':
           $ref: '#/components/responses/InternalServerError'
   /verify-email/confirm:
     get:
       summary: メール確認トークンの確認ページを表示
       tags:
         - Auth
@@ -64,7 +64,7 @@
           $ref: '#/components/responses/Unauthorized'
         '500':
           $ref: '#/components/responses/InternalServerError'
     post:
       summary: メール確認トークンを消費してログインを完了
       tags:
         - Auth
@@ -103,7 +103,7 @@
         '500':
           $ref: '#/components/responses/InternalServerError'
   /csrf:
     get:
       summary: CSRF トークン用 cookie を発行
       tags:
         - Auth
@@ -218,7 +218,7 @@
         '500':
           $ref: '#/components/responses/InternalServerError'
   /invoices:
     get:
       summary: 請求書由来の入金一覧を取得
       tags:
         - Invoice
@@ -233,13 +233,7 @@
           description: 請求書ステータス
           in: query
           schema:
-            type: string
-            enum:
-              - draft
-              - open
-              - paid
-              - uncollectible
-              - void
+            $ref: '#/components/schemas/InvoiceStatus'
         - name: collection_method
           description: 請求書の支払い方法
           in: query
@@ -288,7 +282,7 @@
         '500':
           $ref: '#/components/responses/InternalServerError'
   /webhook/invoice-paid:
     post:
       summary: Webhook の invoice.paid イベントを受け取る
       tags:
         - Webhook
@@ -315,7 +309,7 @@
           $ref: '#/components/responses/InternalServerError'
 
   /checkout/sessions:
     get:
       summary: オンライン決済ページ由来の入金一覧を取得
       tags:
         - CheckoutSession
@@ -352,7 +346,7 @@
         '500':
           $ref: '#/components/responses/InternalServerError'
   /admin:
     get:
       summary: 管理者の一覧を取得
       tags:
         - Admin
@@ -536,6 +530,16 @@
       required:
         - customer_id
         - product_id
+    InvoiceStatus:
+      description: 請求書ステータス
+      type: string
+      enum:
+        - draft
+        - open
+        - paid
+        - uncollectible
+        - void
+      example: draft
     PostInvoiceResponse:
       description: Invoice creation result
       type: object
@@ -590,15 +594,7 @@
               customer:
                 $ref: '#/components/schemas/Customer'
               status:
-                type: string
-                description: 請求書ステータス
-                enum:
-                  - draft
-                  - open
-                  - paid
-                  - uncollectible
-                  - void
-                example: draft
+                $ref: '#/components/schemas/InvoiceStatus'
               payment_intent:
                 type:
                   - string