Yönetici Özeti
üretim hazır sisteme
bağımsız mikroservis
üretim kodu
otomatik test paketi
CI/CD pipeline
REST API endpoint
Proje
Tahıl ambarı sertifikalarının düzenlenmesi, takibi ve yönetimi için bir bilgi sistemi. Sistem dört kullanıcı rolüne hizmet eder — Depo Operatörleri, Tahıl Sahipleri, Borsa Brokerleri ve Düzenleyiciler — her biri ayrı bir portal ve yetki modeline sahiptir.
Alan yoğun şekilde düzenlemeye tabidir: her sertifikanın yasal bir yaşam döngüsü vardır, mülkiyet transferleri denetlenmeli ve sistem ulusal tahıl borsası altyapısıyla entegre olmalıdır.
Yöntem
Ürün Sahibi ve AI orkestratörü olarak görev yapan tek bir mühendis. Belirli rollere atanmış yedi AI ajanı: İş Analisti, Çözüm Mimarı, Backend Geliştirici, Frontend Geliştirici, QA Mühendisi, DevOps Mühendisi, Teknik Yazar.
Her ajan CLAUDE.md formatında yapılandırılmış bir brifing aldı: rol tanımı, kapsam, kısıtlamalar, çıktı formatı ve kalite kriterleri. Mühendis tüm çıktıları inceledi, entegre etti ve nihai kararları verdi. Kritik değerlendirme yapılmadan hiçbir üretilen kod commit edilmedi.
Sonuç: 7–9 kişilik bir ekibe eşdeğer çıktı, tek bir kıdemli mühendis maliyetiyle teslim edildi.
Ne İnşa Edildi
Her biri tek bir sınırlı bağlamdan sorumlu 13 bağımsız mikroservis:
Certificate Service — düzenleme, yaşam döngüsü yönetimi, durum geçişleri. Ownership Service — transfer zincirleri, rehin kaydı, denetim günlüğü. Warehouse Service — depo kaydı, kapasite, akreditasyon durumu. Grain Owner Service — sahip profilleri, portföy, sertifika varlıkları. Exchange Integration Service — ulusal borsa API köprüsü. Notification Service — olay güdümlü uyarılar, e-posta, push. Document Service — PDF oluşturma, şablon yönetimi. Audit Service — değiştirilemez denetim günlüğü, düzenleyici raporlama. Auth Service — Keycloak entegrasyonu, rol atama, token doğrulama. API Gateway — yönlendirme, hız sınırlama, istek izleme. Admin Service — arka ofis operasyonları, manuel müdahaleler. Report Service — analitik, panolar, düzenleyici dışa aktarımlar. File Service — belge depolama, S3 uyumlu backend.
Her servisin Flyway migration'ları ile yönetilen kendi veritabanı şeması vardır. Her biri kaynak limitleri, liveness ve readiness probe'ları ve özel bir GitLab CI/CD pipeline'ı ile kendi Kubernetes Deployment'ında çalışır.
319 otomatik test birim, entegrasyon ve sözleşme katmanlarını kapsar. Testcontainers entegrasyon testleri için gerçek PostgreSQL örnekleri başlatır — veritabanı katmanında mock kullanılmaz.
Teknoloji Stack’i
Geleneksel Geliştirme ile Karşılaştırma
| Geleneksel Ekip | Bu Proje (AI Odaklı) | |
|---|---|---|
| Süre | 3–4 ay | 12 gün |
| Ekip büyüklüğü | 7–9 mühendis | 1 mühendis |
| Mikroservisler | 13 | 13 |
| Test kapsamı | değişken | 319 otomatik test |
| CI/CD pipeline | değişken | 12, ilk günden |
| Maliyet | referans | referansın ~%10’u |
AI odaklı yaklaşım mühendislik uzmanlığının yerini almaz — onu çoğaltır. Hız ve kalite doğrudan orkestratörün niteliklerine bağlıdır: mimari anlayış, problem ayrıştırma, hassas yönlendirme ve AI çıktısının kritik değerlendirmesi. İnsan kontrolü elinde tutar.
Sonuçlar
12 gün. 13 servis. 55.293 satır. 319 test. 12 pipeline. 80 endpoint. Tek mühendis.
Her sayı bir GitLab commit’ine, bir CI/CD çalıştırma günlüğüne veya bir test raporuna izlenebilir. Tahmin yok. Maket yok. Otomatik üretilen şablonlardan şişirilmiş satır sayıları yok.
Bu, AI orkestrasyonunun mühendislik disipliniyle uygulandığındaki halidir — bir kısayol olarak değil, bir güç çarpanı olarak.