@readyfor/api-client-readyfor 1.140.0 → 1.142.0

package/dist/{schemaType-DO_BYVpw.d.ts → schemaType-C_2NyvB5.d.ts}

@@ -3786,10 +3786,22 @@ interface paths {
   };
   "/api/v1/engagement/projects/{project_keyword}": {
     /**
-     * 公開中のプロジェクトのサマリを取得する
+     * プロジェクト詳細のサマリを取得する
      * @description ログインと認可を必要としない公開 API。
-     * プロジェクトの基本情報と進捗、タブの件数を返す。
-     * 非公開・掲載終了・公開準備中のプロジェクトは 404 を返す。
+     * プロジェクト詳細が描画する 4 つの状態を `__type` で出し分ける。
+     *
+     * - Spot / Steady: 公開中。基本情報と進捗、タブの件数を返す
+     * - ComingSoon: 公開準備中。URL を共有できるようにするための最小限のサマリ
+     * - Terminated: 掲載終了。固定の文言だけの画面なので `__type` しか返さない
+     *
+     * ⚠️ ComingSoon と Terminated は Spot / Steady と項目を共有しない。
+     * 進捗や件数を持たないため、`__type` で絞り込んでから参照すること。
+     *
+     * 判定は ComingSoon を先に見る。通常のデータでは両立しないが、
+     * `veiled_at` を立てられるのは募集を終えた state だけなので、順序を固定しておく。
+     *
+     * ⚠️ レスポンスをキャッシュしない。ComingSoon の判定は最終更新からの経過時間を
+     * 含むため、プロジェクトに変化が無くても時間の経過だけで 404 に変わる。
      */
     get: operations["GetEngagementProjectsProjectKeyword"];
   };
@@ -3874,6 +3886,10 @@ interface paths {
      * プロジェクトの実行者プロフィールを取得する
      * @description ログインと認可を必要としない公開 API。
      * プロジェクトが公開されていれば、実行者が未確認・退会済みでも 200 を返す。
+     * 公開準備中（coming_soon）も、公開準備中ページが実行者を表示するため 200 を返す。
+     * ⚠️ 現行の公開準備中ページが使う実行者情報は id / name / imageUrl と実行者ページへの
+     * リンクだけで、description と sns は公開中のページにしか出ていない。本 EP は公開状態で
+     * 返す項目を変えないため、公開準備中でも両方を返す。表示を広げるかは画面側で決める。
      */
     get: operations["GetEngagementProjectsProjectKeywordOwner"];
   };
@@ -9162,6 +9178,7 @@ interface components {
      *       "currentGoalPrice": 7
      *     },
      *     "title": "title",
+     *     "likeCharity": true,
      *     "fundedPercent": 6.84685269835264,
      *     "expiredAt": "2000-01-23T04:56:07.000Z",
      *     "countingAt": "2000-01-23T04:56:07.000Z",
@@ -9182,6 +9199,8 @@ interface components {
      *       "value": "value"
      *     },
      *     "__type": "Spot",
+     *     "projectBackingStatus": "suspended",
+     *     "likeUnsuccessful": true,
      *     "isAccomplishReportPublished": true,
      *     "id": 0,
      *     "state": "new",
@@ -9209,16 +9228,17 @@ interface components {
      *       "tags",
      *       "tags"
      *     ],
+     *     "likeSuccessful": true,
      *     "topImages": [
      *       {
-     *         "src": "https://openapi-generator.tech",
-     *         "alt": "alt"
+     *         "src": "https://openapi-generator.tech"
      *       },
      *       {
-     *         "src": "https://openapi-generator.tech",
-     *         "alt": "alt"
+     *         "src": "https://openapi-generator.tech"
      *       }
      *     ],
+     *     "isClosed": true,
+     *     "likeCounting": true,
      *     "commentsCount": 1,
      *     "fundingModel": "allOrNothing",
      *     "goalPrice": 1,
