DS bundle v3 — איך שודרגה הפלטפורמה ב-3 ימים

שלושה ימים. 22 גרסאות שוחררו. הפלטפורמה עברה מ-43 משטחים על v3 אל 97 משטחים על תשתית אחידה: שכבת tokens משותפת, OG/Schema.org אוטומטיים, sitemap דינמי, audit gate שחוסם deploy אם משהו נשבר.

§ 01נקודת ההתחלה

אחרי DS v2 (שהושק ב-v477 בתחילת יוני), 43 משטחים היו על העיצוב החדש. 52 הנותרים עוד רצו עם styles אינליין שקדמו ל-v3. ה-zip Legal Eye Design System (3).zip הגיע עם 37 משטחים נוספים בעיצוב חי + תשתית משותפת.

האתגר: 97 משטחים זה יותר מדי לעריכה ידנית. כל מה שנעשה היה צריך להיות אוטומטי, idempotent, וניתן לאימות.

§ 02מה נבנה

1. ה-port (v560–v565)

37 משטחים יובאו ב-batch. port-v3.py ביצע את היבוא עם path rewrites. fix-links-v3.py טיפל ב-cross-bundle hrefs שה-script הראשון פיספס.

/index.html (אפליקציית workspace בפרוד) לא הוחלף — זו אפליקציה של 1464 שורות שדרשה replatform שלם. במקום זה היא קיבלה את שכבת ה-tokens החדשה בקסקיידה לפני ה-CSS שלה.

2. תשתית אחידה (v567–v570)

אחרי ה-port, 54 משטחי legacy עדיין לא נטענו את ה-token sheet. Injection אחת הוסיפה <link rel="stylesheet" href="/colors_and_type.css"> ל-54 מהם. 97/97 משטחים משתפים עכשיו מקור אחד לטוקנים. שינויי palette עתידיים — קובץ אחד.

OG metadata: לפני — 48-60 משטחים חסרים og:title/desc/image/url, canonical, twitter:card. אחרי — 0. 49 תיאורים ייחודיים בעברית נכתבו ל-v3 ports.

3. גילוי (v568, v569, v571)

• /sitemap/ הורחב מ-95 ל-125 entries עם 3 קטגוריות חדשות.
• sitemap.xml עבר מ-rewrite ל-HF (96 URL) ל-static generator שסורק את ה-filesystem (122 URLs).
• robots.txt עבר ל-static עם Allow מפורש ל-v3 + Disallow ספציפי לכל admin path.
• 14 short-name aliases מקבלים 308 redirects ב-vercel.json.
• /404.html מציע "אולי התכוונת" עם Damerau-Levenshtein על 80 משטחים.

4. OG SVG cards ייחודיים (v572)

gen-og-svg.py מייצר 1200×630 SVG card לכל משטח — brand mark + כותרת בעברית + tagline + URL footer. ~2.4KB. Autogen sentinel שומר על ידיות. כל לינק שמשתפים מקבל preview ייחודי.

5. Schema.org + cross-linking (v577–v578)

schema-inject.py הוסיף @graph מאוחד (WebPage + Speakable + BreadcrumbList + Organization + WebSite) לכל משטח. לפני: 76/97 חסרי WebPage, 95/97 חסרי Speakable. אחרי: 0.

linkgraph-audit.py מדד inbound לכל v3 target. לפני: 1 orphan + 12 under-linked. שתי link-strip injectors העלו את ממוצע ה-inbound מ-3 ל-11+.

6. הגנות בייצור (v579–v582)

• scripts/run-all.sh — pipeline מאחד עם summary צבעוני.
• deploy.sh audit gate — כל deploy מריץ run-all.sh --audit קודם. failed audit מבטל deploy.
• pre-commit hook — מחדש OG SVGs / sitemap כשהמקור משתנה.
• lint-surfaces.py — 12-check baseline lint על כל index.html.

§ 03המספרים

מדידה	לפני	אחרי
משטחים על DS v3 tokens	43/97	97/97
OG metadata מלא	49/97	97/97
Schema.org @graph	22/97	96/97
Per-surface OG cards	6/97	97/97
sitemap.xml URLs	96	122
/sitemap/ HTML entries	95	125
v3 surfaces עם 4+ inbound	16/29	26/29
חציון TTFB (20 משטחים)	360ms	250ms
Lint failures (12 בדיקות)	—	0/97
Audit-gated deploys	לא	כן

§ 04מה לא נעשה

§ 05איך מוסיפים משטח עכשיו