SoloSheet SoloSheet

SoloSheet: Proje Anatomisi

SoloSheet, karmaşık müzik teorisi ve yapay zeka sürecini son kullanıcı için “link at, notayı al” basitliğine indiren bir SaaS (Hizmet Olarak Yazılım) projesidir. Üç ana katman uyum içinde çalışır.

1. Katman: Frontend (React)

Kullanıcının buzdağının görünen kısmıyla etkileşime girdiği yer.

• Görev: Auth ile kullanıcıyı almak, YouTube linkini toplamak, sunucudan gelen “İşleniyor / Hazır” durumlarını canlı yansıtmak.
• Kritik işlem: Polling — Backend’e sürekli “Dosyam hazır mı?” diye sorarak statik sayfayı dinamik deneyime dönüştürür.

2. Katman: Backend (.NET Web API)

Tüm trafiği yöneten ve iş mantığını yürüten merkez.

• Görev: Güvenlik (JWT vb.), dosyaları geçici depolamak, orkestrasyon.
• Kritik işlem: Asenkron arka plan görevi — Kullanıcıyı bekletmeden arka planda YouTube’u MP3’e çevirir ve YZ servisiyle iletişim kurar.

3. Katman: Yapay Zeka Motoru (Harici API)

Ses dalgalarını matematiksel analiz edip nota sembollerine döken katman.

• Görev: Frekans analizi (FFT), ritim tespiti; ham sesi dijital notaya (MIDI/XML) dönüştürmek.

Veri akışı (uçtan uca)

• Talep: Kullanıcı linki React üzerinden gönderir.
• Kabul: .NET MongoDB’ye “Beklemede” (PENDING) kaydı açar, kullanıcıya “Sıraya alındı” der.
• İşleme: .NET arka planda sesi indirir, YZ API’sine “Bunu notaya çevir” diyerek gönderir.
• Takip: .NET YZ API’sini düzenli kontrol eder.
• Tamamlama: API “Bitti” deyince .NET nota dosyası linkini veritabanına yazar, durumu READY yapar.
• Teslim: React durumun değiştiğini görür, kullanıcıya “İndir” butonunu sunar.

Bu proje neden değerli?

• Zaman tasarrufu: Saatlerce “kulaktan çıkarma” işlemini saniyelere indirir.
• Erişilebilirlik: Nota bilgisi zayıf amatörlerin veya bestecilerin fikirlerini hızla kağıda dökmesini sağlar.
• Teknik yetkinlik: JWT güvenliği, asenkron programlama, harici API entegrasyonu ve veritabanı yönetimi tek projede birleşir.

YouTube linki → ses → AI → nota kağıdı. Link at, notayı al.