> ## 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.

# FormSubmission

> Belirli bir site ve yıl için form gönderimi konteyneri

FormSubmission, bir FormSite (site + yıl) için alan değerlerini (FormElementSubmission) bir araya getirir.

## Amaç ve İşlev

FormSubmission şunlar olarak hizmet eder:

* **Kapsam**: Tüm yanıtları tek bir site/yıl altında gruplar
* **Bağ**: Değerleri `formSiteId` ile sınırlar
* **Sahiplik**: Oluşturan kullanıcı ve organizasyon bilgisini tutar

## Gönderim Türleri

**İç gönderimler (özel formlar)**

* Her FormSite için tek (silinmemiş) gönderim
* Devam eden çalışmayı koruyan otomatik kaydetme işlevi
* Gerçek zamanlı doğrulama ve hata kontrolü
* Kullanıcı izinleriyle doğrudan entegrasyon

**Dış gönderimler (halka açık formlar)**

* Site/yıl başına birden fazla gönderime izin verilir
* Platform hesabı gerekmez
* İsteğe bağlı markalı başlık

## Gönderim Yaşam Döngüsü

**1. Başlatma**: Kullanıcı bir form dağıtımına (FormSite) erişir

**2. Veri Girişi**: Kullanıcı form alanlarını doldurur, FormElementSubmission'ları oluşturur

**3. Doğrulama**: Sistem gerekli alanları, veri türlerini ve iş kurallarını kontrol eder

**4. Gönderim**: Kullanıcı formu tamamlar ve gönderir

**5. İnceleme** (isteğe bağlı): Onaylar iş akışına göre alan bazında yapılır

**6. Entegrasyon**: Veriler hesaplamalar ve raporlama için kullanılabilir hale gelir

## Veri Yapısı

Her FormSubmission şunları içerir:

**Kimlik**:

* Benzersiz gönderim ID'si
* İlişkili FormSite (form + site + yıl)
* Gönderen bilgileri (kullanıcı veya dış kişi)

**İçerik**:

* FormElementSubmission koleksiyonu (bireysel alan değerleri)
* Değerlere bağlı destekleyici dokümanlar

**Zaman bilgiler**:

* Oluşturulma ve güncellenme tarihleri

## Çok Dönemli Veri İşleme

Aylık veya çeyreklik periyotları olan formlar için, tek bir FormSubmission şunları içerebilir:

```
FormSubmission (Yıllık Enerji Raporu - Tesis A - 2024)
├── Ocak Enerji Tüketimi: 1.250 kWh
├── Şubat Enerji Tüketimi: 1.180 kWh
├── Mart Enerji Tüketimi: 1.340 kWh
...
└── Aralık Enerji Tüketimi: 1.290 kWh
```

## Dış form yönetimi

**Halka Açık Erişim**: Dış formlar kimlik doğrulama gerektirmeyen benzersiz URL'ler oluşturur

**Çoklu Gönderimler**: Tedarikçiler veya yükleniciler aynı site/yıl için birden fazla kez gönderebilir

**Onaylar**: Değer bazında onay (durum alanı)

**Toplama**: Birden fazla dış gönderim raporlama için toplanabilir

## Gerçek Dünya Örnekleri

**Aylık Enerji Raporu**:

* Tesis başına yıl başına tek gönderim
* 12 aylık enerji tüketim verisi içerir
* Yıllık toplam ve ortalamaları otomatik hesaplar
* Destekleyici kamu hizmeti faturalarına bağlantı

**Tedarikçi Değerlendirmesi**:

* Her tedarikçiden dış gönderim
* Şirket profili ve emisyon verilerini içerir
* Birden fazla tedarikçi aynı raporlama yılı için gönderebilir
* İç ekip yanıtları inceler ve doğrular

**Çeyreklik Atık Takibi**:

* Site başına yılda dört ayrı gönderim
* Her gönderim atık akışı verilerini içerir
* Yıl boyunca ilerici veri toplama
* Gönderimler tamamlandıkça gerçek zamanlı dashboard güncellemeleri

## Entegrasyon ve Dışa Aktarma

**API erişimi**: Programatik veri alma

**CSV/XLSX dışa aktarma**: Dışa aktarma/içe aktarma FormElementSubmission düzeyindedir

**Dashboard Entegrasyonu**: Gönderim verileri otomatik olarak widget'lara ve görselleştirmelere beslenir

**Dashboard**: Gönderimler özet ve dashboard’lara katkı sağlar

## Operasyonel Faydalar

**Veri Bütünlüğü**: Veri kaybını ve çoğaltmasını önleyen tam gönderim takibi

**İş akışı**: Alan düzeyinde onay durumu yönetimi; satır içi Onayla/Reddet/Geri Al kontrolleri ve doldurulmuş dönemler için toplu eylemler içerir

**Ölçeklenebilirlik**: Birden fazla site ve formda binlerce gönderimi işle

**Esneklik**: Hem iç veri toplama hem de dış paydaş katılımını destekle

**İlerleme telemetrisi**: Dashboard’lar tarafından dinlenebilen canlı “kalan/toplam” veri girişi ve onay metrikleri üretir