docs: proje analizi raporunu ekle
Proje mimarisini, API uç noktalarını, teknoloji yığınını ve veri yapılarını içeren kapsamlı dokümantasyon eklendi.
This commit is contained in:
290
ANALYSIS.md
Normal file
290
ANALYSIS.md
Normal file
@@ -0,0 +1,290 @@
|
||||
# du.pe Proje Analiz Raporu
|
||||
|
||||
## 📋 Proje Özeti
|
||||
|
||||
**du.pe**, Put.io benzeri bir **self-hosted torrent tabanlı dosya yöneticisi ve medya oynatıcısıdır**. Kullanıcıların torrent dosyalarını eklemesine, indirmeleri yönetmesine ve videoları doğrudan tarayıcı üzerinden akışla (stream) izlemesine olanak tanır.
|
||||
|
||||
---
|
||||
|
||||
## 🏗️ Mimari Yapı
|
||||
|
||||
```
|
||||
dupe/
|
||||
├── client/ # Svelte + Vite Frontend
|
||||
│ ├── src/
|
||||
│ │ ├── components/ # Sidebar, Topbar, TorrentItem
|
||||
│ │ ├── routes/ # Files, Movies, TV Shows, Music, Transfers, Trash, Profile, Settings
|
||||
│ │ ├── stores/ # Svelte stores (movieStore, tvStore, musicStore, trashStore, avatarStore)
|
||||
│ │ ├── styles/ # Ana CSS dosyası
|
||||
│ │ └── utils/ # API yardımcı fonksiyonları
|
||||
│ └── package.json
|
||||
├── server/ # Node.js + Express Backend
|
||||
│ ├── modules/ # auth.js, health.js, state.js, websocket.js
|
||||
│ ├── utils/ # diskSpace.js
|
||||
│ ├── data/ # users.json
|
||||
│ └── server.js # Ana sunucu dosyası (~7100 satır)
|
||||
├── docs/ # Dokümantasyon
|
||||
└── docker-compose.yml
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔧 Teknoloji Yığını
|
||||
|
||||
### Backend (Node.js)
|
||||
- **Express** - REST API sunucusu
|
||||
- **WebTorrent** - Torrent indirme yönetimi
|
||||
- **WebSocket (ws)** - Gerçek zamanlı ilerleme güncellemeleri
|
||||
- **Multer** - Dosya upload işlemleri
|
||||
- **JWT (jsonwebtoken)** - Kimlik doğrulama
|
||||
- **ffmpeg/ffprobe** - Video thumbnail oluşturma ve medya bilgisi çıkarma
|
||||
- **TMDB API** - Film metadatası (poster, backdrop, özet)
|
||||
- **TVDB API** - Dizi metadatası
|
||||
- **Fanart.tv API** - Dizi backdrop görselleri
|
||||
- **yt-dlp** - YouTube video indirme
|
||||
|
||||
### Frontend (Svelte)
|
||||
- **Svelte 4** - UI framework
|
||||
- **svelte-routing** - İstemci tarafı yönlendirme
|
||||
- **Vite** - Build aracı
|
||||
- **FontAwesome** - İkonlar
|
||||
- **WebSocket** - Gerçek zamanlı güncellemeler
|
||||
|
||||
---
|
||||
|
||||
## 📡 API Endpoint'leri
|
||||
|
||||
| Method | Endpoint | Açıklama |
|
||||
|--------|----------|-----------|
|
||||
| `GET` | `/api/health` | Sağlık kontrolü |
|
||||
| `GET` | `/api/profile` | Profil bilgileri |
|
||||
| `POST` | `/api/profile/avatar` | Avatar yükleme |
|
||||
| `GET` | `/api/torrents` | Aktif torrent listesi |
|
||||
| `POST` | `/api/transfer` | Torrent/magnet ekleme |
|
||||
| `POST` | `/api/youtube/download` | YouTube indirme |
|
||||
| `POST` | `/api/torrents/:hash/select/:index` | Dosya seçimi |
|
||||
| `DELETE` | `/api/torrents/:hash` | Torrent silme |
|
||||
| `POST` | `/api/torrents/:hash/toggle` | Tek torrent durdur/devam |
|
||||
| `POST` | `/api/torrents/toggle-all` | Tüm torrentleri durdur/devam |
|
||||
| `GET` | `/api/files` | Dosya gezgini |
|
||||
| `GET` | `/api/movies` | Film listesi |
|
||||
| `GET` | `/api/tvshows` | Dizi listesi |
|
||||
| `GET` | `/api/music` | Müzik listesi |
|
||||
| `GET` | `/api/trash` | Çöp kutusu |
|
||||
| `POST` | `/api/trash/restore` | Çöpten geri yükle |
|
||||
| `DELETE` | `/api/trash` | Çöpten kalıcı sil |
|
||||
| `POST` | `/api/file/move` | Dosya taşıma |
|
||||
| `GET` | `/api/disk-space` | Disk alanı bilgisi |
|
||||
| `GET` | `/api/search/metadata` | TMDB/TVDB arama |
|
||||
| `GET` | `/stream/:hash` | Video akışı |
|
||||
| `GET` | `/media/:path(*)` | Genel medya sunumu |
|
||||
| `GET` | `/thumbnails/:path(*)` | Thumbnail sunumu |
|
||||
| `WS` | `ws://host/?token=...` | WebSocket bağlantısı |
|
||||
|
||||
---
|
||||
|
||||
## 🔄 WebSocket Mesajları
|
||||
|
||||
```javascript
|
||||
// İlerleme güncellemesi
|
||||
{ type: "progress", torrents: [...] }
|
||||
|
||||
// Dosya güncellemesi
|
||||
{ type: "fileUpdate", path: "rootFolder" }
|
||||
|
||||
// Disk alanı güncellemesi
|
||||
{ type: "diskSpace", data: {...} }
|
||||
|
||||
// Medya tespiti
|
||||
{ type: "mediaDetected", rootFolder, hasSeriesEpisodes, hasMovieMatch }
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎬 Temel Özellikler
|
||||
|
||||
### 1. Torrent Yönetimi
|
||||
- `.torrent` dosyası veya magnet link ile ekleme
|
||||
- Gerçek zamanlı indirme ilerleme takibi
|
||||
- Tekil veya toplu durdurma/devam ettirme
|
||||
- Dosya seçimi (birden fazla dosya içeren torrentler için)
|
||||
|
||||
### 2. YouTube İndirme
|
||||
- YouTube URL'sinden video/ses indirme
|
||||
- Çözünürlük seçimi (1080p, 720p, 480p, vb.)
|
||||
- Sadece ses indirme seçeneği
|
||||
- Cookie desteği
|
||||
|
||||
### 3. Medya Yönetimi
|
||||
- **Filmler**: TMDB'den otomatik metadata çekme (poster, backdrop, özet)
|
||||
- **Diziler**: TVDB'den sezon/bölüm bilgileri
|
||||
- **Müzik**: YouTube indirmeleri için müzik kütüphanesi
|
||||
- **Thumbnail**: Otomatik video/resim küçük resim oluşturma
|
||||
|
||||
### 4. Dosya Yönetimi
|
||||
- Dosya gezgini
|
||||
- Dosya taşıma
|
||||
- Çöp kutusu (geri yükleme ve kalıcı silme)
|
||||
- `.ignoreFiles` ile dosya filtreleme
|
||||
|
||||
### 5. Video Oynatıcı
|
||||
- Özel modal video oynatıcı
|
||||
- Altyazı desteği (.srt, .vtt)
|
||||
- Ses kontrolü
|
||||
- Tam ekran desteği
|
||||
- İndirme butonu
|
||||
|
||||
### 6. Kimlik Doğrulama
|
||||
- JWT tabanlı auth
|
||||
- Token refresh mekanizması
|
||||
- Profil yönetimi (avatar yükleme)
|
||||
|
||||
---
|
||||
|
||||
## 🗂️ Veri Yapısı
|
||||
|
||||
### info.json (Her torrent klasöründe)
|
||||
```json
|
||||
{
|
||||
"infoHash": "...",
|
||||
"name": "Torrent Adı",
|
||||
"tracker": "...",
|
||||
"added": 1234567890,
|
||||
"folder": "klasor_adi",
|
||||
"completedAt": 1234567890,
|
||||
"type": "movie|tv|music|video",
|
||||
"files": {
|
||||
"dosya.mp4": {
|
||||
"size": 123456789,
|
||||
"extension": "mp4",
|
||||
"mediaInfo": {...},
|
||||
"type": "movie"
|
||||
}
|
||||
},
|
||||
"primaryVideoPath": "dosya.mp4",
|
||||
"primaryMediaInfo": {...},
|
||||
"seriesEpisodes": {...}
|
||||
}
|
||||
```
|
||||
|
||||
### .trash (Çöp yönetimi)
|
||||
```json
|
||||
{
|
||||
"updatedAt": 1234567890,
|
||||
"items": [
|
||||
{
|
||||
"path": "dosya.mp4",
|
||||
"originalPath": "klasor/dosya.mp4",
|
||||
"deletedAt": 1234567890,
|
||||
"isDirectory": false,
|
||||
"type": "video/mp4"
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Frontend Store Yapısı
|
||||
|
||||
### Svelte Stores
|
||||
- `movieStore` - Film sayacı
|
||||
- `tvStore` - Dizi sayacı
|
||||
- `musicStore` - Müzik sayacı
|
||||
- `trashStore` - Çöp öğeleri
|
||||
- `avatarStore` - Avatar URL
|
||||
- `searchStore` - Arama sorgusu
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Çalışma Mantığı
|
||||
|
||||
1. **Başlangıç**: Sunucu başladığında mevcut torrentler diskten yüklenir
|
||||
2. **Torrent Ekleme**: `.torrent` veya magnet → WebTorrent client'e ekle → WebSocket ile ilerleme bildirimi
|
||||
3. **İndirme Tamamlandı**:
|
||||
- Video thumbnail'ları oluşturulur
|
||||
- Medya bilgisi (ffprobe) çıkarılır
|
||||
- TMDB/TVDB'den metadata çekilir
|
||||
- info.json güncellenir
|
||||
4. **Frontend**: WebSocket üzerinden gerçek zamanlı güncellemeler alır, UI'yi günceller
|
||||
5. **Video Oynatma**: `/stream/:hash` endpoint'i üzerinden video akışı sağlanır
|
||||
|
||||
---
|
||||
|
||||
## 🔐 Güvenlik
|
||||
|
||||
- JWT tabanlı kimlik doğrulama
|
||||
- Token refresh mekanizması
|
||||
- Path sanitization (traversal koruması)
|
||||
- Dosya tipi ve boyut kısıtlamaları
|
||||
- CORS yapılandırması
|
||||
|
||||
---
|
||||
|
||||
## 📦 Docker Entegrasyonu
|
||||
|
||||
```yaml
|
||||
# docker-compose.yml
|
||||
services:
|
||||
dupe:
|
||||
build: .
|
||||
ports:
|
||||
- "3001:3001"
|
||||
volumes:
|
||||
- ./server/downloads:/app/server/downloads
|
||||
- ./server/cache:/app/server/cache
|
||||
environment:
|
||||
- TMDB_API_KEY
|
||||
- TVDB_API_KEY
|
||||
- YT_DLP_BIN
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎨 UI/UX Özellikleri
|
||||
|
||||
- Responsive tasarım (mobil uyumlu)
|
||||
- Hamburger menü (mobile)
|
||||
- Drag & drop torrent yükleme
|
||||
- Modal video oynatıcı
|
||||
- İlerleme çubukları
|
||||
- Thumbnail önizlemeler
|
||||
- Gerçek zamanlı hız göstergeleri
|
||||
|
||||
---
|
||||
|
||||
## 📂 Önemli Dosyalar
|
||||
|
||||
| Dosya | Açıklama |
|
||||
|-------|----------|
|
||||
| `server/server.js` | Ana backend sunucusu (~7100 satır) |
|
||||
| `client/src/App.svelte` | Ana uygulama bileşeni |
|
||||
| `client/src/routes/Transfers.svelte` | Torrent yönetim arayüzü |
|
||||
| `client/src/utils/api.js` | API yardımcı fonksiyonları |
|
||||
| `client/src/stores/*.js` | Svelte state yönetimi |
|
||||
| `server/modules/auth.js` | Kimlik doğrulama modülü |
|
||||
| `server/modules/websocket.js` | WebSocket sunucusu |
|
||||
|
||||
---
|
||||
|
||||
## 🔍 Geliştirme Notları
|
||||
|
||||
### Ortam Değişkenleri
|
||||
```bash
|
||||
PORT=3001
|
||||
TMDB_API_KEY=...
|
||||
TVDB_API_KEY=...
|
||||
FANART_TV_API_KEY=...
|
||||
YT_DLP_BIN=/usr/local/bin/yt-dlp
|
||||
YT_DLP_COOKIES=/path/to/cookies.txt
|
||||
VITE_API=http://localhost:3001
|
||||
```
|
||||
|
||||
### Bağımlılıklar
|
||||
- **ffmpeg** ve **ffprobe** kurulu olmalıdır
|
||||
- **yt-dlp** (YouTube indirmeleri için)
|
||||
- **Node.js** v18+
|
||||
|
||||
---
|
||||
|
||||
*Rapor oluşturma tarihi: 24 Aralık 2024*
|
||||
Reference in New Issue
Block a user