Yardım & Dokümantasyon

Hızlı Başlangıç

Kayıt ol — firma adı, slug ve LEI gir.
Dashboard'da + Yeni Batarya Modeli tıkla → 7 cluster × 95 attribute wizard.
Wizard formunu doldur ve Oluştur (Draft).
Dashboard'a dönünce model satırında Aktive Et.
Aktive olunca + Pasaport Yayımla (örnek tek item) veya 📦 Bulk Item Import (Excel/CSV).
Pasaport URL'i şu format: https://battery-id.com/p/<slug>/01/<GTIN>/21/<serial>

EU 2023/1542 Article 77(2) 4 erişim seviyesi tanımlıyor — biz bunları 4 tier olarak uyguluyoruz:

Tier	Kim	Hangi veriler
public	Herkes (auth yok)	Annex XIII point 1 — model bilgileri, performans, karbon
consumer	Son kullanıcı (tüketici)	+ kendi item'inin kullanım verisi (point 4 — Faz 2)
legitimate_interest	Refurbisher, recycler, repairer	+ point 2 (detaylı kompozisyon, dismantling manual)
authority	Notified Body, MSA, EC	+ point 3 test raporları

Şimdilik mock auth (X-Auth-Tier header). Faz 2'de Keycloak/eIDAS High LoA.

Catalog v1.1, EU 2023/1542 Annex XIII point 1+2+3 + Annex VI Part A tam kapsam:

identifiers (12): battery_id, manufacturer_id, GTIN, kategori, ağırlık, üretim yeri/tarihi…
conformity (10): CE marking, EU DoC PDF, atık yönetim sembolü, güvenlik önlemleri, test raporları…
carbon_footprint (9): toplam kgCO₂e/kWh + LCA aşama dağılımı + performans sınıfı A-E…
due_diligence (4): OECD framework, third-party verification, supply chain indices…
materials (7): hücre kimyası, tehlikeli maddeler, kritik hammaddeler, katot/anot/elektrolit kompozisyonu…
circularity (23): geri dönüştürülmüş içerik (Co/Li/Ni/Pb pre+post-consumer), dismantling, spare parts…
performance (30): kapasite, voltaj, çevrim ömrü, sıcaklık, iç direnç (cell/module/pack), RTE…

Her batarya bir GS1 Digital Link URL'i ile temsil edilir:

https://battery-id.com/p/<slug>/01/<GTIN-14>/21/<serial>

QR kod bu URL'i encode eder. Telefon kamerasıyla taranınca mobil-first passport sayfası açılır.

PDF etiket üretimi: POST /battery-batches/{id}/label-sheet — A4 sayfaya 4×6 grid QR + HRI.

QR fiziksel dayanıklılığı: prEN 18220 §5.7.3 — lazer engraved, ISO/IEC 15415 grade ≥ 1.5.

Her PATCH yeni bir passport_version snapshot oluşturur (prEN 18221 §4.2 archive). Eski versiyonlar:

Audit log: tüm yazma operasyonları (GET /audit-log). prEN 18239 §6 madde 18.

Tüm endpoint'ler için: Swagger UI (OpenAPI 3.1).

Auth (şimdilik mock): X-Tenant-Id header'ı UUID olarak yaz; X-Auth-Tier opsiyonel (public/consumer/legitimate_interest/authority).

Rate limit: 120 istek/dakika per-IP. 429 dönerse Retry-After header'ı bak.

Schema değişikliği gerekirse?: Yeni schema_version oluşturulur (örn. v1.2). Eski pasaportlar v1.0/v1.1'de kalır; yeni pasaportlar v1.2'yi kullanır.
Self-host edebilir miyim?: Evet. Repo'da docker-compose.yml + deploy.sh var. --profile tls Caddy ile all-in-one TLS.
2027 Şubat'a yetişir mi?: Evet — MVP hazır, pilot süreç 4 ay + Faz 2 (Keycloak, EU Registry) yeterli buffer var.