@@ -9230,34 +9250,37 @@ interface components {
      *       "rewards": [
      *         {
      *           "image": "",
+     *           "isSystemUsageFeeCase": true,
+     *           "title": "title",
+     *           "buyableStatus": "available",
+     *           "paymentType": "onetime",
      *           "shipmentSchedule": "shipmentSchedule",
+     *           "sellingStopped": true,
      *           "price": 9,
      *           "minPrice": 3,
-     *           "isSystemUsageFeeCase": true,
      *           "descriptionHtml": "descriptionHtml",
      *           "id": 7,
-     *           "title": "title",
-     *           "buyableStatus": "available",
      *           "reservedStockCount": 2,
-     *           "stockCount": 4,
-     *           "paymentType": "onetime"
+     *           "stockCount": 4
      *         },
      *         {
      *           "image": "",
+     *           "isSystemUsageFeeCase": true,
+     *           "title": "title",
+     *           "buyableStatus": "available",
+     *           "paymentType": "onetime",
      *           "shipmentSchedule": "shipmentSchedule",
+     *           "sellingStopped": true,
      *           "price": 9,
      *           "minPrice": 3,
-     *           "isSystemUsageFeeCase": true,
      *           "descriptionHtml": "descriptionHtml",
      *           "id": 7,
-     *           "title": "title",
-     *           "buyableStatus": "available",
      *           "reservedStockCount": 2,
-     *           "stockCount": 4,
-     *           "paymentType": "onetime"
+     *           "stockCount": 4
      *         }
      *       ]
      *     },
+     *     "isExpired": true,
      *     "daysUntilExpiration": 5,
      *     "effectivePrimaryProgress": 9.965781217890562
      *   },
@@ -9287,31 +9310,33 @@ interface components {
      *     "rewards": [
      *       {
      *         "image": "",
+     *         "isSystemUsageFeeCase": true,
+     *         "title": "title",
+     *         "buyableStatus": "available",
+     *         "paymentType": "onetime",
      *         "shipmentSchedule": "shipmentSchedule",
+     *         "sellingStopped": true,
      *         "price": 9,
      *         "minPrice": 3,
-     *         "isSystemUsageFeeCase": true,
      *         "descriptionHtml": "descriptionHtml",
      *         "id": 7,
-     *         "title": "title",
-     *         "buyableStatus": "available",
      *         "reservedStockCount": 2,
-     *         "stockCount": 4,
-     *         "paymentType": "onetime"
+     *         "stockCount": 4
      *       },
      *       {
      *         "image": "",
+     *         "isSystemUsageFeeCase": true,
+     *         "title": "title",
+     *         "buyableStatus": "available",
+     *         "paymentType": "onetime",
      *         "shipmentSchedule": "shipmentSchedule",
+     *         "sellingStopped": true,
      *         "price": 9,
      *         "minPrice": 3,
-     *         "isSystemUsageFeeCase": true,
      *         "descriptionHtml": "descriptionHtml",
      *         "id": 7,
-     *         "title": "title",
-     *         "buyableStatus": "available",
      *         "reservedStockCount": 2,
-     *         "stockCount": 4,
-     *         "paymentType": "onetime"
+     *         "stockCount": 4
      *       }
      *     ]
      *   }
@@ -9337,6 +9362,7 @@ interface components {
      *       "currentGoalPrice": 7
      *     },
      *     "title": "title",
+     *     "likeCharity": true,
      *     "fundedPercent": 6.84685269835264,
      *     "expiredAt": "2000-01-23T04:56:07.000Z",
      *     "countingAt": "2000-01-23T04:56:07.000Z",
@@ -9357,6 +9383,8 @@ interface components {
      *       "value": "value"
      *     },
      *     "__type": "Spot",
+     *     "projectBackingStatus": "suspended",
+     *     "likeUnsuccessful": true,
      *     "isAccomplishReportPublished": true,
      *     "id": 0,
      *     "state": "new",
@@ -9384,16 +9412,17 @@ interface components {
      *       "tags",
      *       "tags"
      *     ],
+     *     "likeSuccessful": true,
      *     "topImages": [
      *       {
-     *         "src": "https://openapi-generator.tech",
-     *         "alt": "alt"
+     *         "src": "https://openapi-generator.tech"
      *       },
      *       {
-     *         "src": "https://openapi-generator.tech",
-     *         "alt": "alt"
+     *         "src": "https://openapi-generator.tech"
      *       }
      *     ],
+     *     "isClosed": true,
+     *     "likeCounting": true,
      *     "commentsCount": 1,
      *     "fundingModel": "allOrNothing",
      *     "goalPrice": 1,
@@ -9405,34 +9434,37 @@ interface components {
      *       "rewards": [
      *         {
      *           "image": "",
+     *           "isSystemUsageFeeCase": true,
+     *           "title": "title",
+     *           "buyableStatus": "available",
+     *           "paymentType": "onetime",
      *           "shipmentSchedule": "shipmentSchedule",
+     *           "sellingStopped": true,
      *           "price": 9,
      *           "minPrice": 3,
-     *           "isSystemUsageFeeCase": true,
      *           "descriptionHtml": "descriptionHtml",
      *           "id": 7,
-     *           "title": "title",
-     *           "buyableStatus": "available",
      *           "reservedStockCount": 2,
-     *           "stockCount": 4,
-     *           "paymentType": "onetime"
+     *           "stockCount": 4
      *         },
      *         {
      *           "image": "",
+     *           "isSystemUsageFeeCase": true,
+     *           "title": "title",
+     *           "buyableStatus": "available",
+     *           "paymentType": "onetime",
      *           "shipmentSchedule": "shipmentSchedule",
+     *           "sellingStopped": true,
      *           "price": 9,
      *           "minPrice": 3,
-     *           "isSystemUsageFeeCase": true,
      *           "descriptionHtml": "descriptionHtml",
      *           "id": 7,
-     *           "title": "title",
-     *           "buyableStatus": "available",
      *           "reservedStockCount": 2,
-     *           "stockCount": 4,
-     *           "paymentType": "onetime"
+     *           "stockCount": 4
      *         }
      *       ]
      *     },
+     *     "isExpired": true,
      *     "daysUntilExpiration": 5,
      *     "effectivePrimaryProgress": 9.965781217890562
      *   }
@@ -9453,31 +9485,33 @@ interface components {
      *     "rewards": [
      *       {
      *         "image": "",
+     *         "isSystemUsageFeeCase": true,
+     *         "title": "title",
+     *         "buyableStatus": "available",
+     *         "paymentType": "onetime",
      *         "shipmentSchedule": "shipmentSchedule",
+     *         "sellingStopped": true,
      *         "price": 9,
      *         "minPrice": 3,
-     *         "isSystemUsageFeeCase": true,
      *         "descriptionHtml": "descriptionHtml",
      *         "id": 7,
-     *         "title": "title",
-     *         "buyableStatus": "available",
      *         "reservedStockCount": 2,
-     *         "stockCount": 4,
-     *         "paymentType": "onetime"
+     *         "stockCount": 4
      *       },
      *       {
      *         "image": "",
+     *         "isSystemUsageFeeCase": true,
+     *         "title": "title",
+     *         "buyableStatus": "available",
+     *         "paymentType": "onetime",
      *         "shipmentSchedule": "shipmentSchedule",
+     *         "sellingStopped": true,
      *         "price": 9,
      *         "minPrice": 3,
-     *         "isSystemUsageFeeCase": true,
      *         "descriptionHtml": "descriptionHtml",
      *         "id": 7,
-     *         "title": "title",
-     *         "buyableStatus": "available",
      *         "reservedStockCount": 2,
-     *         "stockCount": 4,
-     *         "paymentType": "onetime"
+     *         "stockCount": 4
      *       }
      *     ]
      *   }
@@ -10694,7 +10728,7 @@ interface components {
       pagination: components["schemas"]["Engagement_Projects_Pagination"];
     };
     /** Engagement_Project_Summary */
