# Visual System

> תיעוד מקור. מקור: docs/visual-system.md · 6a466bf.

## ההבטחה הוויזואלית

אנרגיה שרואים, בהירות שמרגישים. מערכת מקורית ל־LinkNodes Energy שמחברת צבעוניות של מוצר SaaS עם ביטחון וקריאות של מוצר טעינה. היא שואבת השראה מן הבהירות והצבעוניות שביקש המשתמש, ולא מעתיקה נכסים או רכיבים של Monday.com.

## צבע ותפקיד

| תפקיד       | טוקן                  | ערך       | שימוש                    |
| ----------- | --------------------- | --------- | ------------------------ |
| פעולה ראשית | `--ev-brand-primary`  | `#4B3EFF` | CTA, בחירה וניווט פעיל   |
| מצב hover   | `--ev-brand-hover`    | `#382ACB` | תגובת כפתור ראשי         |
| עוגן כהה    | `--ev-brand-midnight` | `#161B36` | ניווט, מסגרת מותג, טעינה |
| אנרגיה      | `--ev-energy`         | `#C4FF48` | סוללה והדגשות אנרגיה     |
| סגול        | `--ev-brand-violet`   | `#8052F5` | עומק ואיור               |
| טורקיז      | `--ev-cyan`           | `#00C6D7` | משטח גרפי ומידע          |
| קורל        | `--ev-coral`          | `#FF638C` | מועדפים ואופי            |
| ענבר        | `--ev-amber`          | `#FFBD3E` | הספק ודירוג              |
| קנבס        | `--ev-background`     | `#F4F5FB` | סביבת העבודה             |
| כרטיס       | `--ev-surface`        | `#FFFFFF` | תוכן וטפסים              |

נקודת הפתיחה לקומפוזיציה: 70% משטח ניטרלי, 20% מבנה, 10% צבע מודגש. זהו כלל עיצובי ולא חלוקה שיש לאכוף בקוד. בחרו מוקד צבע אחד בכל אזור. אל תשתמשו באותו צבע גם להצלחה וגם לשגיאה.

צבעי המותג אינם צבעי סטטוס. השתמשו ב־`ev-success`, `ev-warning`, `ev-danger`, `ev-info` ובמשטחים שלהם למשמעות תפעולית. כל סטטוס כולל תווית, ובמידת הצורך אייקון. לליים ולטורקיז רוויים מתאימים טקסטים כהים; טקסט לבן מתאים לאינדיגו ולסגול המוגדרים. אין להניח שכל צמד צבעים בפלטה נגיש.

## טיפוגרפיה

- Heebo לתוכן עברי ו־Manrope למספרים, יחידות ומותג.
- כותרת מותג: 48–72px במחשב, 38–44px בנייד.
- כותרת עמוד: 32–40px במחשב, 28–32px בנייד.
- כותרת אזור: 20–24px; כותרת כרטיס: 16–20px.
- טקסט שוטף: 14–16px; תווית: 12–13px. טקסט לוגו וקואורדינטות דקורטיביות יכולים להיות קטנים יותר.
- משקלים: 400–500 תוכן, 600 תוויות, 700–750 כותרות ומספרים.
- גובה שורה 1.6–1.8 בעברית, 1.25–1.4 בכותרות. RTL לתוכן, LTR למספרים עם יחידות לועזיות. מספרים בטבלאות משתמשים בספרות ברוחב קבוע.

## קומפוזיציה וריווח

סולם של 4px: 4, 8, 12, 16, 20, 24, 32, 40, 48, 64, 96.
דשבורד במחשב: ניווט 236px, תוכן עד 1560px, שוליים 32px. מתחת ל־900px הניווט נפתח בתפריט. בנייד: 16px שוליים ועמודה אחת; צמד כרטיסי KPI יכול להישאר בשתי עמודות. טופס או טבלה אינם דוחפים את רוחב המסך.

