Dokümantasyon
Hızlı Başlangıç Kılavuzu
ZincirX'e hoş geldiniz! Bu kılavuz, blok zinciri tabanlı tedarik zinciri yönetim platformumuzu kullanmaya başlamanıza yardımcı olacaktır.
Adım 1: Cüzdanınızı Bağlayın
- Henüz yüklemediyseniz MetaMask tarayıcı eklentisini yükleyin
- Cüzdanınızı oluşturun veya içe aktarın
- ZincirX'i ziyaret edin ve "Cüzdan Bağla" düğmesine tıklayın
- MetaMask üzerinden bağlantıyı onaylayın
- İstendiğinde Scimatic Ağına (Chain ID: 481) geçiş yapın
Adım 2: Kurulumu Tamamlayın
- Bildirimler için e-posta adresinizi girin
- Onay bağlantısı aracılığıyla e-postanızı doğrulayın
- İşletme bilgilerinizi ve kategorinizi girin
- İşletme profili kurulumunuzu tamamlayın
Adım 3: İlk Şablonunuzu Oluşturun
- Şablonlar bölümüne gidin
- "Yeni Şablon Oluştur" düğmesine tıklayın
- Tedarik zinciri süreç adımlarınızı tanımlayın
- Her adım için doğrulama gereksinimlerini belirleyin
- Şablonunuzu kaydedin ve etkinleştirin
Adım 4: Partileri Takip Etmeye Başlayın
- Partiler bölümüne gidin
- Şablonunuzu kullanarak yeni bir parti oluşturun
- Ürünler tedarik zincirinizde ilerlerken her adımı yürütün
- Destekleyici belgeleri ve medyayı yükleyin
- Paydaşlarla doğrulama bağlantılarını paylaşın
Temel Kavramlar
Şablonlar
Şablonlar, tedarik zinciriniz için standart süreci tanımlar. Her adımın doğrulama gereksinimleriyle birlikte ürünlerin geçmesi gereken bir dizi adımı içerir.
- Yeniden kullanılabilir iş akışı tanımları
- Özelleştirilebilir adım gereksinimleri
- Rol tabanlı erişim kontrolleri
- Doğrulama kuralları ve bağımlılıklar
Partiler
Partiler, bir şablonu takip eden belirli üretim çalışmalarını veya ürün gruplarını temsil eder. Her partinin takip ve doğrulama için benzersiz bir UUID'si vardır.
- UUID aracılığıyla benzersiz tanımlama
- Gerçek zamanlı adım yürütme takibi
- Medya ve belge ekleri
- Herkese açık doğrulama özellikleri
Parti Adımları
Parti yürütme sürecindeki bireysel adımlar; her biri kendi durumu, zaman damgaları ve destekleyici belgeleriyle.
- Durum takibi (beklemede, devam ediyor, tamamlandı, başarısız)
- Her durum değişikliği için zaman damgası kaydı
- Konum verileri ve GPS koordinatları
- Dosya ekleri ve notlar
İşletme Profilleri
Cüzdan adreslerine bağlı şirket bilgileri; çok taraflı iş birliği ve rol tabanlı erişim sağlar.
- Şirket tanımlama ve doğrulama
- İş kategorisi sınıflandırması
- İletişim bilgileri ve tercihler
- Erişim izni yönetimi
Kullanıcı Rolleri ve İzinleri
| Rol | İzinler | Tipik Kullanım Senaryosu |
|---|---|---|
| Üretici | Şablon oluşturma, parti başlatma, tüm adımları yürütme | Ürün üreten ve yöneten orijinal üreticiler |
| Distribütör | Belirli adımları yürütme, konumları güncelleme, belge ekleme | Ürünleri taşıyan lojistik ve dağıtım şirketleri |
| Perakendeci | Parti bilgilerini görüntüleme, son adımları yürütme, müşteriye yönelik doğrulama | Son tüketicilere satış yapan mağazalar ve satış noktaları |
| Denetçi | Tüm verileri görüntüleme, sertifika ekleme, kalite kontrol belgeleri | Düzenleyici kurumlar ve kalite güvence ekipleri |
| Tüketici | UUID/QR kodları aracılığıyla herkese açık doğrulama | Ürün orijinalliğini doğrulayan son müşteriler |
API Entegrasyonu
Kimlik Doğrulama
ZincirX cüzdan tabanlı kimlik doğrulama kullanmaktadır. API'mize entegre olmak için:
- Cüzdan özel anahtarınızla mesajları imzalayın
- API isteklerine cüzdan adresini ekleyin
- Scimatic ağında imzaları doğrulayın
Temel Uç Noktalar
Parti İşlemleri
GET /api/batchesPOST /api/batchesGET /api/batches/{id}POST /api/batches/{id}/steps/{stepId}/complete
Şablon Yönetimi
GET /api/templatesPOST /api/templatesPUT /api/templates/{id}
Herkese Açık Doğrulama
GET /verify/{uuid}GET /qr/{uuid}/image
Blok Zinciri Entegrasyonu
Scimatic Ağı
- Chain ID: 481
- Network Name: Scimatic
- Currency: SCI
- Type: Enterprise blockchain network
Akıllı Sözleşme Entegrasyonu
ZincirX, geleneksel veritabanı depolamasını blok zinciri doğrulaması ile birleştiren hibrit modda çalışmaktadır. Temel blok zinciri işlemleri şunları içerir:
- Şablon kaydı ve doğrulaması
- Parti oluşturma ve adım tamamlama kayıtları
- Tüm işlemler için değişmez denetim izleri
- Kritik işlemler için çoklu imza iş akışları
En İyi Uygulamalar
Güvenlik
- Cüzdan özel anahtarlarınızı güvende tutun ve asla paylaşmayın
- Cüzdanınızı ve kurtarma ifadelerinizi düzenli olarak yedekleyin
- İmzalamadan önce tüm işlem ayrıntılarını doğrulayın
- İşletme e-posta hesabınız için güçlü parolalar kullanın
Veri Yönetimi
- Her adım için doğru ve eksiksiz bilgi sağlayın
- Doğrulama için net ve ilgili medya dosyaları yükleyin
- Partiler ve şablonlar için tutarlı adlandırma kuralları kullanın
- İşletme profilinizi düzenli olarak gözden geçirin ve güncelleyin
İş Birliği
- İlgili tedarik zinciri ortaklarıyla parti erişimini paylaşın
- Adım gereksinimlerini tüm katılımcılara açıkça iletin
- Son müşteriler tarafından kolay doğrulama için QR kodları kullanın
- Tedarik zinciri ağınızla düzenli iletişimi sürdürün
Sorun Giderme
Cüzdan Bağlantı Sorunları
- MetaMask'ın yüklü ve kilidi açık olduğundan emin olun
- Doğru ağda olduğunuzu kontrol edin (Scimatic - Chain ID: 481)
- Tarayıcı önbelleğini ve çerezleri temizleyin
- Cüzdanınızın bağlantısını kesip yeniden bağlamayı deneyin
İşlem Hataları
- Gas ücretleri için SCI bakiyenizi kontrol edin
- Ağ bağlantısının kararlı olduğundan emin olun
- Önceki işlemlerin tamamlanmasını bekleyin
- İşlemler başarısız oluyorsa gas limitini artırmayı deneyin
Performans Sorunları
- Modern tarayıcılar kullanın (Chrome, Firefox, Safari)
- Gereksiz tarayıcı sekmelerini ve uygulamalarını kapatın
- İnternet bağlantı hızınızı kontrol edin
- Gerekirse tarayıcı verilerini temizleyin ve yeniden başlatın
Destek ve Kaynaklar
Topluluk Desteği
Diğer ZincirX kullanıcılarıyla bağlantı kurun ve sorularınız ile zorluklarınız için topluluk odaklı destek alın.
- Kullanıcı forumları ve tartışmalar
- En iyi uygulama paylaşımları
- Özellik talepleri ve geri bildirim
Teknik Destek
Entegrasyon ve platforma özgü sorunlar için teknik ekibimizden doğrudan yardım alın.
- API entegrasyon desteği
- Blok zincirine özgü rehberlik
- Özel çözüm danışmanlığı