Project Description
## E-Ticaret Paketleme Takip Sistemi — Kurulum & Çift API Entegrasyonu (Sopyo + Geliver)
### Proje Özeti
Rocopaper markası için hazır kodlanmış bir web tabanlı paketleme takip sistemi kurulumu yapılacaktır. Kod tamamen hazır, sadece kurulum ve API yapılandırması gerekiyor.
---
### Sistem Nasıl Çalışıyor?
Personelimiz sipariş paketlerken kargo barkodunu barkod okuyucuyla sisteme okutacak. Sistem barkodu tanıyıp hangi kaynaktan sorgulaması gerektiğine **otomatik karar verecek:**
- **Site siparişleri (websitesi)** → Geliver.io API’den müşteri bilgisi çekilecek
- **Diğer tüm kanallar (pazaryeri vb.)** → Sopyo API’den müşteri bilgisi çekilecek
Bilgi geldikten sonra sistem otomatik olarak termal yazıcıya sticker basacak. Sıfır manuel işlem.
**Teknoloji stack:**
- Frontend: React + Vite (hazır kod ZIP olarak teslim edilecek)
- Veritabanı & Auth: Supabase (ücretsiz plan yeterli)
- Hosting: Netlify (ücretsiz plan yeterli)
- API 1: Sopyo (API key + firma kodu tarafımızda mevcut)
- API 2: Geliver.io (API key tarafımızda mevcut, doküman: docs.geliver.io)
---
### Yapılacak İşler
**1. Supabase kurulumu**
- Yeni Supabase projesi oluşturulacak
- SQL şeması çalıştırılacak (3 tablo: staff, packaging_logs, settings)
- Row Level Security ayarlanacak
- İlk admin kullanıcısı oluşturulacak
**2. Netlify deploy**
- GitHub reposu oluşturulacak, hazır kod push edilecek
- Netlify’a bağlanacak, build ayarlanacak
- Environment variables girilecek
- Netlify Functions aktif edilecek (API proxy)
**3. Çift API entegrasyonu — en kritik kısım**
- Netlify Function içine Geliver.io proxy eklenmesi
- Barkod kaynağı tanıma mantığı yazılması:
- Barkod → önce Geliver’da ara → bulunursa getir
- Bulunamazsa → Sopyo’da ara → getir
- İkisi de bulanamazsa → “Sipariş bulunamadı” mesajı
- Geliver API endpoint: sipariş barkod ile sorgulama (docs.geliver.io)
- Sopyo API endpoint: cargo_barcode ile sorgulama
- Her iki API’den gelen veri aynı formata normalize edilecek
- Hangi kaynaktan geldiği sticker üzerine yazdırılacak
**4. Test & teslim**
- Gerçek barkodla her iki API uçtan uca test edilecek
- Fallback senaryosu test edilecek (biri bulamazsa diğerine geçiş)
- Admin + personel kullanıcısı oluşturulacak
- 15–20 dakika ekran paylaşımlı kullanım anlatımı
---
### Teslim Edilecekler
- Çalışır halde canlı URL (rocopaper.netlify.app veya benzeri)
- Admin + personel giriş bilgileri
- Ekran paylaşımlı kullanım anlatımı (Zoom/TeamViewer/AnyDesk)
- Güncellenen kaynak kodun GitHub reposu
---
### Teknik Notlar
- Hazır React kodu ZIP olarak teslim edilecek
- Supabase + Netlify ücretsiz plan — aylık maliyet yok
- Sopyo API key + Geliver API key tarafımızda mevcut
- Geliver API dokümanı: docs.geliver.io (OpenAPI standardı, net ve detaylı)
- İleride geliştirme yapılabilecek şekilde temiz kodlanmış
- Site kaynaklı siparişler Geliver, diğer tüm kanallar Sopyo — bu ayrım kesinlikle korunmalı
---
### Beklenen Süre
3–6 saat (deneyimli biri için)
### Bütçe
Müzakereye açığım, teklifinizi belirtin.
### Tercih Edilen Profil
- React + Supabase deneyimi olan
- REST API entegrasyonu yapmış
- Netlify Functions (serverless) bilen
- Ekran paylaşımlı (Zoom/AnyDesk) çalışabilen
### İletişim Notu
Başvuran freelancer’a hazır kod ZIP dosyası ve Sopyo + Geliver API key’leri verilecektir. Soru sormak için mesaj gönderin.