> ## Documentation Index
> Fetch the complete documentation index at: https://docs.azalt.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Genel Bakış

> Azalt'ın nasıl çalıştığına genel bakış

Bu sayfa Azalt platformundaki temel varlıkları ve bunların nasıl birlikte çalıştığını tanıtır. Her bir varlık hakkında detaylı bilgi için sol menüdeki ilgili sayfaları ziyaret edin.

## Veri Toplama Akışı

Azalt'ta sürdürülebilirlik verilerini toplamak ve analiz etmek için temel süreç:

1. **Form Tasarımı**: Veri toplama formları oluşturun
2. **Site Dağıtımı**: Formları belirli site ve yıllara atayın
3. **Veri Toplama**: Çeşitli yöntemlerle veri toplayın
4. **Hesaplamalar**: KPI'lar ve karmaşık hesaplamalar gerçekleştirin
5. **Görselleştirme**: Sonuçları dashboard'lar ve widget'lar aracılığıyla görüntüleyin

## Temel Varlıklar

### Organizasyon Yönetimi

* **Organization**: İzole edilmiş veri, kullanıcı yönetimi ve yapılandırma ayarları ile tam iş ortamları
* **Site**: Karmaşık iş ilişkileri için sınırsız iç içe geçme ile hiyerarşik organizasyon yapıları

### Veri Toplama

* **Form**: Koşullu mantık ve çok dönemli destek ile gelişmiş veri toplama motorları
* **FormElement**: Formlar içindeki bireysel alanlar ve UI bileşenleri (girişler, açılır menüler, hesaplamalar)
* **FormSite**: Formları belirli site ve yıllara bağlayan dağıtım bağlantıları
* **FormSubmission**: Alan yanıtlarını gruplandıran kullanıcı gönderim oturumu konteynerları
* **FormElementSubmission**: Çok dönemli destekle bireysel alan değerleri ve veri depolama

### Hesaplamalar

* **Activity**: Gerçek verilerle karmaşık hesaplama örnekleri (emisyonlar, maliyetler, vb.)
* **ActivityDefinition**: JavaScript mantığı ve özel UI ile yeniden kullanılabilir hesaplama şablonları

### Referans Veriler

* **Unit**: Tutarlı veri işleme için standartlaştırılmış ölçümler (kWh, kg CO2e, vb.)
* **Dataset**: Emisyon faktörleri ve kıyaslamalar gibi referans veriler için konteynerlar
* **DatasetItem**: Dataset'ler içindeki bireysel veri noktaları (belirli emisyon faktörleri, oranlar)

### Görselleştirme

* **Dashboard**: Sürükle-bırak widget'ları ile veri görselleştirme için etkileşimli çalışma alanları
* **Widget**: Bireysel görselleştirme bileşenleri (grafikler, tablolar, KPI görüntüleri)

### Otomasyon

* **CronJob**: Düzenli aralıklarla JavaScript kodu çalıştıran zamanlanmış otomasyon betikleri
* **CronJobVariable**: Otomasyon betikleri için ortam değişkenleri ve şifrelenmiş gizli değerler
* **CronJobExecution**: Günlükler, çıktı ve zamanlama bilgileri ile çalışma geçmişi kayıtları

## Yaygın Kullanım Desenleri

### Enerji Takibi

Aylık enerji tüketim formları oluşturun → Tesislere dağıtın → Tüketim verilerini toplayın → Enerji yoğunluğu göstergelerini hesaplayın → Trend analizi dashboard'ları oluşturun

### Emisyon Hesaplamaları

Yakıt tüketimi Activity tanımları oluşturun → EPA emisyon faktörleri dataset'ini kurun → Emisyon hesaplama formları tasarlayın → Kapsam 1, 2, 3 emisyonlarını hesaplayın → Karbon ayak izi widget'ları oluşturun

### Tedarikçi Değerlendirmesi

Harici tedarikçi değerlendirme formları oluşturun → Tedarikçi başına benzersiz URL'ler oluşturun → Sürdürülebilirlik verilerini toplayın → Tedarikçi performansını analiz edin → Sonuçları tedarikçi dashboard'ları ile paylaşın

### Otomatik Veri Senkronizasyonu

API entegrasyon kodu ile cron görevi oluşturun → Zamanlama yapılandırın (saatlik, günlük) → API kimlik bilgilerini gizli değer olarak ekleyin → Çalışma geçmişini izleyin → Hata bildirimleri kurun

## API Entegrasyonu

Azalt, programatik veri yönetimi için kapsamlı REST API'ler sağlar:

* Form verilerini gönderin
* Hesaplamaları tetikleyin
* Dashboard verilerini alın
* Toplu işlemler gerçekleştirin

Tam API referansı için [API Dokümantasyonu](https://azalt.erguvan.co/docs) sayfasını ziyaret edin.