מתחילים כאן
מפת הרפוזיטורי
משטחי החברה והמוצר, מבנה הקוד, הרצה מקומית ובדיקות.
בעמוד הזה
קוד המקור של LinkNodes Energy — פלטפורמה לטעינה חשמלית לנהגים פרטיים ולציי רכב, בעברית ובתצוגת RTL.
הרפוזיטורי הראשי: DigitalOps-Inc/LinkNodesEnergy · ענף ראשי: main.
כל שינוי בקוד, במיגרציות, בנכסי הממשק ובתיעוד מנוהל כאן ב־Git. Vercel משמש לבנייה ולהרצת האפליקציה; Supabase משמש למסד הנתונים ולאחסון. הסודות ומשתני הסביבה מוגדרים בשירותי ההרצה ואינם נשמרים ברפוזיטורי.
המערכת#
| ממשק | כתובת | APP_SURFACE |
|---|---|---|
| אתר החברה | https://linknodesenergy.com | website |
| המוצר | https://product.linknodesenergy.com | product |
| כניסה לניהול החברה | https://admin.linknodesenergy.com | admin |
שלושת הממשקים נבנים מאותו 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.
תיעוד שימושי#
- ארכיטקטורה והרשאות מולטי־טננט
- רשת הטעינה ומקורות הנתונים בישראל
- בחירת ערים, רחובות וכתובות
- בחירת ספקים לפי לקוח
- זיהוי רכבים לפי מספר רישוי
- מערכת תמונות הרכב
- לוגואים של יצרנים ומצב הכיסוי
- מודל מסחרי ומנויים
- פרופילים וערכות נושא
- Product System
מסמכי שחרור מתארים את המצב בתאריך השחרור שלהם; אין להסיק ממסמך ישן שמחליף מידע מאוחר יותר. מזהי 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.