Poyraz Avsever
03b03d253d
- Introduced "Kurulum Modları" to explain full-stack and app-only installation options. - Created detailed guides for "Full-Stack Kurulum", "Coolify Kurulumu", "Dokploy Kurulumu", and "App-Only Kurulum". - Documented the process for creating the first admin account and the registration lock mechanism. - Added operational guidelines covering health checks, backups, restores, and logging. - Explained environment variables used in Neta installations and their significance. - Provided troubleshooting tips for common issues encountered during setup and operation. - Outlined security measures and limitations of the MVP self-host model.
104 lines
3.4 KiB
Markdown
104 lines
3.4 KiB
Markdown
---
|
||
title: App-Only Kurulum
|
||
description: Mevcut bir Supabase projesine bağlanarak Neta çalıştırma.
|
||
order: 8
|
||
---
|
||
|
||
# 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.
|
||
|