Yerel Kurulum Rehberi

Bu kılavuz, Coursio projesini yerelde kurup çalıştırmak için gereken adımları adım adım anlatır. Ana uygulama (Coursio LMS) proje kökünde çalıştırılır (npm run dev, npm run start). Bu dokümantasyon sitesinin kaynağı ise docs/ klasöründedir ve ayrı bir proje olarak build edilir; kurulum adımları ana uygulama içindir.

Gereksinimler

• Node.js 18+ (önerilen: LTS)
• Paket yöneticisi: npm
• Git
• Stripe CLI (webhook yerel test için isteğe bağlı)
• Neon ve Cloudflare hesapları (geliştirme/production için)

1. Repoyu klonlama

git clone https://github.com/techsider-co/coursio.git
cd coursio

2. Bağımlılıkları yükleme

npm install

3. Ortam dosyası: .dev.vars yapılandırması

Proje kökünde .dev.vars dosyası oluşturun. Bu dosya git’e eklenmez (.gitignore).

En az şu değişkenleri tanımlayın:

Değişken	Açıklama
DATABASE_URL	Neon PostgreSQL bağlantı dizesi
STRIPE_SECRET_KEY	Stripe test anahtarı (sk_test_...)
STRIPE_WEBHOOK_SECRET	Stripe CLI ile alınan whsec_... (yerel webhook için)

Tüm Secret ve Public anahtarların açıklamalı listesi için Ortam Değişkenleri sayfasına bakın.

Örnek .dev.vars (gerçek değerleri kendi anahtarlarınızla değiştirin):

DATABASE_URL=postgresql://user:pass@host/neondb?sslmode=require
STRIPE_SECRET_KEY=sk_test_...
STRIPE_WEBHOOK_SECRET=whsec_...
BETTER_AUTH_SECRET=rastgele-gizli-anahtar

4. Geliştirme sunucusunu başlatma: npm run dev

Ortam dosyası hazır olduktan sonra:

npm run dev

• Uygulama Vite ile http://localhost:5173 adresinde açılır.
• HMR (Hot Module Replacement) ile anlık güncelleme alırsınız.

API / DB / Cloudflare binding testi için (Wrangler ile production’a yakın ortam):

npm run start

veya doğrudan Wrangler:

npx wrangler dev

• Uygulama http://localhost:8787 adresinde çalışır.

Özet akış

1. git clone → cd coursio
2. npm install
3. Proje kökünde .dev.vars oluştur; DATABASE_URL, STRIPE_SECRET_KEY, STRIPE_WEBHOOK_SECRET (ve isteğe bağlı diğerleri) ekle.
4. npm run dev (UI) veya npm run start / npx wrangler dev (API/DB/Cloudflare testi).

Sorun yaşarsanız Ortam Değişkenleri ve Geliştirme Akışı sayfalarına bakın.