// Product.ts — повний приклад import { list } from '@keystone-6/core'; import { text, relationship, timestamp, integer, virtual, select } from '@keystone-6/core/fields'; import { graphql } from '@keystone-6/core'; export const Product = list({ access: { filter: { query: () => true, }, }, fields: { name: text({ validation: { isRequired: true }, isIndexed: true }), slug: text({ isIndexed: 'unique' }), sku: text({ isIndexed: 'unique' }), price: integer({ validation: { min: 0 }, graphql: { cacheHint: { maxAge: 60 } } }), status: select({ options: [ { label: 'Draft', value: 'draft' }, { label: 'Published', value: 'published' }, ], defaultValue: 'draft', }), description: text({ ui: { displayMode: 'textarea' } }), mainImage: image({ storage: 's3_images' }), category: relationship({ ref: 'Category.products', many: false }), tags: relationship({ ref: 'Tag.product', many: true }), priceWithVat: virtual({ field: graphql.field({ type: graphql.Float, resolve(item) { return (item.price ?? 0) * 1.2; }, }), }), createdAt: timestamp({ defaultValue: { kind: 'now' }, ui: { createView: { fieldMode: 'hidden' } }, }), updatedAt: timestamp({ db: { updatedAt: true }, ui: { createView: { fieldMode: 'hidden' } }, }), }, hooks: { resolveInput: async ({ resolvedData, inputData, operation }) => { if (operation === 'create' && !inputData.slug && inputData.name) { resolvedData.slug = inputData.name.toLowerCase().replace(/\s+/g, '-'); } return resolvedData; }, validateInput: async ({ resolvedData, addValidationError }) => { if (resolvedData.price !== undefined && resolvedData.price < 0) { addValidationError('Ціна не може бути від\'ємною'); } if (resolvedData.status === 'published' && !resolvedData.sku) { addValidationError('Для публікації товару необхідний SKU'); } }, afterOperation: async ({ operation, item, context }) => { if (operation === 'create' || (operation === 'update' && item.status === 'published')) { await context.db.IndexQueue.create({ data: { productId: item.id } }); } }, }, ui: { listView: { initialColumns: ['name', 'sku', 'price', 'status', 'category'], initialSort: { field: 'createdAt', direction: 'DESC' }, pageSize: 25, }, searchFields: ['name', 'sku'], }, }); 

Цей List уже вирішує проблеми N+1 (індексовані поля, graphql.cacheHint), безпеки (хуки перевіряють статус) і зручності (авто-slug, віртуальне поле).

Чому хуки важливіші, ніж здається?

Хуки — єдине місце, де можна гарантувати консистентність даних на рівні застосунку. Наприклад, при видаленні Category потрібно перевірити, чи немає опублікованих Product. Хук beforeOperation ловить видалення і кидає помилку — це надійніше, ніж перевірка на клієнті.

Як уникнути N+1 при роботі з відношеннями?

KeystoneJS за замовчуванням завантажує зв'язки ліниво. Щоб уникнути N+1, використовуйте:

• Індексацію зовнішніх ключів (переконайтеся, що поле відношення має isIndexed: true).
• graphql.cacheHint для часто запитаних полів.
• Чіткі налаштування ui.listView.initialColumns — не виводьте всі пов'язані сутності одразу.
• Якщо потрібно, кешуйте з graphql.cacheHint.

Типові помилки при роботі з Lists

• Пропуск індексів. Якщо поле часто бере участь у фільтрації або сортуванні, додайте isIndexed: true. Інакше кожен запит сканує всю таблицю.
• Відсутність хука validateInput. Без нього невірні дані можуть потрапити до БД. Завжди перевіряйте бізнес-обмеження.
• Надлишкові відношення. Не створюйте зв'язки, які не потрібні в поточній версії — зайві відношення сповільнюють Admin UI.

Які типи полів використовувати?

Процес роботи над моделлю даних

1. Аналіз бізнес-вимог — які сутності, зв'язки, права доступу.
2. Проектування схеми — ER-діаграма, типи полів, індекси, хуки.
3. Реалізація — написання Lists, налаштування доступу, хаків.
4. Інтеграційне тестування — перевірка GraphQL-операцій, завантаження даних.
5. Деплой та моніторинг — розгортання на сервері, налаштування логів.

Строки орієнтовно

Один List зі стандартними полями — від 0,5 до 1 робочого дня. Складний List з хуками, віртуальними полями та кастомними мутаціями — 1–2 дні. Повна модель даних для інтернет-магазину (10–15 Lists) — від 5 до 8 днів. Зв'яжіться з нами для точної оцінки вашого проекту.

Що входить в результат

Ми передаємо:

• Вихідний код Lists з коментарями.
• Документацію по моделі (таблиця з описом полів і зв'язків).
• Налаштований Admin UI з потрібними колонками та фільтрами.
• Скрипти міграції (через Prisma).
• Інструкцію з розгортання та інтеграції із зовнішніми сервісами.

А ще — гарантію на 30 днів: якщо виявляться баги, ми виправляємо безкоштовно. Досвід роботи з KeystoneJS — більше 5 років, на рахунку більше 50 проєктів, команда з 20 розробників. Замовте розробку кастомних Lists — оцінимо вашу модель даних безкоштовно. Отримайте консультацію щодо вашого проекту.

Порівняння з альтернативами