3. Compass Kaydı Seçimi — Stacked Cartesian

Bu adımda Stacked widget'ın çalışacağı Compass kaydı seçilir. Stacked akışında kaydınız en az üç kolon döndürmelidir: X ekseni, Y değeri ve stack kategorisini belirleyen kategorik kolon (Stack By).

Sihirbaz rotası: /cartography/add/selectcompass

Ön Koşul

(Cartesian) ve 2. (Stacked* tipi) adımlar tamamlanmış olmalıdır.

Compass'ta hiç kayıt yoksa: → Compass

1. Compass Kayıt Listesi Yüklenir

Adıma girdiğinizde Compass kayıt listesi otomatik yüklenir.

2. Stacked'a Uygun Kayıt Yapısı

Stacked akışı sorgunuzun kategorik bir kolon döndürmesini gerektirir. SQL örneği:

-- Vardiya × Ürün stack column için ideal sorgu
SELECT
    vardiya,            -- X axis (CategoryAxis)
    urun_kodu,          -- Stack By Column
    SUM(adet) AS toplam_adet  -- Y axis (NumericAxis)
FROM uretim_log
WHERE DATE(ts) = CURRENT_DATE
GROUP BY vardiya, urun_kodu
ORDER BY vardiya, urun_kodu;

Kolon	Adım 4'teki rol
`vardiya`	X Axis Column (CategoryAxis)
`urun_kodu`	Stack By Column
`toplam_adet`	Y Axis Column (NumericAxis)

Stack By Kategori Kardinalitesi

Stack By kolonunun benzersiz değer sayısı doğrudan stack katman sayısı olur. 12+ kategori karışıklık yaratır; ideal aralık 3-8 kategori'dir. SQL'de "Diğer" gruplaması yapın:

SELECT
    vardiya,
    CASE WHEN urun_kodu IN (...top5...) THEN urun_kodu
         ELSE 'Diğer' END AS urun_grubu,
    SUM(adet)
FROM ...

3. Stacked'a Uygun Veri Kaynakları

Veri Kaynağı	Stacked'a Uygunluk	Notlar
PostgreSQL / MSSQL / MySQL	✅ İdeal	`GROUP BY x, stack_by` ile hazır gelir
REST API	✅ Uygun	JSON yanıt array yapısında x/y/stack_by olmalı
MQTT	⚠️ Kısıtlı	Snapshot tek satır döner; stack için anlamlı değil
Excel Offline	✅ Uygun	Sheet'in long format'ta olması gerekir (vardiya, urun, adet)

4. Kayıt Arama ve Tag Filtresi

Aksiyon	Etki
Arama kutusu	Kayıt adı + açıklama üzerinde anlık filtre
Tag filtresi	Listenin üst tarafındaki filter ikonu
Clear	Tüm tag filtrelerini kaldırır

Stacked Tag'i

Stacked sorgular için Compass tarafında stacked tag'i ekleyin; Cartography'de ararken filtre aktif olunca yalnızca uygun yapıdaki kayıtlar gelir.

5. Kaydı Onaylayın

Bir kayda tıklandığında satır vurgulanır. Sağ üstteki Next butonuyla ilerleyin.

Kayıt Seçilmeden İlerleme

Hiçbir kayıt seçili değilse Next uyarı verir: "Please select a Compass query first".

6. Excel Offline Sheet Seçimi

Excel kaydında ek olarak sheet seçimi istenir.

Adım	Açıklama
1	Excel kaydını seçin
2	Açılan sheet listesinden bir sheet adı seçin
3	Next

7. Önizleme Çalıştırması

Next butonuna basıldığında kayıt çalıştırılır ve sonuç bellekte tutulur. Sonraki adımda Stack By kolonunu doğru seçebilmek için preview burada hazırlanır.

8. Sık Karşılaşılan Hatalar

Belirti	Olası Neden	Çözüm
Adım 4'te Stack By dropdown'u boş	Sorgu kategorik kolon dönmüyor	SQL'de `GROUP BY` ekleyin ve kategorik kolonu select listesine alın
Stack katmanları çok kalabalık	Stack By kolonu kardinalitesi yüksek	"Diğer" grupla; üst N kategori dışını birleştir
Y değerleri toplanmıyor	Sorgu satır bazlı	`SUM(...) GROUP BY` ile aggregate edin

9. Sonraki Adım

→ 04 — Axis Config + Stack By