דילוג לתוכן
מרכז התיעוד
לאתר LinkNodes Energy
LinkNodesENERGYתיעוד

טוענים את החיפוש…

    חיפוש גם בתוך המאמרים ↑ ↓ לניווט Esc לסגירה

    לאתר החברה

    מוצר ויכולות

    תוכנית ה־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 — בדיקות ופריסה#

    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, ללא גלילה אופקית.
    • נבחנו צילומי מסך של הארנק במחשב ומרכז העזרה בנייד.