Geliştirme Akışı

Komutlar Özeti

Komut	Açıklama
npm run dev	Vite geliştirme sunucusu — HMR, port 5173
npm run start	Wrangler yerel worker — port 8787, production’a yakın
npm run build	Production build (build/client, build/server)
npm run deploy	Build + Cloudflare Workers deploy
npm run typecheck	React Router typegen + TypeScript kontrolü
npm run cf-typegen	Cloudflare Workers TypeScript tipleri

Ne Zaman Hangisi?

• Günlük UI/route geliştirme: npm run dev (hızlı, port 5173).
• API, webhook, DB, Cloudflare binding testi: npm run start (port 8787).

Stripe Webhook Yerelde

Yerelde Stripe webhook’larını test etmek için Stripe CLI gereklidir. Önce CLI’ı kurun, sonra stripe listen komutunu kullanın.

Stripe CLI Kurulumu

macOS

Homebrew ile (önerilen):

brew install stripe/stripe-cli/stripe

Homebrew olmadan:

1. GitHub Releases sayfasından CPU mimarinize uygun stripe_X.X.X_mac-os_*.tar.gz dosyasını indirin.
2. Dosyayı açın: tar -xvf stripe_X.X.X_mac-os_*.tar.gz
3. stripe dosyasını global erişim için /usr/local/bin gibi bir dizine taşıyın.

Windows

GitHub’dan direkt indirme (önerilen):

1. GitHub Releases sayfasından stripe_X.X.X_windows_x86_64.zip dosyasını indirin.
2. Zip dosyasını açın.
3. Açılan stripe.exe dosyasının bulunduğu dizini Windows Path ortam değişkenine ekleyin. PowerShell’de:

   [Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\path\to\stripe", "User")

   Veya Microsoft dokümantasyonu üzerinden manuel olarak Sistem Özellikleri > Ortam Değişkenleri üzerinden ekleyebilirsiniz.

Scoop ile (Scoop kuruluysa):

scoop bucket add stripe https://github.com/stripe/scoop-stripe-cli.git
scoop install stripe

Not: Windows antivirüs yazılımları Stripe CLI’ı bazen yanlış pozitif olarak işaretleyebilir. Bu durumda GitHub issue #692 sayfasına bakabilirsiniz.

Linux

Debian/Ubuntu (apt):

curl -s https://packages.stripe.dev/api/security/keypair/stripe-cli-gpg/public | gpg --dearmor | sudo tee /usr/share/keyrings/stripe.gpg
echo "deb [signed-by=/usr/share/keyrings/stripe.gpg] https://packages.stripe.dev/stripe-cli-debian-local stable main" | sudo tee -a /etc/apt/sources.list.d/stripe.list
sudo apt update && sudo apt install stripe

RPM tabanlı (yum):

echo -e "[Stripe]\nname=stripe\nbaseurl=https://packages.stripe.dev/stripe-cli-rpm-local/\nenabled=1\ngpgcheck=0" | sudo tee -a /etc/yum.repos.d/stripe.repo
sudo yum install stripe

Paket yöneticisi olmadan:

1. GitHub Releases sayfasından stripe_X.X.X_linux_x86_64.tar.gz dosyasını indirin.
2. Dosyayı açın: tar -xvf stripe_X.X.X_linux_x86_64.tar.gz
3. ./stripe dosyasını PATH içindeki bir dizine taşıyın.

Docker

Stripe CLI Docker image olarak da mevcuttur:

docker run --rm -it stripe/stripe-cli:latest

Stripe CLI’ye Giriş (Login)

Kurulum sonrası Stripe hesabınıza bağlanmanız gerekir:

1. Tarayıcı ile giriş (önerilen):

   stripe login

   Komutu çalıştırdığınızda bir pairing code gösterilir. Enter tuşuna basarak tarayıcıda oturum açın veya gösterilen URL’yi manuel olarak ziyaret edin.

2. API key ile giriş (CI/CD veya tarayıcı olmadan):

   stripe login --interactive

   Mevcut API secret key veya restricted key ile giriş yapabilirsiniz.

3. Satır içi API key:

   stripe login --api-key sk_test_...

Stripe CLI geliştirmeleri ve daha fazla bilgi için: Stripe CLI Dokümantasyonu

Webhook Yönlendirme

1. Önce npm run start ile Wrangler’ı başlatın.
2. Başka bir terminalde:

   stripe listen --forward-to localhost:8787/api/stripe/webhook

3. CLI’dan verilen whsec_... değerini .dev.vars içinde STRIPE_WEBHOOK_SECRET olarak kullanın.

Vite ile test ediyorsanız --forward-to localhost:5173/api/stripe/webhook kullanın.

Main Proje vs Docs

• Ana uygulama (Achidemy LMS): Proje kökünde npm run dev / npm run start.
• Bu dokümantasyon sitesi: docs/ klasöründe npm run dev / npm run build. Sadece dokümantasyonu düzenlemek için kullanılır.