Türkiye'nin Teknoloji Etkinlik Platformu
Öğrenme ve pratik yapma amacıyla geliştirilen bir eğitim projesi.
Hackathon, meetup, workshop ve konferansları keşfet. Toplulukla buluş.
Listur, Türkiye'deki teknoloji ve topluluk etkinliklerini tek bir platformda toplayan, kullanıcıların ilgi alanına göre kişiselleştiren açık kaynaklı bir web uygulamasıdır.
Hedef kitle: Geliştirici, tasarımcı, girişimci ve topluluk üyeleri.
Temel fikir: Etkinlik arayan herkes hangi etkinliğin nerede, ne zaman olduğunu kolayca bulsun. Organizatörler minimal çabayla etkinliklerini platforma ekleyebilsin.
- 🎯 İlgi alanı bazlı sıralama — Misafir (localStorage) ve kayıtlı kullanıcı (Supabase) desteği
- 🗺️ Gelişmiş filtreler — Kategori, şehir, tarih aralığı, online/yüz yüze
- 📅 Takvim görünümü — Etkinlikleri aylık takvimde görüntüle
- 🔍 SEO dostu — SSR, sitemap, Open Graph meta tag'leri
- 🔗 Akıllı link parse — metascraper → GPT-4o fallback → manuel düzeltme
- 📝 Etkinlik gönderme — Link yapıştır, otomatik bilgi çekme, önizleme ve gönder
- 🖼️ Görsel yönetimi — OG görseli otomatik Supabase Storage'a yüklenir (CDN)
- ❤️ Favoriler — Beğendiğin etkinlikleri kaydet
- 📋 RSVP — Katılım durumu: Gideceğim / İlgileniyorum / Gitmeyeceğim
- 👁️ Görüntülenme sayacı — Günlük unique view takibi (kayıtlı + anonim)
- 📤 Takvim export — .ics dosyası ile Google Calendar / Apple Calendar'a ekle
- ⏰ Hatırlatıcılar — Etkinlikten 24 saat ve 1 saat önce otomatik bildirim (Vercel Cron)
- 👤 Organizatör profili — Handle, bio, sosyal linkler, verified badge
- 📊 Organizatör dashboard — Etkinlik istatistikleri, takipçi sayısı
- 👥 Takip sistemi — Organizatörleri takip et, yeni etkinlik bildirimi al
- ✅ Doğrulama akışı — Başvuru → Admin inceleme → Verified organizatör
- 🛡️ Moderatör paneli — Onay/red/düzenleme + audit log
- 🏢 Admin paneli — Kullanıcı yönetimi, rol atama, tüm raporlar
- 🚩 İçerik raporlama — Herkes (misafir dahil) uygunsuz içerik bildirebilir
- 🔔 Bildirim sistemi — 7 farklı bildirim tipi (in-app)
- 🔐 4 kullanıcı rolü —
user→verified_user→moderator→admin - 🔒 Row Level Security — Tüm tablolarda satır bazlı erişim kontrolü
| Katman | Teknoloji | Versiyon |
|---|---|---|
| Framework | Next.js (App Router, TypeScript) | 16 |
| UI | React | 19 |
| Stil | Tailwind CSS | v4 |
| Veritabanı | Supabase (PostgreSQL + RLS) | latest |
| Auth | Supabase Auth (email + magic link) | — |
| Storage | Supabase Storage (CDN) | — |
| AI | OpenAI GPT-4o (link parse fallback) | gpt-4o |
| Scraping | metascraper + got | latest |
| Deploy | Vercel (Turbopack build) | — |
| CI/CD | GitHub Actions | — |
| Paket Yöneticisi | pnpm | latest |
- Node.js v20+
- pnpm v9+
- Supabase CLI (opsiyonel, lokal DB için)
# 1. Repo'yu klonla
git clone https://github.com/BilalAbic/listur.git
cd listur
# 2. Bağımlılıkları yükle
pnpm install
# 3. Ortam değişkenlerini ayarla
cp .env.development.example .env.local
# .env.local dosyasını düzenle — aşağıdaki tabloya bak
# 4. (Opsiyonel) Lokal Supabase başlat
pnpm supabase start
pnpm supabase db push
# 5. Geliştirme sunucusunu başlat
pnpm devTarayıcıda http://localhost:3000 adresini aç.
| Değişken | Gerekli | Açıklama | Güvenlik |
|---|---|---|---|
NEXT_PUBLIC_SUPABASE_URL |
✅ | Supabase proje URL'i | Public |
NEXT_PUBLIC_SUPABASE_ANON_KEY |
✅ | Supabase anon (public) key | Public |
SUPABASE_SERVICE_ROLE_KEY |
✅ | Supabase service role key | 🔒 Server-only |
OPENAI_API_KEY |
✅ | OpenAI API key (GPT-4o parse) | 🔒 Server-only |
NEXT_PUBLIC_APP_URL |
✅ | Uygulama base URL | Public |
CRON_SECRET |
Vercel Cron Job auth token | 🔒 Server-only |
⚠️ Güvenlik:SUPABASE_SERVICE_ROLE_KEY,OPENAI_API_KEYveCRON_SECRETaslaNEXT_PUBLIC_öneki almaz. Bu değişkenler sadece server-side API route'larda kullanılır.
development ──→ Vercel Preview (listur-dev Supabase)
production ──→ Vercel Production (listur-prod Supabase)
main ──→ Deploy devre dışı
# 1. Issue aç
gh issue create --title "feat: yeni özellik" --label "enhancement"
# 2. Branch oluştur (issue'ya bağlı)
gh issue develop <ISSUE_NO> --checkout
# 3. Geliştir ve commit at
git commit -m "feat(scope): açıklama
Refs #<ISSUE_NO>"
# 4. PR aç (base: development)
gh pr create --base development
# 5. Merge (squash)
gh pr merge --squash --delete-branchKurallar:
productionbranch'ine direkt push yasak — PR zorunlu- Commit mesajı formatı:
<tip>(<kapsam>): <açıklama>+Refs #N - Tipler:
feat|fix|ui|docs|refactor|test|chore
listur/
├── src/
│ ├── app/ # Next.js App Router
│ │ ├── page.tsx # Ana sayfa — etkinlik listesi + filtreler
│ │ ├── giris/ # Giriş / Kayıt
│ │ ├── etkinlik/[slug]/ # Etkinlik detay sayfası
│ │ ├── etkinlik-gonder/ # Etkinlik gönderme formu
│ │ ├── takvim/ # Takvim görünümü
│ │ ├── profil/ # Kullanıcı profili
│ │ │ ├── organizator/ # Organizatör dashboard
│ │ │ └── organizator-basvuru/ # Organizatör başvurusu
│ │ ├── organizator/[handle]/ # Organizatör public profili
│ │ ├── bildirimler/ # Bildirim listesi
│ │ ├── moderator/ # Moderatör paneli (3 alt sayfa)
│ │ ├── admin/ # Admin paneli (5 alt sayfa)
│ │ ├── auth/callback/ # Supabase auth callback
│ │ └── api/ # API Routes
│ │ ├── parse-link/ # metascraper + GPT-4o parse
│ │ ├── events/ # Etkinlik CRUD + onay/red/kaldır
│ │ ├── reports/ # Raporlama
│ │ ├── notifications/ # Bildirim yönetimi
│ │ ├── organizers/ # Organizatör başvuru + lookup
│ │ ├── users/ # Kullanıcı yönetimi (rol atama)
│ │ ├── storage/ # Kapak görseli yükleme
│ │ └── cron/reminders/ # Saatlik hatırlatıcı cron
│ │
│ ├── components/ # UI Bileşenleri
│ │ ├── engagement/ # FavoriteButton, RsvpButton, CalendarExport
│ │ ├── events/ # EventCard, EventFilters, ShareButtons
│ │ ├── forms/ # AuthForm, EventSubmitForm
│ │ ├── layout/ # Header
│ │ ├── modals/ # InterestsModal, ReportModal
│ │ ├── moderation/ # PendingList, ReportsList, UsersList
│ │ ├── notifications/ # NotificationPageList
│ │ └── organizers/ # OrganizerCard, FollowButton, VerifiedBadge
│ │
│ ├── lib/ # Yardımcı Kütüphaneler
│ │ ├── supabase/ # Client (browser + server + middleware)
│ │ ├── ai/ # parse-link.ts + prompts.ts
│ │ ├── storage/ # upload-cover.ts
│ │ ├── utils/ # slug.ts, html-cleaner.ts
│ │ ├── calendar.ts # .ics export yardımcıları
│ │ ├── organizer-validation.ts # Organizatör doğrulama
│ │ └── site.ts # Base URL çözümleme
│ │
│ ├── types/ # TypeScript Tipleri
│ │ ├── database.ts # Supabase otomatik tip üretimi
│ │ └── index.ts # Genel tip tanımları
│ │
│ ├── context/ # React Context
│ │ └── AuthContext.tsx # Auth state yönetimi
│ │
│ └── hooks/ # Custom Hooks
│ ├── useAuth.ts
│ ├── useFavorites.ts
│ ├── useFollows.ts
│ ├── useInterests.ts # localStorage ↔ Supabase sync
│ ├── useNotifications.ts
│ └── useRsvps.ts
│
├── supabase/
│ ├── migrations/ # SQL migration dosyaları (001-007)
│ ├── seed.sql # Dev için örnek veri
│ └── config.toml
│
├── middleware.ts # Rol bazlı rota koruması
├── vercel.json # Vercel config + cron tanımı
└── docs/
└── platform-srs.md # Detaylı SRS dokümanı
Proje 10 tablo ve 8 enum tipi içerir. Detaylı şema için platform-srs.md dosyasına bakın.
| Tablo | Açıklama |
|---|---|
profiles |
Kullanıcı profilleri (rol, ilgi alanları, organizatör bilgileri) |
events |
Etkinlikler (başlık, tarih, konum, durum, engagement sayaçları) |
submissions |
Etkinlik gönderimleri (parse kaynağı, gönderen) |
notifications |
Bildirimler (7 tip) |
reports |
İçerik raporları (sebep, durum) |
moderation_logs |
Moderasyon audit trail (silinemez) |
favorites |
Kullanıcı favorileri |
rsvps |
RSVP kayıtları (going/interested/not_going) |
event_views |
Görüntülenme kayıtları (unique/gün) |
organizer_follows |
Takip ilişkileri |
organizer_applications |
Organizatör başvuruları |
supabase/migrations/
├── 001_enums.sql # Enum tipleri
├── 002_tables.sql # Ana tablolar + trigger'lar
├── 003_rls.sql # Row Level Security politikaları
├── 004_storage.sql # Storage bucket tanımı
├── 005_engagement.sql # Favoriler, RSVP, view, sayaç trigger'ları
├── 006_calendar_reminders.sql # Hatırlatıcı bildirim tipi
└── 007_organizer_hub.sql # Organizatör profil, takip, başvuru
Proje 5 GitHub Actions workflow'u ile korunur:
| Workflow | Tetikleyici | İşlev |
|---|---|---|
CI (ci.yml) |
PR → development, production |
ESLint (reviewdog) + TypeScript check + Turbopack build |
CodeQL (codeql.yml) |
PR + schedule | Güvenlik açığı tarama |
Secret Scan (secret-scan.yml) |
PR | Secret leak tespiti |
Deps (deps.yml) |
Schedule | Bağımlılık güncelleme |
E2E (e2e.yml) |
PR | End-to-end test |
# Lint
pnpm lint
# TypeScript kontrol
pnpm exec tsc --noEmit
# Build (Turbopack)
pnpm build🚧 Ekran görüntüleri yakında eklenecek. Canlı siteyi ziyaret etmek için: listur.bilalabic.com
Katkılarınızı memnuniyetle karşılıyoruz! İşte başlamanın yolu:
Her katkı bir issue ile başlar:
gh issue create --title "feat: yeni özellik açıklaması" --label "enhancement"- Fork yapın ve repo'yu klonlayın
developmentbranch'inden yeni branch oluşturun:git checkout development git checkout -b feat/yeni-ozellik
- Değişikliklerinizi yapın ve commit atın:
git commit -m "feat(scope): kısa açıklama Detaylı açıklama. Refs #<ISSUE_NO>"
- PR açın (
developmentbranch'ine):gh pr create --base development
<tip>(<kapsam>): <kısa açıklama>
<neden bu değişikliği yaptın>
Refs #N
| Tip | Kullanım |
|---|---|
feat |
Yeni özellik |
fix |
Hata düzeltme |
ui |
Görsel / arayüz değişikliği |
docs |
Belgeleme |
refactor |
Mantık değişmeden yeniden yapı |
test |
Test ekle / düzelt |
chore |
Build, bağımlılık, config |
- PR hedefi her zaman
developmentbranch'idir - CI kontrolleri (lint + type check + build) geçmeli
- Merge yöntemi: squash merge + branch silme
| Doküman | Açıklama |
|---|---|
| platform-srs.md | Detaylı yazılım gereksinimleri (SRS v1.2) |
| CLAUDE.md | AI asistan için proje referans belgesi |
Bu proje MIT Lisansı ile lisanslanmıştır.
Listur ile Türkiye'nin teknoloji etkinliklerini keşfet 🚀