Giriş ve Başlangıç

Achidemy proje vizyonu, LMS ve akıllı pazaryeri konumlandırması, teknoloji yığını.

Bu bölüm, Achidemy geliştirici dökümantasyonuna giriş niteliğindedir. Proje vizyonu ve kullanılan teknoloji yığını özetlenir.

Proje Vizyonu

Achidemy, yalnızca bir Öğrenme Yönetim Sistemi (LMS) değil; eğitmen odaklı bir akıllı pazaryeri olarak konumlandırılmıştır.

LMS çekirdeği: Kurs yönetimi, öğrenme takibi, sertifika, quiz ve kod alıştırmaları, video altyazıları, soru–cevap (Q&A), kurs notları, çoklu dil (i18n).
Öğrenci deneyimi: Sepet, istek listesi (wishlist), kurs paketleri (bundles), streak (günlük öğrenme serisi), sertifikalar sayfası, arşivlenen kurslar, ödeme yöntemleri ve abonelik yönetimi.
Eğitmen deneyimi: Public profil (username, headline, bio, takipçi), mesajlaşma ve hoş geldin mesajı, müfredat (bölüm/ders/quiz/kod egzersizi), altyazı yönetimi, gelir ve ödeme talepleri (Stripe Connect / TR manuel).
Pazaryeri: Eğitmen kaydı, gelir raporları, Stripe Connect (uluslararası) ve Türkiye’deki eğitmenler için manuel ödeme (IBAN/Payoneer) ile yerel regülasyonlara uyum.
Affiliate sistemi: Referans kodu ile paylaşım ve komisyon takibi.
Bölgesel fiyatlandırma: Ülkeye göre fiyat ve para birimi (price_tiers, tier_prices, course_prices); Cloudflare Edge ile konum bazlı fiyat sunumu. Fiyat matrix seeding: npx tsx app/db/seed-pricing.ts (Tier 1–50, USD/TRY/EUR).

Bu vizyon doğrultusunda geliştirme yaparken hem öğrenci hem eğitmen deneyimini ve ölçeklenebilir altyapıyı gözetmek önemlidir.

Achidemy aşağıdaki teknoloji yığını ile geliştirilir:

Katman	Teknoloji
Frontend	React 19, React Router 7 (RR7), TypeScript, Tailwind CSS 4, Radix UI, Framer Motion
Backend	TypeScript/JavaScript, React Router (loader/action), GraphQL (Yoga), Drizzle ORM, Better Auth, Stripe (server-side)
Sunucu / Runtime	Cloudflare Workers (Wrangler)
Veritabanı	Neon PostgreSQL, Drizzle ORM, Hyperdrive (connection pooling)
Kimlik Doğrulama	Better Auth (e-posta, Google OAuth)
Ödeme	Stripe (abonelik, Connect, webhook)
Medya	Bunny CDN (video, storage)
Diğer	i18next (çoklu dil), Monaco Editor, TipTap, Recharts

Teknoloji Referansları:

Stripe geliştirmeleri ve daha fazla bilgi için: Stripe Dokümantasyonu
Bunny CDN geliştirmeleri ve daha fazla bilgi için: Bunny.net Dokümantasyonu
Shadcn UI (Radix UI) geliştirmeleri ve daha fazla bilgi için: Shadcn UI Dokümantasyonu | Radix UI Dokümantasyonu
Better Auth geliştirmeleri ve daha fazla bilgi için: Better Auth Dokümantasyonu
Drizzle ORM geliştirmeleri ve daha fazla bilgi için: Drizzle ORM Dokümantasyonu
Neon geliştirmeleri ve daha fazla bilgi için: Neon Dokümantasyonu
GraphQL Yoga geliştirmeleri ve daha fazla bilgi için: GraphQL Yoga Dokümantasyonu
React Router geliştirmeleri ve daha fazla bilgi için: React Router Dokümantasyonu
Tailwind CSS geliştirmeleri ve daha fazla bilgi için: Tailwind CSS Dokümantasyonu
TipTap geliştirmeleri ve daha fazla bilgi için: TipTap Dokümantasyonu
Monaco Editor geliştirmeleri ve daha fazla bilgi için: Monaco Editor Dokümantasyonu
i18next geliştirmeleri ve daha fazla bilgi için: i18next Dokümantasyonu
Cloudflare Workers geliştirmeleri ve daha fazla bilgi için: Cloudflare Workers Dokümantasyonu
Wrangler geliştirmeleri ve daha fazla bilgi için: Wrangler Dokümantasyonu

Tüm paketlerin detaylı listesi için Eklentiler (Plugins) sayfasına bakın.

Alan	Özellikler
Public	Ana sayfa, fiyatlandırma, eğitmen ol, kurs listesi (kategori), kurs detay, paket (bundle) detay, kullanıcı public profil (`/user/:username`), yasal sayfalar (gizlilik, kullanım şartları, çerez, iade, eğitmen sözleşmeleri), giriş/kayıt, şifre sıfırlama, e-posta doğrulama, affiliate sayfası, sitemap, sertifika doğrulama (`/verify/:code`).
Öğrenci	Sepet, checkout, kurslarım (learn, wishlist, sertifikalar, arşiv, araçlar), öğrenme sayfası (video, quiz, kod egzersizi, Q&A, notlar), ilerleme ve streak, hesap (profil, public profil, şifre, abonelik, satın alma geçmişi, ödeme yöntemleri), mesajlar.
Eğitmen	Dashboard, kurs oluşturma, kurs yönetimi (hedefler, yapı, kurulum, çekim, müfredat, altyazılar, landing, fiyatlandırma), paket oluşturma ve yönetimi, performans (öğrenciler, değerlendirmeler, izlenme trendleri), ödeme talepleri, mesajlar, iletişim ayarları.
Admin	Dashboard, kurslar (onay/red, önizleme), kullanıcılar, finans, abonelik, ödeme talepleri, iadeler, mesajlar, fiyat katmanları (price-tiers).

Tüm URL’ler için Route Haritası sayfasına bakın.

Yerel kurulum ve ortam değişkenleri için sırayla Yerel Kurulum Rehberi ve Ortam Değişkenleri sayfalarına geçin.