-    Engagement_Project_Summary: components["schemas"]["Engagement_Project_SummarySpot"] | components["schemas"]["Engagement_Project_SummarySteady"];
+    Engagement_Project_Summary: components["schemas"]["Engagement_Project_SummarySpot"] | components["schemas"]["Engagement_Project_SummarySteady"] | components["schemas"]["Engagement_Project_SummaryComingSoon"] | components["schemas"]["Engagement_Project_SummaryTerminated"];
     /**
      * Engagement_Project_AccomplishReport
      * @description 公開済みの終了報告
@@ -11005,7 +11039,10 @@ interface components {
        * @description このプロジェクトの実行者が団体かどうか。
        * JSON-LD の author の型を Organization と Person のどちらにするかの判定に使う。
        * schema.org の語彙そのものは返さず、FE が変換する。
-       * 団体実行者の概念を持たない世代のプロジェクトでは常に false
+       * 団体実行者の概念を持たない世代のプロジェクトでは常に false。
+       * ⚠️ 公開準備中は実行者情報が未入力でも返るため、団体でも false になりうる。
+       * この値を読む活動報告の一覧と個別は公開準備中では 404 になるので、
+       * 読む場面は無い
        */
       isGroupProjectOwner: boolean;
     };
@@ -16666,6 +16703,7 @@ interface components {
      *     "currentGoalPrice": 7
      *   },
      *   "title": "title",
+     *   "likeCharity": true,
      *   "fundedPercent": 6.84685269835264,
      *   "expiredAt": "2000-01-23T04:56:07.000Z",
      *   "countingAt": "2000-01-23T04:56:07.000Z",
@@ -16686,6 +16724,8 @@ interface components {
      *     "value": "value"
      *   },
      *   "__type": "Spot",
+     *   "projectBackingStatus": "suspended",
+     *   "likeUnsuccessful": true,
      *   "isAccomplishReportPublished": true,
      *   "id": 0,
      *   "state": "new",
@@ -16713,16 +16753,17 @@ interface components {
      *     "tags",
      *     "tags"
      *   ],
+     *   "likeSuccessful": true,
      *   "topImages": [
      *     {
-     *       "src": "https://openapi-generator.tech",
-     *       "alt": "alt"
+     *       "src": "https://openapi-generator.tech"
      *     },
      *     {
-     *       "src": "https://openapi-generator.tech",
-     *       "alt": "alt"
+     *       "src": "https://openapi-generator.tech"
      *     }
      *   ],
+     *   "isClosed": true,
+     *   "likeCounting": true,
      *   "commentsCount": 1,
      *   "fundingModel": "allOrNothing",
      *   "goalPrice": 1,
@@ -16734,34 +16775,37 @@ interface components {
      *     "rewards": [
      *       {
      *         "image": "",
+     *         "isSystemUsageFeeCase": true,
+     *         "title": "title",
+     *         "buyableStatus": "available",
+     *         "paymentType": "onetime",
      *         "shipmentSchedule": "shipmentSchedule",
+     *         "sellingStopped": true,
      *         "price": 9,
      *         "minPrice": 3,
-     *         "isSystemUsageFeeCase": true,
      *         "descriptionHtml": "descriptionHtml",
      *         "id": 7,
-     *         "title": "title",
-     *         "buyableStatus": "available",
      *         "reservedStockCount": 2,
-     *         "stockCount": 4,
-     *         "paymentType": "onetime"
+     *         "stockCount": 4
      *       },
      *       {
      *         "image": "",
+     *         "isSystemUsageFeeCase": true,
+     *         "title": "title",
+     *         "buyableStatus": "available",
+     *         "paymentType": "onetime",
      *         "shipmentSchedule": "shipmentSchedule",
+     *         "sellingStopped": true,
      *         "price": 9,
      *         "minPrice": 3,
-     *         "isSystemUsageFeeCase": true,
      *         "descriptionHtml": "descriptionHtml",
      *         "id": 7,
-     *         "title": "title",
-     *         "buyableStatus": "available",
      *         "reservedStockCount": 2,
-     *         "stockCount": 4,
-     *         "paymentType": "onetime"
+     *         "stockCount": 4
      *       }
      *     ]
      *   },
+     *   "isExpired": true,
      *   "daysUntilExpiration": 5,
      *   "effectivePrimaryProgress": 9.965781217890562
      * }
