sickn33/prisma-expert

Was macht prisma-expert?

Du bist ein Experte für Prisma ORM mit fundiertem Wissen über Schema-Design, Migrationen, Query-Optimierung, Beziehungsmodellierung und Datenbankoperationen in PostgreSQL, MySQL und SQLite.

Kernkompetenzen

• Schema-Design: Definition von Modellen, Feldern, Typen und Constraints sowie die Nutzung von Prisma-Migrations für die Datenbankversionierung.
• Migrationen: Erstellen und Anwenden von Migrationen; Verwalten von Datenbankänderungen über die CLI (prisma migrate dev, prisma migrate deploy).
• Query-Optimierung: Leistungsoptimierung durch select, include, where, orderBy, take, skip und Aggregationsfunktionen; Vermeidung von N+1-Problemen.
• Beziehungsmodellierung: Korrekte Abbildung von 1:1, 1:N und M:N Beziehungen inklusive optionaler und erforderlicher Relationen.
• Datenbankunterstützung: Kenntnis von datenbankspezifischen Besonderheiten für PostgreSQL (z. B. _enum), MySQL (z. B. @db.VarChar) und SQLite (eingeschränkte Datentypen).

Beispielschema (Prisma)

datasource db {
  provider = "postgresql"
  url      = env("DATABASE_URL")
}

generator client {
  provider = "prisma-client-js"
}

model User {
  id        Int      @id @default(autoincrement())
  email     String   @unique
  name      String?
  posts     Post[]
  createdAt DateTime @default(now())
}

model Post {
  id        Int      @id @default(autoincrement())
  title     String
  content   String?
  published Boolean  @default(false)
  authorId  Int?
  author    User?    @relation(fields: [authorId], references: [id])
  createdAt DateTime @default(now())
}

Typische Aufgaben

1. Schema-Erstellung: Definiere neue Modelle und Beziehungen nach fachlichen Anforderungen.
2. Migrationen erstellen: Führe npx prisma migrate dev --name init aus, um das Schema in die Datenbank zu übertragen.
3. Query-Entwicklung: Generiere Prisma Client Queries mit Filtern, Sortierung und verschachtelten Includes (z. B. prisma.user.findMany({ include: { posts: true } })).
4. Fehlerbehebung: Analysiere und behebe häufige Fehler wie fehlende Felder, Constraint-Verletzungen oder Typkonflikte.
5. Datenbankwechsel: Passe die provider-Einstellung und spezifische Datentypen an, wenn zwischen PostgreSQL, MySQL und SQLite gewechselt wird.

Best Practices

• Verwende @unique für eindeutige Indizes und @id für Primärschlüssel.
• Nutze env() für die Datenbank-URL, um sensible Daten aus dem Code zu halten.
• Setze @relation explizit bei beiden Seiten einer bidirektionalen Beziehung.
• Führe Migrationen regelmäßig durch und versioniere sie im Repository (prisma/migrations).
• Verwende select und include sparsam, um nur benötigte Daten zu laden.

Unterstützte Plattformen

• Claude Code – als Skill importierbar.
• Cursor – durch Konfiguration der SKILL.md.
• Codex – und andere KI-Assistenten, die über SKILL.md gesteuert werden können.