tarfin-labs / tarfin-card

Tarfin Take-Home Coding Challenge

TarfinKart Problemi

Bu problemin temel amacı, kodlama stilini ve seçimlerini belirleyebilmektir.

TarfinKart Problemi benzeri görülmemiş bir çözüm geliştirmeyi veya son teknoloji araçları kullanabilmeyi gerektirmiyor ve istediğimiz tam olarak da bu: Yoldan sapmak yerine kodlama stiline odaklanmak istiyoruz.

Bu bağlamda; problem içinde "doğrular veya yanlışlar" yoktur. "Hileli kısımlar veya kelime oyuları" da yoktur. Sadece nasıl kod geliştirdiğini daha iyi anlamak istiyoruz.

Bu aynı zamanda daha anlamlı ve olumlu bir teknik görüşme yapmamızı sağlar. Mülakatlarda beyaz tahta kullanmaktan hoşlanmıyoruz, bu nedenle tartışacak bazı somut kodlara sahip olmayı tercih ederiz. Böylece yapacağımız teknik mülakatın çok daha eğlenceli ve verimli hale geleceğine inanıyoruz.

Soruların mı var? Bize yazarak bu problemi geliştirmemize yardımcı olabilirsin. Sana yardımcı olmaktan mutluluk duyarız 🙂.

Problem #01

Bu problemde Tarfin'in müşterilerine kredi kartı benzeri bir Kart (TarfinCard) verdiğini ve müşterilerin bu kartlarla çeşitli finansal işlemler (TarfinCardTransaction) yapabildiğini varsayıyoruz.

Amaç

TarfinCard ve TarfinCardTransaction API'lerini ve bunlara ait Policy'leri, Validation'ları ve Resource'ları test etmek için Feature Test'ler oluştur.

Uygulama Detayları

• Her müşterinin birden fazla TarfinCardı olabilir ve her TarfinCardın birden fazla TarfinCardTransactionı olabilir.
• Müşteriler kendi TarfinCardlarını oluşturabilmeli, güncelleyebilmeli, görebilmeli, listeleyebilmeli ve silebilmelidir.
• Müşteriler her bir TarfinCard'a ait TarfinCardTransactionınlarını listeleyebilmeli, görebilmeli ve oluşturabilmelidir.

Sorgula

TarfinCard ve TarfinCardTransaction route'larını, controller'larını, request'lerini, resource' larını, policy'lerini baştan sona okuyup incele. Nasıl çalıştığını anlamaya çalış ve bu API'leri test etmek için mümkün olduğunca çok test yaz.

TarfinCardControllerTest ve TarfinCardTransactionControllerTest Feature test dosyaları senin için zaten oluşturuldu. İçinde fikir vermesi açısından örnek test isimleri var. Sadece testleri tamamlaman ve gerekli gördüğün yeni testler yazman gerekiyor.

İpuçları

• Olumlu ve olumsuz senaryoları doğrula
• API'den dönen cevapları ve veritabanına kaydedilen değerleri doğrula
• Müşteri sadece kendi TarfinCard'ı ile işlem yapabilir.

ÖNEMLİ: Bu problemi çözmek için SADECE Feature Test dosyalarında değişiklik yapabilirsin.

---

PROBLEM #02

Amaç

Geri ödemeleri yönetmek üzere bir Borç Servisi (LoanService) oluştur. Bu servisi yazarken, halihazırda senin için yazılmış olan, Unit testlerini baz almalısın.

Uygulama Detayları

• Her müşterinin bir veya daha fazla Borcu (Loan) olabilir.
• Bu Borçlar (Loan) 3 veya 6 aylık olarak taksitlendirilebilir ve bu vadelere ait Planlanmış Geri Ödemeleri (ScheduledRepayment) bulunur.
• Borçlar Alınan Ödemeler (ReceivedRepayment) ile geri ödenir.

Örneğin:

2022-01-01 tarihinde oluşturulmuş 3000TL tutarındaki 3 taksitli Borç

• 2022-02-01 tarihinde 1000 TL'lik bir Planlanmış Geri Ödeme (ScheduledRepayment)
• 2022-03-01 tarihinde 1000 TL'lik bir Planlanmış Geri Ödeme (ScheduledRepayment)
• 2022-04-01 tarihinde 1000 TL'lik bir Planlanmış Geri Ödeme (ScheduledRepayment)

Müşteri her bir Planlanmış Geri Ödeme (ScheduledRepayment) tutarının tamamını geri ödeyebilir. Fakat isterse Planlanmış Geri Ödeme (ScheduledRepayment) tutarının sadece bir kısmını veya vadesi gelmemiş olsa bile, borcunun tamamını ödeyebilir.

Sorgula

Nasıl çalışması gerektiğini anlamak için LoanService (Borç Servisi) Unit testlerini iyice oku. Testlerin başarılı bir şekilde çalışabilmesi için yapman gerekenler arasında şunlar olabilir:

• Loan, ReceivedRepayment ve ScheduledRepayment Modelleri için Factoryler ve Migrationlar
• Borç Servisi (LoanService)
• Exceptionlar
• Sabit değerler (Constants) için ayrı sınıflar (Enums)

ÖNEMLİ: Bu problemi çözmek için Unit test dosyalarında değişiklik yapmamalısın. Sadece Unit testlerin başarıyla geçmesi için gerekli kodu yazmalısın.

---

Geliştirme Ortamının Hazırlanması

Bu bir Laravel 9 projesidir ve PHP 8.1+ gerektirir.

1. Kişisel GitHub hesabında tarfin-card isimli private bir repo oluştur.
2. GitHub hesabındaki tarfin-card reposunu açtığında en alttaki Import code düğmesini göreceksin.
   Bu özelliği kullanarak https://github.com/tarfin-labs/tarfin-card adresindeki repoyu import et.
3. Private repo'nu inceleyebilmemiz için, şu GitHub kullanıcılarını Settings->Collaborators->Manage access->Add People ile davet et:
   frkcn, deligoez, hozdemir, tkaratug
4. .env.example dosyasından yeni bir .env dosyası oluştur.
   cp .env.example .env
5. Bir sqlite veritabanı dosyası oluştur.
   touch database/database.sqlite
6. Composer paketlerini yükle.
   composer install
7. Laravel için bir application key oluştur.
   php artisan key:generate
8. Veritabanı migration'larını çalıştır.
   php artisan migrate
9. Laravel Passport'u ayarla.
   php artisan passport:install
10. Yaptığın değişikliklerin atomik olmasına dikkat et.
11. En fazla 15dk'da bir commit'le.
12. Tüm testler geçiyor mu diye kontrol et ✅
    php artisan test