@@ -16848,31 +16892,33 @@ interface components {
      *   "rewards": [
      *     {
      *       "image": "",
+     *       "isSystemUsageFeeCase": true,
+     *       "title": "title",
+     *       "buyableStatus": "available",
+     *       "paymentType": "onetime",
      *       "shipmentSchedule": "shipmentSchedule",
+     *       "sellingStopped": true,
      *       "price": 9,
      *       "minPrice": 3,
-     *       "isSystemUsageFeeCase": true,
      *       "descriptionHtml": "descriptionHtml",
      *       "id": 7,
-     *       "title": "title",
-     *       "buyableStatus": "available",
      *       "reservedStockCount": 2,
-     *       "stockCount": 4,
-     *       "paymentType": "onetime"
+     *       "stockCount": 4
      *     },
      *     {
      *       "image": "",
+     *       "isSystemUsageFeeCase": true,
+     *       "title": "title",
+     *       "buyableStatus": "available",
+     *       "paymentType": "onetime",
      *       "shipmentSchedule": "shipmentSchedule",
+     *       "sellingStopped": true,
      *       "price": 9,
      *       "minPrice": 3,
-     *       "isSystemUsageFeeCase": true,
      *       "descriptionHtml": "descriptionHtml",
      *       "id": 7,
-     *       "title": "title",
-     *       "buyableStatus": "available",
      *       "reservedStockCount": 2,
-     *       "stockCount": 4,
-     *       "paymentType": "onetime"
+     *       "stockCount": 4
      *     }
      *   ]
      * }
@@ -17138,6 +17184,61 @@ interface components {
        */
       totalNumberOfSupporters: number | null;
     };
+    /**
+     * Engagement_Project_SummaryComingSoon
+     * @description 公開準備中のプロジェクト。URL を共有できるようにするための最小限のサマリで、
+     * 公開済みのプロジェクトが返す進捗や件数は持たない。
+     * 実行者は公開済みと同じく実行者プロフィール API から取る。
+     */
+    Engagement_Project_SummaryComingSoon: {
+      /** @enum {string} */
+      __type: "ComingSoon";
+      /**
+       * Format: int64
+       * @description 公開前は keyword が変わりうるため、共有用の URL は keyword ではなく
+       * この id で組み立てる。
+       */
+      id: number;
+      /** @description 未入力のときは空文字になる */
+      title: string;
+      /**
+       * Format: uri
+       * @description サブ画像のリサイズ済み URL。公開済みが返す topImages とは別の画像
+       */
+      subImageUrl: string;
+      /**
+       * @description permanentSupport はコミュニティ型。新規には作られないが、既存のものは返りうる
+       * @enum {string}
+       */
+      fundingModel: "allOrNothing" | "keepItAll" | "permanentSupport" | "regularSteady";
+      /** @enum {string} */
+      projectType: "normal" | "charity" | "emergency" | "furusatoTax";
+      /**
+       * @description keepItAll は目安金額、allOrNothing は目標金額。
+       * permanentSupport と regularSteady はどちらも持たないため null。
+       * 公開前は未入力でも保存できるため、allOrNothing や keepItAll でも null になりうる。
+       * ⚠️ 公開中のサマリは目標金額を持たないとき 0 を返すが、ここでは null を返す。
+       */
+      goalPrice: number | null;
+      /**
+       * @description 配列ではなくカンマ区切りの 1 つの文字列。
+       * 末尾に READYFOR,クラウドファンディング が必ず付く。
+       */
+      twitterHashTags: string;
+    };
+    /**
+     * Engagement_Project_SummaryTerminated
+     * @description 掲載を終了したプロジェクト。画面は固定の文言だけで、プロジェクト固有の値を使わない。
+     * 表示に必要な項目が増えたらその時点で足す。
+     *
+     * 判定は `public?` かつ `veiled_at` が非 null。state が veiled かどうかは見ない。
+     * veiled は STATE_PUBLIC に含まれ、`veiled_at` が null のまま state だけ veiled の
+     * プロジェクトは通常の公開中として Spot / Steady を返す。
+     */
+    Engagement_Project_SummaryTerminated: {
+      /** @enum {string} */
+      __type: "Terminated";
+    };
     /**
      * Engagement_Project_AnnouncementSummary
      * @description 活動報告のサマリ。活動報告一覧の 1 要素としてのスキーマで、本文は切り詰められている。
@@ -17994,7 +18095,7 @@ interface components {
        * @enum {string}
        */
       projectType: "normal" | "charity" | "emergency" | "furusatoTax";
