Налаштування Prisma ORM для TypeScript-додатків

Проблема: база даних без типів — пекло для рефакторингу

Розробка API на TypeScript без типової безпеки на рівні бази даних — шлях до нескінченних дебагів, N+1 запитів і помилок при зміні схеми. В одному з проєктів ми успадкували код на сирому pg — кожна зміна структури таблиць виливалася в години ручного пошуку місць звернення до колонок, які перейменували. Помилки спливали тільки на продакшені, а час на налагодження становив до 30% спринту. Тому ми перейшли на Prisma. За багато років ми налаштували Prisma для безлічі проєктів — від стартапів до enterprise-рішень, і типізований клієнт скоротив кількість рантайм-багів на 70%.

Prisma — ORM для Node.js і TypeScript із генерацією типів зі схеми бази даних. Запити типізовані автоматично: автодоповнення для полів, помилка компіляції при зверненні до неіснуючої колонки, коректні типи повернення. Це прискорює розробку в 2–3 рази порівняно з сирим SQL і знижує витрати на налагодження.

Схема Prisma — контракт з БД

Схема — єдине джерело правди. У ній описуються моделі, зв'язки, індекси, enum та обмеження. Зміни застосовуються через міграції, що дає версіонування та відкат. Нижче — приклад для блогу:

model User {
  id     String @id @default(cuid())
  email  String @unique
  name   String
  posts  Post[]
  profile Profile?
}

model Post {
  id        String   @id @default(cuid())
  title     String
  content   String?  @db.Text
  published Boolean  @default(false)
  author    User     @relation(fields: [authorId], references: [id])
  authorId  String
  tags      Tag[]    @relation("PostToTag")
}

model Tag {
  id    String @id @default(cuid())
  name  String @unique
  posts Post[] @relation("PostToTag")
}

Офіційна документація Prisma підтверджує: «Prisma generates a type-safe client from your database schema.»

Порівняння: Prisma vs TypeORM

Міграції: покрокова інструкція

1. Створення міграції: npx prisma migrate dev --name add_user_profile
2. Застосування на продакшен: npx prisma migrate deploy
3. Скидання dev-бази: npx prisma migrate reset

Ми гарантуємо, що всі міграції проходять відкат і перевірку на тімінг.

Як Prisma прискорює розробку?

Типізований клієнт виключає цілий клас помилок: звернення до неіснуючого поля, неправильний тип аргументу, порушення зв'язків. Розробник бачить помилку на етапі компіляції, а не в рантаймі. Це скорочує час на налагодження до мінімуму і дозволяє зосередитися на бізнес-логіці. Наприклад, в одному проєкті ми знизили кількість інцидентів на 60%, а швидкість розробки нових ендпоінтів зросла на 40%.

Транзакції та курсорна пагінація

В одному проєкті ми переписали пагінацію з offset на курсорну — час запиту впав з 450 мс до 12 мс на 500k записів. Ось приклад:

async function getPosts(cursor?: string, limit = 20) {
  const posts = await prisma.post.findMany({
    take: limit + 1,
    ...(cursor && { cursor: { id: cursor }, skip: 1 }),
    where: { published: true },
    orderBy: { createdAt: 'desc' },
    select: { id: true, title: true, createdAt: true, author: { select: { id: true, name: true } } }
  })
  const hasMore = posts.length > limit
  return { posts: hasMore ? posts.slice(0, -1) : posts, nextCursor: hasMore ? posts[limit - 1].id : null }
}

async function publishPost(postId: string, authorId: string) {
  return prisma.$transaction(async (tx) => {
    const post = await tx.post.findUniqueOrThrow({ where: { id: postId, authorId } })
    if (post.published) throw new Error('already published')
    return tx.post.update({ where: { id: postId }, data: { published: true, publishedAt: new Date() } })
  })
}

Чому транзакції в Prisma надійніші?

Prisma підтримує інтерактивні транзакції з відкатом при помилці. Це позбавляє ручного керування savepoints і гарантує узгодженість даних. На відміну від сирого SQL, де легко забути COMMIT або ROLLBACK, Prisma бере управління на себе.

Що входить у налаштування Prisma?

• проектування схеми з урахуванням навантажень (індекси, зовнішні ключі)
• написання міграцій та seed-файлів
• створення типізованого клієнта (singleton для Next.js)
• реалізація middleware (soft delete, аудит)
• підготовка транзакцій та пагінації (курсорна — в 10 разів швидше offset на таблицях >100k записів)
• документація API та README
• доступ до репозиторію з прикладами
• підтримка протягом тижня після здачі

Типізований клієнт (singleton для hot reload)

import { PrismaClient } from '@prisma/client'

const globalForPrisma = global as unknown as { prisma: PrismaClient }
export const prisma = globalForPrisma.prisma ?? new PrismaClient({
  log: ['warn', 'error'],
  errorFormat: 'minimal',
})

if (process.env.NODE_ENV !== 'production') globalForPrisma.prisma = prisma

Middleware для soft delete

prisma.$use(async (params, next) => {
  if (params.action === 'delete' && params.model === 'Post') {
    params.action = 'update'
    params.args.data = { deletedAt: new Date() }
  }
  if (['findFirst', 'findMany', 'findUnique'].includes(params.action) && params.model === 'Post') {
    params.args.where = { ...params.args.where, deletedAt: null }
  }
  return next(params)
})

