נתונים ודיווח
קטלוג מערכת הנתונים
18 רשומות לתכנון נתונים, איכות, יחידות ומחזור חיים.
18 רשומות לתכנון נתונים, איכות, יחידות ומחזור חיים.
{
"meta": {
"name": "LinkNodes Energy Data System",
"version": "1.2.0",
"date": "2026-11-08",
"baseline": "f53f930",
"scope": "תכנון, מקור אמת בקוד וראיות ביצוע; אינו אישור מוכנות להפעלה מסחרית."
},
"sections": [
{
"id": "principles",
"title": "עקרונות ובעלות"
},
{
"id": "dictionary",
"title": "מילון הנתונים"
},
{
"id": "relationships",
"title": "קשרים ובידוד"
},
{
"id": "finance",
"title": "כסף ומדידה"
},
{
"id": "quality",
"title": "איכות ואנליטיקה"
},
{
"id": "lifecycle",
"title": "שימור ומחזור חיים"
},
{
"id": "evolution",
"title": "הרחבות ומיגרציות"
}
],
"entries": [
{
"id": "D01",
"section": "principles",
"title": "מקור אמת ובעלות",
"status": "foundation",
"owner": "Data",
"summary": "נתון עסקי שייך ל־tenant, עם חריגים מפורשים לקטלוג ציבורי ולסודות.",
"details": [
"קטלוג רכבים ומידע תחנות ציבורי אינם כוללים פרטי לקוחות.",
"User הוא זהות גלובלית; membership מחבר אותו ל־tenant אישי או עסקי.",
"הדגמה מקומית אינה מועתקת אוטומטית למסד; יבוא עתידי דורש מיפוי ובדיקות."
],
"evidence": ["lib/platform/types.ts"],
"dependencies": []
},
{
"id": "D02",
"section": "principles",
"title": "יחידות וזמן",
"status": "foundation",
"owner": "Data",
"summary": "כסף באגורות, אנרגיה ב־Wh, זמנים ב־timestamptz.",
"details": [
"ILS הוא המטבע הממומש כיום; אין לטעון לתמיכת ריבוי מטבעות.",
"תעריף דורש דיוק עשרוני וחוק עיגול מאושר. אין חשבון כספי עם float בדפדפן.",
"אירועים נשמרים בזמן מוחלט; חלונות דוחות עסקיים לפי Asia/Jerusalem כולל שעון קיץ.",
"bigint ב־JSON מוגבל ל־safe integer בחוזה או מועבר כמחרוזת עשרונית בגרסה עתידית."
],
"evidence": [
"supabase/migrations/20261107211048_platform_foundation.sql"
],
"dependencies": []
},
{
"id": "D03",
"section": "relationships",
"title": "שיוכים בתוך אותו ארגון",
"status": "foundation",
"owner": "Security",
"summary": "מפתחות זרים מורכבים מונעים חיבור רכב לנהג מארגון אחר.",
"details": [
"tenant_id,id הוא יעד לקשרים בין נהג, רכב, מרכז עלות, דלקן וטעינה.",
"מזהה tenant ומשאב אינם ניתנים לשינוי גם למשתמש שחבר בשני הארגונים.",
"בדיקות RLS עם משתמשים אמיתיים בענן נדרשות בנוסף למבחני SQL המקומיים."
],
"evidence": ["scripts/test-tenant-isolation.mjs"],
"dependencies": []
},
{
"id": "D04",
"section": "relationships",
"title": "היסטוריית שיוך וגורם משלם",
"status": "planned",
"owner": "Fleet",
"summary": "שיוך בזמן הפעולה חייב להישאר ניתן להסבר אחרי שינוי צי.",
"details": [
"טעינה כיום שומרת driver_id,vehicle_id והנחות צריכה; חסרים snapshot מלא של מרכז עלות וגורם משלם.",
"טבלת assignment_periods עתידית תמנע תקופות חופפות ותאפשר אירועי מעבר רכב.",
"אין להסיק הרשאה להיסטוריה רק מהנהג שמשויך לרכב היום."
],
"evidence": ["lib/platform/types.ts"],
"dependencies": []
},
{
"id": "D05",
"section": "finance",
"title": "יומן כספי והחזרים",
"status": "planned",
"owner": "Finance",
"summary": "רישומים בלתי משתנים עם פעולות תיקון מפורשות.",
"details": [
"ה־payments הקיים הוא תשתית סטטוסים; אין כיום ledger חשבונאי מלא.",
"הצעה: ledger_transactions ו־ledger_entries עם איזון חיוב/זיכוי לפי tenant ומטבע.",
"תיקון או החזר יוצרים רישום מקושר, ולא מחיקה של חיוב היסטורי.",
"מאמת האיזון בקוד הוא חוזה בדיקה; אכיפה אטומית במסד והקשר חשבונאי עדיין נדרשים.",
"ספר החברה אינו ledger של הלקוח: מזהה ישות משפטית וספר, ממד tenant, בקרה פיננסית של staff והתאמה למערכת החשבונאית."
],
"evidence": ["lib/systems/contracts.ts"],
"dependencies": []
},
{
"id": "D06",
"section": "finance",
"title": "שריון תקציב במקביל",
"status": "planned",
"owner": "Charging",
"summary": "בדיקת יתרה ושריון צריכים להתרחש באותה טרנזקציה.",
"details": [
"בדוק used + reserved + requested מול מסגרות ארגון, מרכז עלות, נהג ורכב.",
"נעילת שורות בסדר קבוע מפחיתה deadlocks; אין check-then-write בשתי בקשות נפרדות.",
"reservation נשאר תפוס כשמצב הפקודה לא ידוע. שחרור מותנה בראיה או בתהליך בירור.",
"שדות monthly_budget קיימים לתכנון; אכיפה מצטברת עדיין אינה ממומשת."
],
"evidence": ["lib/platform/domain.ts"],
"dependencies": []
},
{
"id": "D07",
"section": "finance",
"title": "תעריף קפוא ומדידה",
"status": "planned",
"owner": "Charging & Finance",
"summary": "התחשבנות מבוססת על מדידה מאומתת ועל תעריף שנשמר בזמן האישור.",
"details": [
"לשמור גרסת מחיר, מטבע, רכיבים, מסים, rounding ומזהה ספק ב־tariff_snapshot.",
"meter_samples דורשים מקור, session, יחידה, sequence, occurred_at ו־received_at.",
"תיקון מדידה מאוחר או מונה שהתאפס נכנסים לבירור; אין להניח שהמדידה האחרונה שהגיעה היא האחרונה בזמן."
],
"evidence": [],
"dependencies": []
},
{
"id": "D08",
"section": "quality",
"title": "הגדרות מדדים עסקיים",
"status": "foundation",
"owner": "Analytics",
"summary": "הוצאות וצריכה מטעות אם לא מגדירים מקור וחלון זמן.",
"details": [
"הדוח הקיים משתמש בטעינות completed ולפי ended_at; אינו דוח התחשבנות סופית מול PSP.",
"עלות לקוט״ש = amount_minor / (energy_wh / 1000) כאשר המכנה גדול מאפס.",
"חיסכון = עלות ייחוס פחות עלות חשמל; תוצאה שלילית נשמרת.",
"אומדן קילומטרים ו־CO₂ תלוי בצריכת הדגם ובהנחות, ואינו טלמטריה או מדידה מוסמכת."
],
"evidence": ["lib/platform/domain.ts"],
"dependencies": []
},
{
"id": "D09",
"section": "quality",
"title": "איכות, lineage וגרסאות",
"status": "planned",
"owner": "Data",
"summary": "לכל מדד מקור, טרנספורמציה ובדיקת איכות.",
"details": [
"Freshness לתחנות, שלמות מזהי ספק, כפילויות אירוע ומדידות חסרות נמדדים בנפרד.",
"שמור גרסת מתאם ו־payload hash; מזהה פקודה חוצה לוגים ללא מידע אישי.",
"הנחות הדוחות כיום מחושבות מחדש מהגדרות tenant. דוח כספי סגור ידרוש snapshot גרסאות."
],
"evidence": [],
"dependencies": []
},
{
"id": "D10",
"section": "quality",
"title": "שאילתות וביצועים",
"status": "planned",
"owner": "Data",
"summary": "גישה מתחילה בסינון tenant ובהרשאה, לפני aggregation.",
"details": [
"להוסיף cursor ויצוא אסינכרוני במקום הרחבת מגבלת התוצאה ללא גבול.",
"לבחון EXPLAIN ANALYZE על נפח דמוי פיילוט; אינדקסים לפי tenant_id,ended_at,id ושדות FK לפי תוכניות אמיתיות.",
"RLS יכול להוסיף עבודה לכל שורה; לשמר SELECT auth.jwt, חיפוש חברות מאונדקס ו־security_invoker לדוחות.",
"אין cache משותף ללא tenant/user/permission context ופסילה עם שינוי חברות."
],
"evidence": [],
"dependencies": []
},
{
"id": "D11",
"section": "lifecycle",
"title": "סיווג מידע ושימור",
"status": "planned",
"owner": "Privacy",
"summary": "שימור נקבע לפי צורך עסקי וחובה חוקית, ולא לפי ברירת מחדל של כלי.",
"details": [
"קטלוג ציבורי; פרטי קשר ולוחיות כמידע אישי; טעינות וכסף כמידע רגיש; token/hash כסוד.",
"לוח שימור לפי מחלקת מידע עדיין טעון אישור. אין TTL מומצא למסמכים כספיים.",
"סיום לקוח: חסימת פעולות, הסדרת יתרות, יצוא מאומת, מחיקה/פסאודונימיזציה לפי מדיניות ולוג ביקורת."
],
"evidence": [],
"dependencies": []
},
{
"id": "D12",
"section": "lifecycle",
"title": "מחיקה וגיבויים",
"status": "planned",
"owner": "Operations",
"summary": "בקשת מחיקה אינה מחיקה עיוורת של עובדות כספיות.",
"details": [
"להפריד מחיקת זהות, נתונים אישיים ורשומות שחובה לשמור. legal hold מונע מחיקה אוטומטית.",
"גיבויים כפופים ללוח שימור; שחזור חייב לשחזר גם הוראות מחיקה רלוונטיות.",
"קובצי יצוא יישמרו ב־Storage פרטי עם בדיקת הרשאה וקישור קצר־חיים."
],
"evidence": [],
"dependencies": []
},
{
"id": "D13",
"section": "evolution",
"title": "תוכנית הרחבת הסכימה",
"status": "planned",
"owner": "Data",
"summary": "שינויים תוספתיים עם מיגרציה ובדיקת תאימות.",
"details": [
"להוסיף tariff_snapshots, meter_samples, budget_reservations, assignment_periods, ledger_transactions, ledger_entries ו־subscription_entitlements רק עם חוזי ביצוע מאושרים.",
"Outbox ו־provider_events כבר קיימים כסכימה; חסרים relay, claim/lease, חוזה payload ו־retry/DLQ.",
"מתאם ספק יקבע תחום uniqueness נכון ומצבי timeout נוספים; אין לפתוח live charging לפני כן."
],
"evidence": [],
"dependencies": []
},
{
"id": "D14",
"section": "evolution",
"title": "תאימות ומעבר מהדגמה",
"status": "planned",
"owner": "Platform",
"summary": "שמות ev1 פנימיים נשמרים כדי לא לשבור מזהים קיימים.",
"details": [
"מיתוג ציבורי LinkNodes Energy נפרד ממזהי SQL ו־storage.",
"כל מיגרציה נבדקת על בסיס ריק ועל גרסה קיימת; rollback של אפליקציה אינו מבטל מיגרציה אוטומטית.",
"יש ארבע טבלאות legacy של ממשק הנהג; אין dual-write או מעבר שקט למודל tenant. נדרש מתאם נתונים ומיפוי מפורש."
],
"evidence": ["supabase/migrations/0001_ev1.sql"],
"dependencies": []
},
{
"id": "D15",
"section": "dictionary",
"title": "מילון שמופק מהקוד",
"status": "foundation",
"owner": "Data",
"summary": "רשימת הטבלאות, השדות, האילוצים והקשרים מופקת מקובצי המיגרציות.",
"details": [
"הספרייה מציגה סכימת מקור, לא מידע של לקוחות או סודות.",
"שינוי מיגרציה מחייב הפקה מחדש ובדיקת drift. טבלאות מוצעות מופיעות בנפרד ולא מוצגות כממומשות.",
"פריסת הסכימה בענן אומתה בנפרד; שדות אינם הוכחה שתהליך התפעול המשתמש בהם קיים."
],
"evidence": ["scripts/generate-systems.mjs"],
"dependencies": []
},
{
"id": "D16",
"section": "evolution",
"title": "נתוני ייחוס ורשתות בישראל",
"status": "deployed",
"owner": "Data Platform",
"summary": "1,316 רשומות יישובים, 2,261 אתרי טעינה עם מיקום ו־26 רשומות מפעילים וכינויים; קטלוג דגמים ממשלתי בשאילתה חיה.",
"details": [
"נתוני הייחוס משותפים ונגישים לקריאה בלבד. קשר בין רכב לאדם או לארגון נשאר נתון פרטי במרחב שלו.",
"מועד קליטה אינו מועד עדכון מקור. מאגר העמדות עודכן במרץ 2026; אין טענה לכיסוי מלא, זמינות או תעריף חי.",
"מספר רישוי נבדק רק לאחר התחברות ובכפוף למכסה אטומית של 30 בקשות ביום. מוחזר מפרט טכני מצומצם; אין אימות בעלות ואין שמירת תוצאות.",
"יבוא מכין נתונים לבדיקה, בודק שלמות ומזהים ומפיק UPSERT. פרסום כל המנות בעסקה אחת; אין מחיקה אוטומטית של רשומות חסרות."
],
"evidence": [
"supabase/migrations/20261107232238_israel_reference_data.sql",
"scripts/import-israel-reference.py",
"lib/reference/manifest.json",
"app/api/reference/[kind]/route.ts"
],
"dependencies": []
},
{
"id": "D17",
"section": "finance",
"title": "נתוני מנוי, עמלה והסכם מסחרי",
"status": "foundation",
"owner": "Data & Finance",
"summary": "חוזי סכומים באגורות, אחוזים בנקודות בסיס וגרסת הסכם למרחב; הרחבת הסכימה עדיין בתכנון.",
"details": [
"billing_accounts, plan_price_revisions, customer_agreements, subscriptions/cycles ו־billing_obligations/lines הוגדרו כישויות מוצעות, לא כטבלאות מותקנות.",
"ev1_payments הקיים דורש session_id ואינו מתאים לחיוב מנוי. ההרחבה חייבת להפריד מקור התחייבות והקצאת תשלום בלי לשנות תשלומים היסטוריים.",
"צילום חיוב שומר מחיר ספק, בסיס ואחוז עמלה, מס, עיגול, הסכם ומקור CDR. עמלה מתווספת ללקוח; אינה קיזוז אוטומטי מספק.",
"ספרי חברה מוגבלים לפי ישות משפטית ומטבע; רישומים, מסמכים והתחשבנות בלתי משתנים, עם תיקון מקושר ו־idempotency."
],
"evidence": [
"lib/commercial-system/pricing.ts",
"lib/commercial-system/spec.json",
"docs/commercial-system/architecture.md"
],
"dependencies": ["D05"]
},
{
"id": "D18",
"section": "evolution",
"title": "פרופיל ארגון ולוגו פרטי",
"status": "deployed",
"owner": "Platform & Data",
"summary": "ev1_workspace_profiles ו־workspace-logos נפרסו עם בידוד לפי מרחב; פרטי התחברות אישיים נשארים ב־Clerk.",
"details": [
"שם משפטי ומספר חברה נשמרים ב־ev1_tenants; איש קשר, טלפון, אתר וכתובת בפרופיל מרחב נפרד.",
"שם החברה וגרסת הפרופיל נקראים באותה תמונת נתונים. שינוי הפרופיל והשם אטומיים, עם בדיקת revision ו־audit ללא תוכן השדות.",
"הלוגו מוגבל לתמונה סטטית עד 2MB ו־16 מיליון פיקסלים; השרת ממיר ל־WebP עד 512px ומסיר מטא־דאטה. צפייה ב־API דורשת חברות פעילה."
],
"evidence": [
"supabase/migrations/20261108013050_workspace_profiles.sql",
"lib/platform/profile-server.ts",
"lib/platform/logo.ts",
"scripts/test-workspace-profile-isolation.mjs"
],
"dependencies": []
}
]
}