🚀 Nsosyal Desktop - Profesyonel Linux İstemcisi + Yerel Sunucu

Teknofest Nsosyal platformu için gelişmiş özelliklerle donatılmış profesyonel masaüstü uygulaması. Yerel sunucu desteği ile tam kontrol!

✨ Özellikler

🖥️ Yerel Sunucu Desteği (YENİ!)

• Docker ile Tam Kontrol - Kendi sunucunuzu çalıştırın
• Kaynak Kodu Entegrasyonu - Next_Sosyal_Beta otomatik entegre
• Mastodon Fork - Tam özellikli sosyal medya platformu
• PostgreSQL + Redis - Profesyonel veritabanı altyapısı
• Hot Reload - Anlık geliştirme desteği

🎨 Gelişmiş Görünüm

• Özel CSS Injection - İyileştirilmiş tasarım ve daha küçük butonlar
• Ayarlanabilir Zoom - 50% - 200% arası zoom desteği
• Karanlık Mod - Göz yorgunluğunu azaltır
• Otomatik Font Smoothing - Daha net metin görüntüleme
• Özel Scrollbar - Modern ve şık scrollbar tasarımı

⚙️ Profesyonel Özellikler

• Çift Sunucu Modu - Yerel ve uzak sunucu arası geçiş (Ctrl+L)
• Sistem Tepsisi Entegrasyonu - Arka planda çalışma
• Pencere Konumu Hafızası - Son konumunuzu hatırlar
• Oturum Yönetimi - Giriş bilgileriniz korunur
• Bildirim Desteği - Masaüstü bildirimleri
• Gizli Kapanma - Kapatma butonu uygulamayı gizler

🎮 Kontroller

• Tam Klavye Desteği - 15+ klavye kısayolu
• Fare Jestleri - Geri/İleri için fare butonları
• Tam Ekran Modu - Dikkat dağıtmayan deneyim
• Hızlı Gezinme - İleri/Geri navigasyon

📦 Kurulum

Gereksinimler

• Node.js 16+ ve npm
• Docker ve Docker Compose (yerel sunucu için)
• En az 4GB RAM, 10GB disk alanı

Otomatik Kurulum

cd /home/takamura/Desktop/lnsosyal
npm install

🚀 Çalıştırma

Uzak Sunucu (Varsayılan)

npm start

Yerel Sunucu (Docker)

1. Uygulamayı başlat: npm start
2. Ctrl+, ile ayarlara gir
3. "Yerel Sunucu Kullan" seçeneğini aç
4. Kaydet ve uygulamayı yeniden başlat

VEYA menüden:

• Ctrl+L - Yerel/Uzak sunucu arası geçiş

🐳 Docker ile Yerel Sunucu

Proje otomatik olarak Next_Sosyal_Beta klasöründeki kaynak kodları kullanır.

Container'lar

• web - Rails web sunucusu (port 3000)
• db - PostgreSQL veritabanı
• redis - Redis cache
• sidekiq - Arka plan işleri
• streaming - WebSocket sunucusu (port 4000)

Manuel Başlatma

docker-compose up

Manuel Durdurma

docker-compose down

⌨️ Klavye Kısayolları

Temel

• Ctrl+H - Ana sayfaya dön
• Ctrl+L - Yerel/Uzak sunucu değiştir
• Ctrl+R - Sayfayı yenile
• Ctrl+Q - Uygulamadan çık
• Ctrl+, - Ayarlar

Görünüm

• F11 - Tam ekran
• Alt - Menü çubuğunu göster/gizle
• Ctrl+Plus - Yakınlaştır
• Ctrl+- - Uzaklaştır
• Ctrl+0 - Normal boyut

Gezinme

• Alt+Left - Geri
• Alt+Right - İleri

Geliştirici

• Ctrl+Shift+I - Geliştirici araçları

📁 Proje Yapısı

lnsosyal/
├── src/
│   ├── main.js              # Ana Electron dosyası
│   ├── preload.js           # Güvenli iletişim katmanı
│   ├── config.js            # Ayarlar yönetimi
│   ├── tray.js              # Sistem tepsisi
│   ├── local-server.js      # Yerel sunucu yönetimi
│   ├── utils/
│   │   └── customCSS.js     # CSS injection
│   └── renderer/
│       ├── settings.html    # Ayarlar arayüzü
│       ├── settings.css     # Ayarlar tasarımı
│       ├── settings.js      # Ayarlar mantığı
│       └── loading.html     # Yükleme ekranı
├── assets/
│   ├── icon.png
│   └── icon.svg
├── Next_Sosyal_Beta/        # Kaynak kodlar (Mastodon fork)
├── docker-compose.yml       # Docker yapılandırması
├── package.json
└── README.md

🔧 Teknolojiler

Desktop Client

• Electron 27 - Çapraz platform masaüstü framework
• electron-store - Ayarlar ve veri saklama
• electron-builder - Build ve paketleme

Yerel Sunucu

• Ruby on Rails - Backend framework
• React - Frontend framework
• PostgreSQL - Veritabanı
• Redis - Cache ve queue
• Docker - Containerization

🔨 Build (Derleme)

AppImage (Evrensel)

Tüm Linux dağıtımlarında çalışır, kurulum gerektirmez:

npm run build:appimage

DEB Paketi (Ubuntu/Debian)

npm run build:deb

Her İkisi Birden

npm run build:linux

Derlenmiş dosyalar dist/ klasöründe oluşur.

💡 Kullanım İpuçları

Yerel Sunucu

1. İlk Başlatma: 5-10 dakika sürebilir (Docker image indirme)
2. Veritabanı: İlk başlatmada otomatik migrate edilir
3. Geliştirme: Kodları değiştirdiğinizde hot reload aktif
4. Port Çakışması: 3000, 4000, 5432, 6379 portları boş olmalı

Genel

1. Sistem Tepsisi: X butonuna basarak gizleyin, sistem tepsisinden "Çıkış" ile kapatın
2. Zoom Ayarı: Butonlar çok büyükse, Ctrl+, ile ayarlara girin ve zoom'u düşürün (önerilen: 80-90%)
3. Özel CSS: Tasarımı beğenmediyseniz, ayarlardan "Özel Tasarım" seçeneğini kapatın
4. Performans: Yerel sunucu 4GB+ RAM kullanabilir

🐛 Sorun Giderme

Yerel sunucu başlamıyor

docker --version
docker-compose --version
sudo systemctl start docker
docker-compose up

Port zaten kullanımda

sudo lsof -i :3000
sudo kill -9 <PID>

Container hataları

docker-compose down
docker-compose up --build

Veritabanı hataları

docker-compose down -v
docker-compose up

📝 Geliştirme

Yerel sunucuda geliştirme yapmak için:

cd Next_Sosyal_Beta/Next_Sosyal_Beta
docker-compose up

Kod değişiklikleri otomatik yansır.

📄 Lisans

MIT

🙏 Teşekkürler

Bu proje Teknofest Nsosyal platformu için bağımsız olarak geliştirilmiştir ve resmi bir ürün değildir.

Nsosyal kaynak kodları Mastodon açık kaynak projesinin fork'udur.