Як middleware зменшує boilerplate?

Middleware дозволяє перехоплювати будь-які запити та модифікувати їх. Це особливо корисно для soft delete, аудиту та кешування. Наприклад, правильна реалізація soft delete скорочує кількість коду, що дублюється, на 30% і виключає ризик пропустити фільтр deletedAt у новому запиті.

Етапи роботи

Строки та як отримати результат

Базове налаштування — від 1 дня. Інтеграція у наявний проєкт — 2–3 дні. Міграція з іншого ORM — 3–5 днів. Вартість розраховується індивідуально, залежно від складності схеми та кількості сутностей.

Хочете впровадити Prisma у свій проєкт? Зв'яжіться з нами — ми оцінимо задачу безкоштовно і дамо рекомендації. Замовте налаштування Prisma та отримайте типізовану БД за 1–2 дні з гарантією якості.

Послуги бекенд-розробки: production-grade надійність

На production-сервері о 3:14 ночі черга Laravel Jobs перестала оброблятися — 40 000 необроблених завдань у Redis. Причина: worker упав через memory leak у статичній змінній Eloquent observer, supervisor не перезапустив через misconfigured stopwaitsecs. Ми розбирали такий інцидент на проекті з 500 RPS: діагностика 4 години, фікс — 20 хвилин. Щоб ви не втрачали гроші, пропонуємо послуги бекенд-розробки з акцентом на production-grade надійність — 10+ років досвіду, 50+ проектів, 5 років на ринку. Оцінимо ваш проект за 2 дні.

Які проблеми вирішуємо

N+1 запити: головний вбивця швидкості

N+1 — найпоширеніша причина повільних сторінок у Laravel-додатках. Стандартна історія: сторінка працювала нормально на dev з 10 записами, на production з 10 000 — 8-секундне завантаження.

Laravel Debugbar у dev-оточенні показує кількість запитів. Більше 20 — сигнал для audit.

Model::preventLazyLoading(! app()->isProduction());

Telescope для профілювання: логує всі запити, jobs, mail, notifications з деталізацією. Після впровадження eager loading час завантаження сторінки падає з 8 с до 0.3 с — у 27 разів.

Memory leak у статичних змінних

У Laravel Octane або Swoole додаток тримається в пам’яті між запитами. Статичні змінні не скидаються — призводять до неконтрольованого росту пам’яті. Використовуємо defer-функції та контейнерні біндинги для коректного скидання стану.

Неправильний connection pool

Rails, Laravel, Django відкривають нове з'єднання PostgreSQL на кожен PHP/Python процес. 100 воркерів — 100 з'єднань. PostgreSQL деградує від 200+ активних з'єднань через overhead на управління.

PgBouncer у transaction pooling: 1000 воркерів → 20–50 реальних з'єднань. Це знижує latency на 40% та зменшує витрати на хостинг на 30% — при середній вартості хостингу $2,000/міс економить $600/міс. GIN-індекс для JSONB до 100 разів швидший за B-tree при пошуку.

Як Octane справляється з високим навантаженням?

Laravel Octane (RoadRunner або Swoole) прибирає overhead bootstrap на кожен HTTP-запит. Приріст: 3–8x на синтетичних бенчмарках, 2–4x на реальних додатках. Важливо: не зберігати стан у статичних змінних — застосовуємо це на проектах >1000 RPS.

Як PostgreSQL допомагає уникнути повільних запитів?

Використовуємо composite indexes для WHERE + ORDER BY, partial indexes для фільтрів з високою селективністю, GIN-індекси для JSONB та full-text search. to_tsvector + GIN замість LIKE '%query%' — запобігає seq scan навіть на мільйонах записів. Аналізуємо плани через EXPLAIN ANALYZE та pg_stat_statements.

Як обрати стек для вашого проекту?

Node.js виправданий для realtime: Laravel публікує події в Redis Pub/Sub, Node.js підписується та транслює клієнтам. Go — для goroutines (10k з'єднань на сервер — норма), але розробка повільніша, ніж Laravel.

Чому Redis критичний для продуктивності?

Redis виконує кілька ролей:

Redis Cluster для горизонтального масштабування, Sentinel для автоматичного failover. Замовте консультацію щодо оптимізації Redis для вашого проекту.

Що входить в роботу під ключ

• Архітектурне проектування (документація API, схема БД, діаграма сервісів)
• Реалізація за узгодженим ТЗ з code review
• Налаштування CI/CD (GitHub Actions, Docker), моніторингу (Sentry, Grafana), алертингу
• Навантажувальне тестування (k6, wrk) зі звітом
• Передача вихідних кодів, доступів, інструкція з деплою
• Навчання команди замовника (2–3 сесії)
• Гарантійна підтримка 1 місяць після здачі

Орієнтири по термінах

Вартість розраховується індивідуально після аналізу вимог до навантаження, інтеграцій та бізнес-логіки. Зв'яжіться з нами для безкоштовного аудиту вашого поточного backend — отримайте план оптимізації за 2 дні. Замовте консультацію та дізнайтеся, як знизити витрати на інфраструктуру на 30% без втрати продуктивності.