GA 準備ロードマップ
EvoMap 開発者プラットフォームは現在ベータとして稼働中です。OAuth、OpenAPI、 テストモード、レシピ API、カタログの読み取り、Webhook、アプリ管理、コンフィデンシャル クライアントのイントロスペクションは今日から使えます。GA とは、面識のない開発者が Web サイトからセルフサービスで始められ、個別のサポートなしで連携でき、安全に運用でき、 何かが壊れたときにサポートを受けられる状態を意味します。
このページでは、ベータとして使える状態と一人前のオープンプラットフォームの 間のギャップを追跡します。
ステータスの凡例
| ステータス | 意味 |
|---|---|
| Live | 外部開発者が今すぐ利用できます。 |
| Beta | 使えますが、サンプル、UX の磨き込み、運用面の堅牢化がまだ必要です。 |
| Planned | 設計が必要で、まだセルフサービスのプラットフォーム機能ではありません。 |
GA 機能マトリクス
| 機能 | 現在のステータス | GA の目標 | 最初に価値が出る範囲 |
|---|---|---|---|
| 1. 多言語 SDK | Planned | OpenAPI から生成した公式の JS/TS、Python、Go SDK に、手書きの OAuth / Webhook ヘルパーを加える。 | OAuth URL ビルダー、トークン交換、カタログ読み取り、テスト公開、Webhook 検証、型付きエラーを備えた @evomap/sdk ベータを公開する。 |
| 2. 統合開発者コンソール | Beta | アプリ、シークレット、スコープ、バージョン、使用量、呼び出し、Webhook、配信、グラント、請求、サポートを 1 つのポータルにまとめる。 | /dev/portal を /dev のフローに組み込み、次に何をすべきか伝える空状態 / エラー状態を追加する。 |
| 3. アプリ審査・バージョン・権限・テナントインストール | Beta | 飛書スタイルのアプリバージョン審査、スコープ申請、テナント / 組織へのインストール、管理者同意、ロールバック履歴。 | 既存のスコープ申請 API とアプリバージョン API を、審査状況と変更履歴つきでポータルに露出する。 |
| 4. イベント購読とリプレイ | Beta | Webhook イベントカタログ、フィルター付き購読、ping、配信ログ、再配信、イベント id 指定でのリプレイ、保持ポリシー。 | 一級の配信詳細ページとリプレイボタンを追加し、リトライ / バックオフ / 保持期間を文書化する。 |
| 5. 充実したサンプル群 | Beta | クイックスタート、レシピ集、Postman / Bruno コレクション、生成クライアント、Webhook 検証、エラー処理、テストモードのデモ。 | 最小サンプルと、ダウンロード可能なサンプルプロジェクトを出す。 |
| 6. API エクスプローラー | Beta | OpenAPI 駆動のブラウザーエクスプローラーに、認証ヘルパー、リクエストビルダー、サンプルスニペット、安全なマスキングを備える。 | /dev/docs/41-api-explorer を堅牢化し、トークンをログに残さずローカルで読み込めるようにして、コピー用の curl / JS / Python を表示する。 |
| 7. エラーコード体系 | Beta | 原因、対処、リトライ可否、サポートへのエスカレーション経路を備えた安定したエラーカタログ。 | errors.md を作り、よくある invalid_*、insufficient_scope、クォータ、モデレーション、べき等性の失敗すべてからリンクする。 |
| 8. マーケットプレイス | Planned | 公開アプリ掲載、開発者プロフィール、アプリインストール、同意前のスコープ表示、レビュー / 評価、掲載取り下げフロー。 | オープンな掲載ではなく、/dev からリンクする厳選パートナーアプリのカードから始める。 |
| 9. 開発者サポートとチケット | Planned | サポートフォーム、コミュニティディスカッション、課題テンプレート、問い合わせ SLA、セキュリティインシデントのエスカレーション。 | GitHub Discussions、メール / フォーム、必須のデバッグ項目を載せた /dev/support またはドキュメントページを追加する。 |
| 10. ステータスページと SLA | Planned | 公開ステータス、インシデント履歴、API 可用性目標、Webhook 配信 SLO、メンテナンス告知。 | /status を /dev からリンクし、開発者向けの API / Webhook のステータス行を追加する。 |
| 11. 権限ガバナンス / 管理者認可 | Beta | 組織全体へのインストールに対する管理者同意、高リスクスコープの警告、最小権限のレビュー、監査ログ。 | ポータルに明示的な管理者同意の状態と、高リスクスコープの警告を追加する。 |
| 12. エンタープライズのテナント分離と監査 | Beta | 組織 / テナント単位の API キー、ウォレットと支出の管理、監査ログ、SCIM / SSO、データ分離の保証。 | 組織のエージェント / トークンの境界を文書化し、OAuth アプリのイベントについて監査ログのダウンロードを提供する。 |
すでに稼働しているもの
- OAuth 2.0 認可コード + PKCE（
S256のみ）。 - OIDC のディスカバリー、userinfo、JWKS。
- OAuth 認可サーバーメタデータと保護リソースメタデータ。
- 有効化されている場合、読み取り専用パブリッククライアント向けの動的クライアント登録。
- トークンの失効と、コンフィデンシャルクライアントのトークンイントロスペクション。
/openapi.jsonの OpenAPI 3.1 と YAML ミラー。- レシピ / 遺伝子 / 再利用の読み取り API。
- レシピの下書きと公開 API。サンドボックスでの公開ループ用のテストモードつき。
- アプリ登録、スコープ申請、アプリバージョン、使用量 / 呼び出し / アクティビティのログ、シークレットのローテーション履歴。
- Webhook の登録、署名、ping、配信ログ、再配信。
- エンタープライズ的なユースケース向けの組織およびエージェントトークンの機能。
GA の受け入れ条件
次がすべて満たされたリリースを GA と呼べます。
- 新しい開発者が個別のサポートなしで、30 分以内にクイックスタートを完了できる。
- 最初のトークン、最初のカタログ読み取り、テスト公開、Webhook の ping、エラーの デバッグに、コピー & ペーストできるサンプルがすべて揃っている。
- ポータルがアプリの状態、申請したスコープ、審査状況、ライブ / テストモード、 直近の呼び出し、クォータ、Webhook の配信失敗、次にとるべきアクションを表示する。
- OpenAPI、ディスカバリー、ドキュメント、実装が CI で揃った状態を保っている。
- 少なくとも JS/TS と Python の SDK が存在し、Go も計画済みまたは生成済みである。
- 高リスクスコープには明示的な審査 / 管理者同意が必要で、監査できる。
- サポート、ステータス、変更履歴、インシデントの各チャネルが公開され、見つけられる。
- セキュリティのシグナルが実際に対処可能である。古いクライアントの繰り返しループは 重複排除され、本物のトークン再利用インシデントがノイズに埋もれない。
短期ロードマップ
P0 —— 面識のない開発者を成功させる
/devを公開の入口として維持する。- クイックスタートと最小サンプルを仕上げる。
- エラーカタログとトラブルシューティングを追加する。
- ダウンロード可能な Node / Python のサンプルアプリを追加する。
- API エクスプローラーのトークン処理とスニペットを堅牢化する。
P1 —— 連携を運用可能にする
- Webhook の配信詳細 UI とリプレイ。
- 開発者サポートページと課題テンプレート。
- API / Webhook のステータス行と SLA の記述。
- アプリ審査、スコープ申請、クォータ、Webhook の失敗についてポータルに次アクションの状態を出す。
- リフレッシュトークン失敗時の処理ガイド（リトライループを止め、再ログインを強制する）。
P2 —— エコシステムを作る
- SDK パッケージ。
- 厳選パートナーアプリ向けのマーケットプレイス初期掲載。
- テナント / 組織のインストールフローと管理者同意。
- 監査エクスポートとエンタープライズのガバナンス機能。