Backend Engineer ajanı
Backend Engineer ajanı bir özelliğin sunucu tarafını onaylanmış bir tasarımdan uygular; dokunduğu dosyaları ve API etkisini listeler. Feature SDLC'de çalışır.
Backend Engineer ajanı sunucu tarafı değişiklikleri uygular. Onaylanmış bir tasarımdan yola çıkar ve değişikliği tarif eder: dokunduğu dosyalar, temel kod ve API'ler üzerindeki etkisi.
Nerede çalışır
| İş akışı | Adım |
|---|---|
| Feature SDLC | Backend |
Feature SDLC, sekiz adımıyla en uzun yerleşik iş akışıdır: gereksinimler, teslimat planı, teknik tasarım, backend, frontend, uçtan uca testler, güvenlik incelemesi ve kullanıcı dokümantasyonu. Backend Engineer dördüncü adımdır. Architect'in teknik tasarımının hemen ardından ve Frontend Engineer'dan önce gelir.
Girdiler
- Oturumun görevi.
- Projenin reposundaki ilgili dosyaların salt okunur bir anlık görüntüsü: rotalar, servisler, veri modelleri ve mevcut testler.
- Önceki adımlar: Product Analyst'ten gelen gereksinimler, teslimat planı ve teknik tasarım. Sekiz adımlı bir iş akışında bunlar ona kısaltılmış hâlde ulaşır.
Çıktılar
Sunucu tarafı değişikliğin dosya başına bir açıklaması:
- Yeni ve değişen uç noktalar ve herhangi bir değişikliğin mevcut çağıranları bozup bozmadığı.
- Tasarımın zaten belirtmiş olması gereken veri modeli değişiklikleri.
- Hata işleme ve doğrulama.
Frontend Engineer, onun tarif ettiği API'ye göre geliştirme yapar. Frontend adımından sonra oturumun kod geçişi dosyaları reponun geçici bir kopyasına yazar ve projenin testleri bu diff üzerinde çalışır. Ardından son üç adım (E2E tests, Security review ve User docs) yazılmış değişiklik üzerinde çalışır ve bulgu geçişi diff'i inceler.
Örnek çalıştırma
Gösterim amaçlı bir örnektir, kaydedilmiş bir oturum değildir. Müşterilerin filtre ön ayarlarını kaydetmesini sağlayan bir özellik için Backend Engineer; kullanıcıya ve çalışma alanına ait bir ön ayarlar tablosu, ön ayarları listelemek, oluşturmak ve silmek için üç uç nokta ve kullanıcı başına 20 ön ayar sınırı ile bu sınır aşıldığında açık bir hata önerir. Listelemenin, çağıranın çalışma alanıyla sınırlı olması gerektiğini ve başkasının ön ayarını silmeye çalışmanın forbidden yerine not-found döndürmesi gerektiğini belirtir. Ardından Frontend Engineer arayüzü bu uç noktalara göre planlar.
Sınırlar
- Sunucu, veritabanı veya migration çalıştırmaz. Kodu tarif eder.
- Kod geçişi, kendisinden önceki adımların yazdıklarının sabit bir miktarını okur. Feature SDLC'de bu beş uzun adım demektir; bu yüzden sonrakilerin bazı kısımları okuduğu kısmın dışında kalabilir. Diff'in planlananı kapsadığını kontrol edin.
- Geriye dönük uyumluluğu bozan API değişiklikleri metin olarak bildirilir. Testleriniz zorlamadıkça hiçbir şey sürümlemeyi zorunlu kılmaz. Bkz. kalite kapıları.
Sık sorulan sorular
Bunun için neden Builder ajanı kullanılmıyor?
Feature SDLC, sunucu ve istemci işinin her biri odaklı bir adım alsın diye uygulamayı ikiye böler. Sunucu tarafını Backend Engineer, istemci tarafını Frontend Engineer üstlenir.
Dosyaları kendisi mi yazar?
Hayır. Her ajan gibi metin döndürür. Dosyaları oturumun kod geçişi yazar ve diff'i, işi kontrol eden adımlardan önce, Frontend adımından sonra üretir.