Schnellstart-Leitfaden

Dieser Leitfaden hilft Ihnen, Ihr erstes Architekturdiagramm in Archyl in nur wenigen Minuten zu erstellen.

Schritt 1: Konto erstellen

1. Gehen Sie zu app.archyl.com
2. Registrieren Sie sich mit Ihrer E-Mail oder verbinden Sie sich mit GitHub, GitLab oder Bitbucket
3. Verifizieren Sie Ihre E-Mail, wenn Sie sich per E-Mail registriert haben

Schritt 2: Ihr erstes Projekt erstellen

1. Klicken Sie auf "Neues Projekt" in Ihrem Dashboard
2. Geben Sie einen Namen für Ihr Projekt ein (z.B. "Meine E-Commerce-Plattform")
3. Fügen Sie optional eine Beschreibung und Tags hinzu
4. Klicken Sie auf "Projekt erstellen"

Schritt 3: Ihr erstes System hinzufügen

1. In Ihrem neuen Projekt starten Sie auf der Systemkontext-Ebene
2. Klicken Sie auf den "+"-Button oder rechtsklicken Sie auf die Leinwand
3. Wählen Sie "System hinzufügen"
4. Geben Sie einen Namen ein (z.B. "E-Commerce-Plattform")
5. Fügen Sie eine Beschreibung hinzu, was das System macht

Schritt 4: Externe Systeme hinzufügen

Echte Systeme existieren nicht isoliert. Fügen Sie externe Systeme hinzu, mit denen Ihre Software interagiert:

1. Klicken Sie auf "+" und wählen Sie "Externes System hinzufügen"
2. Fügen Sie Systeme wie "Zahlungs-Gateway", "E-Mail-Dienst", "CDN" hinzu
3. Diese erscheinen mit einem anderen Stil, um zu zeigen, dass sie extern sind

Schritt 5: Beziehungen erstellen

Zeigen Sie, wie Systeme kommunizieren:

1. Klicken Sie auf das Quellsystem
2. Ziehen Sie vom Verbindungspunkt zum Zielsystem
3. Fügen Sie ein Label hinzu, das die Beziehung beschreibt (z.B. "Verarbeitet Zahlungen über API")

Schritt 6: In Container eintauchen

Doppelklicken Sie auf Ihr Hauptsystem, um auf die Container-Ebene zu gelangen:

1. Fügen Sie Container wie "Webanwendung", "API-Server", "Datenbank" hinzu
2. Zeigen Sie, wie sie miteinander kommunizieren
3. Verbinden Sie sie mit externen Systemen

Nächste Schritte

Herzlichen Glückwunsch! Sie haben Ihr erstes Architekturdiagramm erstellt. Hier ist, was Sie als Nächstes erkunden können:

• Repository verbinden - Lassen Sie die KI Ihre Architektur automatisch entdecken
• KI-Entdeckung - Erfahren Sie, wie die KI Ihren Code analysiert
• Team-Zusammenarbeit - Laden Sie Ihre Teammitglieder ein
• Exportieren & Teilen - Teilen Sie Ihre Diagramme mit Stakeholdern

Tipps für den Erfolg

• Beginnen Sie auf hoher Ebene: Starten Sie mit dem Systemkontext, bevor Sie in Details eintauchen
• Verwenden Sie klare Namen: Benennen Sie Systeme und Container beschreibend
• Fügen Sie Beschreibungen hinzu: Ihr zukünftiges Ich (und Ihr Team) wird es Ihnen danken
• Iterieren Sie: Architektur-Dokumentation ist lebendig - aktualisieren Sie sie, wenn sich Ihr System weiterentwickelt