Route Haritası

Bu sayfa Achidemy projesindeki tüm route’ları tek bakışta listeler. Path, method, dosya, yetki ve kısa açıklama ile public / auth / öğrenci / eğitmen / admin ayrımı yapılır. API endpoint’lerinin detayı için API Referansı ve GraphQL sayfasına bakın.

---

Dil prefix kuralı

• Dil prefix’i olan path’ler: /:lang/... — Örneğin /tr/pricing, /en/my-courses/learn. Tüm kullanıcı arayüzü sayfaları (ana sayfa, fiyatlandırma, kurslar, hesap, öğrenci paneli, eğitmen paneli, yasal sayfalar) dil prefix’i ile erişilir. Desteklenen lang: tr, en, de, es vb.
• Dil prefix’i olmayan path’ler:
  • / — Kök; varsayılan locale’e yönlendirilir (root._index.tsx).
  • /api/ — Tüm API route’ları (graphql, auth, stripe, certificate, invoice, admin/activities, video-telemetry, update-progress (legacy) vb.).
  • /admin, /admin/ — Admin paneli (dil yok).
  • /verify/:code — Sertifika doğrulama (public, giriş yok).
  • /robots.txt — SEO robots.txt.
  • /sitemap.xml — SEO sitemap XML.
  • /401, /404, /500 — Hata sayfaları (lang’siz).

---

Tüm route’lar — Özet tablo

Dil prefix olmayan route’lar

