Skip to content

cozakgit/klarnet-app

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 

Repository files navigation

KlaRnet — Sol Klarnet Öğrenme PWA

Sol Klarnet öğrenmek için açık platform. Pitch detection, parmak diyagramları, ders yükleme ve gamification.

Tech Stack

Katman Teknoloji
Frontend React 19 + TypeScript + Vite + Tailwind CSS v4
State Zustand
Nota render OSMD (MusicXML) + VexFlow (egzersizler)
Pitch detection Web Audio API + AudioWorklet + pitchy
Backend Node.js + Express + TypeScript
DB PostgreSQL
Storage S3/MinIO (MusicXML dosyaları)
Auth JWT (access + refresh token)
PWA vite-plugin-pwa (Workbox)

Kurulum

# Frontend
cd frontend && npm install && npm run dev

# Backend
cd backend && npm install && npm run dev

Özellikler

  • Pitch Detection: Mikrofon ile gerçek zamanlı nota tanıma (≤50ms latency)
  • Sol Klarnet Transpozisyon: Written pitch ↔ Sounding pitch (-3 semitone) otomatik dönüşüm
  • Parmak Diyagramları: Tüm 18 nota için görsel SVG rehber
  • Ders Oynatıcı: Nota highlight + doğru/yanlış geri bildirim + XP
  • Wiki Versiyonlama: Herkes ders düzenleyebilir, tam versiyon geçmişi, geri dönüş
  • Gamification: XP, streak çarpanı, rozet sistemi, liderlik tablosu
  • İkidilli: Türkçe / İngilizce

Geliştirme Fazları

  • Faz 1: Proje kurulumu, Auth, Pitch detection, Parmak diyagramı, Ders oynatıcı, Gamification temel
  • Faz 2: MusicXML/OSMD, İçerik yükleme, Ders katalogu, Rozet sistemi, Profil/Liderlik
  • Faz 3: PWA offline, i18n, Ritim analizi, React Native taşıma

About

Sol Klarnet öğrenme PWA — pitch detection, parmak diyagramları, ders yükleme, gamification

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages