Neta

App-Only Kurulum

App-only kurulumda yalnızca Neta web uygulaması çalışır. Auth, veritabanı, REST API ve Storage servisleri mevcut bir Supabase projesinden sağlanır.

Bu model, harici Supabase kullanmak isteyen veya mevcut Supabase altyapısına sahip kullanıcılar için uygundur.

Ne Zaman Kullanılır?

App-only mod şu durumlarda tercih edilebilir:

  • Zaten aktif bir Supabase projen varsa
  • Veritabanını managed servis olarak kullanmak istiyorsan
  • Neta uygulamasını ayrı bir sunucuda yayınlamak istiyorsan
  • Full-stack self-host yerine Supabase'in hosted altyapısını kullanmak istiyorsan

İlk MVP için tam self-host hedefleniyorsa full-stack mod daha uygundur.

Gerekli Değerler

App-only mod için gerekli environment değerleri:

env
NEXT_PUBLIC_SITE_URL=https://app.example.com
NEXT_PUBLIC_SUPABASE_URL=https://project-ref.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=...
SUPABASE_SERVICE_ROLE_KEY=...
SUPABASE_INTERNAL_URL=https://project-ref.supabase.co

Migration çalıştırmak için ayrıca doğrudan PostgreSQL bağlantısı gerekir:

env
DATABASE_URL=postgresql://postgres:password@host:5432/postgres

Migration'ları Uygula

App-only modda migration dosyaları otomatik uygulanmaz. Neta'nın SQL dosyalarını bağlandığın Supabase projesinde çalıştırman gerekir.

Repository kökünde:

bash
DATABASE_URL='postgresql://postgres:password@host:5432/postgres' sh ./scripts/apply-migrations.sh

Bu script şu dosyaları sırayla uygular:

  • supabase/schema.sql
  • supabase/migrations/0002_add_freelancer_os_core_tables.sql
  • supabase/migrations/0003_add_project_planning_assets.sql
  • supabase/migrations/0004_add_business_os_tables.sql
  • supabase/migrations/0005_add_advanced_crm_tables.sql
  • supabase/migrations/0006_add_pgvector_and_embeddings.sql
  • supabase/migrations/0007_add_client_portal_tables.sql
  • supabase/migrations/0008_add_project_progress_and_quota.sql
  • supabase/migrations/0009_lock_registration_after_first_admin.sql

Doğru Projeye Uyguladığından Emin Ol

En önemli kural:

text
Migration hangi Supabase projesinde çalıştıysa uygulama da aynı projeye bağlanmalıdır.

Uygulama NEXT_PUBLIC_SUPABASE_URL değerindeki projeye istek atar. Migration farklı bir projede çalıştıysa /register, login veya veri işlemleri hata verebilir.

Docker ile Başlat

App-only modda şu Compose dosyası kullanılır:

bash
docker compose up -d --build

Bu Compose dosyası sadece web uygulamasını çalıştırır ve harici Supabase değerlerini bekler.

.env.local Uyarısı

Lokal geliştirme sırasında Next.js .env.local dosyasını okur.

Eğer .env.local şu şekilde hosted Supabase'e bakıyorsa:

env
NEXT_PUBLIC_SUPABASE_URL=https://project-ref.supabase.co

lokal pnpm dev çalıştırdığında self-host Docker veritabanı değil bu hosted Supabase projesi kullanılır.

Self-host Docker stack ile lokal geliştirme yapmak istiyorsan .env.local değerlerini buna göre düzenlemen gerekir.

İlk Admin

Migrationlar doğru projede çalıştıktan sonra /register sayfası ilk admin oluşturmak için kullanılabilir.

Eğer is_first_admin_setup_available() fonksiyonu false dönüyorsa, o projede zaten profil kaydı vardır ve kayıt kapalıdır.