w

Kurulum Rehberi

Platformumuza hoş geldiniz. Bu rehber, mevcut tüm araçları ve işlevleri yapılandırmanıza ve kullanmaya başlamanıza yardımcı olacaktır.

Sistem Gereksinimleri

Desteklenen Tarayıcılar

  • Chrome 90+
  • Firefox 88+
  • Safari 14+
  • Edge 90+

Mobil Cihazlar

  • iOS 14+
  • Android 8+
  • Modern mobil tarayıcılar

Ağ Gereksinimleri

  • Kararlı internet bağlantısı
  • Minimum bant genişliği: 1 Mbps
  • Önerilen: 5+ Mbps daha iyi deneyim için

Yerel Kurulum (Geliştiriciler)

Ön Gereksinimler

  • Node.js 18.0+
  • pnpm 8.0+
  • Git 2.30+

Kurulum Adımları

  1. Depoyu Klonlayın
    git clone https://github.com/your-org/woker-job.git
    cd woker-job
    
  2. Bağımlılıkları Yükleyin
    pnpm install
    
  3. Ortam Değişkenlerini Yapılandırın
    cp .env.example .env
    # Ayarlarınızla .env'yi düzenleyin
    
  4. Hizmetleri Başlatın
    # Backend'i başlat
    pnpm --filter back-end dev
    
    # Başka bir terminalde frontend'i başlat
    pnpm --filter web dev
    
  5. Kurulumu Doğrulayın

Geliştirme Yapılandırması

Proje Yapısı

woker-job/
├── apps/
│   ├── back-end/     # NestJS API
│   └── web/          # Nuxt.js Frontend
├── packages/         # Paylaşılan paketler
└── docs/            # Dokümantasyon

Mevcut Scriptler

# Geliştirme
pnpm dev              # Tüm hizmetleri başlat
pnpm build            # Üretim için derle
pnpm test             # Testleri çalıştır
pnpm lint             # Kodu kontrol et

# İçerik yönetimi
pnpm content:check    # Çok dilli içerik senkronizasyonunu kontrol et
pnpm content:init     # Dil yapısını başlat

Üretim Yapılandırması

Docker (Önerilen)

# Görüntü oluştur
docker build -t woker-job .

# Konteyner çalıştır
docker run -p 3000:3000 woker-job

Manuel Dağıtım

  1. Uygulamayı Derleyin
    pnpm build
    
  2. Sunucuyu Yapılandırın
    • Node.js 18+
    • PM2 veya süreç yönetimi için benzer
    • Ters proxy için Nginx
  3. Üretim Ortam Değişkenleri
    NODE_ENV=production
    DATABASE_URL=your_database_url
    JWT_SECRET=your_jwt_secret
    

Veritabanı Yapılandırması

PostgreSQL (Önerilen)

# PostgreSQL yükle
sudo apt-get install postgresql postgresql-contrib

# Veritabanı oluştur
sudo -u postgres createdb woker_job

# Migrasyonları çalıştır
pnpm migration:run

SQLite (Geliştirme)

# .env'de yapılandır
DATABASE_URL="file:./dev.db"

Kimlik Doğrulama Yapılandırması

OAuth 2.0

  1. Sağlayıcıları Yapılandırın
    • Google OAuth
    • GitHub OAuth
    • Microsoft OAuth
  2. Ortam Değişkenleri
    GOOGLE_CLIENT_ID=your_google_client_id
    GOOGLE_CLIENT_SECRET=your_google_client_secret
    GITHUB_CLIENT_ID=your_github_client_id
    GITHUB_CLIENT_SECRET=your_github_client_secret
    

JWT

JWT_SECRET=your_jwt_secret_key
JWT_EXPIRES_IN=7d

E-posta Yapılandırması

SMTP

SMTP_HOST=smtp.gmail.com
SMTP_PORT=587
SMTP_USER=your_email@gmail.com
SMTP_PASS=your_app_password

E-posta Hizmetleri

  • SendGrid: Toplu gönderim için
  • Mailgun: İşlem e-postaları için
  • AWS SES: Ölçeklenebilirlik için

Depolama Yapılandırması

Yerel

STORAGE_TYPE=local
STORAGE_PATH=./uploads

