Archie Core Dokümantasyonu

Archie Core Dokümantasyonu

Backend Konsoluna hoş geldiniz. Bu platform, uygulamanızın sunucu tarafı mantığı, veri mimarisi ve altyapısı için merkezi komuta merkezi olarak işlev görür. Veritabanınızı yönetmek, otomatik olarak oluşturulan GraphQL API’nizi keşfetmek ve temel uygulama hizmetlerini yapılandırmak için birleşik bir arayüz sağlar.

---

Platform Genel Bakış

Veri Modeli

Veri Modeli, uygulamanızın temelidir. Burada, karmaşık geçiş (migration) komut dosyaları yazmadan veritabanınızın yapısını tanımlarsınız.

• Tablolar: Uygulama kayıtlarınızı saklamak için veritabanı tabloları (örn. users, audit_events) oluşturun ve yönetin.
• Şema ve Alanlar: Belirli veri türlerini (Metin, Sayı, Tarih, UUID) tanımlayın ve tablolar arasındaki ilişkileri yapılandırın.
• Görünümler ve Veri Türleri: Karmaşık veri toplama işlemleri için SQL Görünümleri (Views) oluşturun ve şemanız genelinde değerleri standartlaştırmak için yeniden kullanılabilir Veri Türleri (Enums) tanımlayın.

API Gezgini

API Gezgini, uygulamanızın API’si ile doğrudan etkileşim kurmanıza olanak tanıyan entegre bir GraphiQL ortamıdır.

• Otomatik oluşturulan API: Sistem, Veri Modelinize dayalı olarak GraphQL Sorgularını (Queries), Mutasyonlarını (Mutations) ve Aboneliklerini (Subscriptions) otomatik olarak oluşturur.
• Oluşturucu (Composer): Alanlara tıklayarak sorgular oluşturmanızı sağlayan görsel bir araçtır, sözdizimini manuel olarak yazma ihtiyacını ortadan kaldırır.
• Dokümantasyon: Mevcut alanları ve argümanları anlamak için şemanızın gerçek zamanlı, satır içi dokümantasyonuna erişin.

SQL Oyun Alanı

Gelişmiş veri işlemleri için, SQL Oyun Alanı ham bir SQL düzenleyicisi sağlar.

• Doğrudan Erişim: Standart SQL sorgularını (SELECT, JOIN, vb.) doğrudan veritabanı tablolarınız üzerinde çalıştırın.
• Hata Ayıklama: Karmaşık mantığı test etmek veya GraphQL API aracılığıyla izlenmesi zor olan veri sorunlarını ayıklamak için idealdir.

Entegrasyonlar

Entegrasyonlar modülü aracılığıyla üçüncü taraf hizmetleri bağlayarak uygulamanızın yeteneklerini genişletin.

• İletişim: Mesajlaşma için Slack veya Twilio’yu bağlayın.
• E-posta: İşlemsel e-postalar için SendGrid’i yapılandırın.
• Ödemeler: Ödemeleri işlemek için Stripe’ı entegre edin.
• Yapay Zeka: Akıllı özellikler için ChatGPT’yi bağlayın.

Uygulama Servisleri

Bu bölüm, modern bir uygulama için gereken temel altyapı bileşenlerini yönetir:

• Dosya Yöneticisi: Kullanıcı yüklemelerini ve dosya varlıklarını işlemek için AWS S3, Google Cloud Storage, Filestack veya Azure Blob Storage gibi depolama sağlayıcılarını yapılandırın.
• Kimlik Doğrulama Sağlayıcıları: Auth0, Google, AWS Cognito veya standart API Tokenlarını kullanarak güvenli giriş yöntemleri ayarlayın.
• Roller: İzinleri yönetmek ve farklı kullanıcıların (örn. Yönetici, Müşteri) neleri görebileceğini veya yapabileceğini kısıtlamak için RBAC (Rol Tabanlı Erişim Kontrolü) tanımlayın.

Ayarlar

Ayarlar menüsü, projenizin global yapılandırmasını ve güvenliğini kontrol eder:

• API Anahtarları: Harici uygulamaların backendinize güvenli bir şekilde bağlanmasına izin vermek için API anahtarları oluşturun ve yönetin.
• Ortam Değişkenleri: Hassas yapılandırma değerlerini (gizli anahtarlar veya harici URL’ler gibi) anahtar-değer çiftleri olarak güvenli bir şekilde saklayın.
• Ağ: CORS (Kökenler Arası Kaynak Paylaşımı) politikalarını yapılandırın ve API’nizi kötüye kullanımdan korumak için Hız Limitleri (Rate Limits) belirleyin.