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

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

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

    לאתר החברה

    ארכיטקטורה וטכנולוגיה

    מחסנית הטכנולוגיה

    רכיבי הווב, המובייל, הנתונים, התורים והתפעול, ותחום האחריות של כל אחד.

    בעמוד הזה

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

    רכיבי המערכת#

    שכבהטכנולוגיות מתועדותאחריות וגבול
    ווב ו־APINext.js App Router, React, TypeScriptממשקים, נתיבים ועבודת שרת תחומה; בחירת משטח באמצעות APP_SURFACE
    ממשק וובCSS tokens, רכיבי UI, Lucide, MapLibre GLשפה חזותית, רכיבים, אייקונים ומפה; הנכסים המאושרים נשארים מקור האמת
    מוביילExpo, React Native, Expo Routerאפליקציה נייטיבית עם התאמות iOS ו־Android
    שירותי מכשירExpo SecureStore, Location, Linking; react-native-mapsאחסון מאובטח במכשיר, מיקום בחזית, קישורים ומפה נייטיבית
    זהותClerk לווב ול־Expoאימות משתמש; אינו מחליף בדיקת חברות והרשאה במרחב
    נתוניםSupabase PostgreSQL, RLS ו־Storageמקור האמת לנתוני לקוח, חברות, רכבים, כספים וקבצים
    חוזי קלטZod, טיפוסי TypeScript, OpenAPIאימות מבנה וגבולות בקשה, חוזי שירות ותיעוד API
    עבודה ברקעRedis, ioredis, BullMQמטמון ותורים; הנתונים העסקיים המחייבים נשארים ב־PostgreSQL
    הרצת workersתהליך מתמשך נפרד, מתועד ב־Railwayחיי תהליך ותורים שאינם מתאימים לפונקציית בקשה קצרה
    תשלומיםמתאם HYP בצד השרתתשתית תשלום ומסמכים, עם מתגי הפעלה והרשאות ספק נפרדים
    טפסי החברהCloudflare Turnstile, Supabase Edge Functionאימות בקשה וכתיבה פרטית לטפסי קשר ומועמדות
    ניתוח וניטורPostHog, Grafana Faroאירועים וניטור עם כללי סינון ותנאי הפעלה לפי פלטפורמה
    אירוח והפצהGitHub, Vercel, Cloudflareניהול מקור ובדיקות, אירוח ווב, DNS וגבול רשת
    בדיקותVitest, Playwright, PostgreSQL מבודדלוגיקה, תרחישי ממשק וראיות לבידוד/אטומיות במאגר בדיקות

    קובצי package.json וה־lockfile הם מקור האמת לגרסאות התלויות. במקור המוצג הווב מצהיר על סדרות Next.js 16 ו־React 19; אפליקציית המובייל משתמשת בסדרת Expo 58 וב־React Native 0.88. מדריך זה אינו מסמן גרסה כ״האחרונה״ בשוק ואינו מחליף את ה־lockfile. מפת הרפוזיטורי ומדריך המובייל מתארים הרצה ופיתוח.

    חלוקת אחריות#

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

    PostgreSQL נשאר מקור האמת. Redis מספק מטמון ותורים; אין להעביר אליו את הסמכות לרשומות חיוב או לבידוד לקוחות. מסמך Redis ו־BullMQ מתעד גם את התוכנית המקורית וגם את בדיקת התשתית המאוחרת. worker ה־smoke מוכיח קישוריות תשתית, ואינו מוכיח שמתאמי הספקים העסקיים הופעלו.

    עבודה עם עמדות וספקים#

    עבודה מתמשכת מול עמדה, WebSocket או gateway של OCPP אינה רצה בתוך פונקציית בקשה רגילה ב־Vercel. פרוטוקול, זהות ספק, פקודות, אירועים, חזרה על הודעות והתאמה חייבים להיות מוגדרים במתאם הספק. הארכיטקטורה ההיסטורית מציינת גם RabbitMQ ו־OCPP כאפשרויות תכנון; עצם האזכור אינו ראיה ל־broker או gateway חי.

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

    ספריות המערכת#

    • Design System מגדיר טוקנים, רכיבים, נגישות ו־RTL.
    • Visual System מגדיר צבע, טיפוגרפיה, קומפוזיציה, תנועה ונכסים.
    • מערכת הסאונד משתמשת ב־Web Audio מקומי ובאינטראקציה מפורשת.
    • Product System מגדיר יכולות, מסעות וכללים.
    • Architecture System מגדיר שירותים, חוזים והחלטות.
    • Data System מגדיר יחידות, קשרים, מחזור חיים ומילון סכימה.

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