scx-database-management

name	scx-database-management
description	SCX-Studio-Pro projesinin Prisma ORM ve SQLite tabanlı veritabanı şemasını, model ilişkilerini, migrasyon süreçlerini ve veri yönetimini açıklar.

SCX-Studio-Pro Veritabanı Yönetimi

Bu skill, SCX-Studio-Pro projesinin veritabanı yapısını ve yönetimiyle ilgili süreçleri detaylandırır. Proje, Prisma ORM ve SQLite kullanmaktadır.

1. Veritabanı Şeması (prisma/schema.prisma)

prisma/schema.prisma dosyası, projenin tüm veritabanı modellerini ve ilişkilerini tanımlar. Aşağıda kritik modeller ve ilişkileri özetlenmiştir:

1.1. User Modeli

Kullanıcı bilgilerini (isim, e-posta, roller, API anahtarları vb.) saklar. Diğer birçok modelle bire-çok veya bire-bir ilişkisi vardır.

Alan Adı	Tipi	Açıklama
id	String	Kullanıcı ID (cuid)
name	String?	Kullanıcı adı
email	String?	Kullanıcı e-postası (unique)
emailVerified	DateTime?	E-posta doğrulama tarihi
image	String?	Profil resmi URL'si
isAdult	Boolean	Yetişkin onayı (varsayılan: false)
role	String	Kullanıcı rolü (varsayılan: "USER")
gender	String?	Cinsiyet
apiKeys	String?	Kullanıcının API anahtarlarını JSON olarak saklar
createdAt	DateTime	Oluşturulma tarihi
updatedAt	DateTime	Son güncelleme tarihi
accounts	Account[]	Kullanıcının hesapları (NextAuth)
adminActions	AdminAction[]	Admin eylemleri
albums	Album[]	Kullanıcının albümleri
characters	CharacterDNA[]	Kullanıcının karakter DNA'ları
generatedImages	GeneratedImage[]	Kullanıcının ürettiği görseller
securitySettings	UserSecuritySettings?	Kullanıcının güvenlik ayarları (bire-bir ilişki)

1.2. CharacterDNA Modeli

Karakterlerin genetik bilgilerini ve görsel referanslarını saklar. Bir User'a aittir.

Alan Adı	Tipi	Açıklama
id	String	Karakter ID (cuid)
userId	String	İlişkili kullanıcı ID'si
name	String?	Karakter adı (varsayılan: "Ana Karakter")
isMainCharacter	Boolean	Ana karakter mi (varsayılan: false)
faceImages	String?	Yüz görselleri (JSON string)
poseReference	String?	Poz referans görseli
view360PackJson	String?	360 derece görünüm paketi (JSON string)
user	User	İlişkili kullanıcı (bire-çok)

1.3. GeneratedImage Modeli

Üretilen görsellerin detaylarını, kullanılan prompt'ları ve depolama bilgilerini saklar. Bir User'a aittir ve isteğe bağlı olarak bir Album'e bağlı olabilir.

Alan Adı	Tipi	Açıklama
id	String	Görsel ID (cuid)
userId	String	İlişkili kullanıcı ID'si
promptUsed	String	Görsel üretiminde kullanılan prompt
imageUrl	String	Görselin URL'si
storageSource	String	Depolama kaynağı (varsayılan: "external")
driveFileId	String?	Google Drive dosya ID'si
albumId	String?	İlişkili albüm ID'si
engineUsed	String	Kullanılan AI motoru (varsayılan: "fal_ai_flux_pulid")
isNsfw	Boolean	NSFW içeriği mi (varsayılan: false)
user	User	İlişkili kullanıcı (bire-çok)
album	Album?	İlişkili albüm (bire-çok)

1.4. Album Modeli

Kullanıcıların görsellerini organize ettiği albümleri temsil eder. Bir User'a aittir.

Alan Adı	Tipi	Açıklama
id	String	Albüm ID (cuid)
userId	String	İlişkili kullanıcı ID'si
name	String	Albüm adı
kind	String	Albüm türü (varsayılan: "standard")
visibilityMode	String	Görünürlük modu (varsayılan: "normal")
requiresPin	Boolean	PIN gerektiriyor mu (varsayılan: false)
user	User	İlişkili kullanıcı (bire-çok)
images	GeneratedImage[]	Albümdeki görseller

1.5. UserSecuritySettings Modeli

Kullanıcıya özel güvenlik ve sağlayıcı ayarlarını saklar. Bir User ile bire-bir ilişkisi vardır.

Alan Adı	Tipi	Açıklama
id	String	Ayar ID (cuid)
userId	String	İlişkili kullanıcı ID'si
providerDefaults	String?	Sağlayıcı varsayılanları (JSON string)
providerPools	String?	Sağlayıcı havuzları (JSON string)
selfHostConfig	String?	Self-host yapılandırması (JSON string)
user	User	İlişkili kullanıcı (bire-bir)

2. Migrasyonlar

Veritabanı şemasında yapılan değişiklikler, Prisma migrasyonları aracılığıyla yönetilir. Yeni bir değişiklik yapıldığında aşağıdaki komutlar kullanılır:

npx prisma migrate dev --name <migration_name>

Bu komut, şema değişikliklerini algılar, yeni bir migrasyon dosyası oluşturur ve veritabanına uygular.

3. Veritabanı Erişimi

Prisma Client, lib/core/prisma.ts üzerinden projenin geri kalanına sağlanır. Veritabanı işlemleri için doğrudan prisma objesi kullanılır.

import { prisma } from '@/lib/core/prisma';

// Örnek kullanım
const user = await prisma.user.findUnique({ where: { id: userId } });

4. Bilinen Sorunlar ve Çözümler

• SecuritySettings Hatası: Yeni bir kullanıcı oluşturulduğunda veya mevcut kullanıcıda üretim hatası alındığında, scripts/fix-user-settings.ts scriptini çalıştırarak varsayılan sağlayıcı ayarlarını (SecuritySettings) veritabanına ekleyin.

Bu skill, SCX-Studio-Pro veritabanı yapısını ve yönetimini anlamak için kapsamlı bir rehber sunar.