# תוכנית ה־Frontend

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

## יעד המוצר

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

## שלב 1 — תשתית ושפת עיצוב

- מערכת טוקנים משותפת לצבע, טיפוגרפיה, ריווח, רדיוסים, צללים ותנועה.
- ספריית רכיבים מתועדת ב־`/design-system`: כפתורים, שדות, מתגים, תגיות, הודעות, התקדמות, טאבים, חלונות וטעינה.
- כתובת ישירה לכל מסך באמצעות Next App Router. תמיכה ברענון, קישור עמוק וחזרה/קדימה בדפדפן.
- ניווט צדדי מותאם לנייד, כותרת לכל עמוד, קישורים משפטיים ומצבי 404, טעינה ושגיאה.
- ערכים מספריים ברורים, תאריכים לפי Asia/Jerusalem, עבודה עם מקלדת ומצבי מיקוד.

## שלב 2 — מסע הנהג

| כתובת            | תכולה והתנהגות                                                      |
| ---------------- | ------------------------------------------------------------------- |
| `/`              | מפה ורשימה, חיפוש, סינון, מיון, מיקום ומידע על הרכב                 |
| `/favorites`     | הוספה והסרה של מועדפים, שמירה וריקון הרשימה                         |
| `/stations/:id`  | זמינות לדוגמה, מחבר, הספק, מחיר, שירותים, מועדף ופתיחת מסלול חיצוני |
| חלון קוד עמדה    | הזנה ידנית, ולידציה, הודעה על קוד לא מוכר                           |
| חלון התחלת טעינה | יעד סוללה, אומדן עלות, בדיקת חיבור, זמינות וטעינה קיימת             |
| `/charging`      | סוללה, התקדמות, אנרגיה, מחיר, זמן ואישור סיום                       |
| `/history`       | רשימת טעינות שהסתיימו, נתונים מצטברים וייצוא CSV                    |
| `/history/:id`   | פירוט טעינה, זמן, תעריף, סוללה, הורדת JSON והדפסה                   |
| `/vehicle`       | דגם רכב, לוחית, קיבולת סוללה, מצב סוללה ומחבר                       |

תנאי קבלה: התהליך מתחיל רק עם קלט תקין; טעינה פעילה שורדת רענון; סיום נשמר פעם אחת; הסיכום מקושר מההיסטוריה; נתונים לא תקינים באחסון לא מפילים את האתר.

## שלב 3 — המרחב האישי

| כתובת                 | תכולה והתנהגות                                                                |
| --------------------- | ----------------------------------------------------------------------------- |
| `/account`            | עריכת שם ואימייל אופציונלי עם ולידציה ושמירה מקומית                           |
| `/billing`            | הוספה/הסרה של כרטיסים בדויים, בחירת ברירת מחדל וסיכומי טעינות                 |
| `/notifications`      | עדכונים מתוך פעילות ההדגמה, סימון כנקרא וסינון                                |
| `/settings`           | העדפות, הפחתת תנועה, ייצוא נתונים ואיפוס מאושר ומוגבל לנתוני LinkNodes Energy |
| `/onboarding`         | תהליך היכרות בשלושה שלבים, התאמת שם וקישור להגדרת רכב                         |
| `/login`, `/register` | מסכי גישה והסבר על מצב ההדגמה; רכיבי Clerk רק כאשר השירות מוגדר               |

תנאי קבלה: אין איסוף פרטי כרטיס אמיתיים או סיסמאות במצב הדגמה; העדפות נשמרות; מחיקה דורשת אישור ואינה מוחקת מידע של יישומים אחרים; מוצגים מצבים ריקים אמיתיים.

## שלב 4 — תמיכה ואמון

- `/support`: חיפוש שאלות, תשובות נפתחות, ולידציית טופס, שמירת טיוטות תמיכה ומחיקתן. מוצג בבירור שהטיוטות אינן נשלחות.
- `/privacy`: הסבר על נתונים מקומיים, מיקום ושירותים חיצוניים.
- `/terms`: תנאי סביבת ההדגמה וההבדל בין סיכום הדמיה למסמך חשבונאי.
- `/accessibility`: יכולות, התאמות ומגבלות הבדיקה; ללא טענה לאישור תקן מלא.
- `/roadmap`: תוכנית המוצר, מפת מסכים וקישורים להמשך.

## שלב 5 — בדיקות ופריסה

1. בדיקות טיפוסים ו־ESLint.
2. בדיקות יחידה ללוגיקת טעינה ולטוקנים/ניגודיות.
3. בדיקות דפדפן למפה, סינון, מועדפים, תהליך טעינה, קלט לא תקין, היסטוריה ושמירה.
4. בדיקות לתהליכי הפרופיל, הארנק, טיוטות, התראות, איפוס, ניווט ישיר וחזרה בדפדפן.
5. בדיקת רוחב נייד ומעברי מסכים, צילום ובחינה חזותית של עמודים מייצגים.
6. בניית Production מקומית, פריסת Preview ב־Vercel ואימות האתר שנפרס.

## המשך לבקאנד — מחוץ לשלב הנוכחי

1. Clerk: כניסה, הרשמה, שחזור גישה, ניהול חשבון וזהות בצד השרת.
2. Supabase: סנכרון, מדיניות הרשאות, רכב, מועדפים, טעינות ופרופיל.
3. ספק טעינה: זמינות אמיתית, פקודות התחלה וסיום, מדידות וניתוקים.
4. ספק תשלומים: tokenization, אישור חיוב, מניעת כפל חיובים, קבלות וזיכויים.
5. שירותי התראות ותמיכה: העדפות, דיוור, push ופניות שירות אמיתיות.
6. תפעול: ניטור, אירועי מוצר, תורים, עמידות בתקלות וסודות שירות בצד שרת בלבד.

## שער השקה

לפני שימוש מסחרי נדרשים בדיקת משתמשים, מבדק נגישות עם קוראי מסך, בדיקות Safari/iOS ו־Android על מכשירים אמיתיים, אבטחת אינטגרציות, בדיקת תקלות ספק ונוסחים משפטיים מאושרים. הבדיקות האוטומטיות הנוכחיות ב־Chromium אינן תחליף לכך.

## תוצאות אימות לגרסה הנוכחית

- 27 בדיקות יחידה: עברו.
- 15 בדיקות דפדפן: עברו (13 בהרצה הראשונית; שתי בדיקות הורצו שוב לאחר צמצום בורר ההודעות לממשק כדי להבחין בינו לבין מודיע הניווט של Next.js).
- TypeScript ו־ESLint: ללא שגיאות או אזהרות.
- בניית Next.js לייצור: עברה.
- בדיקות רוחב: כלל המסכים החדשים ב־390px; חשבון, ארנק, תמיכה, תוכנית והיכרות גם ב־320px, ללא גלילה אופקית.
- נבחנו צילומי מסך של הארנק במחשב ומרכז העזרה בנייד.
