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

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

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

    לאתר החברה

    מתחילים כאן

    מפת הרפוזיטורי

    משטחי החברה והמוצר, מבנה הקוד, הרצה מקומית ובדיקות.

    בעמוד הזה

    קוד המקור של LinkNodes Energy — פלטפורמה לטעינה חשמלית לנהגים פרטיים ולציי רכב, בעברית ובתצוגת RTL.

    הרפוזיטורי הראשי: DigitalOps-Inc/LinkNodesEnergy · ענף ראשי: main. כל שינוי בקוד, במיגרציות, בנכסי הממשק ובתיעוד מנוהל כאן ב־Git. Vercel משמש לבנייה ולהרצת האפליקציה; Supabase משמש למסד הנתונים ולאחסון. הסודות ומשתני הסביבה מוגדרים בשירותי ההרצה ואינם נשמרים ברפוזיטורי.

    המערכת#

    ממשקכתובתAPP_SURFACE
    אתר החברהhttps://linknodesenergy.comwebsite
    המוצרhttps://product.linknodesenergy.comproduct
    כניסה לניהול החברהhttps://admin.linknodesenergy.comadmin

    שלושת הממשקים נבנים מאותו codebase בפרויקטי Vercel נפרדים. אזור ניהול החברה הוא כניסה מוגנת; אין לראות בו מימוש מלא של כל תפעול החברה. פרטי ההפרדה והפריסה מופיעים ב־תיעוד המיתוג והדומיינים.

    מה כלול בקוד#

    • אתר חברה ומסלולי Personal, Family, Business ו־Enterprise, עם תשתית לתמחור מנויים ולעמלה על טעינה.
    • אפליקציית נהג עם מפה ארצית, בחירת עיר/רחוב/כתובת, מועדפים ובחירת ספקי טעינה.
    • זיהוי רכב לפי מספר רישוי, שמירת רכבים בחשבון, איורי דגמים ולוגואים מקוריים של יצרנים. תיעוד הכיסוי החלקי ומקורות הנכסים נשמר לצד הקוד.
    • מרחבים אישיים ועסקיים, onboarding, חברות בארגונים, הרשאות, רכבי צי ומסכי ניתוח נתונים.
    • פרופיל משתמש וארגון, תמונה/לוגו, תמיכה במצב בהיר וכהה וממשק RTL מותאם למובייל.
    • Design System, Visual System, Product System, Architecture System ו־Data System, עם ספריות ותיעוד.
    • API, מיגרציות PostgreSQL, מדיניות RLS, חוזי חיבור לספקים ובדיקות יחידה ודפדפן.

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

    הרצה מקומית#

    נדרשים Node.js 22 ומעלה ו־pnpm 11.25.0, בהתאם ל־package.json ול־lockfile.

    git clone https://github.com/DigitalOps-Inc/LinkNodesEnergy.git
    cd LinkNodesEnergy
    corepack enable
    pnpm install --frozen-lockfile
    cp .env.example .env.local
    pnpm dev
    

    פותחים את localhost:3000. הרפוזיטורי פרטי ולכן נדרשת הרשאת GitHub לשכפולו. ברירת המחדל היא APP_SURFACE=product. התצוגות המקומיות ניתנות להרצה ללא סודות; יכולות חשבון ונתונים חיים דורשות Clerk ו־Supabase. מפות ומקורות נתונים חיצוניים דורשים חיבור לרשת.

    הגדירו ערכים מקומיים ב־.env.local לפי .env.example. חיבור Clerk ל־Supabase דורש גם הגדרת אמון בספק ההזדהות; ראו ארכיטקטורת הפלטפורמה. אין להעתיק נתוני לקוחות או סודות ייצור לקבצים שמנוהלים ב־Git.

    בדיקות ובנייה#

    pnpm typecheck
    pnpm lint
    pnpm test
    pnpm build
    pnpm start
    

    בדיקות דפדפן:

    pnpm exec playwright install chromium
    pnpm test:e2e
    

    אפשר להגדיר PLAYWRIGHT_BASE_URL כדי לבדוק שרת שכבר פועל. סקריפטי בדיקות בידוד מסד הנתונים מיועדים למסד בדיקות ייעודי לפי הוראותיהם, ואינם חלק מבדיקות היחידה הרגילות.

    תהליך GitHub Actions בודק התקנה עם lockfile, יצוא ספריות המערכת, טיפוסים, lint, בדיקות יחידה ובנייה ללא סודות ענן. בדיקות הדפדפן מופעלות בנפרד.

    מבנה הרפוזיטורי#

    נתיבתפקיד
    app/נתיבים, API ומשטחי האתר/המוצר/הניהול
    components/רכיבי הממשק, מפה, רכבים וצי
    lib/לוגיקת מוצר, הרשאות, תמחור ונתוני ייחוס
    styles/עיצוב, טוקנים וערכות נושא
    public/תמונות רכב, לוגואים, אייקונים וספריות לפרסום
    supabase/migrations/קוד סכמת הנתונים, מדיניות RLS ומיגרציות
    scripts/הכנת נתונים, יצוא מערכות ובדיקות ייעודיות
    tests/בדיקות Playwright
    docs/ארכיטקטורה, מקורות נתונים, מגבלות ותיעוד פריסות

    node_modules, תוצרי .next, קובצי סודות, קובצי עבודה ודוחות בדיקות אינם מנוהלים ב־Git. נכסי MapLibre נבנים אוטומטית ב־postinstall.

    תיעוד שימושי#

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

    Account plans and capacity enforcement: Personal, Family, Business and Enterprise.

    Product packaging: 40-feature catalog and subscription lifecycle, with pricing and delivery rationale. The website comparison and Commercial System use these versioned sources; financial activation remains separate.