Yol Arkadaşı

TÖMER hazırlık yılı için hazırlanan öğrenci projesi. Uluslararası öğrencileri Türk aileleri, Türk öğrenciler ve deneyimli yabancı öğrencilerle buluşturan bir web platformu.

Bu sürüm gerçek bir backend (Node.js sunucusu) içerir: üyelik, giriş yapma, etkinlik oluşturma, katılma, bağlantı kurma gibi işlemler artık tarayıcıda değil sunucuda saklanır ve sayfa yenilense bile kaybolmaz.

Nasıl çalıştırılır

1. Bilgisayarınızda Node.js kurulu olmalı (sürüm 18 veya üstü). Kurulu olup olmadığını görmek için bir terminalde şunu çalıştırın:

   node -v
   

2. Bu klasörü terminalde açın ve sunucuyu başlatın:

   node server.js
   

3. Terminalde şu satırı görmelisiniz:

   Yol Arkadaşı sunucusu çalışıyor → http://localhost:3000
   

4. Tarayıcınızda http://localhost:3000 adresine gidin.

Ekstra bir paket kurmanıza (npm install) gerek yok — sunucu sadece Node.js'in kendi kütüphaneleriyle yazıldı.

Nasıl çalışır (mimari)

yol-arkadasi/
  server.js        ← Node.js HTTP sunucusu + JSON API (/api/...)
  data/db.json      ← veriler burada saklanır (sunucu ilk açılışta otomatik oluşturur)
  public/
    index.html      ← sayfanın iskeleti
    styles.css      ← tüm görsel tasarım
    app.js          ← arayüz mantığı, sunucudaki API'ye istek atar

• Üyelik ve giriş bilgileri şifrelenmiş olarak (scrypt ile) saklanır, düz metin şifre hiçbir yerde tutulmaz.
• Oturumlar tarayıcı çerezi (cookie) ile takip edilir; tarayıcı depolama alanı (localStorage) kullanılmaz.
• Tüm veriler data/db.json dosyasında tutulur. Bu dosyayı silerseniz uygulama örnek verilerle sıfırdan başlar.

Sunum/teslim için notlar

• Ekip sayfası şu an yer tutucu isimlerle geliyor (Takım Üyesi 1 vb.) — server.js dosyasındaki team dizisini kendi isimleriniz, rolleriniz ve kısa açıklamalarınızla güncelleyin.
• Bölge illüstrasyonları (İstanbul, Kapadokya vb.) gerçek fotoğraf yerine elle çizilmiş basit SVG görsellerdir. Kendi fotoğraflarınız varsa public/app.js içindeki art-wrap kısımlarını <img src="..."> ile değiştirebilirsiniz.
• Bu, okul projesi için hazırlanmış bir prototiptir. Gerçek bir yayına almadan önce düşünülmesi gerekenler: HTTPS, e-posta doğrulama, daha güçlü oturum yönetimi, ve büyük kullanıcı sayısı için gerçek bir veritabanı (PostgreSQL/MySQL gibi).

Sorun giderme

• "Bu port zaten kullanımda" hatası alırsanız: başka bir uygulama 3000 portunu kullanıyor olabilir. PORT=3001 node server.js şeklinde başka bir port deneyebilirsiniz.
• Sayfa açılıyor ama veriler gelmiyor: sunucunun hâlâ terminalde çalışır durumda olduğundan emin olun (pencereyi kapatmayın).