Yerel geliştirme kurulumu
Panel, worker ve frontend’i doğru port ve ortamla ayrı çalıştırın.
Gereksinimler
- Node.js 22 ve npm; Docker Compose için çalışan Docker ortamı.
- Ana panel için Postgres ve Redis. Medya kullanımı için ayrıca S3 uyumlu depolama.
- Yalnızca frontend / docs önizlemesi için Postgres, Redis veya Meta anahtarı gerekmez.
Paneli hazırlayın
PowerShell · depo kökünde
npm ci
Copy-Item .env.example .env.local
docker compose -f docker-compose.dev.yml up -dGeliştirme Compose’u Postgres’i 55432, Redis’i 56379 portunda açar. .env.local dosyasını aşağıdaki yerel adreslerle düzenleyin; örnek dosyanın postgres / redis servis adları konteyner içi adreslerdir.
Yerel bağlantılar · .env.local
APP_URL=http://localhost:3100
DATABASE_URL=postgres://purpwaba:devpassword@127.0.0.1:55432/purpwaba
REDIS_URL=redis://127.0.0.1:56379
ENCRYPTION_KEY=BURAYA_64_KARAKTER_HEX_ANAHTARMigration, web ve worker
Migration · bir kez / şema değiştiğinde
node --env-file=.env.local node_modules/tsx/dist/cli.mjs scripts/migrate.tsTerminal 1 · panel, port 3100
npm run devTerminal 2 · worker
node --env-file=.env.local node_modules/tsx/dist/cli.mjs watch src/worker/index.tsNext.js .env.local dosyasını kendi yükler. Migration ve worker betikleri bunu kendiliğinden yapmadığı için örneklerde --env-file kullanılır. Worker kapalıyken web arayüzünün açılması mesaj işleme ve zamanlanmış işlerin tamamlandığı anlamına gelmez.
Frontend ve docs önizlemesi
Ayrı terminal · frontend dizininde
cd frontend
npm ci
node node_modules/next/dist/bin/next dev -p 3200Tanıtım sitesi http://localhost:3200, dokümantasyon http://localhost:3200/docs adresindedir. Panel ile aynı portu kullanmayın.
Bu rehberdeki adımlar mevcut panel akışına göre hazırlanmıştır.