Üreticiler ve bağımsız girişimciler için tasarlanmış açık kaynaklı, hafif Trello alternatifi.
Sadelik, hız ve ölçeklenebilirliğe odaklanır. Modern teknolojiyle geliştirildi: Tailwind CSS, shadcn/ui, Supabase, Stripe entegrasyonu. Sınırsız proje, ekip işbirliği, koyu/açık mod ve kesintisiz kullanıcı deneyimini destekler. Gereksiz karmaşıklık olmadan tam kontrol isteyen solo geliştiriciler ve küçük ekipler için mükemmeldir.
🌟 Bu projeyi faydalı bulursanız, bir yıldız vermeyi düşünün! Bu sayede başkaları da keşfedebilir.
Dağıtım Rehberi
Genel Bakış
Bu uygulama artık Stripe entegrasyonu için Supabase Edge Functions yerine yerel Next.js API rotalarını kullanıyor. Bu, dağıtımı daha basit hale getirir ve yapılandırma için standart .env dosyalarını kullanmanıza olanak tanır.Ortam Değişkenleri Kurulumu
1. .env.local dosyası oluşturun
.env.example dosyasını .env.local olarak kopyalayın ve gerçek değerlerinizi girin:cp .env.example .env.local
2. Gerekli Ortam Değişkenleri
#### Supabase Yapılandırması
NEXT_PUBLIC_SUPABASE_URL- Supabase projenizin URL'siNEXT_PUBLIC_SUPABASE_ANON_KEY- Supabase anonim anahtarınızSUPABASE_SERVICE_ROLE_KEY- Supabase servis rolü anahtarınız (sadece sunucu tarafı)
STRIPE_SECRET_KEY- Stripe gizli anahtarınız (sadece sunucu tarafı)NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY- Stripe yayınlanabilir anahtarınızSTRIPE_WEBHOOK_SECRET- Stripe webhook gizli anahtarınız
NEXT_PUBLIC_SITE_URL- Sitenizin URL'si (prodüksiyon için)NEXTAUTH_URL- Sitenizin URL'si (yukarıdakiyle aynı)NEXTAUTH_SECRET- NextAuth için rastgele bir gizli anahtar
Yerel Geliştirme
- Bağımlılıkları yükleyin:
npm install
- Ortam değişkenlerinizi
.env.localdosyasında ayarlayın - Geliştirme sunucusunu çalıştırın:
npm run dev
- Stripe CLI kullanarak Stripe webhook'larını yerel olarak test edin:
stripe listen --forward-to localhost:3000/api/stripe/webhook
Üretim Dağıtımı
Vercel Dağıtımı
- Vercel'e Dağıt:
npx vercel
- Ortam Değişkenleri:
- Stripe Webhook Kurulumu:
- Webhook'u şu adrese yönlendirin:
https://your-domain.vercel.app/api/stripe/webhook
API Uç Noktaları
Uygulama artık bu yerel API yollarını kullanıyor:
POST /api/stripe/checkout- Stripe ödeme oturumları oluştururPOST /api/stripe/webhook- Stripe webhook olaylarını işler
Yerel API Yollarının Faydaları
- Daha Basit Dağıtım - Ayrı edge fonksiyonları dağıtmaya gerek yok
- Ortam Değişkenleri - Standart .env dosya desteği
- Daha İyi Hata Ayıklama - Yerelde hata ayıklamak daha kolay
- Çerçeve Entegrasyonu - Next.js ile daha iyi entegrasyon
- Satıcıya Bağımlılık Yok - Next.js destekleyen herhangi bir platforma dağıtabilirsiniz
Sorun Giderme
- Webhook Sorunları:
STRIPE_WEBHOOK_SECRETdeğerinin Stripe webhook uç noktanızla eşleştiğinden emin olun- Stripe panosunda webhook günlüklerini kontrol edin
- Webhook URL'sinin doğru olduğundan emin olun
- Ortam Değişkenleri:
- Gerekli tüm değişkenlerin ayarlandığından emin olun
- Değişken adlarında yazım hatası olup olmadığını kontrol edin
- Supabase servis rol anahtarının uygun izinlere sahip olduğundan emin olun
- CORS Sorunları:
- API yolları uygun CORS başlıklarını içerir
- Gerekirse alan adınızın beyaz listeye alındığından emin olun
Güvenlik Notları
STRIPE_SECRET_KEYveyaSUPABASE_SERVICE_ROLE_KEYanahtarlarını asla istemciye göstermeyin- Yalnızca istemci tarafı değişkenler için
NEXT_PUBLIC_önekini kullanın - Webhook gizli anahtarlarınızı düzenli olarak değiştirin
- Stripe panosunda webhook teslimatını izleyin