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

> מדריך. מקור: apps/docs/content/guides/technology-stack.md · 6a466bf · 2026-11-21.

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

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

| שכבה         | טכנולוגיות מתועדות                                     | אחריות וגבול                                                        |
| ------------ | ------------------------------------------------------ | ------------------------------------------------------------------- |
| ווב ו־API    | Next.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. [מפת הרפוזיטורי](/repository-overview) ו[מדריך המובייל](/mobile-overview) מתארים הרצה ופיתוח.

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

הדפדפן והמכשיר מציגים נתונים ומגישים בקשות. השרת מאמת זהות וקלט, ומסד הנתונים אוכף חברות פעילה, תחום לקוח וכללי קשר. חברות ב־Clerk Organization אינה לבדה מקור הרשאה למרחב LinkNodes. עובדות כספיות ועובדות ספק נכתבות דרך מסלול שרת מהימן. [יסודות הפלטפורמה](/platform-architecture) ו[ספר הארכיטקטורה](/architecture-handbook) מתעדים את גבולות האמון.

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

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

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

[מפת האינטגרציות](/integrations) מציגה את ההבדל בין קטלוג עמדות, יבוא לקוח, חוזה API וחיבור תפעולי מאומת.

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

- [Design System](/design-system) מגדיר טוקנים, רכיבים, נגישות ו־RTL.
- [Visual System](/visual-system) מגדיר צבע, טיפוגרפיה, קומפוזיציה, תנועה ונכסים.
- [מערכת הסאונד](/sound-system) משתמשת ב־Web Audio מקומי ובאינטראקציה מפורשת.
- [Product System](/product-system-handbook) מגדיר יכולות, מסעות וכללים.
- [Architecture System](/architecture-handbook) מגדיר שירותים, חוזים והחלטות.
- [Data System](/data-handbook) מגדיר יחידות, קשרים, מחזור חיים ומילון סכימה.

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