Misafir adlı üyeden alıntı: mesajı görüntüle
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:

A’dan Z’ye 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 checklist’lerini

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ı API’den 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

2–3 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.