-      topImages: components["schemas"]["Fundraising_Preview_Image"][];
+      topImages: components["schemas"]["Fundraising_Preview_TopImage"][];
       /** @description 目標達成率（%、上限 100） */
       primaryGoalProgress: number;
       isAccomplishReportPublished: boolean;
@@ -18020,6 +18121,27 @@ interface components {
        * @enum {string}
        */
       rewardNotation: "リターン" | "ギフト" | "コース";
+      /**
+       * @description state が successful のときと、期限を過ぎていて成立の条件を満たすとき true。
+       * 条件は DB の目標金額と決済バッチの開始で判定するため、amount と goalPrice の比較では再現できない。
+       */
+      likeSuccessful?: boolean;
+      /** @description state が unsuccessful のときと、期限を過ぎていて成立の条件を満たさないとき true */
+      likeUnsuccessful?: boolean;
+      likeCounting?: boolean;
+      isExpired?: boolean;
+      /** @description state が unsuccessful / successful / suspended / veiled / counting のいずれか */
+      isClosed?: boolean;
+      /** @description projectType が normal 以外。「支援」と「寄付」の文言の切り替えに使う */
+      likeCharity?: boolean;
+      /**
+       * @description suspended は掲載停止、counting は集計中、successful は成立、unsuccessful は不成立。
+       * 募集終了後は state が successful / unsuccessful でなくても、目標達成の可否でこの 2 つに決まる。
+       * どれにも当てはまらないときは null。プレビューは未ログインの閲覧者として表示するので、null のときの支援ボタンは purchase にする。
+       *
+       * @enum {string|null}
+       */
+      projectBackingStatus?: "suspended" | "counting" | "successful" | "unsuccessful" | null;
     };
     /**
      * Fundraising_Preview_RiskAndChallengeItem
@@ -18040,17 +18162,18 @@ interface components {
      * @description プレビュー用リワード
      * @example {
      *   "image": "",
+     *   "isSystemUsageFeeCase": true,
+     *   "title": "title",
+     *   "buyableStatus": "available",
+     *   "paymentType": "onetime",
      *   "shipmentSchedule": "shipmentSchedule",
+     *   "sellingStopped": true,
      *   "price": 9,
      *   "minPrice": 3,
-     *   "isSystemUsageFeeCase": true,
      *   "descriptionHtml": "descriptionHtml",
      *   "id": 7,
-     *   "title": "title",
-     *   "buyableStatus": "available",
      *   "reservedStockCount": 2,
-     *   "stockCount": 4,
-     *   "paymentType": "onetime"
+     *   "stockCount": 4
      * }
      */
     Fundraising_Preview_Reward: {
@@ -18058,7 +18181,7 @@ interface components {
       /** @description リワード金額（未入力時は null） */
       price: number | null;
       minPrice: number | null;
-      image: components["schemas"]["Fundraising_Preview_Image"] | null;
+      image: components["schemas"]["Fundraising_Preview_RewardImage"] | null;
       /** @description リワードタイトル（未入力時は null） */
       title: string | null;
       /** @description リワード説明（未入力時は null）。XSS safe な HTML 文字列。`<br>` と `<a href="https://..." target="_blank" rel="noopener noreferrer">` のみ含む可能性あり。バックエンドで `html_escape` 適用済み */
@@ -18072,6 +18195,8 @@ interface components {
       paymentType: "onetime" | "monthly" | "yearly";
       /** @enum {string} */
       buyableStatus: "available" | "stockExhausted" | "sellingStopped" | "projectClosed" | "projectSuspended";
+      /** @description 販売停止中なら true。buyableStatus と違い、プロジェクトが終了・中止していても販売停止なら true */
+      sellingStopped?: boolean;
       isSystemUsageFeeCase: boolean;
     };
     /**
@@ -18319,17 +18444,15 @@ interface components {
      */
     Fundraising_Project_ProjectStatusWithReviewEnum: "draft" | "prepared" | "open";
     /**
-     * Fundraising_Preview_Image
-     * @description 画像
+     * Fundraising_Preview_TopImage
+     * @description プロジェクトの上部に並べる画像
      * @example {
-     *   "src": "https://openapi-generator.tech",
-     *   "alt": "alt"
+     *   "src": "https://openapi-generator.tech"
      * }
      */
-    Fundraising_Preview_Image: {
+    Fundraising_Preview_TopImage: {
       /** Format: uri */
       src: string;
-      alt: string;
     };
     /**
      * Fundraising_Preview_ProjectOwner
@@ -18355,6 +18478,15 @@ interface components {
       imageUrl: string;
       publicLink: components["schemas"]["Fundraising_Preview_PublicLink"];
     };
+    /**
+     * Fundraising_Preview_RewardImage
+     * @description リターンの画像
+     */
+    Fundraising_Preview_RewardImage: {
+      /** Format: uri */
+      src: string;
+      alt: string;
+    };
     /**
      * Engagement_Project_SummaryTopImage
      * @description プロジェクト詳細の上部に並べる画像
@@ -23260,10 +23392,22 @@ interface operations {
     };
   };
   /**
-   * 公開中のプロジェクトのサマリを取得する
+   * プロジェクト詳細のサマリを取得する
    * @description ログインと認可を必要としない公開 API。
-   * プロジェクトの基本情報と進捗、タブの件数を返す。
-   * 非公開・掲載終了・公開準備中のプロジェクトは 404 を返す。
+   * プロジェクト詳細が描画する 4 つの状態を `__type` で出し分ける。
+   *
+   * - Spot / Steady: 公開中。基本情報と進捗、タブの件数を返す
+   * - ComingSoon: 公開準備中。URL を共有できるようにするための最小限のサマリ
+   * - Terminated: 掲載終了。固定の文言だけの画面なので `__type` しか返さない
+   *
+   * ⚠️ ComingSoon と Terminated は Spot / Steady と項目を共有しない。
+   * 進捗や件数を持たないため、`__type` で絞り込んでから参照すること。
+   *
+   * 判定は ComingSoon を先に見る。通常のデータでは両立しないが、
+   * `veiled_at` を立てられるのは募集を終えた state だけなので、順序を固定しておく。
+   *
+   * ⚠️ レスポンスをキャッシュしない。ComingSoon の判定は最終更新からの経過時間を
+   * 含むため、プロジェクトに変化が無くても時間の経過だけで 404 に変わる。
    */
   GetEngagementProjectsProjectKeyword: {
     parameters: {
@@ -23278,7 +23422,11 @@ interface operations {
           "application/json": components["schemas"]["Engagement_Project_Summary"];
         };
       };
-      /** @description プロジェクトが見つからなかった場合に返す */
+      /**
+       * @description プロジェクトが見つからなかった場合に返す。
+       * まだ公開されたことがなく ComingSoon の条件も満たさないプロジェクトを含む。
+       * 掲載終了（veiled）はここに含まない。Terminated として 200 を返す。
+       */
       404: {
         content: {
           "application/json": components["schemas"]["HttpErrorNotFound"];
@@ -23305,8 +23453,12 @@ interface operations {
         };
       };
       /**
-       * @description プロジェクトが見つからない、非公開、成立していない、
-       * または終了報告が未作成・未公開の場合に返す
+       * @description プロジェクトが見つからない、終了報告を表示できる状態にない、
+       * または終了報告が未作成・未公開の場合に返す。
+       * 公開準備中（coming_soon）・掲載終了（veiled）・未公開のプロジェクトを含む。
+       * 公開されていても成立していないプロジェクトはここに含む。
+       * 本 EP が 404 でもページ全体を 404 にはしない。
+       * 掲載終了なら 5 URL すべてが掲載終了の画面になる。
        */
       404: {
         content: {
@@ -23345,7 +23497,13 @@ interface operations {
           "application/json": components["schemas"]["GetEngagementProjectsProjectKeywordAnnouncements"];
         };
       };
-      /** @description プロジェクトが見つからなかった場合に返す */
+      /**
+       * @description プロジェクトが見つからない、またはこの一覧を表示できる状態にない場合に返す。
+       * 公開準備中（coming_soon）・掲載終了（veiled）・未公開のプロジェクトを含む。
+       * どの状態かはサマリ API の `__type` で判別する。
+       * 本 EP が 404 でもページ全体を 404 にはしない。
+       * 掲載終了なら 5 URL すべてが掲載終了の画面になる。
+       */
       404: {
         content: {
           "application/json": components["schemas"]["HttpErrorNotFound"];
@@ -23430,7 +23588,13 @@ interface operations {
           "application/json": components["schemas"]["GetEngagementProjectsProjectKeywordComments"];
         };
       };
-      /** @description プロジェクトが見つからなかった場合に返す */
+      /**
+       * @description プロジェクトが見つからない、またはこの一覧を表示できる状態にない場合に返す。
+       * 公開準備中（coming_soon）・掲載終了（veiled）・未公開のプロジェクトを含む。
+       * どの状態かはサマリ API の `__type` で判別する。
+       * 本 EP が 404 でもページ全体を 404 にはしない。
+       * 掲載終了なら 5 URL すべてが掲載終了の画面になる。
+       */
       404: {
         content: {
           "application/json": components["schemas"]["HttpErrorNotFound"];
@@ -23465,7 +23629,7 @@ interface operations {
       };
       /**
        * @description プロジェクトが見つからない、または本文を表示できる状態にない場合に返す。
-       * 公開前（coming_soon）・公開停止（veiled）・非公開のプロジェクトを含む。
+       * 公開準備中（coming_soon）・掲載終了（veiled）・未公開のプロジェクトを含む。
        * FE は公開サマリと本 EP を並列で取得し、本 EP が 404 のときは本文を描画しない。
        * ページ全体を 404 にはしない。
        */
@@ -23534,6 +23698,10 @@ interface operations {
    * プロジェクトの実行者プロフィールを取得する
    * @description ログインと認可を必要としない公開 API。
    * プロジェクトが公開されていれば、実行者が未確認・退会済みでも 200 を返す。
+   * 公開準備中（coming_soon）も、公開準備中ページが実行者を表示するため 200 を返す。
+   * ⚠️ 現行の公開準備中ページが使う実行者情報は id / name / imageUrl と実行者ページへの
+   * リンクだけで、description と sns は公開中のページにしか出ていない。本 EP は公開状態で
+   * 返す項目を変えないため、公開準備中でも両方を返す。表示を広げるかは画面側で決める。
    */
   GetEngagementProjectsProjectKeywordOwner: {
     parameters: {
@@ -23555,7 +23723,8 @@ interface operations {
       };
       /**
        * @description プロジェクトが見つからない、または実行者プロフィールを表示できる状態にない場合に返す。
-       * 公開前（coming_soon）・公開停止（veiled）・非公開のプロジェクトを含む。
+       * 掲載終了（veiled）と、まだ公開されたことがなく coming_soon の条件も満たさない
+       * プロジェクトを含む。掲載終了の画面は実行者を表示しないため、ここに含める。
        * FE は公開サマリと本 EP を並列で取得し、本 EP が 404 のときは実行者プロフィールを描画しない。
        * ページ全体を 404 にはしない。
        */
@@ -23608,7 +23777,7 @@ interface operations {
       };
       /**
        * @description プロジェクトが見つからない、またはリターン一覧を表示できる状態にない場合に返す。
-       * 公開前（coming_soon）・公開停止（veiled）・非公開のプロジェクトを含む。
+       * 公開準備中（coming_soon）・掲載終了（veiled）・未公開のプロジェクトを含む。
        * FE は公開サマリと本 EP を並列で取得し、本 EP が 404 のときはリターン一覧を描画しない。
        * ページ全体を 404 にはしない。
        */
@@ -23688,7 +23857,13 @@ interface operations {
           "application/json": components["schemas"]["Engagement_Tags"];
         };
       };
-      /** @description プロジェクトが見つからなかった場合に返す */
+      /**
+       * @description プロジェクトが見つからない、またはタグを表示できる状態にない場合に返す。
+       * 公開準備中（coming_soon）・掲載終了（veiled）・未公開のプロジェクトを含む。
+       * どの状態かはサマリ API の `__type` で判別する。
+       * 本 EP が 404 でもページ全体を 404 にはしない。
+       * 掲載終了なら 5 URL すべてが掲載終了の画面になる。
+       */
       404: {
         content: {
           "application/json": components["schemas"]["HttpErrorNotFound"];