לקוח מגיע עם אפליקציית React מוכנה — התוכן חי בקבצי JSON. כל שחרור כרוך בהעתקת נתונים דרך Slack, עריכות אובדות, מיקרו-בקרים משתגעים. המעבר ל-Contentful הוא מציל חיים, אבל סכמת תוכן שגויה הופכת את ה-CMS לביצה. טעויות בסוגי שדות או חוסר ולידציה הורגים את המדרגיות. אנו מגדירים את ה-Space כך שמפתחים ומנהלי תוכן לא יקללו כל מה שזז.
במשך יותר מ-5 שנים של עבודה עם Contentful, צברנו מאות שעות של אופטימיזציה. לדוגמה, לקוח אחד איבד עד 20% מהתוכן במהלך מיגרציה ידנית — לאחר הגדרת ה-Space עם ולידציה אוטומטית, השגיאות נעלמו לחלוטין. עלות הגדרה כזו משתנה בהתאם למורכבות המודל ומספר הסביבות. להלן השלבים המרכזיים של הגדרה מקצועית.
איך לעצב מודל תוכן לסקייל?
מודל תוכן הוא השלד של הפרויקט. נורמליזציה לא נכונה מובילה לשאילתות N+1 ולטפסי עריכה מסובכים מדי. אנו פועלים לפי הכלל: סוג תוכן אחד — ישות אחת (מאמר, מחבר, קטגוריה). לבלוג, 4–6 סוגים מספיקים. מבנה לדוגמה:
| רכיב | סוג שדה | ולידציה | לוקליזציה |
|---|---|---|---|
| title | טקסט קצר | חובה, ייחודי | כן |
| slug | טקסט קצר | ייחודי, regex: ^[a-z0-9-]+ | לא |
| content | טקסט עשיר | חובה | כן |
| heroImage | מדיה (תמונה) | - | לא |
| author | הפניה | 1:1 למחבר | לא |
| categories | הפניות | רבים לקטגוריה | לא |
מודל תוכן לדוגמה לחנות מסחר אלקטרוני
- מוצר: title, slug, description, price, images, categories
- קטגוריה: name, slug, parent (הפניה עצמית)
- מותג: name, logo, website
- עמוד: title, slug, content (טקסט עשיר)
רק 4 סוגים עם עומק מינימלי. נורמליזציה מונעת כפילות נתונים.
השתמש בלוקליזציה ברמת שדה עבור שדות SEO (title, description) — זה מספק גמישות ללא כפילות תוכן. לפי התיעוד הרשמי של Contentful, לוקליזציה נכונה עם לוקליזציה ברמת שדה מפחיתה שדות כפולים ב-40%. לפרויקטים עם 5+ לוקליזציות, אנו ממליצים לא לחרוג מ-10 סוגי תוכן — אחרת ביצועי ממשק העורך יורדים.
GUI, CLI, או Codegen?
גישת CLI מהירה פי 3 מיצירה ידנית ב-GUI ומאפשרת ניהול גרסאות של המודל ב-Git. השוואה:
| שיטה | מהירות | ניהול גרסאות | טיפוסים |
|---|---|---|---|
| GUI | ~שעה | לא | לא |
| CLI | ~15 דקות | כן (JSON) | לא |
| Codegen | ~דקה | כן (TypeScript) | מלא |
לסביבת production, אנו משלבים CLI + codegen: ייצוא מודל, עריכת JSON, ייבוא דרך CI. זה חוסך יומיים על כל שינוי מודל ומפחית עלויות ניהול תוכן ב-30–50%. צור קשר לייעוץ ארכיטקטורת Space — ננתח את המודל שלך תוך 30 דקות.
הגדרת סביבות וטוקני API
השתמש בסביבות נפרדות ל-staging ו-production. לכל סביבה יש טוקני CDA, Preview ו-CMA משלה. לעולם אל תשתמש בטוקן CMA בפרונטאנד — זה חור אבטחה.
# Создать окружение staging и скопировать модель из master
contentful space environment create --name staging \
--environment-id staging --source masterב-SDK של הפרונטאנד, השתמש בטוקן CDA עם סביבת ה-staging:
const client = createClient({ space: SPACE_ID, accessToken: STAGING_CDA_TOKEN, environment: 'staging', }) אוטומציה של ייצוא מודל ל-Git
השתמש בContentful CLI כדי לייצא את המודל ללא תוכן:
contentful space export --space-id xxx --skip-content --export-dir ./model הקובץ # Создать окружение staging и скопировать модель из master contentful space environment create --name staging \ --environment-id staging --source master נשמר במאגר. כאשר המודל משתנה, ייבא דרך CI לסביבות המתאימות. זה מבטל שגיאות אנוש ומאיץ פריסות. לפי התיעוד הרשמי של Contentful, זהו שיטה מומלצת לשיתוף פעולה בצוות.
יצירת טיפוסי TypeScript ממודל התוכן
Codegen דרך const client = createClient({ space: SPACE_ID, accessToken: STAGING_CDA_TOKEN, environment: 'staging', }) יוצר ממשקים מלאים:
npx cf-content-types-generator \ --spaceId YOUR_SPACE_ID \ --token YOUR_CMA_TOKEN \ --out ./src/types/contentful.d.ts לאחר מכן, ייבוא contentful space export --space-id xxx --skip-content --export-dir ./model נותן השלמה אוטומטית והגנה משגיאות. חוסך 1–2 שעות של הגדרת טיפוסי TypeScript ידנית לכל פרויקט.
מדריך הגדרת Space שלב אחר שלב
- ניתוח דרישות — הגדרת סוגי תוכן, שדות, ולידציות (שעה).
- יצירת Space וסביבות — master, staging, dev דרך CLI (15 דקות).
- עיצוב וייבוא מודל תוכן — יצירת סכמת JSON, ייבוא דרך CLI (30 דקות).
- יצירת טיפוסים ותיעוד — codegen TypeScript, כתיבת readme (שעה).
הגדרה מלאה אורכת 1–2 ימים ומפחיתה עלויות תפעול ב-20–30%. עלות הגדרה טיפוסית תלויה בהיקף. חיסכון במיגרציית תוכן ידנית יכול להגיע לסכומים משמעותיים.
מה כלול בעבודה שלנו?
- ניתוח דרישות ועיצוב מודל תוכן
- יצירת Space וסביבות (production, staging, dev)
- הגדרת טוק�י API (CDA, Preview, CMA)
- ייצוא/ייבוא מודל דרך CLI, אינטגרציית CI/CD
- יצירת טיפוסי TypeScript ואינטגרציה
- תיעוד למנהלי תוכן
אנו מבטיחים: אין שדות מיותרים, ולידציה מלאה ברמת ה-CMS, ארכיטקטורה מוכנה לסקייל. אנו עובדים עם Contentful כבר יותר מ-5 שנים — במהלך תקופה זו השלמנו יותר מ-30 פרויקטים ברמות מורכבות שונות. פרויקט טיפוסי (4–6 סוגי תוכן, 2 לוקליזציות, 2 סביבות) מוגדר תוך 1–2 ימים. העלות מחושבת באופן אישי — תלויה במורכבות המודל ובדרישות האוטומציה. פשוט צור קשר — נכין את הארכיטקטורה ותוכנית מדויקת.