93b9c03419
- docs/scrum4me-styling.md → docs/design/styling.md - docs/MD3_Color_Scheme_Documentation.md → docs/design/md3-color-scheme.md - docs/API.md → docs/api/rest-contract.md - docs/scrum4me-test-plan.md → docs/qa/api-test-plan.md - docs/scrum4me-backlog.md → docs/backlog/index.md - docs/scrum4me-product-backlog.md → docs/backlog/product-historical.md - docs/erd.svg → docs/assets/erd.svg - docs/icons.html → docs/assets/icons.html Internal links updated across CLAUDE.md, README.md, docs/, prisma/, and scripts/. prisma/schema.prisma erd output path also updated.
76 lines
2.2 KiB
Markdown
76 lines
2.2 KiB
Markdown
# Patroon: Prisma Client singleton
|
|
|
|
## lib/prisma.ts
|
|
|
|
PostgreSQL via `pg` + `@prisma/adapter-pg` (Neon/Vercel).
|
|
|
|
```ts
|
|
import { PrismaClient } from '@prisma/client'
|
|
import { Pool } from 'pg'
|
|
import { PrismaPg } from '@prisma/adapter-pg'
|
|
|
|
function createPrismaClient() {
|
|
const url = process.env.DATABASE_URL
|
|
if (!url) throw new Error('DATABASE_URL is not set')
|
|
|
|
const pool = new Pool({ connectionString: url })
|
|
const adapter = new PrismaPg(pool)
|
|
return new PrismaClient({
|
|
adapter,
|
|
log: process.env.NODE_ENV === 'development' ? ['error', 'warn'] : ['error'],
|
|
})
|
|
}
|
|
|
|
const globalForPrisma = globalThis as unknown as { prisma: PrismaClient | undefined }
|
|
|
|
export const prisma = globalForPrisma.prisma ?? createPrismaClient()
|
|
|
|
if (process.env.NODE_ENV !== 'production') globalForPrisma.prisma = prisma
|
|
```
|
|
|
|
## prisma.config.ts (Prisma v7 vereiste)
|
|
|
|
```ts
|
|
import 'dotenv/config'
|
|
import { defineConfig } from 'prisma/config'
|
|
|
|
export default defineConfig({
|
|
schema: 'prisma/schema.prisma',
|
|
migrations: { path: 'prisma/migrations' },
|
|
})
|
|
```
|
|
|
|
## Prisma generators
|
|
|
|
`prisma/schema.prisma` bevat twee generators:
|
|
|
|
```prisma
|
|
generator client {
|
|
provider = "prisma-client-js"
|
|
}
|
|
|
|
generator erd {
|
|
provider = "prisma-erd-generator"
|
|
output = "../docs/assets/erd.svg"
|
|
}
|
|
```
|
|
|
|
`prisma generate` bouwt dus twee artifacts:
|
|
|
|
- Prisma Client in `node_modules/@prisma/client`
|
|
- het ERD-diagram in `docs/assets/erd.svg`
|
|
|
|
Gebruik volledige `prisma generate` alleen lokaal. De ERD-generator gebruikt Mermaid/Puppeteer en mag niet in CI of Vercel draaien.
|
|
|
|
## Commands
|
|
|
|
| Command | Gebruik |
|
|
|---|---|
|
|
| `npx prisma db push` | Schema synchroniseren naar de database |
|
|
| `npx prisma db seed` | Seeddata laden |
|
|
| `npx prisma generate --generator client` | Alleen Prisma Client genereren; gebruiken in CI/deployment |
|
|
| `npm run db:erd` | `prisma generate`: Prisma Client en `docs/assets/erd.svg` genereren |
|
|
| `npm run db:erd:watch` | `prisma/schema.prisma` watchen en ERD opnieuw genereren |
|
|
| `npm run dev` | Next.js dev server plus ERD watcher starten |
|
|
|
|
Belangrijk: `db push` schrijft naar de database, maar genereert geen ERD. Gebruik na schemawijzigingen lokaal `npm run db:erd` of laat `npm run dev` de watcher draaien. Gebruik in CI en deployment alleen `npx prisma generate --generator client`.
|