SOSYAL PLATFORM MASTER DOKÜMANTASYONU (TAM & ÖLÇEKLENEBİLİR)
1. AMAÇ VE KAPSAM
Bu doküman;
Instagram + Discord + TeamSpeak mantığını birleştiren, tamamen web tabanlı,
gerçek zamanlı (realtime) çalışan bir sosyal platformun:
Adan Zye teknik mimarisini
Yetkilendirme ve güvenlik modelini
WebRTC (sesli / görüntülü) akışlarını
Final dosya ve klasör yapısını
cPanel üzerinden canlıya çıkış sürecini
Test checklistlerini
Ve bugünden itibaren 10 milyon → 100 milyon → 1 milyar kullanıcıya ölçeklenebilir olacak şekilde alınmış mimari kararları
detaylı biçimde tanımlar.
Bu doküman demo veya POC değildir,
doğrudan üretim (production) vizyonu ile hazırlanmıştır.
2. PROJE GENEL TANIMI
Bu proje;
❌ Bu doküman web platformunu kapsar. Mobil ve masaüstü uygulamalar aynı backend & realtime altyapısını kullanacak şekilde ileride geliştirilecektir.
✅ Web tabanlıdır (desktop-first)
✅ Mobil tarayıcı uyumludur
✅ Sayfa yenilemeden çalışan tamamen realtime bir sistemdir
✅ Kendi altyapısını kullanır (Pusher, Firebase vb. YOK)
✅ Node.js + Socket.IO + WebRTC temellidir
✅ Instagram (feed) + Discord (chat) + TeamSpeak (sesli oda) mantıklarını tek sistemde birleştirir
Temel İlke
Sistemde yapılan her aksiyon, diğer kullanıcılara anlık olarak yansır.
Sayfa yenileme, manuel refresh veya polling yoktur.
3. TEKNOLOJİ VE ALTYAPI
Backend
Node.js
Express.js
Socket.IO (gerçek zamanlı iletişim)
WebRTC (sesli / görüntülü iletişim)
JWT Authentication
Role Based Access Control (RBAC)
MySQL / MariaDB
cPanel Node.js App (terminal yok varsayımıyla uyumlu) / Sunucular ile de yapılabilir
Frontend
Saf HTML / CSS / JavaScript
SPA benzeri davranış
SVG tabanlı ikonlar
Desktop-first layout
Socket.IO ile gerçek zamanlı UI güncellemeleri
4. ÖLÇEKLENEBİLİRLİK VİZYONU (BUGÜNDEN → 1B KULLANICI)
Bu sistem ilk günden itibaren aşağıdaki prensiplere göre tasarlanır:
Stateless backend (server üzerinde kalıcı state tutulmaz)
Event-driven mimari
Media (ses/görüntü) katmanı APIden ayrıştırılabilir
Global ID stratejisi (UUID / ULID / Snowflake)
Repository & service layer ayrımı
WebRTC katmanı soyutlanmış yapıdadır
Kod tek sunucu, çok sunucu, cluster ve region bazlı çalışmaya hazırdır
Kod bir kez yazılır, ölçek büyürken geri dönülüp yeniden yazılmaz.
Değişen şey kod değil, altyapıdır.
5. ROL VE YETKİ SİSTEMİ
Roller
SUPER_ADMIN
ADMIN
MODERATOR
SUPPORT (Trust & Safety)
VERIFIED
USER
RESTRICTED
BANNED
Yetkilendirme Prensibi
auth.middleware.js → Kimlik doğrulama (JWT)
*.policy.js → İşlem bazlı yetki kontrolü
Controller katmanı asla karar vermez.
Tüm kararlar Policy katmanında alınır.
6. AUTH & USER AKIŞI
Register
auth.routes.js
auth.controller.js
auth.service.js
user.model.js
JWT + refresh token
Login
Token üretimi
Socket authentication (auth.socket.js)
7. POST / COMMENT / FEED SİSTEMİ
Post CRUD
Zamanlı paylaşım / Taslağa alma / Hemen Paylaşma / Kişiye özel paylaşım / Arka plan bulanık görüntü gözükmez ücretli paylaşım sistem içerisinde yıldız,kredi veya bir başka birşey satılır post atıyorum 50 yıldız karşılığında görüntülenir gibi
Çoklu görsel / video
Like, repost, save (Socket.IO ile anlık)
Yorum & yanıt (ilk 20 + load more)
AI destekli moderasyon
8. CHAT SİSTEMİ (DISCORD / TEAMSPEAK MANTIĞI)
DM (Birebir)
Anlık mesajlaşma
Medya
Sesli mesaj (600 sn)
Okundu bilgisi
ROOMS (Oda / Kanal)
Oda & kanal yapısı
Presence (kim odada?)
Yetkili giriş
Sesli / görüntülü iletişim (WebRTC)
TeamSpeak benzeri sürekli açık odalar
9. WEBRTC AKIŞI
Oda oluşturulur
Socket bağlantısı kurulur
Offer / Answer
ICE candidate paylaşımı
Media stream başlar
WebRTC katmanı ileride SFU (Media Server) ile çalışacak şekilde soyutlanmıştır.
10. BİLDİRİM SİSTEMİ
Like
Comment
Follow
DM
Sistem bildirimleri
Özellikler:
Kullanıcı bazlı kapatma
Realtime + DB kayıtlı
Queue ile yoğunluk kontrolü
11. EXPLORE & SEARCH (AI DESTEKLİ)
Explore
Davranış sinyalleri
Skorlama algoritması
Search
Arama geçmişi
AI destekli öneriler
12. VERIFIED (MAVİ TİK)
Evrak yükleme
Admin onayı
Verified badge
Keşfette öncelik
13. ADS (REKLAM SİSTEMİ)
Reklam hesabı
Kampanya
Hedefleme
Gösterim / tıklama analitiği
Ücretli içerik, reklam ve dijital ürünler aynı billing altyapısını paylaşır.
14. AI MODÜLLERİ
Moderation
Discovery
Support
Tüm AI kararları:
ai.logs.js içinde kayıt altına alınır
Super Admin tarafından ayarlanabilir
15. SUPPORT & SLA
Ticket sistemi
Canlı destek
SLA kuralları
Önceliklendirme (güvenlik, ödeme, genel)
16. GÜVENLİK
Rate limiting
IP block
Device fingerprint
Davranış analizi
Audit log (silinemez)
17. cPANEL ÜZERİNDEN CANLIYA ÇIKIŞ
Node.js App oluştur
Node.js 18+ seç
npm install
.env yapılandır
app.js entry point
Restart & test
18. FINAL DOSYA VE KLASÖR YAPISI (DOKUNULMAZ)
Aşağıda belirtilen yapı nihai (final) kabul edilir.
Yeni klasör açılmaz
Yapı değiştirilmez
Sadece mevcut klasörlerin içine dosya eklenir
/project-root
├─ src/
│ ├─ auth/
│ │ ├─ auth.controller.js → Giriş/Kayıt HTTP isteklerini yönetir
│ │ ├─ auth.service.js → Şifreleme ve JWT oluşturma mantığı
│ │ ├─ auth.routes.js → Kimlik doğrulama API uç noktaları
│ │ ├─ auth.middleware.js → JWT doğrulama ve rota koruma
│ │ ├─ auth.validator.js → Giriş verilerinin format kontrolü
│ │ └─ auth.socket.js → Socket.io bağlantı yetkilendirmesi (Realtime)
│ │
│ ├─ users/
│ │ ├─ user.controller.js → Kullanıcı arama/getirme işlemleri
│ │ ├─ user.service.js → Kullanıcı veritabanı sorgu mantığı
│ │ ├─ user.model.js → Kullanıcı veritabanı şeması (SQL/NoSQL)
│ │ ├─ user.routes.js → Kullanıcı yönetimi API yolları
│ │ ├─ user.policy.js → Yetki kontrolü (Kim neyi görebilir?)
│ │ └─ user.settings.js → Gizlilik ve kullanıcı tercihleri
│ │
│ ├─ profile/
│ │ ├─ profile.controller.js → Profil bilgilerini güncelleme
│ │ ├─ profile.service.js → Profil verisi işleme mantığı
│ │ ├─ profile.routes.js → Profil API yolları
│ │ ├─ profile.validator.js → Profil güncellenirken veri doğrulaması
│ │ └─ profile.media.js → Avatar ve Kapak fotoğrafı yükleme işlemleri
│ │
│ ├─ posts/
│ │ ├─ post.controller.js → Paylaşım oluşturma ve yönetme
│ │ ├─ post.service.js → Gönderi akışı ve DB işlemleri
│ │ ├─ post.model.js → Paylaşım veri modeli
│ │ ├─ post.routes.js → Paylaşım API yolları
│ │ ├─ post.policy.js → Gönderi gizlilik/erişim kontrolü
│ │ ├─ post.events.js → Paylaşım anında tetiklenen olaylar (Bildirim vb.)
│ │ ├─ post.validator.js → İçerik karakter/format kontrolü
│ │ ├─ post.media.js → Gönderiye ait görsel/video yönetimi
│ │ └─ post.scheduler.js → Zamanlanmış paylaşımların yönetimi
│ │
│ ├─ comments/
│ │ ├─ comment.controller.js → Yorum yazma ve silme işlemleri
│ │ ├─ comment.service.js → Yorum hiyerarşisi ve DB mantığı
│ │ ├─ comment.model.js → Yorum veri modeli
│ │ ├─ comment.routes.js → Yorum API yolları
│ │ ├─ comment.validator.js → Yorum içerik doğrulaması
│ │ └─ comment.moderation.js → AI destekli veya manuel yorum denetimi
│ │
│ ├─ chat/
│ │ ├─ chat.view.html → Ana Sohbet Arayüzü (WhatsApp/Insta Stili)
│ │ ├─ chat.controller.js → Sohbet verisi çekme ve sayfa yönetimi
│ │ ├─ chat.routes.js → Chat API yolları (Geçmiş, Medya gönderimi vb.)
│ │ ├─ chat.gateway.js → Merkezi Socket.io yönetimi (DM/Oda birleştirici)
│ │ ├─ css/
│ │ │ └─ chat.style.css → Arayüz Stilleri ve SVG konumlandırmaları
│ │ ├─ js/
│ │ │ ├─ chat.engine.js → Frontend UI render motoru (DOM güncelleyici)
│ │ │ └─ socket.client.js → İstemci tarafı realtime dinleyicisi
│ │ ├─ modals/
│ │ │ ├─ user-info.html → Profil detayı ve takip butonu modalı
│ │ │ ├─ media-viewer.html → Fotoğraf/Video zoom arayüzü
│ │ │ └─ search-user.html → Yeni DM başlatma arama ekranı
│ │ ├─ dm/
│ │ │ ├─ dm.socket.js → Birebir mesaj sinyalleri (Yazıyor, Görüldü)
│ │ │ ├─ dm.service.js → Özel mesaj veritabanı sorguları
│ │ │ ├─ dm.voice.js → Sesli mesaj kaydı ve Waveform desteği
│ │ │ ├─ dm.disappear.js → Kaybolan mesaj (Vanish Mode) mantığı
│ │ │ └─ dm.media.js → Tek seferlik görüntülenen medya yönetimi
│ │ ├─ rooms/
│ │ │ ├─ room.controller.js → Grup odası oluşturma ve yönetme
│ │ │ ├─ room.presence.js → Grupta kimler online? Takibi
│ │ │ ├─ room.routes.js → Grup API yolları
│ │ │ ├─ room.service.js → Grup odası ve üyelik sorguları
│ │ │ ├─ room.socket.js → Grup içi anlık mesaj yayını (Broadcast)
│ │ │ └─ room.webrtc.js → Grup içi sesli/görüntülü görüşme altyapısı
│ │ ├─ channels/
│ │ │ ├─ channel.service.js → Kanal veritabanı işlemleri
│ │ │ ├─ channel.socket.js → Sadece admin yayını ve üye tepkileri
│ │ │ ├─ channel.policy.js → Yazma yetkisi (Sadece sahip) kontrolü
│ │ │ └─ channel.media.js → Kanal özelinde toplu medya dosyaları
│ │ └─ servers/
│ │ ├─ server.socket.js → Hiyerarşik ağaç yapısı güncellemeleri
│ │ ├─ server.service.js → Sunucu ve alt kanal sorguları
│ │ ├─ server.tree.js → Kompleks ağaç yapısı algoritması
│ │ ├─ server.voice.js → Odadan odaya geçişli 3D ses mantığı
│ │ └─ server.permissions.js → Sunucu içi hiyerarşik yetki yönetimi
│ │
│ ├─ notifications/
│ │ ├─ notification.service.js → Bildirim oluşturma mantığı
│ │ ├─ notification.socket.js → Anlık bildirim gönderimi
│ │ ├─ notification.routes.js → Bildirim geçmişi API yolları
│ │ ├─ notification.settings.js→ Kullanıcı bildirim tercihleri
│ │ └─ notification.queue.js → Yoğun saatlerde bildirim kuyruklama
│ │
│ ├─ explore/
│ │ ├─ explore.controller.js → Keşfet sayfası yönetimi
│ │ ├─ explore.ai.js → İlgi alanına göre içerik öneren AI
│ │ ├─ explore.routes.js → Keşfet API yolları
│ │ └─ explore.signals.js → Kullanıcı davranış sinyalleri takibi
│ │
│ ├─ search/
│ │ ├─ search.controller.js → Genel arama motoru yönetimi
│ │ ├─ search.ai.js → Akıllı arama ve öneri motoru
│ │ ├─ search.routes.js → Arama API yolları
│ │ └─ search.history.js → Kullanıcı arama geçmişi yönetimi
│ │
│ ├─ ads/
│ │ ├─ adAccount.controller.js → Reklam veren hesap yönetimi
│ │ ├─ campaign.controller.js → Reklam kampanyası yönetimi
│ │ ├─ billing.service.js → Ödeme ve faturalandırma sistemi
│ │ ├─ ads.routes.js → Reklam API yolları
│ │ ├─ ads.policy.js → Reklam yayın politikası kontrolü
│ │ ├─ ads.analytics.js → Tıklama ve gösterim analitiği
│ │ └─ ads.targeting.js → Hedef kitle belirleme mantığı
│ │
│ ├─ security/
│ │ ├─ audit.log.js → Kritik işlem kayıtları (Audit Log)
│ │ ├─ behavior.monitor.js → Şüpheli kullanıcı davranışı izleme
│ │ ├─ rate.limit.js → API istek sınırlama (DDoS koruması)
│ │ ├─ ip.blocklist.js → Yasaklı IP yönetimi
│ │ ├─ device.fingerprint.js → Cihaz tanıma ve güvenli giriş
│ │ └─ security.middleware.js → Genel güvenlik filtreleri
│ │
│ ├─ config/
│ │ ├─ database.js → DB bağlantı yapılandırması
│ │ ├─ jwt.js → Token anahtarları ve süreleri
│ │ ├─ roles.js → Kullanıcı rol tanımlamaları
│ │ ├─ ai.js → AI servis konfigürasyonu
│ │ ├─ security.js → Güvenlik anahtarları
│ │ └─ app.js → Uygulama genel ayarları
│
│ ├─ routes.js → Tüm modüllerin rotalarını birleştiren dosya
│ ├─ loaders.js → Başlangıç servislerini yükleyici
│ ├─ app.js → Sunucu ana giriş dosyası (Entry Point)
│ └─ socket.js → Socket.io ana kurulum dosyası
│
├─ public/ → Dışarıya açık statik dosyalar
├─ storage/ → Yüklenen dosyalar ve logların saklandığı yer
├─ database/ → Veritabanı şemaları ve migration dosyaları
├─ .env.example → Çevre değişkenleri örnek dosyası
├─ package.json → Proje bağımlılıkları ve scriptler
└─ README.md → Proje dökümantasyonu
19. GELİŞTİRME PRENSİPLERİ (ÇOK ÖNEMLİ)
Adım adım ilerlenir
23 adım birden atlanmaz
Bir dosya final yazılır, sonradan geri dönülmez
Gerekirse:
Şu satırı bul, altına ekle şeklinde ilerlenir
Kodlar eksiksiz ve çalışır şekilde teslim edilir
20. SON SÖZ
Bu proje:
Hayal değildir
Demo değildir
Basit bir proje değildir
Bu doküman;
gerçek, ölçeklenebilir, uzun ömürlü bir sosyal platformun teknik anayasasıdır.
Yapay ZEKA ile yazdırdım bunları bu mantıga göre sisteme göre bunu yapabilecek biri varmı varsa fiyat teklifi nedir ?
Cpanel Ve Statless Back-end biraz çelişkili hocam kullanmak istediğiniz teknoloji ile. Yeniden detaylandırmak ve fiyat almak isterseniz pm iletebilirsiniz.