Path	Method	Dosya	Yetki	Açıklama
/	GET	root._index.tsx	public	Kök; varsayılan locale’e redirect.
/401	GET	401.tsx	public	Unauthorized hata sayfası (oturum sonlandırıldı).
/404	GET	404.tsx	public	Not Found hata sayfası.
/500	GET	500.tsx	public	Server Error hata sayfası.
/verify/:code	GET	verify.$code.tsx	public	Sertifika doğrulama (giriş gerekmez).
/robots.txt	GET	robots[.]txt.ts	public	Dinamik robots.txt.
/sitemap.xml	GET	sitemap[.]xml.ts	public	Dinamik sitemap XML.
/admin	GET	admin.tsx + admin._index.tsx	admin	Admin dashboard.
/admin/courses	GET	admin.courses.tsx	admin	Kurs listesi, onay/red.
/admin/course/:slug/preview	GET	admin.course.$slug.preview.tsx	admin	Kurs önizleme.
/admin/users	GET	admin.users.tsx	admin	Kullanıcı listesi.
/admin/finances	GET	admin.finances.tsx	admin	Finans özeti, gelir havuzu.
/admin/subscription	GET	admin.subscription.tsx	admin	Abonelik yönetimi.
/admin/payouts	GET	admin.payouts.tsx	admin	Ödeme talepleri, onay/red.
/admin/refunds	GET	admin.refunds.tsx	admin	İade listesi.
/admin/messages	GET	admin.messages.tsx	admin	Admin mesajlar.
/admin/support	GET	admin.support.tsx	admin	Destek masası (kanban, ticket yönetimi).
/admin/price-tiers	GET	admin.price-tiers.tsx	admin	Fiyat katmanları CRUD.
/admin/kyc-requests	GET	admin.kyc-requests.tsx	admin	KYC liste paneli (eğitmen kimlik doğrulama).
/admin/kyc/:userId/preview	GET/POST	admin.kyc.$userId.preview.tsx	admin	KYC detay/onay sayfası (kimlik belgeleri, onay/red).
/admin/categories	GET	admin.categories.tsx	admin	Kategori yönetimi (3 seviyeli kategori ağacı CRUD).
/admin/reports	GET	admin.reports.tsx	admin	Kurs bazlı şikayet listesi (DMCA, Safe Harbor).
/admin/reports/:courseId	GET/POST	admin.reports.$courseId.tsx	admin	Seçili kurs için şikayet detay sayfası, incelemeye alma ve bildirim akışı.
/admin/marketing	GET	admin.marketing.tsx	admin	Pazarlama içerikleri yönetimi.
/admin/blog	GET	admin.blog.tsx	admin	Blog yazıları yönetimi (CRUD).
/admin/careers	GET	admin.careers.tsx	admin	Kariyer ilanları yönetimi (CRUD).
/admin/careers/:id	GET	admin.careers.$id.tsx	admin	İlana gelen başvuruların listesi + aday detay inceleme.
/api/graphql	GET/POST	api.graphql.ts	—	GraphQL endpoint.
/api/auth/*	*	api.auth.ts	—	Better Auth (giriş, kayıt, OAuth, session).
/api/stripe/webhook	POST	api.stripe.webhook.ts	—	Stripe webhook.
/api/stripe/connect-onboarding	POST	api.stripe.connect-onboarding.ts	giriş (instructor)	Stripe Connect onboarding.
/api/instructor/update-manual-payout	POST	api.instructor.update-manual-payout.ts	instructor	TR manuel ödeme bilgisi.
/api/instructor/submit-kyc	POST	api.instructor.submit-kyc.ts	giriş	KYC başvurusu (kimlik belgesi yükleme).
/api/lesson-resource-upload	POST	api.lesson-resource-upload.ts	instructor	Ders kaynağı yükleme (Bunny).
/api/bunny/create-upload	POST	api.bunny.create-upload.ts	instructor	Bunny TUS ile video yükleme (create upload URL).
/api/lesson/caption-upload	POST	api.lesson.caption-upload.ts	instructor	Video altyazısı (.vtt) yükleme (Bunny Stream).
/api/lesson/caption-delete	POST	api.lesson.caption-delete.ts	instructor	Video altyazısı silme (Bunny Stream).
/api/chat-image-upload	POST	api.chat-image-upload.ts	giriş	Sohbet görsel yükleme (Bunny).
/api/blog-image-upload	POST	api.blog-image-upload.ts	public	Blog kapak görseli yükleme (Bunny Storage). FormData: file, slug
/api/career-cv-upload	POST	api.career-cv-upload.ts	public	Kariyer CV PDF yükleme (Bunny Storage). FormData: jobId, file
/api/admin/career-cv/:applicationId/download	GET	api.admin.career-cv.$applicationId.download.ts	admin	Admin-only CV indir (Bunny Storage proxy, PDF stream).
/api/certificate/:id/download	GET	api.certificate.$id.download.ts	giriş	Sertifika PDF indirme.
/api/certificates/:id/download	GET	api.certificate.$id.download.ts	giriş	Aynı (geriye dönük URL).
/api/invoice/:enrollmentId/download	GET	api.invoice.$enrollmentId.download.ts	giriş	Fatura PDF indirme.
/api/admin/activities	GET	api.admin.activities.ts	admin	Admin aktivite listesi (modal).
/api/video-telemetry	POST	api.video-telemetry.ts	giriş	Video telemetri heartbeat (15 sn blok).
/api/update-progress	POST	api.update-progress.ts	giriş	Video izleme ilerlemesi kaydı.
/api/support-deflect	POST	api.support-deflect.ts	giriş	AI destek asistanı; ticket öncesi çözüm önerisi (deflection).
/api/algolia-sync	GET	api.algolia-sync.ts	—	Algolia kurs index’ine toplu senkronizasyon ve index ayarları.

Dil prefix’li route’lar — Public

Path	Method	Dosya	Yetki	Açıklama
/:lang	GET	$lang.tsx + _index.tsx	public	Ana sayfa.
/:lang/pricing	GET	pricing.tsx	public	Fiyatlandırma sayfası.
/:lang/teaching	GET	teaching.tsx	public	Eğitmen ol sayfası.
/:lang/register	GET	register.tsx	public	Kayıt formu.
/:lang/login	GET	login.tsx	public	Giriş formu.
/:lang/forgot-password	GET	forgot-password.tsx	public	Şifre sıfırlama talebi.
/:lang/reset-password	GET	reset-password.tsx	public	Şifre sıfırlama formu (token).
/:lang/verify-email	GET	verify-email.tsx	public	E-posta doğrulama.
/:lang/affiliate	GET	affiliate.tsx	public	Affiliate program sayfası.
/:lang/about	GET	$lang.about.tsx	public	Hakkımızda sayfası.
/:lang/contact	GET	$lang.contact.tsx	public	İletişim sayfası.
/:lang/investors	GET	$lang.investors.tsx	public	Yatırımcılar sayfası.
/:lang/blog	GET	$lang.blog.tsx	public	Blog yazıları liste sayfası.
/:lang/blog/:slug	GET	$lang.blog.$slug.tsx	public	Blog yazısı detay sayfası.
/:lang/careers	GET	$lang.careers.tsx	public	Kariyer ilanları listesi.
/:lang/careers/:slug	GET/POST	$lang.careers.$slug.tsx	public	İlan detayı + başvuru (POST).
/:lang/sitemap	GET	$lang.sitemap.tsx	public	HTML sitemap sayfası.
/:lang/courses	GET	courses.index.tsx	public	Kurs keşfet ana sayfa (tüm kurslar, kategori ağacı, keşfet bölümleri).
/:lang/courses/search	GET	courses.search.tsx	public	Kurs arama sayfası (query parametreleri ile).
/:lang/courses/:category	GET	courses.all.tsx	public	Kurs listesi (ana kategori; örn. development).
/:lang/courses/:category/:subcategory	GET	courses.all.tsx	public	Kurs listesi (alt kategori; örn. data-science).
/:lang/courses/:category/:subcategory/:topic	GET	courses.all.tsx	public	Kurs listesi (konu; örn. python).
/:lang/course/:id	GET	course.$id.tsx	public	Kurs detay sayfası.
/:lang/user/:username	GET	user.$username.tsx	public	Kullanıcı profil sayfası.
/:lang/bundle/:slug	GET	bundle.$slug.tsx	public	Paket (bundle) vitrin; kurs detayıyla aynı grid + sağ yapışkan kart (promo video kart içinde), PPP (getBundleRegionalPrice), ?ref= affiliate cookie.
/:lang/terms	GET	$lang.terms.tsx	public	Yasal sayfalar layout.
/:lang/terms/privacy-policy	GET	$lang.terms.privacy.tsx	public	Gizlilik politikası.
/:lang/terms/terms-of-use	GET	$lang.terms.use.tsx	public	Kullanım şartları.
/:lang/terms/cookie-policy	GET	$lang.terms.cookies.tsx	public	Çerez politikası.
/:lang/terms/instructor/*	GET	$lang.terms.instructor*.tsx	public	Eğitmen yasal sayfalar.
/:lang/terms/refund	GET	$lang.terms.refund.tsx	public	İade politikası.
/:lang/test-error	GET	$lang.test-error.tsx	public	Hata test sayfası.
/:lang/coming-soon	GET	$lang.coming-soon.tsx	public	Yakında sayfası.
/:lang/mobile-app	GET	$lang.mobile-app.tsx	public	Mobil uygulama tanıtım sayfası.
/:lang/business	GET	$lang.business.tsx	public	Kurumsal çözümler sayfası.
/:lang/enterprise-solution	GET	$lang.enterprise-solution.tsx	public	Enterprise çözüm sayfası.
/:lang/accessibility-statement	GET	$lang.accessibility-statement.tsx	public	Erişilebilirlik beyanı.
/:lang/401	GET	401.tsx	public	Unauthorized hata sayfası (lang’li).
/:lang/404	GET	404.tsx	public	Not Found hata sayfası (lang’li).
/:lang/500	GET	500.tsx	public	Server Error hata sayfası (lang’li).

Dil prefix’li route’lar — Giriş gerekli (öğrenci)

Path	Method	Dosya	Yetki	Açıklama
/:lang/onboarding	GET	onboarding.tsx	giriş	Eğitmen onboarding (kayıt sonrası).
/:lang/messages	GET	messages.tsx	giriş	Öğrenci mesajlar.
/:lang/cart	GET	cart.tsx	public	Sepet sayfası; misafir sepeti çerezden (guest_cart) okunur, giriş sonrası loader DB ile merge eder ve çerezi temizler.
/:lang/payment/checkout	GET/POST	payment.checkout.tsx	giriş	Ödeme / checkout.
/:lang/my-courses	GET	my-courses.tsx + my-courses._index.tsx	giriş	Kurslarım (learn’e redirect).
/:lang/my-courses/learn	GET	my-courses.learning.tsx	giriş	Kurslarım listesi.
/:lang/my-courses/wishlist	GET	my-courses.wishlist.tsx	giriş	İstek listesi.
/:lang/my-courses/certifications	GET	my-courses.certifications.tsx	giriş	Sertifikalar.
/:lang/my-courses/archived	GET	my-courses.archived.tsx	giriş	Arşivlenen kurslar.
/:lang/my-courses/tools	GET	my-courses.tools.tsx	giriş	Öğrenci araçları hub (çalışma planlayıcı, pomodoro, AI özet, streak haritası).
/:lang/my-courses/tools/calendar	GET	my-courses.tools.calendar.tsx	giriş	Akıllı Çalışma Planlayıcı; enrolled kurslardan haftalık çalışma rutini oluşturup takvime ekler.
/:lang/learn/:slug	GET	learn.$slug.tsx	giriş	Öğrenme sayfası (video, müfredat).
/:lang/account	GET	account.tsx + account._index.tsx	giriş	Hesap (profile’e redirect).
/:lang/account/profile	GET	account.profile.tsx	giriş	Profil düzenleme.
/:lang/account/public-profile	GET	account.profile.public.tsx	giriş	Genel profil.
/:lang/account/password	GET	account.password.tsx	giriş	Şifre değiştir.
/:lang/account/subscription	GET	account.subscription.tsx	giriş	Abonelik yönetimi.
/:lang/account/purchase-history	GET	account.purchase-history.tsx	giriş	Satın alma geçmişi.
/:lang/account/payment-methods	GET	account.payment-methods.tsx	giriş	Ödeme yöntemleri.
/:lang/account/notifications	GET	account.notifications.tsx	giriş	Bildirimler sayfası (uygulama içi).
/:lang/account/support	GET	account.support.tsx	giriş	Öğrenci/eğitmen destek masası (ticket + AI asistan).
/:lang/account/settings	GET	account.settings.tsx	giriş	Hesap ayarları.

Dil prefix’li route’lar — Eğitmen (instructor)

Path	Method	Dosya	Yetki	Açıklama
/:lang/instructor	GET	instructor.tsx + instructor._index.tsx	instructor	Eğitmen dashboard (sekmeler: courses, bundles, coupons, trash).
/:lang/instructor?tab=coupons	GET	instructor._index.tsx	instructor	Kuponlar sekmesi (liste, oluştur, aç/kapat, sil).
/:lang/instructor/coupons	GET	instructor.coupons.tsx	instructor	Redirect → /instructor?tab=coupons.
/:lang/instructor/create	GET	instructor.create.tsx	instructor	Yeni kurs oluştur.
/:lang/instructor/payouts	GET	instructor.payouts.tsx	instructor	Ödeme talepleri, bakiye, KYC formu (?tab=payment).
/:lang/instructor/messages	GET	instructor.messages.tsx	instructor	Eğitmen mesajlar.
/:lang/instructor/communication	GET	instructor.communication.tsx	instructor	İletişim ayarları.
/:lang/instructor/performance	GET	instructor.performance.tsx + _index	instructor	Performans özeti.
/:lang/instructor/performance/students	GET	instructor.performance.students.tsx	instructor	Öğrenci istatistikleri.
/:lang/instructor/performance/reviews	GET	instructor.performance.reviews.tsx	instructor	Değerlendirmeler.
/:lang/instructor/course/:slug/manage	GET	instructor.course.$slug.manage.tsx	instructor	Kurs yönetimi layout.
/:lang/instructor/course/:slug/manage/goals	GET	instructor.course.$slug.manage.goals.tsx	instructor	Hedefler.
/:lang/instructor/course/:slug/manage/course-structure	GET	instructor.course.$slug.manage.course-structure.tsx	instructor	Bölüm yapısı.
/:lang/instructor/course/:slug/manage/setup	GET	instructor.course.$slug.manage.setup.tsx	instructor	Kurulum.
/:lang/instructor/course/:slug/manage/filming	GET	instructor.course.$slug.manage.filming.tsx	instructor	Çekim bilgisi.
/:lang/instructor/course/:slug/manage/curriculum	GET	instructor.course.$slug.manage.curriculum.tsx	instructor	Müfredat, dersler.
/:lang/instructor/course/:slug/manage/captions	GET	instructor.course.$slug.manage.captions.tsx	instructor	Video altyazıları yönetimi.
/:lang/instructor/course/:slug/manage/landing	GET	instructor.course.$slug.manage.landing.tsx	instructor	Landing sayfası.
/:lang/instructor/course/:slug/manage/pricing	GET	instructor.course.$slug.manage.pricing.tsx	instructor	Kurs fiyatı.
/:lang/instructor/course/:slug/manage/promotions	GET	instructor.course.$slug.manage.promotions.tsx	instructor	Promosyonlar ve kuponlar (bu kursa özel).
/:lang/instructor/course/:id	GET	instructor.course.$id.tsx	instructor	Kurs detay/redirect sayfası.
/:lang/instructor/bundles	GET	instructor.bundles._index.tsx	instructor	Paket listesi; modal ile yeni paket oluşturma.
/:lang/instructor/bundles/:id/manage	GET	instructor.bundles.$id.manage.tsx	instructor	Paket yönetimi.
/:lang/instructor/tools	GET	instructor.tools.tsx + instructor.tools._index.tsx	instructor	Eğitmen AI Araçları merkezi (sosyal medya, pazar öngörüleri, AI quiz, AI müfredat).
/:lang/instructor/tools/social-media	GET	instructor.tools.social-media.tsx	instructor	Sosyal medya içerik fabrikası (X, LinkedIn, Reels).
/:lang/instructor/tools/market-insights	GET	instructor.tools.market-insights.tsx	instructor	Pazar öngörüleri aracı.
/:lang/instructor/tools/ai-quiz	GET	instructor.tools.ai-quiz.tsx	instructor	AI quiz oluşturucu.
/:lang/instructor/tools/ai-syllabus	GET	instructor.tools.ai-syllabus.tsx	instructor	AI müfredat (syllabus) oluşturucu.

Catch-all

Path	Method	Dosya	Yetki	Açıklama
/:lang/* (eşleşmeyen)	GET	404.tsx	public	Lang altında 404.
* (eşleşmeyen)	GET	404.tsx	public	Genel 404.

---

Yetki kısaltmaları

Yetki	Açıklama
public	Giriş gerekmez; herkes erişebilir.
giriş	Oturum açmış kullanıcı gerekir; rol kontrolü yok (veya sayfa bazında).
instructor	Oturum + user.role === "instructor" (veya eğitmen kaydı tamamlanmış).
admin	Oturum + user.role === "admin".
—	API; yetki endpoint’e göre (auth, webhook, giriş/instructor/admin).

---

Özet

• Dil prefix yok: /, /api/*, /admin/*, /verify/:code, /robots.txt, /sitemap.xml, /401, /404, /500.
• Dil prefix var: /:lang/... — public sayfalar (ana sayfa, pricing, teaching, courses [index / search / category/subcategory/topic], course, bundle, user, terms, login, register, affiliate, sitemap, coming-soon, mobile-app, business, enterprise-solution, accessibility-statement); giriş gerekli (cart, payment, my-courses, learn, account, messages, onboarding); instructor (instructor/*, instructor/tools ve alt sayfalar: social-media, market-insights, ai-quiz, ai-syllabus).
• Kurs keşfet: /:lang/courses (index), /:lang/courses/search, /:lang/courses/:category ve alt path’ler için route ayrımı ve keşfet bölümleri Kurs Keşfet ve Arama sayfasında açıklanır.
• API detayı: Parametreler, body, response için API Referansı ve GraphQL sayfasına bakın.
• Layout ve dosya isimlendirmesi: Proje Yapısı (Detaylı) sayfasında layout hiyerarşisi ve route dosya kuralları açıklanır.