first commit

SETUP.md

@@ -0,0 +1,166 @@
+# ConfigVault — Kurulum Rehberi
+
+## 1. PostgreSQL — Database kurulumu
+
+Herhangi bir Postgres çalışır: kendi sunucun, Railway, Render, Neon, Fly.io...
+
+```bash
+# Lokal kurulum için (macOS):
+brew install postgresql && brew services start postgresql
+createdb configvault
+
+# Veya Docker ile:
+docker run -d --name configvault-db \
+  -e POSTGRES_DB=configvault \
+  -e POSTGRES_PASSWORD=password \
+  -p 5432:5432 postgres:16
+```
+
+Schema'yı yükle:
+
+```bash
+psql postgresql://postgres:password@localhost:5432/configvault < schema.sql
+```
+
+Veya `psql`'e bağlanıp `schema.sql` içeriğini yapıştır.
+
+---
+
+## 2. Proje kurulumu
+
+```bash
+npm install
+cp .env.example .env.local
+```
+
+`.env.local` doldur:
+
+```bash
+DATABASE_URL=postgresql://postgres:password@localhost:5432/configvault
+DATABASE_SSL=false
+
+NEXTAUTH_SECRET=$(openssl rand -base64 32)
+NEXTAUTH_URL=http://localhost:3000
+
+ADMIN_USERNAME=admin
+# Şifre hash'i oluştur:
+node -e "const b=require('bcryptjs'); console.log(b.hashSync('şifren', 12))"
+ADMIN_PASSWORD_HASH=$2a$12$...
+
+NEXT_PUBLIC_APP_URL=http://localhost:3000
+```
+
+## 3. Çalıştır
+
+```bash
+npm run dev
+# → http://localhost:3000
+```
+
+---
+
+## Deploy seçenekleri
+
+### Vercel + Railway (kolay)
+1. Railway'de PostgreSQL aç → connection string'i al
+2. Vercel'e deploy et, env variable'ları ekle
+3. `DATABASE_SSL=true` yap (Railway SSL ister)
+
+### Kendi sunucun (VPS)
+```bash
+# Sunucuda:
+npm run build
+npm start
+# Veya PM2 ile:
+pm2 start npm --name configvault -- start
+```
+
+### Docker Compose (her şey bir arada)
+```yaml
+version: '3.8'
+services:
+  app:
+    build: .
+    ports: ["3000:3000"]
+    environment:
+      DATABASE_URL: postgresql://postgres:password@db:5432/configvault
+      DATABASE_SSL: "false"
+      NEXTAUTH_SECRET: your-secret
+      NEXTAUTH_URL: https://configvault.yourdomain.com
+      ADMIN_USERNAME: admin
+      ADMIN_PASSWORD_HASH: $2a$12$...
+      NEXT_PUBLIC_APP_URL: https://configvault.yourdomain.com
+    depends_on: [db]
+  db:
+    image: postgres:16
+    environment:
+      POSTGRES_DB: configvault
+      POSTGRES_PASSWORD: password
+    volumes:
+      - pgdata:/var/lib/postgresql/data
+      - ./schema.sql:/docker-entrypoint-initdb.d/schema.sql
+volumes:
+  pgdata:
+```
+
+---
+
+## React Native — Kullanım
+
+Uygulamanın içinde `lib/config.ts` oluştur:
+
+```typescript
+import AsyncStorage from '@react-native-async-storage/async-storage'
+
+const CONFIG_URL = 'https://configvault.yourdomain.com/api/v1/config'
+const APP_API_KEY = 'buraya_dashboard_api_key'  // Dashboard > App > API Key tab
+
+export async function initConfig(env = 'production') {
+  try {
+    const res = await fetch(`${CONFIG_URL}?env=${env}`, {
+      headers: { 'X-Api-Key': APP_API_KEY },
+    })
+    if (!res.ok) throw new Error('Config fetch failed')
+    const config = await res.json()
+
+    // Offline fallback için cache
+    await AsyncStorage.setItem('app_config', JSON.stringify(config))
+    return config
+  } catch {
+    const cached = await AsyncStorage.getItem('app_config')
+    if (cached) return JSON.parse(cached)
+    throw new Error('No config available')
+  }
+}
+```
+
+`App.tsx`:
+```typescript
+import { initConfig } from './lib/config'
+import { createClient } from '@supabase/supabase-js'
+
+let supabase: any
+
+export default function App() {
+  useEffect(() => {
+    initConfig('production').then(config => {
+      supabase = createClient(config.SUPABASE_URL, config.SUPABASE_ANON_KEY)
+      // artık config.ICON_URL, config.API_ENDPOINT vs. kullanabilirsin
+    })
+  }, [])
+}
+```
+
+**Config değişince:** Dashboard'a gir → ilgili key'i güncelle → kaydet.
+Tüm kullanıcılar bir sonraki açılışta yeni değeri alır. Rebuild yok. 🎉
+
+---
+
+## Yeni özellik ekleme
+
+**Yeni config tipi:** `schema.sql` → `type CHECK` + `types/index.ts` + `AppDetailClient.tsx` select
+
+**Yeni tablo/özellik:**
+1. `schema.sql`'e ekle, `psql` ile migrate et
+2. `app/api/apps/[id]/` altına route ekle
+3. Dashboard'a tab/section ekle