リアルタイムホワイトボード - Archyl Docs

チームとリアルタイムでアーキテクチャダイアグラム上でコラボレーション

リアルタイムホワイトボードコラボレーション

チームとリアルタイムでアーキテクチャダイアグラムを一緒に作業できます。お互いのカーソルを確認し、変更が即座に反映され、同じ部屋にいるかのようにコラボレーションできます。

コラボレーションセッションの開始

  1. 任意のプロジェクトを開き、ダイアグラムビューに移動
  2. ツールバーのコラボレーションボタンをクリック
  3. チームメイトにセッションリンクを共有
  4. プロジェクトアクセスを持つチームメンバーが直接参加可能

コラボレーターが参加すると、通知が表示され、コラボレーターリストにプレゼンスが表示されます。

表示される内容

コラボレーターのカーソル

各チームメンバーには色付きのカーソルがあり、キャンバス上をリアルタイムで移動します。カーソルには名前が表示されるため、誰がどこで作業しているかが常にわかります。

カーソルには10色の異なる色合いのパレットから自動的に色が割り当てられます。同じ人にはセッション中ずっと同じ色が割り当てられます。

要素フォーカスインジケーター

誰かが要素を選択すると、その要素が割り当てられた色でハイライトされ、名前が上に表示されます。これにより、2人が同時に同じ要素を編集してしまうことを防ぎます。

コラボレーターリスト

アクティブなコラボレーターのリストが左下に表示され、重なり合うスタックでアバターが表示されます。アバターにカーソルを合わせるとフルネームが表示されます。5人以上参加すると「+N人」インジケーターが表示されます。

同期される変更

すべてのアクションが全参加者間で同期されます:

  • 要素の作成: 新しいシステム、コンテナ、コンポーネント、図形が全員のキャンバスに表示
  • 要素の移動: ドラッグして位置を変更すると全員に移動が反映
  • プロパティの編集: 名前、説明、技術情報をリアルタイムで更新
  • リレーションシップの追加: 接続を描くとチーム全体に表示
  • オーバーレイの変更: 視覚的グループを一緒に作成・調整

変更は楽観的に処理され、画面上に即座に表示されながら他の参加者に同期されます。同時編集はシステムが自動的に調整します。

アーキテクチャであり、単なる描画ではない

一般的なホワイトボードツールとは異なり、Archylで作成するものはすべて実際のアーキテクチャドキュメントです。

ブレインストーミング中にスケッチしたシステムは、C4モデルの正式なエンティティになります。描いたリレーションシップは追跡・検証されます。セッション終了後、アーキテクチャはドキュメント化されており、クリーンアップは不要です。

セッションの動作

参加と退出

セッションはプロジェクトベースです。プロジェクトにアクセスできる人は誰でもアクティブなセッションに参加できます。ページから移動したりブラウザを閉じると、自動的にセッションから退出します。

セッションのクリーンアップ

30秒間アクティビティがない場合、セッションは自動的にクリーンアップされます。古い操作履歴は24時間後に削除され、システムの効率を維持します。

再接続

接続が一時的に途切れた場合、自動的に再接続して現在の状態に同期します。変更は失われません。

ベストプラクティス

アーキテクチャワークショップ

設計ディスカッションにコラボレーションセッションを使用しましょう。高レベルのシステムをスケッチしながら、チームメイトがコンテナの詳細を埋めていきます。全員が貢献し、ドキュメントは自然に作成されます。

オンボーディング

新しいチームメンバーにリアルタイムでアーキテクチャを案内しましょう。システムを指し示し、リレーションシップを説明し、同じキャンバスを見ながら質問してもらいます。

アーキテクチャレビュー

既存のアーキテクチャをチームレビューのために表示しましょう。注意が必要な領域を特定し、変更を提案し、一緒に実装します。全員がビフォーとアフターを確認できます。

インシデント分析

インシデント後、コラボレーションでアーキテクチャの障害パスをトレースしましょう。影響を受けたシステムをマークし、何が問題だったかを注釈し、コンテキストが新鮮なうちに修正を文書化します。

技術的な注意事項

コラボレーションは1秒間隔のポーリングベースの同期を使用しています。これにより、アーキテクチャ作業に許容できるレイテンシーを提供しながら、運用がシンプルで、企業のプロキシやロードバランサーとの互換性を維持しています。

同時編集はシステムが適切に処理します。2人が同じ要素を同時に変更した場合、last-write-winsセマンティクスで自動的に調整されます。実際には、カーソルのプレゼンス機能により、自然とダイアグラムの異なる部分で作業するため、これはまれです。

次のステップ