aibot88 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
SecuritySettingsHatası: Yeni bir kullanıcı oluşturulduğunda veya mevcut kullanıcıda üretim hatası alındığında,scripts/fix-user-settings.tsscriptini ç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.