# SmartAir · הנחיות הטמעה למפתחים

מדריך אחד לשילוב עמודי ה-SEO (ישראייר, אל על, חגי תשרי) בקוד של אתר SmartAir.
הקוד הוא HTML/CSS סטטי, ללא תלות בספריות חיצוניות וללא JavaScript הכרחי (פרט לאינטראקציה קוסמטית במוקאפ).

> **TL;DR למפתח:** כל עמוד מורכב מ-(1) בלוקי תוכן HTML מעוצבים שמוזרקים לגוף העמוד, (2) תגיות meta + JSON-LD שנכנסות ל-`<head>`, (3) נכסים (לוגו/תמונות) שמתארחים ב-CDN שלכם. **שמרו על מנוע ההזמנות הקיים שלכם** — המנוע בעמודי הדמו הוא מוקאפ ויזואלי בלבד.

---

## 1. מה קיבלתם (מבנה הקבצים)

| קובץ | מטרה | מה לעשות איתו |
|------|------|----------------|
| `*-demo.html` | עמוד מלא לתצוגה (reference) | להסתכל, להשוות ויזואלית. **לא** להעתיק כמו שהוא לפרודקשן |
| `*-content-blocks.html` | בלוקי התוכן להטמעה (scoped) | **זה המקור להעתקה.** כל בלוק מסומן ב-`<!-- ===== בלוק X ===== -->` |
| `הוראות-הטמעה*.md` | meta + כל ה-JSON-LD schema פר עמוד | להעתיק ל-`<head>` |
| `*-logo.svg`, `*.jpg` | נכסים (לוגואים, תמונות) | להעלות ל-CDN/שרת הסטטי שלכם ולעדכן נתיבים |

עמודים:
- ישראייר → `israir-content-blocks.html` + `הוראות-הטמעה.md`
- אל על → `elal-content-blocks.html` + `הוראות-הטמעה-אלעל.md`
- חגי תשרי → `tishrei-demo.html` (עמוד נחיתה עונתי, מבנה זהה)

חי לצפייה: **https://smartair-israir.vercel.app**

---

## 2. שתי דרכי הטמעה (בחרו לפי העמוד)

### דרך A — הזרקת תוכן לעמוד קיים (ישראייר, אל על)
לעמודים `smartair.co.il/israir` ו-`/elal-flights` שכבר קיימים עם מנוע ההזמנות האמיתי:
1. השאירו את מנוע ההזמנות הקיים במקומו.
2. החליפו/הוסיפו את אזור התוכן העריכותי בבלוקים שלנו (בלוק 2 והלאה).
3. בלוק 1 (HERO + H1) — או שתעטפו בו את המנוע הקיים, או שתשתמשו רק ב-H1 ובפסקת הפתיח ותשאירו את המנוע מתחת.

### דרך B — עמוד חדש (חגי תשרי)
ל-`/tishrei-flights` (עמוד חדש):
1. צרו route חדש בתבנית העמוד הסטנדרטית שלכם (header/footer של האתר).
2. הזריקו את כל הבלוקים לגוף.
3. שלבו את מנוע ההזמנות האמיתי שלכם במקום ה-`search-card` המוקאפ.

---

## 3. מנוע החיפוש — קריאה חובה ⚠

ה-`search-card` / `.fields` בעמודי הדמו הוא **מוקאפ ויזואלי בלבד** (כולל ה-`onclick="alert(...)"`). אסור להעלות אותו כמנוע אמיתי.

**אפשרות 1 (מומלצת):** השאירו את מנוע ההזמנות הקיים של SmartAir, והחילו עליו את צבעי המעטפת שלנו אם רוצים אחידות.
**אפשרות 2:** עטפו את המנוע הקיים שלכם ב-`id="sa-search"` כדי שכל הקישורים והכפתורים בעמוד (`href="#sa-search"`) יקפיצו אליו.

---

## 4. הטמעה צעד-צעד

1. **`<head>`** — הדביקו מהקובץ `הוראות-הטמעה*.md`:
   - `<title>` ו-`<meta name="description">` (סעיף 3 שם)
   - `<link rel="canonical">`
   - כל בלוקי ה-`<script type="application/ld+json">` (FAQPage, TravelAgency, BreadcrumbList, ItemList, WebPage+Speakable)
   - תגיות Open Graph
2. **CSS** — העתיקו את בלוק ה-`<style>` מתחילת קובץ ה-`content-blocks`. הוא צריך להופיע **פעם אחת** בעמוד. מומלץ להעביר אותו לקובץ CSS חיצוני שנטען בעמוד הזה.
3. **בלוקי גוף** — העתיקו את הבלוקים לפי הסדר בטבלה שבקובץ ההוראות. כל בלוק עטוף ב-`<section class="sa-israir ...">` (או `.sa-elal`).
4. **נכסים** — העלו לוגואים/תמונות ל-CDN שלכם ועדכנו `src`.
5. **קישורים** — עדכנו `href="#sa-search"` ל-ID האמיתי, וקישורי "קישורים שימושיים" לעמודים האמיתיים באתר.

