cuopt-server-common

cuOpt Server（共通）

cuOpt REST サーバーのドメイン概念です。デプロイコマンドやクライアントコードは含まれません。

サーバーの動作

• HTTP 経由で最適化リクエスト（ルーティング、LP、MILP）を受け付けます。
• リクエスト ID を返します。ソリューションは、その ID でポーリングして取得します。
• REST 経由の QP はサポートしていません。

サポートされる問題タイプ

問題タイプ	サポート状況
ルーティング	✓
LP	✓
MILP	✓
QP	✗

リクエストの流れ（概念）

1. クライアントが必要なスキーマ（行列、タスク、車両、ソルバー設定）に従って問題データを送信します。
2. サーバーが reqId を返します。
3. クライアントはジョブが完了するまで、reqId を使ってソリューションエンドポイントをポーリングします。
4. レスポンスにはステータスが含まれ、成功した場合はソリューション（ルート、目的関数値、主変数値など）も含まれます。

確認事項（デプロイと使用方法）

不明な場合は、以下を確認してください。

1. 問題タイプ — ルーティングと LP／MILP のどちらですか？（QP は利用できません。）
2. デプロイ方法 — ローカル、Docker、Kubernetes、クラウドのいずれですか？
3. クライアント — API の呼び出しに使用する言語またはツール（例：Python、curl、別のサービス）は何ですか？

主なエンドポイント（概念）

• ヘルスチェック。
• リクエストの送信（POST）。
• リクエスト ID によるソリューションの取得（GET）。
• OpenAPI 仕様（ペイロード形式など）。