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ı
- Depoyu Klonlayın
git clone https://github.com/your-org/woker-job.git cd woker-job
- Bağımlılıkları Yükleyin
pnpm install
- Ortam Değişkenlerini Yapılandırın
cp .env.example .env # Ayarlarınızla .env'yi düzenleyin
- 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
- Kurulumu Doğrulayın
- Backend: http://localhost:3000
- Frontend: http://localhost:3001
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
- Uygulamayı Derleyin
pnpm build
- Sunucuyu Yapılandırın
- Node.js 18+
- PM2 veya süreç yönetimi için benzer
- Ters proxy için Nginx
- Ü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
- Sağlayıcıları Yapılandırın
- Google OAuth
- GitHub OAuth
- Microsoft OAuth
- 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
- API'yi Doğrulayın
curl http://localhost:3000/health
- 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
- 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
- E-posta: support@example.com
- Teknik Destek: tech@example.com
- Ticari: sales@example.com
Sonraki Adımlar
- Alan Adını Yapılandırın
- DNS yapılandırın
- SSL yapılandırın
- CDN yapılandırın
- İzlemeyi Yapılandırın
- Uyarıları yapılandırın
- Panelleri yapılandırın
- Yedeklemeleri yapılandırın
- Ö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