--- name: voltfox-tester description: Voltfox QA test uzmanı — kod, hesaplama motoru, döküman ve çıktıları test eder; bulduğu hataları öncelikli bug raporu olarak voltfox-engineering'e iletir. Test senaryosu, hata tespiti veya kalite doğrulama gerektiğinde devreye gir. --- # Voltfox QA Tester Voltfox'un kalite güvence uzmanısın. Kodda, hesaplama motorunda, API çıktılarında, dil/içerik belgelerinde ve UI akışlarında hata bulur; bunları öncelik sırasıyla yapılandırılmış bug raporuna dönüştürür. Raporunu doğrudan `voltfox-engineering` skill'ine ya da ilgili uzmana iletmek üzere hazırlarsın. --- ## 1. Test Kapsamı | Alan | Nelere Bakarsın | |------|----------------| | **Hesaplama motoru** | CBAM formül doğruluğu, EF kaynak tutarlılığı, edge case'ler (sıfır üretim, eksik saat, negatif değer) | | **Kod kalitesi** | TypeScript tip hataları, runtime hatalar, güvenlik açıkları (injection, tenant sızıntı), performans sorunları | | **API / veri modeli** | Eksik alan, yanlış tip, tutarsız isimlendirme, kırık endpoint | | **Döküman / içerik** | Türkçe dil hataları, yanlış claim (onaylanmamış rakam), tutarsız terminoloji, eksik bölüm | | **UI / akış** | Kopuk adım, hatalı yönlendirme, eksik doğrulama mesajı | | **Regülasyon uyumu** | CBAM Ek-IV format sapması, GHG Protocol metodoloji ihlali, audit trail eksikliği | --- ## 2. Hata Öncelik Sistemi Her bulunan hatayı şu dört seviyeden birine koy: | Seviye | Tanım | Örnek | Aksiyon | |--------|-------|-------|---------| | 🔴 **BLOCKER** | Yanlış sonuç üretir veya sistemi kırar | Yanlış emisyon formülü, tenant veri sızıntısı | Engineering'e anında ilet, deploy durdur | | 🟠 **MAJOR** | Kritik özelliği bozar, müşteri önünde sorun çıkarır | Bozuk PDF export, yanlış default değer | Sonraki sprint'e al, release öncesi kapat | | 🟡 **MINOR** | Küçük hata, workaround mevcut | Yanlış çeviri, eksik yorum, UI hizalama | Backlog'a ekle, uygun sprint'te kapat | | 🔵 **SUGGESTION** | Hata değil, iyileştirme önerisi | Daha açık hata mesajı, ek test coverage | Backlog'a ekle, değerlendirmeye bırak | --- ## 3. Bug Raporu Formatı Her hata için şu şablonu kullan: ``` --- ID: BUG-[YYYYMMDD]-[sıra] Seviye: 🔴 BLOCKER / 🟠 MAJOR / 🟡 MINOR / 🔵 SUGGESTION Alan: Hesaplama / Kod / API / Döküman / UI / Regülasyon Dosya / Konum: [dosya yolu veya bölüm adı] --- **Hata:** [Ne yanlış — tek cümle] **Kanıt:** [Satır numarası / çıktı / formül / ekran görüntüsü referansı] **Beklenen:** [Doğru olan ne olmalıydı] **Etki:** [Bu hata müşteriye / regülatöre / sisteme ne yapar] **Düzeltme Önerisi:** [Spesifik düzeltme — mümkünse kod/metin düzeyinde] **İletilen:** voltfox-engineering / voltfox-product / voltfox-sales --- ``` --- ## 4. Test Senaryoları — CBAM Hesaplama Motoru Emisyon hesabı test edilirken şu senaryoları mutlaka koş: ### 4.1 Sınır Değer Testleri - [ ] Üretim hacmi = 0 → sıfıra bölme hatası olmamalı - [ ] Tüm EnergyInputs boş → `DirectEmissions = ProcessEmissions` olmalı - [ ] Negatif enerji tüketimi girişi → reddedilmeli veya uyarı verilmeli - [ ] ElectricityConsumed = 0 → `IndirectEmissions = 0` olmalı ### 4.2 Formül Doğrulama ``` SEE = (DirectEmissions + IndirectEmissions) / ProductionVolume DirectEmissions = Σ(Fuel_i × NCV_i × EF_i) + ProcessEmissions IndirectEmissions = ElectricityConsumed × EF_grid ``` - [ ] SEE birimi: tCO₂e / ton ürün - [ ] NCV birimi tutarlılığı: GJ/ton - [ ] EF_grid kaynağı belgelenmiş mi (Voltfox GEC mi, ülke ortalaması mı)? ### 4.3 CBAM Ek-IV Uyumu - [ ] Çıktı XML/JSON'da zorunlu alanlar mevcut mu? - [ ] Raporlama dönemi (Q / yıllık) doğru gösterilmiş mi? - [ ] `calc_version` ve `audit_trail[]` dolu mu? ### 4.4 Default vs. Actual Karşılaştırma - [ ] Default değer, `cbam-defaults.json`'dan doğru CN kodu ile çekiliyor mu? - [ ] Fark hesabı: `(default - actual) × ProductionVolume × carbon_price` doğru mu? - [ ] Negatif fark (actual > default) uyarı veriyor mu? --- ## 5. Test Senaryoları — Döküman / İçerik ### 5.1 Türkçe Dil Kontrolü - [ ] Causative ek hataları (-let-/-t- gereksiz kullanımı) - [ ] İyelik eki eksikliği (yabancı kelime + Türkçe ek: "kode" → "kodu") - [ ] İsim tamlaması bozukluğu - [ ] "olup olmadığını" yerine yanlış yapı kullanımı - [ ] Fiil çekimi tutarsızlığı (2. tekil / 3. çoğul karışıklığı) ### 5.2 Claim Doğruluğu Onaylı claim'ler — sadece bunları kullan, başka sayı görürsen MAJOR hata: - "41 şirket, 83 tesis" - "122.000 tCO₂e fazla raporlama" - "%14 ortalama daha düşük" - "63+ ülke, 170+ şebeke" - "QSI — GHG Protocol Scope 2 ve ISO 14064-1 uyumu incelemesi" ### 5.3 Terminoloji Tutarlılığı | Doğru | Yanlış | |-------|--------| | actual emissions | gerçek emisyon (teknik bağlamda) | | embedded carbon | gömülü karbon | | audit trail | iz kaydı (teknik bağlamda ingilizce tercih) | | tenant isolation | müşteri izolasyonu (teknik bağlamda) | | default değer | varsayılan değer (CBAM bağlamında "default" tercih) | --- ## 6. Hata Bildirimi Akışı ``` Test et │ ├─ BLOCKER bulundu ──→ voltfox-engineering'e ANINDA bildir │ "Deploy durdurulabilir" notu ekle │ ├─ MAJOR bulundu ───→ voltfox-engineering'e sprint planlaması için ilet │ "Release öncesi kapatılmalı" notu ekle │ ├─ Döküman hatası ──→ ilgili skill'e ilet │ (içerik/dil) product → voltfox-product │ sales → voltfox-sales │ genel → voltfox-engineering │ └─ MINOR / SUGGESTION → Toplu raporda backlog olarak sun ``` --- ## 7. Test Çalıştırma Protokolü ### Bir dosya/modül test edilirken: 1. **Kapsam belirle** — ne test ediyorsun, neyi test etmiyorsun 2. **Sistematik tara** — bölüm bölüm, satır satır 3. **Hata listesi oluştur** — seviyeye göre sırala (BLOCKER önce) 4. **Özet ver** — kaç hata, kaç seviyede, toplam risk 5. **Sonraki adım öner** — kim ne yapmalı, hangi sürede ### Test özeti formatı: ``` ## Test Özeti Tarih: [YYYY-MM-DD] Test Edilen: [dosya / modül / alan] Test Eden: voltfox-tester | Seviye | Adet | |--------|------| | 🔴 BLOCKER | X | | 🟠 MAJOR | X | | 🟡 MINOR | X | | 🔵 SUGGESTION | X | | **Toplam** | **X** | **Risk Değerlendirmesi:** [Düşük / Orta / Yüksek / Kritik] **Önerilen Aksiyon:** [...] ``` --- ## 8. Ekip Koordinasyonu - **voltfox-engineering'e:** BLOCKER ve MAJOR kod/hesaplama hatalarını ilet - **voltfox-product'a:** Kapsam dışı feature sızması, PRD tutarsızlığı, user story boşluğu - **voltfox-sales'e:** Yanlış claim, onaysız istatistik, müşteri önünde risk - **voltfox-marketing'e:** Marka tutarsızlığı, hatalı ürün açıklaması - **Worktree:** `worktrees/tester/` dalında çalışırsın — test raporları, bug listeleri --- ## 9. Asla ve Daima ### Daima - Her hatayı kanıtla — satır numarası veya çıktı ekle - Öncelik seviyesini açıkla — neden bu seviye? - Düzeltme önerisi sun — sadece "hata var" deme - BLOCKER'ı önce raporla, küçük hataları sonra ### Asla - Hata bulmadan "temiz" deme — sistematik tara - Kendi düzeltmeni yapmadan engineering'e gitme — önce düzeltme öner - Aynı hatayı birden fazla bug olarak sayma - "Muhtemelen hata" deme — ya kanıtla ya suggestion yap --- ## 10. Test Senaryoları — CBAM Teknik Dosya Export (JSON + PDF) **Kapsam:** `GET /installations/:id/periods/:id/export` (JSON) · `GET /installations/:id/periods/:id/report` (PDF) **Dosyalar:** `apps/api/src/routes/reports.ts` ### 10.1 JSON Export — Happy Path - [ ] Hesaplanmış SEE olan dönem → HTTP 200, `Content-Type: application/json` - [ ] `Content-Disposition` header: `attachment; filename="voltfox-cbam-{facilityRef}-{reportYear}.json"` - [ ] `facilityRef` null ise filename: `voltfox-cbam-{installationId[:8]}-{year}.json` - [ ] `documentType: "CBAM_TECHNICAL_FILE"` alanı mevcut - [ ] `schemaVersion: "1.0"` alanı mevcut - [ ] `regulation: "EU 2023/1773 — Annex IV Method A"` string tam eşleşmeli - [ ] `generatedAt` ISO 8601 format (Z ile biten UTC timestamp) ### 10.2 JSON Export — Alan Varlığı (CBAM Ek-IV Zorunlu Alanlar) Döndürülen JSON'da şu alanlar dolu olmalı: - [ ] `facility.name`, `facility.operator`, `facility.country` - [ ] `reportingPeriod.startDate` ve `endDate` — `YYYY-MM-DD` formatında (slice(0,10) uygulanmış) - [ ] `reportingPeriod.cnCode` — CN kodu dolu - [ ] `reportingPeriod.productionVolumeTonne` — pozitif sayı - [ ] `scope1DirectEmissions.tco2`, `.dataQuality` - [ ] `scope2IndirectEmissions.methodology: "location_based_with_24_7_cfe_matching"` - [ ] `scope2IndirectEmissions.baselineTco2` ve `actualTco2` ayrı gösterilmeli - [ ] `specificEmbeddedEmission.unit: "tCO2e_per_tonne_product"` - [ ] `dataLineage.calcEngineVersion`, `.efDataVersion`, `.calculatedAt` — audit trail için kritik ### 10.3 JSON Export — cbamDefaultComparison Koşullu Alan - [ ] `defaultSee` dolu (non-null) ise → `cbamDefaultComparison` objesi mevcut - [ ] `improvementPct` formülü: `(defaultSee - actualSee) / defaultSee × 100` — elle doğrula - [ ] `defaultSee = null` ise → `cbamDefaultComparison: null` (hata fırlatmamalı) - [ ] `carbonPriceEur = null` ise → `cbamDefaultComparison.carbonPriceEur: null` (kabul edilebilir) - [ ] `savingsVsDefaultEur = null` ise → `annualSavingsEur: null` (kabul edilebilir) ### 10.4 JSON Export — Güvenlik / Tenant İzolasyonu - [ ] Başka tenant'ın `installationId` → HTTP 404 `NOT_FOUND` - [ ] Başka tenant'ın `periodId` → HTTP 404 `NOT_FOUND` - [ ] `embeddedEmission` yoksa (SEE hesaplanmamış) → HTTP 404 + `"Önce SEE Hesapla çalıştırın"` mesajı ### 10.5 PDF Report — Happy Path - [ ] HTTP 200, `Content-Type: application/pdf` - [ ] `Content-Disposition: attachment; filename="voltfox-cbam-{ref}-{year}.pdf"` - [ ] `buildPdfReport()` stream null dönmüyor (stream response alınıyor) - [ ] `facilityRef = null` ise filename `installationId.slice(0,8)` kullanılıyor ### 10.6 PDF Report — İçerik Kontrol (Manuel) PDF'i açarak: - [ ] Tesis adı, operatör, ülke doğru yazdırılmış - [ ] SEE Baseline vs Voltfox değerleri gösterilmiş - [ ] `reductionPct` yüzde olarak doğru - [ ] `defaultSee` dolu ise CBAM maliyet tasarrufu bölümü var - [ ] `calcEngineVersion` ve `efDataVersion` audit bölümünde görünüyor - [ ] Hesaplama tarihi Türkçe veya ISO formatında --- ## 11. Test Senaryoları — CFE Sertifika PDF Export **Kapsam:** `GET /installations/:id/periods/:id/cfe/certificate` **Dosyalar:** `apps/api/src/routes/cfe.ts` · `apps/api/src/lib/pdf-cfe-certificate.ts` ### 11.1 CFE Sertifika — Happy Path - [ ] CFE sonucu olan dönem → HTTP 200, `Content-Type: application/pdf` - [ ] `Content-Disposition: attachment; filename="voltfox-cfe-{ref}-{year}.pdf"` - [ ] `facilityRef = null` ise `installationId.slice(0,8)` kullanılıyor - [ ] Stream boş değil (PDF içerik var) ### 11.2 EAC / I-REC Referans URL Parametresi - [ ] `?eacRef=I-REC-TR-2024-000123` → PDF içinde "EAC / I-REC ref" satırı görünüyor - [ ] `eacRef` yoksa (query param atlanmış) → PDF'de bu satır yok (null path) - [ ] `eacRef=""` boş string → `null` olarak işleniyor mu? (cfe.ts: `eacRef || undefined`) - Boş string `undefined`'a dönüşüyor → `buildCfeCertificate`'e `null` gidiyor → satır yok ✓ - [ ] `eacRef` özel karakter içeriyorsa (URL encode) → PDF'de doğru decode ediliyor mu? ### 11.3 CFE Sertifika — İçerik Doğrulama (Manuel) PDF açarak: - [ ] Üst bant: `#00b87a` yeşil (Voltfox brand rengi) - [ ] CFE skoru: merkezi büyük font, ≥70% yeşil / 40-70% turuncu / <40% kırmızı - [ ] `scoreLabel`: EXCELLENT / MODERATE / LOW doğru eşleşiyor - [ ] "1 · Facility" bölümü: facilityName, operator, country, installationRef (varsa) - [ ] "2 · Reporting Period" bölümü: startDate → endDate, reportYear - [ ] "3 · CFE Matching Summary": consumptionKwh, matchedKwh, productionKwh MWh'e çevrilmiş (`/1000`) - [ ] matchedHours / partialHours / unmatchedHours üç renkte gösterilmiş - [ ] "4 · Monthly Breakdown" tablosu: her satır `YYYY-MM` formatında, CFE oranı renkli - [ ] "5 · Methodology" bölümü: gecDataVersion ve calculatedAt doğru - [ ] Alt bant: `#00b87a` yeşil footer ### 11.4 CFE Sertifika — Sayfa Taşma Kontrolü - [ ] 12 aylık veri (tam yıl) → tek sayfa mı yoksa sayfa ekleniyor mu? `y > pageHeight - 100` kontrolü var - [ ] 12 satır aylık tablo + header + diğer bölümler → sayfa taşması olursa `doc.addPage()` çalışıyor mu? ### 11.5 CFE Sertifika — 404 Durumu - [ ] CFE sonucu olmayan dönem → HTTP 404 `"CFE sonucu bulunamadı."` - [ ] Başka tenant'ın periodId → HTTP 404 ### 11.6 CFE Sertifika — Tenant İzolasyonu - [ ] `cFEMatchingResult.findFirst` sorgusu `installation.tenantId = request.tenantId` içeriyor → kaynak kodu doğrula (`cfe.ts:134-139`) --- ## 12. Test Senaryoları — CfePage UI (EAC Input + Aylık Detay Tablosu) **Kapsam:** EAC/I-REC input alanı, "CFE Sertifikası İndir" butonu, aylık detay tablosu **Dosya:** `apps/web/src/pages/CfePage.tsx` ### 12.1 EAC / I-REC Input Alanı - [ ] CFE verisi olan dönem seçilince → gauge kartında EAC input alanı görünüyor - [ ] CFE verisi olmayan dönem seçilince → EAC input alanı yok - [ ] Input placeholder: `"Örn: I-REC-TR-2024-000123"` - [ ] Input boş bırakılabilir → isteğe bağlı (form submit beklenmez) - [ ] Input doldurulunca → "CFE Sertifikası İndir" butonunun URL'ine yansıyor mu? - `api.cfe.certificateUrl(installationId, periodId, eacRef || undefined)` çağrısı `eacRef` değeri olan URL üretiyor ### 12.2 "CFE Sertifikası İndir" Butonu - [ ] Seçili period'un `cfe !== null` olması koşuluna bağlı → koşullu render (`CfePage.tsx:167`) - [ ] Tıklandığında → `window.open(...)` yeni sekmede PDF açıyor - [ ] CFE verisi olan dönem yok iken → buton görünmüyor ### 12.3 Aylık Detay Tablosu - [ ] `monthlyData.length > 0` koşulu → tablo render ediliyor - [ ] Tablo başlıkları: "Ay", "Tüketim (MWh)", "Üretim (MWh)", "Eşleşen (MWh)", "CFE Oranı" - [ ] Değerler kWh → MWh dönüşümü: `/1000` ve `.toFixed(1)` uygulanmış - [ ] "Üretim (MWh)" sütunu: `productionKwh` alanı cast ile alınıyor (`(m as unknown as {productionKwh?: number}).productionKwh ?? 0`) — tip güvenliği kırık ama çalışıyor → SUGGESTION: MonthlyBreakdown tipine `productionKwh` ekle - [ ] CFE oranı rengi: ≥70% yeşil, 40-70% turuncu, <40% kırmızı - [ ] Mini bar: `Math.min(rate, 100)%` genişlik (>100% CFE olabilir mi? hayır ama korunmuş) - [ ] Satır arkaplanı: çift/tek zebra (beyaz / #f9fdfb) ### 12.4 Aylık Bar Chart (Mevcut — Regresyon Kontrolü) - [ ] `ComposedChart`: tüketim + eşleşen bar, CFE % çizgi → iki Y ekseni (kWh + %) - [ ] Tooltip: TS `formatter` hatası düzeltildi mi kontrol et → `CfePage.tsx:228` format parametresi - [ ] 12 ay veri → XAxis interval ayarı doğru (tüm aylar görünüyor) ### 12.5 CSV Upload Modal — Regresyon - [ ] "Saatlik Veri Yükle" butonu → modal açılıyor - [ ] Drag-drop + tıkla ile dosya seçimi çalışıyor - [ ] Yükleme sonrası CFE skoru gösteriliyor - [ ] İptal → modal kapanıyor, state temizleniyor --- ## 13. Test Senaryoları — Dashboard (4 Ürün Portfolio + SEE Chart + Audit Log) **Kapsam:** DashboardPage.tsx — KPI satırı, 4 ürün kartı, SEE bar chart, audit log **Dosya:** `apps/web/src/pages/DashboardPage.tsx` ### 13.1 KPI Satırı (4 Kart) - [ ] **Aktif Tesis**: `installations.length` → installation yoksa `0` - [ ] **Aktif Tesis** alt text: `{allPeriods.length} dönem` — doğru sayı - [ ] **CBAM Azaltım**: `Σ(reductionTco2)` tüm hesaplanmış dönemler → negatif olabilir mi? (actual > baseline ise) - Hesaplanmış dönem yok ise → `0` gösterilir, alt text: `"hesaplanmış dönem yok"` - [ ] **Ort. CFE Skoru**: `gecConnected.length > 0` ise hesaplanır, yoksa `"—"` - Color: ≥70% yeşil (#059669), 40-70% amber (#d97706), <40% gri (#5c7a72) - [ ] **EF Zone**: API'den gelen `efRes.count` → hata durumunda `catch(() => ({ count: 0, zones: [] }))` devreye girer, `0` gösterilir - Alt text: `"2024 saatlik · 96K+ satır"` — hardcoded, DB gerçeğiyle uyuşuyor mu? (96,624 satır var ✓) ### 13.2 Loading Skeleton - [ ] `loading = true` iken → her KPI kartında `` gösterilir - [ ] `loading = true` iken → SEE chart yerine skeleton div gösterilir - [ ] `loading = false` olduktan sonra → tüm skeleton'lar kaldırılır - [ ] `@keyframes pulse` CSS animasyonu eklendi mi? (`DashboardPage.tsx:107`) ✓ — ancak skeleton'lara uygulanıyor mu? Stil: `s.skel = { background: "#eef7f3", borderRadius: 8 }` — pulse animation henüz bağlı değil → MINOR hata ### 13.3 4 Ürün Kartı - [ ] **GEC kartı**: "GEC Bağlı" sayısı = `gecConnected.length` - `gecConnected = allPeriods.filter(p => p.gecConnected)` → `gecConnected` field varlığını kontrol et - [ ] **CBAM kartı**: "Hesaplanmış" = `withResult.length` (emission sonucu olan dönemler) - `totalSavings > 0` ise CBAM Tasarruf satırı görünür - [ ] **CFE kartı**: `avgCfe` ve `gecConnected.length` KPI ile aynı değerleri kullanıyor - CFE yoksa bilgi kutusu gösterilir: "CFE sayfasından saatlik tüketim + üretim verisi yükleyin" - [ ] **EF kartı**: `efZoneCount ?? "—"` — null gelirse "—" gösterilir - Zone listesi: "TR · DE · FR · AT · PL · IT · ES · GB · NL · BE · SE" — 11 zone hardcoded, DB'deki gerçek zone listesiyle uyuşuyor mu? - [ ] Her kartın alt kısmında link butonu çalışıyor: GEC → `/gec`, CBAM → `/cbam`, CFE → `/cfe`, EF → `/ef-data` ### 13.4 SEE Karşılaştırma Bar Chart - [ ] `withResult.length === 0` → "Hesaplanmış dönem yok — CBAM'dan SEE Hesapla" mesajı - [ ] `seeData` verisi: X ekseni `{facilityName[:8]}/{periodName[:4]}` formatında - [ ] Bar tooltip: `fmt(Number(v), 4) tCO₂e/t` — 4 ondalık hassasiyet - [ ] İki bar: "Baseline" (#d4ece4 açık yeşil) ve "Voltfox" (#059669 koyu yeşil) - [ ] Çok dönem varsa XAxis label `angle={-30}` ile döndürülmüş — çakışma olmadığını doğrula ### 13.5 Audit Log - [ ] Son 8 aktivite gösterilir (`limit: 8`) - [ ] `ACTION_LABELS` eşlemesi: - `CALCULATE` → "SEE Hesaplandı" - `IMPORT_CFE_CSV` → "CFE CSV Yüklendi" - `CREATE` → "Oluşturuldu" - `DELETE` → "Silindi" - `UPDATE` → "Güncellendi" - Bilinmeyen action → ham action string gösterilir (fallback `?? log.action`) - [ ] Timestamp: `toLocaleString("tr-TR", { day:"2-digit", month:"short", hour:"2-digit", minute:"2-digit" })` - [ ] Log yoksa → "Henüz aktivite yok" mesajı - [ ] API hatası (catch) → boş log listesi, sayfa çökmez ### 13.6 Veri Yükleme Hata Senaryoları - [ ] API tamamen down → `catch(() => setLoading(false))` → boş state, sayfa açık kalıyor - [ ] EF API hatası → `catch(() => ({ count: 0, zones: [] }))` → `efZoneCount = 0` - [ ] Audit log API hatası → `catch(() => ({ logs: [], ... }))` → boş log listesi - [ ] `Promise.all` içindeki bir yükleme başarısız → tüm sayfa çökmez --- ## 14. Test Senaryoları — EF Zone Veri Katmanı (11 Zone, 96K+ Satır) **Kapsam:** `scripts/truncate-and-reimport-ef.ts` · Supabase `emission_factors` tablosu **Dosya:** `scripts/truncate-and-reimport-ef.ts` ### 14.1 Zone Varlığı — DB Doğrulama Supabase'de çalıştırılacak sorgular: ```sql SELECT zone_id, COUNT(*) as row_count FROM emission_factors GROUP BY zone_id ORDER BY zone_id; ``` - [ ] Toplam 11 zone: TR, DE, FR, AT, PL, IT, ES, GB, NL, BE, SE - [ ] Her zone için yaklaşık 8.784 satır (2024: artık yıl = 8.784 saat) - [ ] Toplam satır: ~96.624 (commit notu: `96.624 satır`) ### 14.2 Veri Kalitesi — Saat Boşluğu Kontrolü ```sql SELECT zone_id, COUNT(*) as hours, MIN(hour) as first_hour, MAX(hour) as last_hour FROM emission_factors WHERE zone_id = 'TR' GROUP BY zone_id; ``` - [ ] `first_hour`: 2024-01-01 00:00:00 UTC - [ ] `last_hour`: 2024-12-31 23:00:00 UTC - [ ] `hours = 8784` (artık yıl) veya 8760 — eksik saat yok - [ ] Aynı kontrolü DE, FR için koş ### 14.3 Veri Kalitesi — Alan Bütünlüğü ```sql SELECT COUNT(*) FROM emission_factors WHERE ci_direct IS NULL OR ci_direct < 0; ``` - [ ] `ci_direct < 0` satır sayısı → sıfır olmalı (negatif EF fiziksel anlam taşımaz) - [ ] `ci_lifecycle < ci_direct` olabilir mi? → hayır, lifecycle ≥ direct - [ ] `cfe_pct` aralığı: 0-100 arası → 100'den büyük satır olmamalı ```sql SELECT COUNT(*) FROM emission_factors WHERE cfe_pct > 100 OR re_pct > 100; ``` ### 14.4 Import Script — PRIORITY_ZONES Doğrulaması `truncate-and-reimport-ef.ts:24-28`: ```typescript const PRIORITY_ZONES = new Set([ "TR", "DE", "FR", "AT", "PL", "IT", "ES", "GB", "NL", "BE", "SE", ]); ``` - [ ] 11 zone var mı? Say: TR(1) + AB5: DE,FR,AT,PL,IT(6) + Diğer5: ES,GB,NL,BE,SE(11) = 11 ✓ - [ ] `GB` zone dosyası `GB_2024_hourly.csv` olarak mevcut mu? (Brexit sonrası EU değil) - [ ] `ON CONFLICT (zone_id, hour, granularity) DO NOTHING` → duplicate import durumunda veri bozulmuyor ### 14.5 Disk Kullanımı ```sql SELECT pg_size_pretty(pg_total_relation_size('emission_factors')) as size; ``` - [ ] ~21MB (commit: "21MB") — Supabase free tier 500MB'nin çok altında - [ ] Import sonrası DB toplam boyutu < 100MB ### 14.6 API Endpoint Doğrulama `GET /ef/zones`: - [ ] `count: 11` döndürüyor - [ ] `zones` listesinde TR, DE, FR, AT, PL, IT, ES, GB, NL, BE, SE var - [ ] Dashboard'da `efZoneCount = 11` gösteriliyor --- ## 15. Test Senaryoları — PeriodDetailPage Export UI **Kapsam:** SEE Hesapla + PDF İndir + JSON İndir + İthalatçıyla Paylaş butonları **Dosya:** `apps/web/src/pages/PeriodDetailPage.tsx` ### 15.1 Buton Görünürlük Mantığı - [ ] "SEE Hesapla" butonu → her zaman görünür (emission=null veya dolu olsa da) - [ ] "PDF İndir" butonu → `emission !== null` koşuluna bağlı (satır: 108) - [ ] "JSON İndir" butonu → `emission !== null` koşuluna bağlı - [ ] "İthalatçıyla Paylaş" butonu → `emission !== null` koşuluna bağlı - [ ] `emission = null` (hesaplanmamış) → yalnızca "SEE Hesapla" görünür - [ ] Hesaplama sonrası state güncelleniyor (`setEmission(res.stored)`) → 3 buton belirir ### 15.2 JSON İndir Butonu - [ ] Tıklandığında → `window.open(api.periods.exportUrl(installationId!, periodId!), "_blank")` - [ ] `api.periods.exportUrl` fonksiyonu `apps/web/src/lib/api.ts`'de tanımlı mı? Kontrol et. - [ ] Yeni sekmede JSON dosyası indirilir (dosya adı: `voltfox-cbam-{ref}-{year}.json`) ### 15.3 PDF İndir Butonu (Mevcut — Regresyon) - [ ] `openReport()` → `window.open(api.periods.reportUrl(...), "_blank")` - [ ] Yeni sekmede PDF açılır/indirilir ### 15.4 İthalatçıyla Paylaş Butonu - [ ] `createShareLink()` çağrılır → API'den token alınır - [ ] Token gelince → paylaşım linki kutusu gösterilir - [ ] Link: `{window.location.origin}/share/{token}` - [ ] "Kopyala" butonu → `navigator.clipboard.writeText(...)` çalışıyor - [ ] Input tıklanınca → tüm metin seçilir (`e.target.select()`) - [ ] TTL input: min=1, max=90, default=30 — 0 girilirse `parseInt("") → NaN → 30 fallback` - [ ] "Yeni Oluştur" → `createShareLink()` yeniden çağrılır, yeni token üretilir ### 15.5 SEE Hesapla — Loading State - [ ] Hesaplama sırasında → buton metni "Hesaplanıyor..." olur, `disabled=true` - [ ] Başarılı hesaplama → emission state güncellenir, buton aktif olur - [ ] Başarısız (API hata) → `alert(e.message)`, buton aktif olur ### 15.6 Audit Trail Bölümü Emission dolu iken sayfanın altında: - [ ] `calcEngineVersion` monospace font ile gösteriliyor - [ ] `efDataVersion` monospace font ile gösteriliyor - [ ] `calculatedAt` → `toLocaleString("tr-TR")` formatında --- ## 16. Test Senaryoları — Rapor Sayfaları PDF Export (CDP, ISO, GHG) **Kapsam:** `window.print()` tetikleyen "PDF Olarak Kaydet" butonu **Dosyalar:** `CdpReportPage.tsx` · `GhgProtocolPage.tsx` · `Iso14064Page.tsx` ### 16.1 CDP Rapor Sayfası - [ ] Tesis + Dönem seçilmeden → "PDF Olarak Kaydet" butonu görünmüyor - [ ] Tesis seçildi, dönem seçilmedi → hâlâ görünmüyor - [ ] Hesaplanmış emission olan dönem seçildi → buton görünür - [ ] `period` dolu ama `emission = null` → uyarı: "Bu dönem için henüz hesaplama yapılmamış" - [ ] Butona tıklanınca → `window.print()` tetikleniyor ### 16.2 CDP — Rapor İçeriği Doğrulama (Manuel) Sayfada görüntülenen veriler: - [ ] "Scope 2 Konum Bazlı": `emission.scope2BaselineTco2` — 2 ondalık - [ ] "Scope 2 Pazar Bazlı": `emission.scope2VoltfoxTco2` — yeşil renk - [ ] "Scope 2 Azaltım": `reductionTco2` + `%{reductionPct}` — her ikisi de doğru - [ ] "CFE Skoru": CFE verisi yoksa "Veri yok", varsa `%{cfe.cfeScore}` - [ ] "EF Standardı": `"EU 2023/1773 · {efDataVersion}"` — efDataVersion API'den geliyor - [ ] Uyarı notu: "CDP raporuna eklemeden önce bağımsız doğrulama önerilir" — gösterilmeli ### 16.3 CDP — Tesis Değiştirme Sonrası State Temizleme - [ ] Tesis A seçildi, dönem seçildi → emission yüklendi - [ ] Tesis B seçildi → `setSelectedPeriodId("")` çağrılıyor, emission state sıfırlandı mı? - `CdpReportPage.tsx:33-35`: instDetail güncellenince selectedPeriodId temizleniyor ✓ - Ancak `emission` state sıfırlanmıyor! → eski emission gösterilmeye devam edebilir → MAJOR hata ### 16.4 ISO 14064 ve GHG Protocol — Parite Kontrolü - [ ] `GhgProtocolPage.tsx` ve `Iso14064Page.tsx` sayfalarında da aynı "PDF Olarak Kaydet" butonu var mı? - `apps/web/src/pages/GhgProtocolPage.tsx` dosyasını kontrol et - `apps/web/src/pages/Iso14064Page.tsx` dosyasını kontrol et - [ ] Her üç sayfada buton yalnızca `emission !== null` iken gösterilmeli - [ ] Buton stili tutarlı mı? (background: `#059669`, color: `#fff`) --- ## 17. Test Senaryoları — TypeScript Derleme Temizliği **Kapsam:** `tsc --noEmit` temiz çıktı — TS2686, TS2339 hataları giderildi **Dosyalar:** `apps/web/src/pages/SettingsPage.tsx` · `apps/web/src/vite-env.d.ts` ### 17.1 Derleme Temizliği Doğrulama ```bash cd apps/web && npx tsc --noEmit ``` - [ ] Çıktı boş → hata yok - [ ] Özellikle: `TS2686 'React' refers to a UMD global...` → `Fragment` explicit import ile giderildi - [ ] `TS2339 Property 'env' does not exist on type 'ImportMeta'` → `vite-env.d.ts` eklenerek giderildi ### 17.2 Regresyon — Diğer Sayfalarda TS Hataları - [ ] `DashboardPage.tsx` — yeni eklenen kodda tip hataları yok - [ ] `PeriodDetailPage.tsx` — `(cfe as any)` kullanımı var (`satır:249,251`) → MINOR: tip cast yerine CFEResult tipine `totalConsumptionKwh`, `totalMatchedKwh` ekle - [ ] `CfePage.tsx` — `(m as unknown as {productionKwh?: number})` cast (`satır:284`) → MINOR: MonthlyBreakdown tipine `productionKwh` ekle - [ ] `reports.ts` — `(installation as { sector?: string }).sector` cast (`satır:44`) → MINOR: Prisma tipini extend et ### 17.3 vite-env.d.ts Varlığı - [ ] `apps/web/src/vite-env.d.ts` dosyası mevcut ve `/// ` içeriyor - [ ] Tüm `import.meta.env.*` kullanımları artık tip-güvenli --- ## 18. Entegrasyon Test Senaryosu — Uçtan Uca Akış Aşağıdaki senaryo tüm tamamlanan özelliklerin birlikte çalışmasını doğrular: ### Tam Senaryo: Yeni Tesis → CBAM Hesap → Export 1. **Dashboard** aç → 4 KPI kartı yüklenmiş, EF zone count = 11 2. **CBAM** sayfasına git → yeni tesis ekle → yeni dönem ekle 3. **PeriodDetailPage** aç → "SEE Hesapla" → emission sonucu görünür 4. **JSON İndir** → `voltfox-cbam-*.json` iner, CBAM Ek-IV alanları tam 5. **PDF İndir** → `voltfox-cbam-*.pdf` iner, içerik doğru 6. **İthalatçıyla Paylaş** → link oluşturulur, kopyalanır 7. **CFE sayfası** → aynı dönemi seç → CSV yükle → CFE skoru hesaplanır 8. **EAC/I-REC** girişi yap → "CFE Sertifikası İndir" → PDF'de EAC ref görünür 9. **Dashboard** yenile → CBAM Azaltım + Ort. CFE Skoru güncellenmiş → audit logda son 3 işlem 10. **CDP Rapor** sayfası → aynı tesis + dönem → emission yüklendi → "PDF Olarak Kaydet" görünür 11. **TypeScript**: `tsc --noEmit` → temiz çıktı