1. Giris
Vepora hesabiniz EVOHAUS tarafindan olusturulur. Ilk giris bilgileri size e-posta ile ulasacaktir. vepora.evohaus.org uzerinden giris yapip Sifremi unuttum ile sifre sifirlayabilirsiniz.
Vepora 5 dil destekler: TR, EN, DE, AR, ZH. Sag ust kosedeki dil secici ile gecis yapabilirsiniz. Oturum 60 dakika hareketsizlik sonrasinda otomatik kapanir.
2. GTIP Sorgulama
Bir GTIP koduna ait 27 farkli bolumu tek ekranda toplayan modul: gumruk vergileri, KDV, OTV, EMY, IGV, KKDF, Cevre Katki Payi, Tarim Payi, dipnotlar, gozetim, damping ve daha fazlasi.
Arama kutusuna GTIP kodu yazin (4, 6, 8, 10 veya 12 haneli). Tarife tespiti icin 12 haneli tam kod kullanmaniz onerilir (orn. 8703.21.10.10.00).
Tum Kaynak baglantilari mevzuat.gov.tr resmi devlet sitesine yonlenir.
3. Akilli Tarife Tespiti
Urununuzu isim, tanim veya fotografile arayip uygun GTIP'i bulan modul. Iki sekme: Metin Modu ve Foto Modu (Gemini Vision).
Foto modu: JPG/PNG/WEBP, maksimum 10 MB. Sistem 2 yapay zeka modeline paralel sorgu atar (Gemini 3 Flash + 3.1 Flash Lite), 5-15 saniyede tarife onerisi doner.
Gunluk kota: 50 fotograf/kullanici (00:00 TSI sifirlanir). Kota dolarsa metin modu kullaniminiza devam edebilir.
⚠️ AI tabanli onerilerin mutlaka bir gumruk musavirinin onayindan gecmesi gerekir. Vepora sadece on-onerme aracidir.
4. Hesaplama Motoru
Bir GTIP koduna gore tum vergileri ve toplam maliyeti hesaplayan 8 adimli sihirbaz:
- GTIP ve esya tanimi
- KDV orani (birden fazla varsa seciliyor)
- Mensei ulkesi (AB/EFTA/GTS/DU/spesifik)
- Miktar ve birim
- Gumruk kiymeti (CIF, TCMB kuru)
- Ek masraflar
- OTV (varsa)
- Sonuc — tum vergiler + toplam maliyet
Otomatik tespit: Tarim Payi (fasil 04/19/20/21), Cevre Katki Payi, Haric Sektor (GTS ulkeleri tekstil/giyim → DU orani).
Detayli formul referansi: docs/HESAPLAMA-FORMULLERI.md
5. Teblig ve Dipnot Goruntuleme
Bir GTIP'e bagli dipnotlar GTIP Sorgulama sayfasinda Dipnotlar (Ithalat) ve Dipnotlar (Ihracat) bolumlerinde listelenir.
3 katmanli eslestirme:
- Tier 1 STRICT: Belgenin tam metni gosterilir (mevzuat numarasi ile dogrulanmis)
- Tier 2:Adi-bazli eslesme — mevzuat.gov.tr arama URL'i
- Tier 3: Eslesmeyen — raw kod
6. Admin Sayfasi (Sadece Admin)
Admin rolune sahip hesaplar /admin/audit-log sayfasindan tum kullanici aktivitelerini izleyebilir.
Filtreleme: action prefix (auth.*, vision.*, hesaplama.*), severity (info/warning/security/critical), tarih araligi.
CSV export ve before/after diff drawer mevcut.
RBAC roller:admin (tam yetki) / manager (sadece okuma) / user (kendi audit'i).
7. Veri Saklama ve KVKK
Veriler EVOHAUS VPS uzerinde self-hosted Supabase'de saklanir. 3. parti cloud SaaS'ta tutulmaz, tum trafik HTTPS uzerinden gecer.
Audit log retention:
- Info/warning satirlari: 6 ay
- Security/critical satirlari: 5 yil
- KVKK silme:
emir.audit_anonymize_user(uuid)
Password, token, secret, API key, TCKN, IBAN gibi alanlar audit log'da otomatik maskelenir.
8. Sorun Bildirimi ve Destek
E-posta:
SLA (genel kural):
- Critical (uretim duruyor): 4 saat
- High (modul calismiyor): 1 is gunu
- Normal (hata): 3 is gunu
- Low (ozellik istegi): Sprint kuyruguna alinir
Mevzuat veri tabani otomatik guncellenir — yeni teblig 24-48 saat icinde sisteme yansir.
Bu kilavuz Vepora v1.0 surumune gore hazirlanmistir. Daha detayli bilgi ve REST API referansi icin destek ekibiyle iletisime gecin.