# 🌟 ReviewPilot - Google Maps Yorum Yönetimi & Otomasyonu

**Pinkod Dijital** - Profesyonel Yorum Yönetim Sistemi

Müşteri yorumlarını otomatik olarak cevapla, raporla ve analiz et. Google Maps, e-posta ve Telegram entegrasyonu ile tamamen otomatikleştirilmiş iş akışı.

---

## 📁 Proje Yapısı

```
reviewpilot-full/
├── backend/
│   ├── src/
│   │   ├── index.js           # Express sunucusu
│   │   ├── models/
│   │   │   ├── db.js          # SQLite bağlantısı
│   │   │   └── migrate.js     # DB kurulumu
│   │   ├── routes/            # 6 API route dosyası
│   │   ├── services/          # AI, Email, Telegram
│   │   ├── middleware/        # JWT auth
│   │   └── jobs/              # Cron jobs
│   ├── package.json
│   └── .env
│
├── frontend/
│   ├── src/
│   │   ├── App.jsx            # React ana komponenti
│   │   └── main.jsx
│   ├── package.json
│   ├── vite.config.js
│   └── index.html
│
├── .htaccess                   # Apache proxy config
├── nginx.conf                  # Nginx config (opsiyonel)
├── ecosystem.config.js         # PM2 yapılandırması
├── quick-install.sh            # Hızlı kurulum
├── maintenance.sh              # Bakım araçları
├── crontab.txt                 # Zamanlanmış görevler
├── DEPLOYMENT.sh               # Detaylı kurulum rehberi
└── README_TR.md                # Türkçe dokümantasyon
```

---

## ⚡ 5 Dakikalık Kurulum

### 1. SSH Bağlantısı
```bash
ssh username@example.com
```

### 2. Hızlı Kurulum Scripti
```bash
bash quick-install.sh
```

### 3. API Anahtarlarını Yapılandır
```bash
nano ~/private/reviewpilot-backend/.env
# Google Places, Anthropic, Gmail, Telegram anahtarlarını doldur
```

### 4. Test Et
```bash
# Terminal
curl http://localhost:3001/api/health

# Tarayıcı
https://example.com/app/
```

---

## 🎯 Özellikler

✅ **Yorum Yönetimi**
- Google Maps yorumlarını otomatik senkronize
- Statü takibi (Beklemede, Yanıtlandı, Yoksayıldı)

✅ **AI Destekli Cevaplar**
- Claude (Anthropic) AI ile otomatik cevap önerisi
- Yorum tonuna göre uyarlanmış yanıtlar
- Türkçe, profesyonel ve samimi

✅ **Raporlama**
- Haftalık ve aylık otomatik raporlar
- AI analiziyle müşteri geri bildirimi
- HTML e-posta şablonları

✅ **Bildirimler**
- Gmail SMTP e-posta gönderimi
- Telegram Bot entegrasyonu
- Anlık uyarı (düşük puanlı yorumlar)
- Zamanlanmış gönderimler

✅ **Çok İşletmeli Destek**
- Sınırsız işletme yönetimi
- Rol tabanlı erişim kontrolü
- İşletme başına bildirim ayarları

✅ **Entegrasyonlar**
- Google Places API
- Claude AI API
- Gmail SMTP
- Telegram Bot API
- SQLite Veritabanı

---

## 🔐 Güvenlik

- JWT tabanlı oturum yönetimi
- bcrypt ile şifre hashleme
- SQL injection koruması
- Rate limiting
- CORS kontolü
- HTTPS/SSL mandatory

---

## 📊 Teknik Detaylar

**Backend:**
- Node.js 16+
- Express.js (Web framework)
- SQLite3 (Veritabanı)
- PM2 (Process manager)
- node-cron (Zamanlanmış görevler)

**Frontend:**
- React 18
- Vite (Build tool)
- CSS-in-JS (Inline styles)

**Hosting:**
- Shared Hosting (cPanel/Plesk)
- Apache + mod_rewrite + mod_proxy
- HTTPS/SSL

---

## 📚 Dokümantasyon

- **[README_TR.md](./README_TR.md)** - Türkçe kurulum & deployment rehberi
- **[DEPLOYMENT.sh](./DEPLOYMENT.sh)** - Adım adım kurulum komutları
- **[quick-install.sh](./quick-install.sh)** - Otomatik kurulum scripti

---

## 🎓 Örnek Kullanım

### Login
```bash
E-posta: admin@reviewpilot.com
Şifre: Admin123!
```

### API Çağrısı
```bash
# Token al
curl -X POST http://localhost:3001/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email":"admin@reviewpilot.com","password":"Admin123!"}'

# Yorumları listele
curl http://localhost:3001/api/businesses/[BID]/reviews \
  -H "Authorization: Bearer [TOKEN]"

# AI cevap üret
curl -X POST http://localhost:3001/api/businesses/[BID]/reviews/[RID]/generate-reply \
  -H "Authorization: Bearer [TOKEN]"
```

---

## 🔄 Otomatik Görevler (Cron)

| Görev | Zamanlama | Açıklama |
|-------|-----------|----------|
| Google Sync | Her saat başı | Yorumları çeker, anlık uyarı gönderir |
| Haftalık Rapor | Pazartesi 09:00 | E-posta + Telegram |
| Aylık Rapor | Her ayın 1'i | Detaylı analiz |
| Yanıtsız Uyarı | Her gün 10:00 | 3+ gün yanıtsız olumsuz yorumlar |

---

## 📞 İletişim & Destek

**Pinkod Dijital**
- Web: https://pinkoddigital.com
- Email: support@pinkoddigital.com
- Tel: +90 XXX XXX XXXX

---

## 📄 Lisans

Copyright © 2026 Pinkod Dijital. Tüm hakları saklıdır.

---

**Sürüm:** 1.0.0  
**Son Güncelleme:** 31 Mayıs 2026  
**Durum:** Production Ready ✅