クイックスタートガイド

このガイドでは、Archyl で最初のアーキテクチャダイアグラムをわずか数分で作成する方法を説明します。

ステップ 1：アカウントの作成

1. app.archyl.com にアクセスします
2. メールアドレスでサインアップするか、GitHub、GitLab、または Bitbucket で接続します
3. メールアドレスでサインアップした場合は、メールを確認してください

サインインすると、すべてのプロジェクトの司令塔となるダッシュボードが表示されます：

ステップ 2：最初のプロジェクトの作成

1. ダッシュボードで 「新規プロジェクト」 をクリックします
2. プロジェクト名を入力します（例：「EC プラットフォーム」）
3. 必要に応じて説明とタグを追加します
4. 「プロジェクトを作成」 をクリックします

ステップ 3：最初のシステムの追加

1. 新しいプロジェクトでは、システムコンテキスト レベルから始まります
2. 「+」 ボタンをクリックするか、キャンバス上で右クリックします
3. 「システムを追加」 を選択します
4. 名前を入力します（例：「EC プラットフォーム」）
5. システムの機能の説明を追加します

ステップ 4：外部システムの追加

実際のシステムは孤立して存在しません。ソフトウェアが連携する外部システムを追加しましょう：

1. 「+」 をクリックし、「外部システムを追加」 を選択します
2. 「決済ゲートウェイ」、「メールサービス」、「CDN」などのシステムを追加します
3. これらは外部であることを示す異なるスタイルで表示されます

ステップ 5：関係の作成

システム間の通信方法を示します：

1. ソースシステムをクリックします
2. 接続ポイントからターゲットシステムにドラッグします
3. 関係を説明するラベルを追加します（例：「API 経由で決済処理」）

人、システム、外部プロバイダーがラベル付きの関係で結ばれた、完全なシステムコンテキストビューは次のとおりです：

任意の要素をクリックすると、説明、オーナー、リンクされた決定、ドキュメント、API コントラクトなどの詳細が開きます：

ステップ 6：コンテナへのズームイン

メインシステムをダブルクリックして、コンテナレベルに深入りします：

1. 「Web アプリケーション」、「API サーバー」、「データベース」などのコンテナを追加します
2. それらの間の通信方法を示します
3. 外部システムに接続します

次のステップ

おめでとうございます！最初のアーキテクチャダイアグラムを作成しました。次に探索できることは以下の通りです：

• リポジトリの接続 - AI にアーキテクチャを自動的に発見させる
• AI ディスカバリー - AI がコードベースを分析する方法を学ぶ
• チームコラボレーション - チームメンバーを招待する
• エクスポートと共有 - ステークホルダーとダイアグラムを共有する

成功のヒント

• 高レベルから始める：詳細に入る前にシステムコンテキストから始めましょう
• 明確な名前を使う：システムとコンテナに説明的な名前を付けましょう
• 説明を追加する：将来のあなた（とチーム）が感謝するでしょう
• 反復する：アーキテクチャドキュメントは生きたものです——システムの進化に合わせて更新しましょう