רשימות KeystoneJS מותאמות אישית: הימנעות ממלכודות נפוצות

// 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), אבטחה (hooks שבודקים סטטוס) ושימושיות (auto-slug, שדה וירטואלי).

למה Hooks חשובים יותר ממה שחושבים

Hooks הם המקום היחיד שבו אפשר להבטיח עקביות נתונים ברמת האפליקציה. לדוגמה, בעת מחיקת Category, צריך לבדוק אם יש מוצרים שפורסמו. ה-hook של beforeOperation תופס את המחיקה וזורק שגיאה—זה אמין יותר מבדיקה בצד הלקוח.

"Hooks הם המקום היחיד שבו אפשר להבטיח עקביות נתונים ברמת האפליקציה" — תיעוד KeystoneJS.

איך להימנע מ-N+1 בעבודה עם קשרים

KeystoneJS טוען קשרים בעצלתיים כברירת מחדל. כדי להימנע מ-N+1, השתמשו ב:

• אינדקס על מפתחות זרים (ודאו שלשדה הקשר יש isIndexed: true).
• graphql.cacheHint עבור שדות שנשאלים לעתים קרובות.
• הגדרות ui.listView.initialColumns ברורות—אל תפלטו את כל הישויות הקשורות בבת אחת.
• במידת הצורך, שמרו במטמון עם graphql.cacheHint.

טעויות טיפוסיות בעבודה עם Lists

• אינדקסים חסרים. אם שדה משמש לעתים קרובות בסינון או מיון, הוסיפו isIndexed: true. אחרת, כל שאילתה סורקת את כל הטבלה.
• חוסר ב-validateInput hook. בלעדיו, נתונים שגויים יכולים להיכנס למסד הנתונים. תמיד בדקו אילוצים עסקיים.
• קשרים מוגזמים. אל תיצרו חיבורים שאינם נחוצים בגרסה הנוכחית—קשרים מיותרים מאטים את ממשק הניהול.

אילו סוגי שדות להשתמש

תהליך עבודה למודל נתונים

1. ניתוח דרישות עסקיות — ישויות, קשרים, זכויות גישה.
2. עיצוב הסכמה — דיאגרמת ER, סוגי שדות, אינדקסים, hooks.
3. יישום — כתיבת Lists, הגדרת גישה, hooks.
4. בדיקות אינטגרציה — בדיקת פעולות GraphQL, טעינת נתונים.
5. פריסה וניטור — פריסה לשרת, הגדרת לוגים.

לוחות זמנים משוערים

List אחד עם שדות סטנדרטיים — בין 0.5 ליום עבודה אחד. List מורכב עם hooks, שדות וירטואליים ו-mutations מותאמים אישית — 1–2 ימים. מודל נתונים מלא לחנות מקוונת (10–15 Lists) — בין 5 ל-8 ימים. צרו איתנו קשר להערכה מדויקת לפרויקט שלכם.

מה כלול בתוצאה

אנחנו מספקים:

• קוד מקור ל-Lists עם הערות.
• תיעוד למודל (טבלה עם תיאורי שדות וקשרים).
• ממשק ניהול מוגדר עם עמודות ומסננים נדרשים.
• סקריפטי מיגרציה (באמצעות Prisma).
• הוראות פריסה ואינטגרציה.

בנוסף, אחריות ל-30 יום: אם נמצאו באגים, נתקן אותם בחינם. ניסיון עם KeystoneJS — מעל 5 שנים, יותר מ-50 פרויקטים שהושלמו. הזמינו פיתוח List מותאם אישית — נעריך את מודל הנתונים שלכם. קבלו ייעוץ לפרויקט שלכם.

השוואה עם חלופות