מבנה מסך: הקשר וניווט → כותרת/פעולה → מבט מהיר → אזור עבודה → מידע משני. לא מוסיפים אזור Hero גדול כשאינו מסייע למשימה. במסכי עבודה צפופים, אזור העבודה מקבל את רוב השטח.

## עומק ומשטחים

- Base: קנבס ללא צל.
- Raised: כרטיס לבן, גבול עדין וצל קצר.
- Floating: חלון, תפריט או כרטיס מעל מפה — צל רחב ומיקוד ברור.
- רדיוס: 8–12px לבקרים, 16–22px לכרטיסים, 28px למשטח מותג גדול.
- גרדיאנט מותג מיועד לפתיחת עמוד, כרטיס רכב וארנק. גרדיאנט אנרגיה מיועד לאיורים ורגעי סוללה.
- זוהר מוגבל לפעולה ראשית ולחתימת אנרגיה. אינו מחליף מסגרת focus ואינו משמש סביב כל כרטיס.

## נתונים וגרפים

כרטיס KPI כולל תווית, מספר, יחידה והקשר. צבע סדרה נשאר קבוע בכל המסך. צבעי `ev-chart-1..4` מותאמים לרקע לבן ונבדקים לניגודיות 3:1 לפחות. עמודות מתחילות באפס; ערכים ויחידות מופיעים במפורש; נתוני דוגמה מסומנים. הגרף בספרייה כולל טבלה חלופית עם אותם שבעה ערכים וסכום 170kWh. לא מציגים מגמות, השוואות או שיפור שאין להם נתונים.

## אייקונים ואיור

Lucide, קו מעוגל, 20–24px ובעובי 1.8–2px. מיכל אייקון בכרטיס: 40–48px. מילוי מסמן בחירה, למשל לב מועדף. אייקון דקורטיבי מוסתר מקוראי מסך. כפתור ללא טקסט מקבל שם נגיש.
איורי LinkNodes Energy מקוריים ב־SVG: מסלול אליפטי, אריח בהטיה של 8–12 מעלות וברק מרכזי. צבע מרכזי ועד שלושה צבעי משנה. האיור הוא דקורטיבי ומופרד מתוכן אינטראקטיבי. קובץ: `components/energy-art.tsx`.

## תנועה

120ms ל־hover, 200ms לבחירה/כניסת רכיב, 360ms למעבר גדול. אנימציות הסבר רצות פעם אחת. אין הבהוב או תנועה מתמשכת ברקע. מכבדים `prefers-reduced-motion` ואת הגדרת ההפחתה של המוצר. הדגמת התנועה בספרייה כוללת מתג מקומי וכפתור ניגון.

## מימוש ומסירה

- מקור טוקנים: `styles/tokens.css` — 90 טוקנים.
- רכיבים: `components/ui/index.tsx`, `styles/components.css`.
- יישום חזותי במוצר: `styles/visual-theme.css`.
- ספרייה: `/visual-system`, הגדרות וטקסטים: `lib/visual-system.ts`.
- JSON להורדה: `/visual-system/tokens.json`; ספריית הרכיבים משתמשת באותו קובץ ב־`/design-system/tokens.json`.
- שמות הטוקנים הישנים forest/sand נשארו לתאימות לרכיבים קיימים. מסכים חדשים משתמשים בשמות התפקידים החדשים: brand, energy, chart.
- JSON הוא מיפוי CSS, לא פורמט Figma או DTCG. אין קובץ Figma נפרד בשלב זה.

## בקרת איכות

בודקים ניגודיות, RTL, תוויות, יחידות, מצבי בחירה וריק, מקלדת, reduced motion וגדלי מסך. בדיקות אוטומטיות מאמתות זוגות טקסט, צבעי גרפים וסנכרון הטוקנים, וכן העתקת צבע, הצגת טבלה, מעבר בין תבניות והורדת קובץ. מבדק נגישות מלא עם משתמשים וקוראי מסך נשאר שער להשקה.
