Mockphine

Mockphineとは？

Mockphineは、小規模な開発・QAチーム向けのローカルモックAPIサーバーです。コア機能は、各エンドポイントに対して明示的なルーティングルール（mock、passthrough、disabled）を定義することで、ローカルAPIの動作を決定論的にし、実際のレスポンスを何が提供したかの可視性を保つことです。

不安定なバックエンドやステージング変更がテストにどう影響するかを推測するのではなく、Mockphineはローカル優先の制御とリアルタイム検査に焦点を当てます。これにより、チームはデバッグを高速化し、UIとQAサイクルを進め、開発中の予期せぬ動作を減らせます。

主な機能

• 各エンドポイントの決定論的ルートマッチング: 厳密なルールを定義し、エンドポイントの動作を実行間やチーム共有ワークフローで一貫させます。
• 制御されたpassthroughモード: 部分的に完成したサービスを接続し、特定の要求を実際のバックエンドにルーティングしつつ、チームを偶発的なライブコールから保護します。
• エンドポイントごとのstrict vs fallback動作: 条件未達時のサーバー動作を構成し、動作を一元管理します。
• リアルタイム「served-by」とペイロード可視化（Live View）: リクエスト発生時に、各レスポンスがmock、strict-failed、またはpassthroughかを検査します。
• 障害と遅延シミュレーション: レイテンシ、障害、リトライをシミュレートし、フロントエンドとQAフローが悪条件をどう扱うかを検証します。
• dev + QAコラボのための共有リクエストログ: 共通のリクエストレベル証拠を使い、問題を役割間で再現・議論します。

Mockphineの使い方

1. OS向けにMockphineをインストール（サイトからmacOSとWindowsのダウンロードを提供）。
2. ローカルサーバーを起動し、APIコール用のエンドポイントルーティングルールを構成。各ルートごとにmock、passthrough、またはdisabledを選択。
3. 通常のフロントエンドやテストワークフローをローカルサーバーに対して実行。
4. テスト中にLive Viewでリクエスト結果を検査—各レスポンスがmock、strictルールで失敗、またはpassthroughかを確認。
5. 動作を調整し、ルーティングとシミュレーション設定（例: 遅延や障害）をイテレートして、ローカルテストループが検証したい状態を反映。

ユースケース

• バックエンド不安定時のUI動作デバッグ: サービス遅延や変更時、特定エンドポイントをmockレスポンスにルーティングし、UIとQAループを停止せずに継続。
• 厳密な障害・リトライロジックのテスト: ローカルで障害と遅延をシミュレートし、Live Viewでstrict-failed、passthrough、またはmockペイロードの要求を確認。
• 未完成サービスの段階的統合: 準備完了のエンドポイントのみ制御passthroughで接続し、他をdisabledやmockに保ち偶発的ライブ使用を防ぐ。
• devとQA間でリクエストレベル問題再現: リクエストログを共有し、ローカルテスト中の同一リクエスト動作とペイロード詳細を確認。
• ステージング変更によるサプライズ削減: 初回コールからローカルAPI動作を明示し、ステージング変更がテスト結果を静かに変えない。

FAQ

• Mockphineの「passthrough」とは？ 構成済みエンドポイントをmockレスポンスの代わりに実際のバックエンドにルーティングしつつ、どのエンドポイントがライブ許可かを管理します。

• ローカルでエンドポイントを無効化できますか？ はい。Mockphineはmockとpassthroughに加え、disabledモードでエンドポイントをルーティングします。

• レスポンスがmockかバックエンド由来かをどう知る？ 製品にLive Viewがあり、各レスポンスがmock、strict-failed、またはpassthroughかをリアルタイムで可視化します。

• Mockphineでレイテンシと障害をシミュレートできますか？ はい。リトライ、タイムアウト、フォールバック動作をリリース前に検証する障害/遅延シミュレーションをサポートします。

• Mockphineのダウンロードはどこ？ サイトにmacOSとWindowsのダウンロードを記載。

代替案

• 静的サーバースタブを使用したAPIモックツール: あらかじめ定義したレスポンスを返すことに焦点を当てていますが、各リクエスト結果に対するリアルタイム「served-by」可視化のレベルは同等でない場合があります。
• ブラウザ内モック手法（サービスワーカー基盤）: フロントエンド統合ループに有用ですが、ローカル優先のルート制御やチーム横断のリクエストソース検査の扱いが異なる場合があります。
• API仮想化ツール（ネットワーク/サービス仮想化）: 通常、大規模またはエンタープライズ向けワークフローを対象としており、小規模dev + QAチームのローカルループに対するセットアップスタイルや適合性が異なる場合があります。
• 汎用リクエスト/ルートシミュレーション・ユーティリティ: 代替ソリューションはネットワーク条件をシミュレートできますが、決定論的エンドポイント別ルーティングと同等のserved-byおよびペイロード検査を1つのローカルワークフローで組み合わせていない場合があります。