מוצר ויכולות
תוכנית ה־Frontend
תוכנית הממשק, תכולת המסכים ומצבי המוצר; יש לקרוא כתוכנית מקור.
בעמוד הזה
יעד המוצר#
אפליקציית טעינה לנהגים, בעברית 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 — בדיקות ופריסה#
- בדיקות טיפוסים ו־ESLint.
- בדיקות יחידה ללוגיקת טעינה ולטוקנים/ניגודיות.
- בדיקות דפדפן למפה, סינון, מועדפים, תהליך טעינה, קלט לא תקין, היסטוריה ושמירה.
- בדיקות לתהליכי הפרופיל, הארנק, טיוטות, התראות, איפוס, ניווט ישיר וחזרה בדפדפן.
- בדיקת רוחב נייד ומעברי מסכים, צילום ובחינה חזותית של עמודים מייצגים.
- בניית Production מקומית, פריסת Preview ב־Vercel ואימות האתר שנפרס.
המשך לבקאנד — מחוץ לשלב הנוכחי#
- Clerk: כניסה, הרשמה, שחזור גישה, ניהול חשבון וזהות בצד השרת.
- Supabase: סנכרון, מדיניות הרשאות, רכב, מועדפים, טעינות ופרופיל.
- ספק טעינה: זמינות אמיתית, פקודות התחלה וסיום, מדידות וניתוקים.
- ספק תשלומים: tokenization, אישור חיוב, מניעת כפל חיובים, קבלות וזיכויים.
- שירותי התראות ותמיכה: העדפות, דיוור, push ופניות שירות אמיתיות.
- תפעול: ניטור, אירועי מוצר, תורים, עמידות בתקלות וסודות שירות בצד שרת בלבד.
שער השקה#
לפני שימוש מסחרי נדרשים בדיקת משתמשים, מבדק נגישות עם קוראי מסך, בדיקות Safari/iOS ו־Android על מכשירים אמיתיים, אבטחת אינטגרציות, בדיקת תקלות ספק ונוסחים משפטיים מאושרים. הבדיקות האוטומטיות הנוכחיות ב־Chromium אינן תחליף לכך.
תוצאות אימות לגרסה הנוכחית#
- 27 בדיקות יחידה: עברו.
- 15 בדיקות דפדפן: עברו (13 בהרצה הראשונית; שתי בדיקות הורצו שוב לאחר צמצום בורר ההודעות לממשק כדי להבחין בינו לבין מודיע הניווט של Next.js).
- TypeScript ו־ESLint: ללא שגיאות או אזהרות.
- בניית Next.js לייצור: עברה.
- בדיקות רוחב: כלל המסכים החדשים ב־390px; חשבון, ארנק, תמיכה, תוכנית והיכרות גם ב־320px, ללא גלילה אופקית.
- נבחנו צילומי מסך של הארנק במחשב ומרכז העזרה בנייד.