Add comprehensive installation and operational documentation for Neta

- 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.

content/03-mimari.md

@@ -0,0 +1,113 @@
+---
+title: Mimari
+description: Neta'nın teknik mimarisi ve servis yapısı.
+order: 3
+---
+
+# Mimari
+
+Neta, modern web teknolojileri ve Supabase uyumlu açık kaynak servisler üzerine kuruludur. Full-stack self-host modunda uygulama ve backend servisleri tek bir Docker Compose yapısı içinde çalışır.
+
+## Genel Yapı
+
+Full-stack kurulumda çalışan ana servisler:
+
+- `neta-web`: Next.js uygulaması
+- `neta-db`: PostgreSQL ve pgvector
+- `neta-auth`: Supabase Auth
+- `neta-rest`: PostgREST
+- `neta-storage`: Supabase Storage
+- `neta-supabase-proxy`: Nginx tabanlı API proxy
+- `neta-migrations`: Veritabanı migration runner
+
+Bu servisler birlikte Neta'nın harici Supabase hesabına ihtiyaç duymadan çalışmasını sağlar.
+
+## Next.js Uygulaması
+
+Neta'nın kullanıcı arayüzü Next.js App Router üzerinde çalışır. Uygulama production ortamında standalone build olarak container içine alınır.
+
+Uygulama:
+
+- Dashboard ve modül sayfalarını sunar.
+- Supabase Auth ile oturum yönetimi yapar.
+- PostgREST üzerinden veritabanı işlemlerini gerçekleştirir.
+- Server action ve API route yapıları ile bazı işlemleri sunucu tarafında yürütür.
+
+## PostgreSQL ve pgvector
+
+Veritabanı olarak PostgreSQL kullanılır. Full-stack modda `pgvector/pgvector:pg16` imajı tercih edilir.
+
+PostgreSQL şu verileri saklar:
+
+- Kullanıcı profilleri
+- Müşteriler
+- Projeler
+- Görevler
+- Finans kayıtları
+- Journal kayıtları
+- Client portal ilişkileri
+- Uygulama ayarları
+
+pgvector desteği, ileride AI ve embedding tabanlı özellikler için hazır altyapı sağlar.
+
+## Supabase Auth
+
+Kimlik doğrulama için Supabase Auth kullanılır. Full-stack modda Auth servisi Neta'nın kendi PostgreSQL veritabanına bağlanır.
+
+Auth servisi:
+
+- Kullanıcı kaydı
+- Parola ile giriş
+- JWT üretimi
+- Oturum yönetimi
+- Auth tablolarının migration işlemleri
+
+gibi işleri yürütür.
+
+Neta, ilk admin hesabı oluşturulduktan sonra public kayıt akışını kapatır. Bu kontrol veritabanı fonksiyonu ve trigger ile desteklenir.
+
+## PostgREST
+
+PostgREST, PostgreSQL üzerindeki public schema için REST API sağlar. Supabase istemcisi uygulama içinde bu API üzerinden veri okuma ve yazma işlemleri yapar.
+
+Row Level Security politikaları PostgreSQL tarafında uygulanır. Böylece veri erişimi uygulama koduna ek olarak veritabanı seviyesinde de kontrol edilir.
+
+## Supabase Storage
+
+Dosya depolama için Supabase Storage API kullanılır. Full-stack modda dosyalar Docker volume içinde lokal disk backend ile saklanır.
+
+Bu yapı MVP için yeterlidir. Daha ileri production senaryolarında S3 uyumlu harici storage desteği değerlendirilebilir.
+
+## Nginx Proxy
+
+`neta-supabase-proxy`, Supabase uyumlu API giriş noktası sağlar.
+
+Proxy üzerinden:
+
+- `/auth/v1`
+- `/rest/v1`
+- `/storage/v1`
+- `/health`
+
+gibi endpointler ilgili servislere yönlendirilir.
+
+Uygulama container içinden internal URL ile bu proxy'ye bağlanır. Kullanıcı tarafında ise public Supabase API URL değeri kullanılır.
+
+## Migration Runner
+
+`neta-migrations` servisi tek seferlik çalışan bir container'dır. Görevi, Supabase Auth ve Storage tabloları hazır olduktan sonra Neta'nın kendi SQL dosyalarını doğru sırayla uygulamaktır.
+
+Full-stack modda kullanıcı migration dosyalarını manuel çalıştırmaz. Compose başlatıldığında migration runner bu işi otomatik yapar.
+
+## Veri Akışı
+
+Tipik bir istek akışı şöyledir:
+
+1. Kullanıcı tarayıcıdan Neta arayüzünü açar.
+2. Next.js uygulaması oturum bilgisini Supabase Auth ile doğrular.
+3. Veri istekleri PostgREST üzerinden PostgreSQL'e gider.
+4. PostgreSQL RLS politikaları erişim kontrolünü uygular.
+5. Dosya işlemleri Storage API üzerinden volume tabanlı depoya yazılır.
+
+Bu mimari, self-host kullanım için sade, taşınabilir ve Docker tabanlı bir yapı sağlar.
+