Tahıl Deposu Sertifika Kayıt Sistemi

Tahıl deposu sertifikalarının düzenlenmesi, izlenmesi ve yönetimi için bir bilgi sistemi. Sistem dört kullanıcı rolüne — depo işletmecileri, tahıl sahipleri, borsa aracıları ve düzenleyici kurumlar — hizmet eder; her rolün kendine ait bir portalı ve yetki modeli vardır.

Alan sıkı biçimde düzenlenmiştir: her sertifikanın yasal bir yaşam döngüsü vardır, mülkiyet devirlerinin denetlenebilir olması gerekir ve sistem emtia borsası altyapısıyla entegre çalışmak zorundadır. Doğruluk bir tercih değil, zorunluluktur.

Ürün sahibi (Product Owner) ve yapay zekâ orkestratörü rolünü üstlenen tek bir mühendis. Belirli rollere atanmış yedi yapay zekâ ajanı: iş analisti, mimar, geliştirici, kalite güvence mühendisi, DevOps mühendisi, teknik yazar ve çevirmen.

Her ajan, CLAUDE.md biçiminde yapılandırılmış bir görev tanımı aldı: rol tanımı, kapsam, kısıtlar, çıktı biçimi ve kalite ölçütleri. Mühendis çıktıları inceledi, bütünleştirdi ve tüm nihai kararları verdi. Üretilen kodun hiçbir bölümü eleştirel bir değerlendirmeden geçmeden commit edilmedi.

Sonuç: 7–9 kişilik bir ekibin çıktısına eşdeğer bir iş, tek bir kıdemli mühendisin maliyetiyle teslim edildi.

Her biri tek bir sınırlı bağlamdan (bounded context) sorumlu 13 bağımsız mikroservis:

• Certificate Service — sertifika düzenleme, yaşam döngüsü yönetimi, durum geçişleri
• Ownership Service — devir zincirleri, rehin kaydı, denetim kaydı
• Warehouse Service — depo sicili, kapasite, akreditasyon durumu
• Grain Owner Service — sahip profilleri, portföy, eldeki sertifikalar
• Exchange Integration Service — emtia borsası API köprüsü
• Notification Service — olay güdümlü uyarılar, e-posta, anlık bildirimler
• Document Service — PDF üretimi, şablon yönetimi
• Audit Service — değiştirilemez denetim kaydı, düzenleyici raporlama
• Auth Service — Keycloak entegrasyonu, rol atama, belirteç (token) doğrulama
• API Gateway — yönlendirme, istek hızı sınırlama, istek izleme
• Admin Service — arka ofis işlemleri, elle müdahaleler
• Report Service — analitik, gösterge panelleri, düzenleyici kurumlara yönelik dışa aktarımlar
• File Service — belge depolama, S3 uyumlu depolama altyapısı

Her servisin Flyway geçişleriyle (migration) yönetilen kendi veritabanı şeması vardır. Her servis; kaynak sınırları, liveness ve readiness yoklamaları ve kendine ait bir GitLab CI/CD işlem hattıyla ayrı bir Kubernetes Deployment'ında çalışır.

320 otomatik test birim, entegrasyon ve sözleşme katmanlarını kapsar. Testcontainers, entegrasyon testleri için gerçek PostgreSQL örnekleri ayağa kaldırır; veritabanı katmanında sahte nesne (mock) kullanılmaz.

Yapay zekâ odaklı yaklaşım mühendislik uzmanlığının yerini almaz — onu katlar. Hız ve kalite doğrudan orkestratörün yetkinliğine bağlıdır: mimariyi kavrayışı, problemi parçalara ayırma becerisi, istemleri kesin biçimde yazması ve yapay zekâ çıktısını eleştirel gözle değerlendirmesi. Kontrol insandadır.

12 gün. 13 servis. 55.293 satır. 320 test. 12 CI/CD işlem hattı. 80 uç nokta. Tek mühendis.

Her rakam bir GitLab commit'ine, bir CI/CD çalışma kaydına ya da bir test raporuna dayandırılabilir. Tahmin yok. Maket yok. Otomatik üretilmiş şablon kodla şişirilmiş satır sayısı yok.

Yapay zekâ orkestrasyonu mühendislik disipliniyle uygulandığında ortaya çıkan tablo budur: bir kestirme yol olarak değil, bir kuvvet çarpanı olarak.