balikci/backend/README.md

# Oltalama Backend API

Phishing test yönetim sistemi backend API'si.

## ✨ Özellikler

✅ **Authentication** - Session-based login/logout  
✅ **Company Management** - Şirket CRUD & istatistikler  
✅ **Token Management** - Tracking token oluşturma & mail gönderimi  
✅ **Tracking** - IP, GeoIP, User-Agent tracking  
✅ **Telegram** - Gerçek zamanlı bildirimler  
✅ **Mail** - Gmail entegrasyonu (Nodemailer)  
✅ **Templates** - HTML mail şablonları (Handlebars)  
✅ **Stats** - Dashboard ve detaylı istatistikler  

## 🚀 Kurulum

```bash
npm install
cp .env.example .env
# .env dosyasını düzenle

npm run db:migrate
npm run db:seed
npm run dev
```

## 📡 API Endpoints

### Authentication
```
POST   /api/auth/login      - Giriş
POST   /api/auth/logout     - Çıkış
GET    /api/auth/check      - Session kontrolü
GET    /api/auth/me         - Kullanıcı bilgisi
```

### Companies
```
GET    /api/companies           - Tüm şirketler
POST   /api/companies           - Yeni şirket
GET    /api/companies/:id       - Şirket detay
PUT    /api/companies/:id       - Şirket güncelle
DELETE /api/companies/:id       - Şirket sil
GET    /api/companies/:id/tokens - Şirket tokenları
GET    /api/companies/:id/stats  - Şirket istatistikleri
```

### Tokens
```
GET    /api/tokens                  - Tüm tokenlar
POST   /api/tokens/create           - Token oluştur
POST   /api/tokens/create-and-send  - Token oluştur + mail gönder
GET    /api/tokens/:id              - Token detay
PUT    /api/tokens/:id              - Token güncelle
DELETE /api/tokens/:id              - Token sil
POST   /api/tokens/:id/send         - Mail gönder
GET    /api/tokens/:id/clicks       - Tıklama geçmişi
```

### Tracking (Public)
```
GET    /t/:token   - Tracking endpoint (IP, GeoIP, Telegram)
```

### Templates
```
GET    /api/templates          - Tüm şablonlar
GET    /api/templates/:type    - Şablon detay
POST   /api/templates/preview  - Önizleme
```

### Settings
```
GET    /api/settings             - Tüm ayarlar
PUT    /api/settings/gmail       - Gmail ayarları
PUT    /api/settings/telegram    - Telegram ayarları
POST   /api/settings/test-gmail  - Gmail testi
POST   /api/settings/test-telegram - Telegram testi
```

### Stats
```
GET    /api/stats/dashboard      - Dashboard özet
GET    /api/stats/recent-clicks  - Son tıklamalar
GET    /api/stats/by-company     - Şirket bazlı stats
```

## 🔐 Default Credentials

```
Username: admin
Password: admin123
```

## 📊 Database

SQLite database: `database/oltalama.db`

**Tablolar:**
- companies (3 örnek şirket)
- tracking_tokens
- click_logs
- mail_templates (2 şablon)
- settings
- admin_user

## 🧪 Test

```bash
# Health check
curl http://localhost:3000/health

# Login
curl -X POST http://localhost:3000/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"username":"admin","password":"admin123"}'
```

## 📝 Environment Variables

```env
PORT=3000
BASE_URL=http://localhost:3000
SESSION_SECRET=your-secret-key

# Gmail
GMAIL_USER=your-email@gmail.com
GMAIL_APP_PASSWORD=your-app-password
GMAIL_FROM_NAME=Güvenlik Ekibi

# Telegram
TELEGRAM_BOT_TOKEN=your-bot-token
TELEGRAM_CHAT_ID=your-chat-id
```

## 🏗️ Yapı

```
src/
├── config/          - Database, Logger, Session
├── controllers/     - Route handlers (auth, company, token, tracking, etc.)
├── middlewares/     - Auth, error handler, rate limiter
├── models/          - Sequelize models
├── routes/          - API routes
├── services/        - Business logic (mail, telegram, token)
├── utils/           - Helpers (geoip, user-agent parser, token generator)
├── validators/      - Joi schemas
├── public/          - Static files (landing page)
└── app.js           - Express app
```

## ✅ Durum

**Tamamlanan:**
- ✅ Authentication sistem
- ✅ Company yönetimi
- ✅ Token yönetimi
- ✅ Tracking endpoint
- ✅ Telegram bildirimleri
- ✅ Mail gönderimi
- ✅ GeoIP tracking
- ✅ User-Agent parsing
- ✅ Stats & Analytics
- ✅ Landing page

**Sırada:**
- Frontend (React)
- API Documentation (Swagger)
- Unit tests