Bulut Depolama

# AWS S3
STORAGE_TYPE=s3
AWS_ACCESS_KEY_ID=your_access_key
AWS_SECRET_ACCESS_KEY=your_secret_key
AWS_REGION=us-east-1
AWS_BUCKET=your_bucket_name

# Google Cloud Storage
STORAGE_TYPE=gcs
GCS_PROJECT_ID=your_project_id
GCS_BUCKET=your_bucket_name

İzleme Yapılandırması

Günlükler

LOG_LEVEL=info
LOG_FORMAT=json

Metrikler

  • Prometheus: Sistem metrikleri için
  • Grafana: Görselleştirme için
  • Sentry: Hata izleme için

Güvenlik Yapılandırması

HTTPS

# SSL sertifikaları oluştur
openssl req -x509 -newkey rsa:4096 -keyout key.pem -out cert.pem -days 365

Güvenlik Başlıkları

// Nuxt.js'de yapılandır
export default {
  serverMiddleware: [{ path: '/api', handler: '~/server-middleware/security.js' }],
};

Önbellek Yapılandırması

Redis

REDIS_URL=redis://localhost:6379
REDIS_PASSWORD=your_redis_password

Önbellek Yapılandırması

// NestJS'de yapılandır
import { CacheModule } from '@nestjs/cache-manager';
import { redisStore } from 'cache-manager-redis-store';

CacheModule.register({
  store: redisStore,
  host: 'localhost',
  port: 6379,
});

İş Kuyruğu Yapılandırması

Bull Queue

REDIS_URL=redis://localhost:6379
QUEUE_PREFIX=woker-job

Kuyruk Yapılandırması

// NestJS'de yapılandır
import { BullModule } from '@nestjs/bull';

BullModule.registerQueue({
  name: 'email',
  redis: {
    host: 'localhost',
    port: 6379,
  },
});

Kurulum Doğrulaması

Otomatik Testler

# Birim testleri
pnpm test:unit

# Entegrasyon testleri
pnpm test:integration

# End-to-end testleri
pnpm test:e2e

Manuel Doğrulama

  1. API'yi Doğrulayın
    curl http://localhost:3000/health
    
  2. Frontend'i Doğrulayın
    • http://localhost:3001 adresini açın
    • Tüm sayfaların yüklendiğini doğrulayın
    • Temel işlevleri test edin
  3. Veritabanını Doğrulayın
    pnpm db:test
    

Sorun Giderme

Yaygın Sorunlar

Port Kullanımda Hatası

# Portu kullanan işlemi bul
lsof -i :3000

# İşlemi sonlandır
kill -9 <PID>

Bağımlılık Hatası

# Önbelleği temizle
pnpm store prune

# Bağımlılıkları yeniden yükle
rm -rf node_modules
pnpm install

Veritabanı Hatası

# Bağlantıyı doğrula
pnpm db:ping

# Veritabanını sıfırla
pnpm db:reset

Hata Ayıklama Günlükleri

# Gerçek zamanlı günlükleri görüntüle
pnpm logs

# Belirli günlükleri görüntüle
pnpm logs:api
pnpm logs:web

Güncellemeler

Otomatik Güncelleme

# Bağımlılıkları güncelle
pnpm update

# Uygulamayı güncelle
git pull origin main
pnpm install
pnpm build

Veritabanı Migrasyonları

# Migrasyon oluştur
pnpm migration:generate

# Migrasyonları çalıştır
pnpm migration:run

# Migrasyonu geri al
pnpm migration:revert

Destek

Yardım Kaynakları

İletişim

Sonraki Adımlar

  1. Alan Adını Yapılandırın
    • DNS yapılandırın
    • SSL yapılandırın
    • CDN yapılandırın
  2. İzlemeyi Yapılandırın
    • Uyarıları yapılandırın
    • Panelleri yapılandırın
    • Yedeklemeleri yapılandırın
  3. Ölçeklenebilirliği Yapılandırın
    • Yük dengeleyici yapılandırın
    • Otomatik ölçeklendirme yapılandırın
    • Mikroservisler yapılandırın

Son Güncelleme: Aralık 2024 Sürüm: 1.0.0

Was this page helpful?