この記事について
この記事は、生成AIを活用した自動生成フローで作成しています。Cytoscape.jsの公式情報を参照し、固定版とライセンスを同梱した静的Web教材を制作しました。検証ステータス:🧪 計算ロジックは確認済み、ブラウザー表示は未確認
GitHubにあるlogic.mjsの純粋関数をV8隔離環境で確認しました。GitHub Pagesの実到達と操作、WordPress表示は今回未確認です。
Cytoscape.jsでサービス依存関係を操作:障害の影響候補を逆向きに探索
架空のポータル、API、認証、DBという4サービスの依存関係を表示し、障害対象を選ぶと影響候補の色と件数が変わる教材です。
静的サイトでも動きのあるJavaScript教材を実現できます。ただし、第三者ライブラリを使うことと、実際の業務システムに導入できることは別です。まず画面操作で結果の変化を確かめ、仕組みと検証条件を理解しましょう。
まず動かす
Cytoscape.jsのライブデモ(公開URL到達・実ブラウザー操作は未確認)
DBを選ぶとAPIとポータルの2件、認証を選ぶとポータル1件、ポータルを選ぶと影響候補0件です。これは事前に登録した依存関係から機械的にたどった結果であり、実際の障害を検知したものではありません。
初期の入力から条件を1つだけ変えて、元のデータが変わったのか、表示する条件だけが変わったのかを意識してください。操作を戻して期待結果が復元するかも確認します。特にグラフや図は見た目の変化が目立つため、数字での結果確認も重要です。
何が使われているのか
| 項目 | 内容 |
|---|---|
| ライブラリ | Cytoscape.js 3.30.4 |
| 配信 | GitHub Pagesの静的HTML/CSS/JavaScript |
| ライセンス | MIT(ライセンス全文をvendorに同梱) |
| コードの取得 | 公式GitHubの版を固定。実行時CDNなし |
| データ | 架空の値のみ |
| 確認済み | 分離したロジックのV8検査 |
| 未確認 | 公開URLの到達・ブラウザー実操作・WordPress表示 |
動く仕組みと役割分担
Cytoscape.jsはノードとエッジの描画とクリック操作を受け持ち、affectedBy関数は『依存する側→依存先』の矢印を逆向きに探索します。キューと集合で重複するサービスを数えないようにしています。
次は教材の計算ロジックです。ブラウザーで描画できなくても、画面へ渡す値が期待通りかを別に確かめられます。完成した操作画面はHTML、CSS、app.mjs、vendorの全ファイルが必要です。この抜粋だけで動くと誤認しないようにしてください。
export const nodes=[{id:"portal",label:"ポータル"},{id:"api",label:"API"},{id:"auth",label:"認証"},{id:"db",label:"DB"}];
export const dependencies=[["portal","api"],["portal","auth"],["api","db"]];
export function affectedBy(failed){const impacted=new Set(),queue=[failed];while(queue.length){const node=queue.shift();for(const [service,requires] of dependencies){if(requires===node&&!impacted.has(service)){impacted.add(service);queue.push(service);}}}return [...impacted];}
この分離によって、計算の誤りと見た目の不具合を別々に診断できます。画面が出ないからといって元データが間違っているとは限りません。逆に画面が綺麗でも、元データや計算条件が間違っていれば役に立ちません。
一条件を変えたときの意味
依存関係があってもフェイルオーバーなどによって実際には停止しない場合があります。影響候補を確定情報と誤認してはいけません。実システムの構成情報を公開デモへ流用すると、接続関係を外部に知らせるリスクもあります。
変更した入力と結果を記録してから次の条件へ進みます。複数の値を同時にいじると、何が変化の原因になったか分からなくなるためです。まずダミー入力で動きを覚え、必要があれば公式仕様の境界値を照合しましょう。
動かないときの確認
何も描画されないときはライブラリの取得、DIVの高さ、ノードID、エッジのsource/target、クリック時のIDを調べます。矢印の向きを逆に扱うと原因と影響を取り違えます。
| 現象 | 確認する場所 | 切り分け |
|---|---|---|
| URLが開けない | Pagesの配信とHTTP応答 | 公開側の問題 |
| 画面が真っ白 | vendor・DOM・Console | 読込み/実行の問題 |
| 操作が反映されない | 入力イベントと更新処理 | 状態管理の問題 |
| 数字と画面が違う | 元配列と表示設定 | 計算と描画の問題 |
今回の検証で実施したのは計算部分の隔離確認です。ライブラリ本体の実ブラウザー動作や本番のWordPress表示は確認していません。実施していない操作を検証済みとしないことは、失敗を再現できる技術記事にとって重要です。
実務に応用する場合
DBを選ぶとAPIとポータルの2件、認証を選ぶとポータル1件、ポータルを選ぶと影響候補0件です。これは事前に登録した依存関係から機械的にたどった結果であり、実際の障害を検知したものではありません。 その一方で、業務データへ拡張する前に依存関係があってもフェイルオーバーなどによって実際には停止しない場合があります。影響候補を確定情報と誤認してはいけません。実システムの構成情報を公開デモへ流用すると、接続関係を外部に知らせるリスクもあります。
運用向けに広げるときは、アクセス権、保存の成否、更新の証跡、失敗時の復旧、データの取り違え防止を検討する必要があります。ブラウザーの静的デモは説明用であり、本番のDBや認証を備えたシステムの代わりではありません。
静的同梱と安全管理
ライブラリ本体は外部CDNへ毎回読み込むのではなく、docs/demos/cytoscape-service-dependencies/vendor/へ固定版を同梱しています。第三者が配布したソフトウェアなので、出典・バージョン・ライセンスをREADMEに明記し、ライブラリの更新は意図的に検証してから行います。外部CDNの突然の変更に左右されにくい一方、セキュリティ更新まで自動で行われるわけではありません。
架空データだけを使用し、実在する人・会社・機密システムの情報を公開教材に入れません。第三者製のコードであっても、利用者が実行するものとして権限やネットワーク接続、将来のライブラリ更新を確認する責任は残ります。WordPress記事本文に無断のスクリプトやiframeを挿入せず、従来の配信経路を維持しています。
まとめ
架空のポータル、API、認証、DBという4サービスの依存関係を表示し、障害対象を選ぶと影響候補の色と件数が変わる教材です。 「操作して結果を確認する」「変化の理由を説明する」「1つだけ条件を変えて比較する」という順で、動くライブラリを技術の学びへ変えられます。完成版のREADMEとソースを見れば、静的サイトのまま再現する手順も確認できます。
公式資料とコード
ライブデモ(実到達・実ブラウザー操作は未確認)
検証範囲
計算ロジックをV8隔離環境で確認し、静的教材と版固定の第三者ライブラリ、ライセンスをGitHubへ保存しました。ブラウザー実機での操作、画面表示、WordPress本番での見え方、スマートフォン、Windows/macOS差は未確認です。