---

## 5. CSS, גופנים ו-RTL

- **בידוד:** כל ה-CSS מוקצה תחת `.sa-israir` / `.sa-elal`, כך שלא יתנגש בסגנונות הקיימים. אל תסירו את ה-class העוטף מה-`<section>`.
- **משתני מותג:** להתאמת צבעים, ערכו רק את משתני ה-`:root`/`.sa-*` בראש ה-`<style>` (`--sa-primary` וכו'). פירוט בסעיף "צבעי מותג" של כל קובץ הוראות.
- **גופן:** ברירת המחדל `'Assistant','Heebo',system-ui,...`. אם האתר כבר טוען גופן, אפשר לשנות את `--sa-font` ל-`inherit`.
- **RTL:** ה-`<section>` מוגדר `direction:rtl`. ודאו שעמוד האב גם הוא `dir="rtl"`.

---

## 6. נכסים (לוגו ותמונות)

| נכס | קובץ | הערה |
|-----|------|------|
| לוגו ישראייר | `israir-logo.svg` | רשמי (מקור Wikimedia). לוודא הרשאת שימוש כשותף מכירות |
| לוגו אל על | `elal-logo.svg` | רשמי. צבע מותג `#193193` |
| HERO חגי תשרי | `tishrei-hero.jpg` | תמונת Unsplash (חופשי לשימוש) |
| כרטיסי חגים | `hol-rosh.jpg`, `hol-kippur.jpg`, `hol-sukkot.jpg` | Unsplash |

- העלו לנתיב סטטי באתר (למשל `/assets/`) ועדכנו את כל ה-`src`/`url()`.
- **הוסיפו `alt` תיאורי לכל תמונה** (טוב ל-SEO ולנגישות), למשל `alt="מטוס איירבוס A330 של ישראייר"`, `alt="נוף סנטוריני, טיסות לראש השנה"`.

---

## 7. כללי SEO קשיחים (אסור לפספס)

1. **H1 יחיד בעמוד** — "טיסות ישראייר" / "טיסות אל על" / "טיסות לחגי תשרי". אם קיים H1 ישן, הפכו ל-H2 או הסירו.
2. **טקסט אמיתי, לא תמונה** — אסור להפוך כותרות/פסקאות לתמונה.
3. **בלוק "תשובה מהירה" (GEO)** — להשאיר גבוה בעמוד; זה מה שמנועי AI מצטטים.
4. **הסכמות חייבות להישאר תואמות לטקסט הגלוי.** אם משנים טקסט ב-FAQ, מעדכנים גם ב-JSON-LD.
5. **`dateModified`** בסכמת WebPage — לעדכן בכל עדכון מהותי.

---

## 8. נתונים שמשתנים (לחבר/לעדכן בצד שלכם)

- **מחירים** — לא מקובעים בקוד. או לחבר דינמית למערכת ההזמנות, או לעדכן ידנית "החל מ-".
- **זמני טיסה** — משוערים ומסומנים ככאלה. לא חובה לעדכן.
- **תאריכי חגי תשרי** — אומתו ל-2026 (תשפ"ז). בשנה הבאה לעדכן.
- **בלוק חדשות** — "טרי", לרענן מעת לעת.

---

## 9. צ׳קליסט מסירה (פר עמוד)

- [ ] `<title>` + `description` + `canonical` הוטמעו
- [ ] כל בלוקי ה-JSON-LD ב-`<head>` ועוברים ב-[Rich Results Test](https://search.google.com/test/rich-results)
- [ ] H1 יחיד ונכון
- [ ] CSS מוקצה נטען פעם אחת; אין שבירת עיצוב באתר
- [ ] מנוע ההזמנות האמיתי משולב (לא המוקאפ), עם `id="sa-search"`
- [ ] לוגואים/תמונות מאוחסנים ב-CDN שלכם + `alt` לכל תמונה
- [ ] קישורים פנימיים מצביעים לעמודים אמיתיים
- [ ] בדיקת מובייל (responsive) ומהירות טעינה
- [ ] לאחר עלייה: Request Indexing ב-Search Console + עדכון sitemap

---

## 10. סדר עבודה מומלץ

ישראייר ואל על קודם (עמודים קיימים, החלפת תוכן), חגי תשרי כעמוד חדש. אחרי הטמעה ואינדוקס, עוקבים ב-Search Console אחרי הביטויים "טיסות ישראייר" / "טיסות אל על" / "טיסות לחגי תשרי".

לשאלות על מבנה הבלוקים — הכל מתועד בתוך קבצי ה-`content-blocks` עצמם (הערות HTML) ובקובצי `הוראות-הטמעה*.md`.
