Zirve Aktar — XML Aktarım Platformu

🔔

Sentry Hata Takibi

Gerçek zamanlı hata izleme ve raporlama

Aktif https://c26979e58f75c986e48ca9362cb5b9c2…

Butona tıklayarak Sentry bağlantısını test edin. Başarılı gönderimde Sentry dashboard'unda bir test event görünür.

↩

Rollback — Aktarım Geri Al

Son aktarımları listele ve veritabanından sil

Rollback kalıcıdır — seçili aktarıma ait tüm kayıtlar tenant veritabanından silinir. Geri alınamaz.

Yükleniyor…

>_

Terminal Komutları

Servis başlatma, DB yönetimi ve aktarım komutları

Docker başlat:

zirve-start

Image yoksa build eder, MySQL hazır olana kadar bekler, http://localhost:8000 açılır.

DB durumu:

db-setup

Tüm kullanıcıları, tenant'ları ve her tenant DB'sinin boyutunu listeler.

Kullanıcı ekle:

db-setup --add-user ad@ornek.com Ad Soyad

laravel.users tablosuna kayıt eklenir. Şifre alanı boş bırakılır — uygulama şifre gerektirmez.

Tenant ekle:

db-setup --add-tenant <uuid> "Büro Adı" ad@ornek.com

laravel.tenants + tenant_users kaydı oluşturulur, tenant_<uuid> veritabanı provision edilir ve seed tabloları yüklenir.

Test verilerini sıfırla:

db-reset

Şunları siler (geri alınamaz):

Tüm tenant_* veritabanlarındaki veri tabloları
aktarmatch.aktar_jobs — iş kuyruğu kayıtları
/tmp/zirve_* — geçici chunk dosyaları
logs/ — aktarım log dosyaları

Seed (lookup) tabloları korunur ve yeniden yüklenir.

CLI ile XML aktar:

aktar dosya.xml <tenant-uuid> aktar dosya.xml <tenant-uuid> --dry-run aktar dosya.xml <tenant-uuid> --verbose

--dry-run: veritabanına yazmadan parse + doğrulama yapar. --verbose: her adımı loglar.

Docker yönetimi:

docker compose up -d # başlat docker compose stop # durdur (veri korunur) docker compose down -v # sil + volume temizle docker compose logs -f app # PHP/Apache log canlı sudo ./bin/install-cli # CLI kısayollarını kur

✓

Test Suite

175 test — Unit · Integration · E2E. Docker ve MySQL çalışıyor olmalı.

Tüm testleri çalıştır:

vendor/bin/phpunit --testdox

Unit + Integration + E2E — 3 suite birlikte çalışır. Sonuç: her test için ✔/✘.

Sadece Unit testler (DB gerekmez):

vendor/bin/phpunit --testsuite Unit --testdox

XmlParser, StructuredLog, FieldDefinition, Registry, Validation — 114 test, saf PHP mantığı.

Sadece Integration testler:

vendor/bin/phpunit --testsuite Integration --testdox

MySQL bağlantısı gerektirir. JobQueue, DatabaseConnection, XmlParserStreamSplit — 44 test. Tenant ID dinamik çekilir.

Sadece E2E testler:

vendor/bin/phpunit --testsuite E2E --testdox

PHP built-in server başlatır, HTTP istekleri atar. 17 test — API sağlık, tenant listesi, XML yükleme, job tamamlama. Tenant ID /api/tenants'tan dinamik alınır.

Tek test sınıfı çalıştır:

vendor/bin/phpunit tests/Integration/JobQueueTest.php vendor/bin/phpunit tests/E2E/HttpApiTest.php

Tek test metodu çalıştır:

vendor/bin/phpunit --filter test_api_aktar_creates_job

Metod adının bir parçasını da verebilirsiniz: --filter aktar_creates

Gereksinimler:

PHP ≥ 8.1 (CLI)
MySQL erişimi — DB_HOST, DB_PORT, DB_USERNAME, DB_PASSWORD .env'den okunur
En az 1 tenant_* veritabanı (Integration + E2E)
Port 18765 boş olmalı (E2E — built-in server)

Test sonuçları ne anlama gelir:

✔ (OK) — geçti
✘ (FAIL/ERROR) — başarısız, log'a bak
↩ (SKIP) — Docker/MySQL kapalı veya tenant yok

XML Aktarım

Geçmiş Aktarımlar

Araçlar