Archie Core Dokumentation

Archie Core Dokumentation

Willkommen zur Backend-Konsole. Diese Plattform dient als zentrale Kommandozentrale für die serverseitige Logik, Datenarchitektur und Infrastruktur Ihrer Anwendung. Sie bietet eine einheitliche Oberfläche zur Verwaltung Ihrer Datenbank, zur Erkundung Ihrer automatisch generierten GraphQL-API und zur Konfiguration wesentlicher Anwendungsdienste.

---

Plattform-Übersicht

Datenmodell

Das Datenmodell ist das Fundament Ihrer Anwendung. Hier definieren Sie die Struktur Ihrer Datenbank, ohne komplexe Migrationsskripte schreiben zu müssen.

• Tabellen: Erstellen und verwalten Sie Datenbanktabellen (z. B. users, audit_events), um Ihre Anwendungsdatensätze zu speichern.
• Schema & Felder: Definieren Sie spezifische Datentypen (Text, Zahl, Datum, UUID) und konfigurieren Sie Beziehungen zwischen Tabellen.
• Ansichten & Datentypen: Erstellen Sie SQL-Ansichten (Views) für komplexe Datenaggregationen und definieren Sie wiederverwendbare Datentypen (Enums), um Werte in Ihrem Schema zu standardisieren.

API Explorer

Der API Explorer ist eine integrierte GraphiQL-Umgebung, die es Ihnen ermöglicht, direkt mit der API Ihrer Anwendung zu interagieren.

• Automatisch generierte API: Das System generiert automatisch GraphQL-Abfragen (Queries), Mutationen (Mutations) und Abonnements (Subscriptions) basierend auf Ihrem Datenmodell.
• Composer: Ein visuelles Tool zum Erstellen von Abfragen durch einfaches Anklicken von Feldern, wodurch das manuelle Eingeben von Syntax entfällt.
• Dokumentation: Greifen Sie auf Echtzeit-Inline-Dokumentation für Ihr Schema zu, um verfügbare Felder und Argumente zu verstehen.

SQL Playground

Für fortgeschrittene Datenoperationen bietet der SQL Playground einen reinen SQL-Editor.

• Direkter Zugriff: Führen Sie Standard-SQL-Abfragen (SELECT, JOIN usw.) direkt auf Ihren Datenbanktabellen aus.
• Debugging: Ideal zum Testen komplexer Logik oder zum Debuggen von Datenproblemen, die über die GraphQL-API schwer nachzuvollziehen sind.

Integrationen

Erweitern Sie die Funktionen Ihrer Anwendung, indem Sie Drittanbieterdienste über das Integrationen-Modul verbinden.

• Kommunikation: Verbinden Sie Slack oder Twilio für Nachrichten.
• E-Mail: Konfigurieren Sie SendGrid für Transaktions-E-Mails.
• Zahlungen: Integrieren Sie Stripe zur Zahlungsabwicklung.
• KI: Verbinden Sie ChatGPT für intelligente Funktionen.

App-Dienste

Dieser Abschnitt verwaltet die zentralen Infrastrukturkomponenten, die für eine moderne Anwendung erforderlich sind:

• Dateimanager: Konfigurieren Sie Speicheranbieter wie AWS S3, Google Cloud Storage, Filestack oder Azure Blob Storage, um Benutzer-Uploads und Dateiressourcen zu verwalten.
• Authentifizierungsanbieter: Richten Sie sichere Anmeldemethoden mit Auth0, Google, AWS Cognito oder Standard-API-Token ein.
• Rollen: Definieren Sie RBAC (Rollenbasierte Zugriffskontrolle), um Berechtigungen zu verwalten und einzuschränken, was verschiedene Benutzer (z. B. Admin, Kunde) sehen oder tun können.

Einstellungen

Das Menü Einstellungen steuert die globale Konfiguration und Sicherheit Ihres Projekts:

• API-Schlüssel: Generieren und verwalten Sie API-Schlüssel, damit externe Anwendungen sicher eine Verbindung zu Ihrem Backend herstellen können.
• Umgebungsvariablen: Speichern Sie sensible Konfigurationswerte (wie geheime Schlüssel oder externe URLs) sicher als Schlüssel-Wert-Paare.
• Netzwerk: Konfigurieren Sie CORS-Richtlinien (Cross-Origin Resource Sharing) und legen Sie Ratenlimits fest, um Ihre API vor Missbrauch zu schützen.