シーケンス図とは？
シーケンス図は、オブジェクトやシステム間が時間軸でどのように通信するかを示すUMLインタラクションダイアグラムです。異なるアクター間のメッセージ交換の時系列を表示し、APIフロー、システムインタラクション、マルチステッププロセスの文書化に非常に役立ちます。各参加者は垂直のライフラインで表され、水平の矢印がメッセージ交換を示します。
編集とプレビュー
Mermaid構文でシーケンス図を作成し、変更を即座に確認。
一般的なユースケース
APIドキュメント
APIエンドポイントとそのインタラクションフローを文書化。クライアントとサーバー間のリクエスト-レスポンスサイクル、認証フロー、エラーハンドリング、データ交換を視覚化。
マイクロサービスアーキテクチャ
マイクロサービス、メッセージキュー、データベース間の通信パターンをマッピング。分散システムの動作を理解し、統合問題のデバッグに不可欠。
認証と認可
OAuth、SAML、JWTトークンフローなどの多段階認証プロセスをモデル化。リダイレクト、トークン交換、検証ステップのシーケンスを表示。
システム統合
複雑な統合シナリオで異なるシステムがどのように相互作用するかを視覚化。Webhookコールバック、イベント駆動アーキテクチャ、サードパーティサービス統合を文書化。
主な機能
参加者管理
エイリアスとアクティベーションボックスで複数のアクター、システム、サービスを定義し、コンポーネントがアクティブに処理している状態を表示。
メッセージタイプ
同期呼び出し、非同期メッセージ、戻り値、自己呼び出しを、明確さのために異なる矢印スタイルでサポート。
制御構造
直感的な構文でループ、条件分岐（alt/else）、オプションブロック、並列処理をモデル化。
ノートと注釈
シーケンス内の任意のポイントに説明ノートを追加し、コンテキスト、ビジネスロジック、エッジケースを文書化。
ベストプラクティス
1つのシナリオに集中
各シーケンス図は単一のユースケースまたはインタラクションフローを表すべき。すべてを組み合わせるのではなく、異なるシナリオには別々のダイアグラムを作成。
意味のある名前を使用
参加者に明確で説明的な名前を付ける。「システムA」や「コンポーネント1」のような汎用ラベルではなく、実際のサービス名やロールタイトルを使用。
エラーパスを表示
ハッピーパスだけを文書化しない。エラー条件、タイムアウト、例外処理の代替フローも含める。
時間は上から下へ
時間が上から下に流れる規約に従う。早い相互作用は後の相互作用より上に表示。
他のダイアグラムタイプを探す
フローチャート
ノードと方向矢印でプロセス、ワークフロー、アルゴリズムを視覚化。ビジネスプロセスやデシジョンツリーに最適です。
クラス図
クラス、属性、関係でオブジェクト指向システムをモデル化。ソフトウェアアーキテクチャ設計に不可欠です。
ステート図
システムやアプリケーションの状態遷移を表現。ライフサイクル状態やワークフローのモデリングに最適です。
ガントチャート
タスクと依存関係でプロジェクトのタイムラインを計画・追跡。プロジェクト管理やスケジューリングに最適です。
ER図
エンティティと関係でデータベーススキーマを設計。データベースモデリングやドキュメント作成に最適です。
ユーザージャーニー
タッチポイント全体のユーザー体験とインタラクションをマッピング。UXデザインやカスタマージャーニーマッピングに最適です。
Gitグラフ
Gitのブランチ戦略やコミット履歴を視覚化。バージョン管理ワークフローの説明に役立ちます。
マインドマップ
アイデアの整理、ブレインストーミング、階層的なビジュアル構造の作成に。計画立案やナレッジマネジメントに最適です。
円グラフ
円形チャートでデータの比率分布を表示。パーセンテージやマーケットシェアの分析に最適です。
タイムライン
時間軸に沿ってイベントやマイルストーンを視覚化。プロジェクト履歴やロードマップの表示に最適です。
カンバンボード
ワークフローの段階ごとにタスクを列に整理。アジャイルプロジェクト管理やタスク追跡に最適です。
象限チャート
2軸グリッド上に項目をプロットして比較・優先順位付け。機能の優先順位付けや戦略分析に最適です。
サンキーダイアグラム
ノード間のフロー量を比例矢印で視覚化。エネルギーフロー、予算配分、コンバージョンファネルに最適です。
XYチャート
カスタマイズ可能な軸を持つ棒グラフと折れ線グラフを作成。データ視覚化やトレンド分析に最適です。
ブロックダイアグラム
行と列に配置されたブロックで構造化レイアウトを構築。システムアーキテクチャやコンポーネント概要に最適です。
アーキテクチャ図
サービスアイコンと接続を使用してクラウドやシステムアーキテクチャを設計。インフラストラクチャドキュメントに最適です。
パケットダイアグラム
ネットワークプロトコルのパケット構造とビットレベルのフィールドレイアウトを視覚化。ネットワークプロトコルドキュメントに最適です。