🔍 İşletme Arama Sistemi

Türkiye'deki işletmeleri kolayca bulun ve iletişim bilgilerine anında ulaşın

Özellikler · Kurulum · Kullanım · Katkıda Bulunun

---

📖 Hakkında

Modern, açık kaynak bir işletme arama platformu. Pazarlama ekipleri, araştırmacılar ve iş sahipleri için tasarlandı. Tamamen ücretsiz OpenStreetMap API'si veya isteğe bağlı Google Places API desteği ile çalışır.

🎯 Kullanım Senaryoları

• 👔 Pazarlama Ekipleri: Hedef kitle analizi ve müşteri bulma
• 🔬 Araştırmacılar: Sektör verileri toplama ve analiz
• 💼 İş Sahipleri: Rakip analizi ve pazar araştırması
• 🎨 Freelancer'lar: Potansiyel müşteri keşfi

---

✨ Özellikler

🔍 Gelişmiş Arama

• Çoklu Filtre: İşletme türü, adı, il, ilçe/semt
• Çift API Desteği: OpenStreetMap (ücretsiz) veya Google Places API
• Akıllı Sonuçlar: 50+ işletme tek aramada
• Gerçek Zamanlı: Güncel işletme bilgileri

📊 Veri Yönetimi

• Excel Export: Profesyonel formatlı tablolar
• PDF Export: Landscape formatında raporlar
• WhatsApp Entegrasyonu: Direkt paylaşım
• Veritabanı: Supabase ile otomatik kayıt

📈 Analitik Dashboard

• İstatistikler: Toplam arama, işletme sayısı
• Trend Analizi: En çok aranan türler ve konumlar
• Geçmiş: Detaylı arama geçmişi
• Görselleştirme: Modern kartlar ve grafikler

🎨 Modern Tasarım

• Shadcn UI: Minimal ve şık arayüz
• Responsive: Mobil, tablet, desktop uyumlu
• Dark Mode Ready: Kolay tema desteği
• Accessibility: WCAG standartlarına uygun

🔐 Güvenlik

• Authentication: Supabase Auth ile güvenli giriş
• RLS: Row Level Security politikaları
• API Key Yönetimi: Güvenli localStorage
• HTTPS: Production'da zorunlu

---

🛠️ Teknoloji Stack

Next.js 16

React 19

Tailwind CSS

Supabase

Frontend: Next.js 16, React 19, Tailwind CSS, Shadcn UI
Backend: Next.js API Routes, Supabase
Database: PostgreSQL (Supabase)
Authentication: Supabase Auth
APIs: OpenStreetMap Overpass API, Google Places API (opsiyonel)
Export: ExcelJS, jsPDF
Icons: Lucide React

---

🚀 Kurulum

Gereksinimler

• Node.js 18+
• npm veya yarn
• Supabase hesabı (ücretsiz)

1. Projeyi Klonlayın

git clone https://github.com/ibidi/business-search-system.git
cd business-search-system

2. Bağımlılıkları Yükleyin

npm install

3. Environment Değişkenlerini Ayarlayın

.env.local dosyası oluşturun:

NEXT_PUBLIC_SUPABASE_URL=your_supabase_project_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key

4. Supabase Kurulumu

a) Authentication'ı Etkinleştirin

1. Supabase Dashboard → Authentication → Providers
2. Email provider'ı etkinleştirin
3. "Confirm email" seçeneğini kapatın (geliştirme için)

b) Veritabanı Tablolarını Oluşturun

SQL Editor'de supabase/QUICK_SETUP.sql dosyasını çalıştırın.

Detaylı kurulum için: supabase/README.md

5. Geliştirme Sunucusunu Başlatın

npm run dev

Uygulama http://localhost:3000 adresinde çalışacak.

---

📁 Proje Yapısı

business-search-system/
├── app/                      # Next.js App Router
│   ├── (auth)/              # Authentication sayfaları
│   │   ├── login/
│   │   └── register/
│   ├── dashboard/           # Dashboard sayfaları
│   │   ├── analytics/
│   │   └── settings/
│   ├── api/                 # API routes
│   └── layout.js
├── components/              # React bileşenleri
│   ├── ui/                  # Shadcn UI bileşenleri
│   ├── DashboardLayout.js
│   ├── SearchForm.js
│   ├── ResultsTable.js
│   └── ExportButtons.js
├── lib/                     # Utility fonksiyonlar
│   ├── googlePlaces.js      # OpenStreetMap API
│   ├── googlePlacesAPI.js   # Google Places API
│   └── supabase.js          # Supabase client
├── utils/                   # Helper fonksiyonlar
│   └── exportHelpers.js     # Excel/PDF export
├── supabase/               # Database migrations
│   └── migrations/
└── public/                 # Statik dosyalar

---

🎮 Kullanım

1. Kayıt Olun

• /register sayfasından hesap oluşturun
• E-posta ve şifre ile kayıt olun

2. Arama Yapın

• Dashboard'da işletme türünü seçin
• İl, ilçe ve işletme adı girin (opsiyonel)
• API kaynağını seçin (OpenStreetMap veya Google Places)
• "Ara" butonuna tıklayın

3. Sonuçları İnceleyin

• Excel tablo formatında sonuçları görün
• İşletme adı, adres, telefon, website, puan bilgilerine erişin

4. Dışa Aktarın

• Excel: Profesyonel formatlı tablo
• PDF: Landscape formatında rapor
• WhatsApp: Direkt paylaşım

5. Analitik

• Arama geçmişinizi görüntüleyin
• İstatistikleri inceleyin
• Trend analizleri yapın

---

🔑 API Kullanımı

OpenStreetMap (Ücretsiz)

• ✅ API key gerekmez
• ✅ Sınırsız istek (makul kullanımda)
• ✅ Türkiye'de iyi kapsama

Google Places API (Opsiyonel)

1. Google Cloud Console → Proje oluşturun
2. Places API'yi etkinleştirin
3. API anahtarı oluşturun
4. Dashboard → Ayarlar → API key'i girin

Maliyet: Aylık $200 ücretsiz kredi (~540 arama)

---

🤝 Katkıda Bulunun

Katkılarınızı bekliyoruz!

Nasıl Katkıda Bulunabilirsiniz?

1. Fork edin
2. Feature branch oluşturun (git checkout -b feature/amazing-feature)
3. Değişikliklerinizi commit edin (git commit -m 'feat: Add amazing feature')
4. Branch'inizi push edin (git push origin feature/amazing-feature)
5. Pull Request açın

Detaylı bilgi için: CONTRIBUTING.md

Katkı Alanları

• 🐛 Bug düzeltmeleri
• ✨ Yeni özellikler
• 📝 Dokümantasyon iyileştirmeleri
• 🎨 UI/UX geliştirmeleri
• 🌍 Çeviri (i18n)
• ⚡ Performance optimizasyonları

---

📝 Lisans

Bu proje MIT lisansı altında lisanslanmıştır.

---

👨‍💻 Geliştirici

İhsan Baki Doğan

---

🙏 Teşekkürler

• Next.js - React framework
• Supabase - Backend as a Service
• OpenStreetMap - Ücretsiz harita verileri
• Shadcn UI - UI bileşenleri
• Lucide - İkonlar

---

📞 İletişim

Sorularınız veya önerileriniz için:

• Issues: GitHub Issues
• Pull Requests: GitHub PRs
• Instagram: @ihsanbakidogan
• X (Twitter): @ibidicode
• Website: ihsanbakidogan.com

---

⭐ Projeyi beğendiyseniz yıldız vermeyi unutmayın!

Made with ❤️ by İhsan Baki Doğan