מפרטים ומסמכים
עדכון אחרון: 12.8.2026, 12:10מרכז תיעוד טכני וארכיטקטוני של InvestIQ. עמוד זה מיועד למנהלים בלבד ואינו גלוי למשתמש הסופי.
Master Architecture v1.0 — מטריצת עמידות
השוואת 20 רכיבי המערכת מול מצב היישום · מסמך מחייב מאושר · אוגוסט 2026
מפת-אב CH1–CH8 — כרך 1 סגור
מפת שליטה מרכזית: סדר ביצוע, סטטוס לכל משימה, חסמים ידועים, DoD. Version 1.0 — Locked & Approved. סה"כ 244/244 PASS: CH1 (20), CH2 (10), CH3 (31), CH4 (29), CH5 (45), CH6 (53), CH7 (17), CH8 (39). 8/8 פרקים עברו, 0 כשלים, 0 חסמים פתוחים. המקום הראשון למי שרוצה לדעת איפה המערכת עומדת.
CH1-001 — דוח ביצוע: מטריצת Invariants
חבילה 1 (CH1-001): מודול ch1Invariants.ts v1.0 — רשימת Invariants אחידה של 20 עקרונות מחייבים המכסה את CH1-001 עד CH1-010. כל Invariant מקושר לרכיב ולבדיקה. כשל P0 חוסם Release (gate_status = BLOCKED). 20/20 PASS, gate OPEN (10.8.2026). 3 חסמי P0 נפתרו: PolicyVersion baseline + backfill, Impact Check (impactCheck.ts), Degraded Mode (degradedMode.ts). v1.0 — מאושר.
CH1 — מפרטי יישום עם הערות
מפרט יישום מאושר v0.2 (10.8.2026) + הערות סקירה מול הקוד. 10 משימות: 3 מתקיימות (CH1-003, CH1-006, CH1-010), 7 חלקיות, 0 פתוחות. 3 חסמי P0 נפתרו: PolicyVersion (policyVersionGuard.ts), Impact Check (impactCheck.ts), Data Freshness (degradedMode.ts). v0.3 — מאושר כמפרט עבודה.
CH1 — עקרונות מחייבים
מטריצת כיסוי ל-10 משימות-אב. כל עקרון ממופה למשימות-הבת שסוגרות אותו. 20/20 Invariants PASS, gate OPEN. 3 P0 נפתרו (10.8.2026).
CH2 — ארכיטקטורת-העל
מטריצת כיסוי ל-15 משימות-אב. חוזים, שירותים ותשתית — מי סוגר כל אחת. סטטוס: 2 סגורות, 12 חלקיות, 1 פתוחות. CH3/CH4/CH5 משימות-בת סגורות ✅ (104/105 PASS).
CH2 — מסמך מוכנות
מפת מוכנות מקיפה: מלאי קוד מלא (28 מודולים, 20 ישויות, 8 workflows), 15 משימות-אב (0 סגורות, 14 חלקיות, 1 פתוחות), 15 דרישות הוכחה מחולקות ל-3 קבוצות (10 סימולציה/4 Paper/1 Broker), טבלת TTL מוצעת (Baseline בלבד), גבול פריסה Base44 (המלצה ראשונית), סדר ביצוע. v0.22 — CH4 ✅ (29/29), CH5 ✅ (45/45). הכנה בלבד, טרם ריצת הוכחות.
CH3 — סקירה
סקירה ארכיטקטונית של פרק 3 — 3 מתוך 5 פערים טופלו ב-CH3-001/002/003. מסמך היסטורי מעודכן (v0.2).
CH3 — מפרט טכני
מפרט יישום CH3-001/002/003: הפרדת Orchestrator, מכונת מצבים, Idempotency. v0.2.2 — כל 3 המשימות מומשו ואומתו (40/40 PASS).
CH3-001 — מיפוי
מיפוי טכני של פיצול ה-Orchestrator: קבצים מושפעים, תלויות. ✅ מיפוי אושר ו-CH3-001 בוצע (v0.2.3, 9/9 PASS).
CH3-001 — דוח ביצוע
דוח ביצוע + בדיקות קבלה לאחר יישום CH3-001: snapshot, diff, תוצאות וקריטריוני קבלה.
CH3-002 — מפרט מכונת מצבים
מכונת מצבים דטרמיניסטית ל-Trade: סטטוסים, מטריצת מעברים, CAS, Outbox. v1.0 — נעול.
CH3-002 — דוח ביצוע
דוח ביצוע: snapshot, שלושת המישורים, סדר ביצוע, קבצים מושפעים וקריטריוני קבלה.
CH3-003 — מפרט פקודת ביצוע
ניהול execution_state מול ברוקר: Paper/Live, client_order_id, ביטול, Reconciliation, Inbox/Outbox. v1.0 — נעול.
CH3-003 — דוח ביצוע
דוח ביצוע: מכונת מצב, Paper Adapter, Inbox/Outbox, עדכון תיק חד-פעני. 10/10 קריטריוני קבלה עברו.
CH3-005 — דוח ביצוע
דוח ביצוע v1.0 — Approved. כל 9 הפערים תוקנו, 31/31 תנאי קבלה. תיקונים סופיים: supersede אטומי (חדש נוצר ראשון) + שערי בקרה RiskVerdict/ApprovalRecord לפני ביצוע. CH3-005 + CH3-007/013/014 סגורים.
CH3-005 — מפרט Decision
ישות Decision גרסאית עם Snapshot קפוא. v1.0 Locked & Approved — מאושר לביצוע. התאמת decision_context לפרק 2, Decision אינה משתנה לאחר פרסום (RiskVerdict/ApprovalRecord נפרדות), supersedeDecision אטומי מלא, כלל Legacy, הפרדת cancel_reason_code ממעברי מצב.
CH4 — סקירה
סקירת פרק 4 (קטלוג סוכנים) + תשובות מאומתות-קוד ל-8 שאלות פתוחות. כל ההמלצות יושמו (CH4-005/007/010).
CH4 — מפרטי יישום
14 משימות פיתוח לקטלוג הסוכנים, חוזי אחריות ומעבר ל-Shadow. v0.3 — 12/14 Verified (29/29 PASS), 2 שוחררו (CH3-005 ✅).
CH4-001 — מפרט נעילת זהויות
מפרט טכני: מיפוי 6 סוכנים, נעילת זהויות SHA-256, Snapshot Append-Only. v1.0 — מאושר.
CH4 — דוח משימות 002–014
דוח ביניים לכל משימת CH4: בעיה, יעד, מה בוצע, הערות סקירה וקריטריוני קבלה. v0.3 — 12/14 Verified (29/29 PASS), CH4-008/011 שוחררו (CH3-005 ✅).
CH4 — דוח ביצוע
דוח ביצוע: 12/14 Verified (29/29 PASS), 2 שוחררו (CH3-005 ✅). v0.3 — Gate OPEN, CH4-008/011 מוכנות לביצוע CIO Shadow.
CH5 — מסגרת
מסמך מסגרת מאושר: 6 מפרטים (Data Inventory → Asset Master → Decision Snapshot → Market Data → Audit → Least Privilege). v0.1 — מאושר.
CH5-001 — מיפוי As-Is
מיפוי נתונים, מקורות אמת, נתיבי קריאה/כתיבה ו-Gap Analysis מול פרק 5. ללא שינוי קוד במערכת. v0.1 — מאושר לביצוע.
CH5-002 — בעלות ומקורות אמת
מודל בעלות על נתונים: מקור אמת מחייב, רכיבים מוסמכים לכתיבה לפי שדה, Cash Ledger, כללי גרסאות, איסור עדכון ישיר וטיפול בהתנגשויות. v0.3 — מאושר לביצוע.
CH5-003 — DecisionContextSnapshot
Snapshots קפואים (Market/Portfolio/Policy/System/DecisionContext), בנייה אטומית, Idempotency, Risk Gate עדכני לפני Order, Hash קנוני, computed_status (policy_hash+Freeze+Invalidation), build_status CAS, Shadow mode על As-Is. v0.3 — Approved for Implementation.
CH5-004 — Data Layers & Corporate Actions
Raw/Canonical/Adjusted/Derived/ExecutableQuote (הפרדה מוחלטת), Data Quality מורחב (סבילות/צבירה לפי asset+שדה+Use Case/Quarantine), ספי Staleness בשלוש רמות (Baseline מוצע), Corporate Action State Machine + Saga (Outbox ל-Transaction מקומי; קריאות ברוקר Idempotent; כשל חלקי→RECONCILIATION_REQUIRED; Retry מהשלב האחרון) + canonical_action_id יציב (זהות עסקית; terms_hash לתנאים משתנים; התאמה לא ודאית→Quarantine), AssetMaster עם ISIN/FIGI, Cash Ledger כמקור אמת, בידוד שכבות, Rollback מוגבל ל-Shadow. v0.4 — Approved for Implementation.
CH5-005 — גרסאות ידע, Audit, Lineage ו-Retention
הפרדת גרסאות (Policy/SystemSettings/AgentConfig נפרדים), AuditEvent Append-Only עם שרשרת Hash + Transaction/Outbox לשינויים קריטיים, VersionActivationEvent, Lineage מקצה לקצה, Retention עם Legal Hold ומחיקה מאושרת, Tombstone עד תום Retention, Restore יוצר גרסה חדשה. v0.2 — Approved for Implementation.
CH5-006 — Least Privilege, התאוששות וקבלה משולבת
שער הקבלה האחרון: Permission Matrix (DENY default; Admin מפוצל ל-4 תפקידים; Break-Glass; Broker Adapter יחיד ל-Fill), RPO/RTO (Proposed Baseline; RPO=0 כיעד) + מדיניות גיבוי מלאה, Rollback מוגבל (מסלולי קריאה בלבד), מפת תנאי קבלה מפורטת (criterion_id לכל תנאי), דוח סגירת CH5 כולל. v0.2 — Approved for Implementation.
CH5 — סקירה
סקירת Final Review: אימות 12 עקרונות מול קוד — 9 מתקיימים (CH5-003/004/005/006 ✅ 45/45 PASS), 1 חלקי, 2 עקרונות נכונים + 18 שאלות אימות מעודכנות. CH5 סגור ✅. v0.2.
CH6 — אירועים, תזמונים וזרימות עבודה
סגור ✅ (10.8.2026). 4 משימות: T6.1 Registry ✅, T6.2 Idempotency Enforced ✅, T6.3 Workflow Gates ✅, T6.4 Acceptance ✅. רגרסיה 105/105, Double-fire No-Op, CIO Shadow 0 mismatch, Background 3/3. מוכן לשגרת בוקר/אחה"צ. Live-Go נשאר חסום (CH1 P0). תיאום: BAROUCH SHALIT.
CH6 T6.1 — Registry טריגרים ו-Workflows
מיפוי As-Is של כל הטריגרים, התזמונים והזרימות הפעילים. 8 Workflows + 6 AgentConfigs + 5 טריגרים ידניים. כולל: אזורי זמן ו-DST, Source of Truth לכל רכיב, D6 שודרג ל-P1 (CH1 חסר בשגרת הבוקר), D5 עבר ל-T6.2. 6 פערים מתועדים (ללא שינוי קוד). כולל כפתור הדפסה/PDF. v0.2 Review — 5 עדכונים נדרשו ובוצעו.
CH6 T6.2 — אחידות הפעלה, Idempotency ומניעת חפיפה
דף משימה: נעילת הקשר קורלציה, מפתח Idempotency על זהות טריגר, Overlap Guard לפי שוק, Retry באותה קורלציה, P0 Bypass, Crash Recovery. 7/7 פעולות מקודדות ומאומתות. T62_MODE=enforced (עבר מ-Shadow ל-Enforced). ראיות: triggerIdempotency.ts + שילוב ב-runAgentScan + נתיב Rollback. מאושר ✅.
CH6 T6.3 — מעברי Workflow, אישור, Timeout וכשל בטוח
דף משימה: מיפוי Trigger→State→Gate→Result, שמירת Approval/TTL/Validity/Freeze/Risk, legacy: true עוקף רק Decision Gate, CIO Shadow, Data Freshness כחסם CH1. ראיות קוד: 10/11 הגנות ממומשות ב-executeTrade/decisionObject/stateMachine. Data Freshness חלקי (חסם CH1 P0). נדרש אימות E2E.
CH6 T6.4 — בדיקת קבלה משולבת וסגירת CH6
סגור ✅ (10.8.2026). רגרסיה 105/105 PASS (אפס נסיגה), Background 3/3 מצבים, CIO Shadow 47/50 (0 mismatch), Double-fire No-Op audit פעיל (T6.2 Enforced). מוכן לשגרת בוקר/אחה"צ. Live-Go נשאר חסום עד 3 חסמי P0 של CH1.
CH7 — סקירה: הרשאות, אישורים ומעורבות אנושית
Version 1.0 — Approved Architecture Baseline for T7.1 (11.8.2026). כל 6 הערות חוסמות + 5 נוספות טופלו. §7.7 חוזה ספים (8.5/9.5) נוסף. §7.16 (סיווג P0–P3), §7.18 (6 שאלות), נספח ב׳ (11 הכרעות), נספח ג׳ (22 בדיקות) — מלאים. 7/7 עקרונות מאושרים כבסיס ל-T7.1. מעבר ל-T7.1 מאושר.
CH7 T7.2 — חוזה Approval וסמכות לפי מצב עבודה
T7.2 v1.0 — חוזה Approval מאוחד ל-manual/semi_auto/full_auto. 3/3 פערי P1 מ-T7.1 נפתרו: (1) סף 9.5 configurable ב-SystemSettings; (2) actor_type/logical_role נוספו ל-AuditEvent; (3) reauthGuard.ts + verifyReauth function + ReauthDialog — re-auth מחובר בפועל ל-Settings (הפקדה/העברה ל-cash_auto) ול-Dashboard (ביטול Freeze). 11 שערים מאוחדים (אפס עקיפות). מוכן ל-T7.3.
CH8 T8.1 — מיפוי As-Is ואחריות תשתיתית
T8.1 v1.0 — מיפוי קריאת-קוד מלא (11.8.2026, הושלם ✅). 5 זהויות שירות, 5 סודות, 6 תלויות חיצוניות, 12 תחומי אחריות, 6 שכבות סכמה/הצפנה, 9 רכיבי לוג, 19 endpoints, 5 שכבות RPO/RTO. הצלבת T8.2: 7 ממצאים נפתרו (errorSanitizer, Frankfurter API, RBAC, Incident entity, DataQualityLog, BackupPolicy, console.error). פתוח: service_identity, PRICE_ID, RPO/RTO verification (T8.5).
CH8 T8.5 — Backup, Restore ו-DR Drill
T8.5 v1.0 — תרגיל DR Drill: snapshot, restore, מדידת RPO/RTO, hash verification, smoke test, reconciliation. 9/9 PASS ✅. RPO=0s, RTO=0.95s. RpoRtoPolicy.infrastructure_verified=true. RestoreLog + RecoveryTestResult מתועדים. BackupPolicy עודכן עם encryption + retention + restore_test_frequency.
CH8 T8.6 — E2E Regression וחתימת כרך 1
T8.6 v1.0 — חתימת כרך 1: רגרסיית E2E, וידוא T8.1–T8.5 evidence, error sanitization, ServiceIdentity, RBAC, audit integrity, observability, DR readiness, Paper mode, Feature Flag model, no open P0/P1 gaps. 12 בדיקות. דוח חתימה: Closed / Remain Open. Live-Go נשאר חסום (שער נפרד).
CH8 T8.4 — Observability, Alerts ו-SLO
T8.4 v1.0 — 9/9 PASS ✅ (11.8.2026). הפרדת 4 קטגוריות (Business/Infra/Security/DataQuality). 6 SLOs עם target, error_budget, owner, runbook. 10 AlertRules (4 P0 + 3 P1) — כולם עם owner + runbook. False Positive/Negative נבדקו לכל P0/P1. Health Check: SystemSettings, AgentConfig, AuditEvent, Incident. Incident entity עם timeline + post-incident review.
CH8 T8.3 — Audit Integrity ו-Retention
T8.3 v1.0 — 9/9 PASS ✅ (11.8.2026). Hash Chain (append-only SHA-256), Tamper Detection (actor_type, logical_role, event_hash — כולם מזוהים), Export (getAuditTrail), Reconstruction (correlation_id), Secret Scan (50 events — 0 secrets), Retention (13 entity types), UTC ISO-8601. verifyHashChain מחשב מחדש hash ומשווה לשמור. scanForSecrets פעיל בכתיבה.
CH8 T8.2 — זהויות, Secrets והפרדת סביבות
T8.2 v1.0 — מיפוי זהויות שירות, סודות, תלויות חיצוניות ופערי תשתית (11.8.2026). 6 זהויות שירות, 6 תלויות חיצוניות, 10 פערים (9 נפתרו, 1 חלקי). נפתר: errorSanitizer ל-18 פונקציות, ישות Incident פורמלית, refreshFxRate עבר ל-Frankfurter API, 5 RpoRtoPolicy + 5 BackupPolicy, RBAC checkPermission מחובר ל-executeTrade, DataQualityLog + logDataQuality, ServiceIdentity entity (6 records) + serviceIdentity.ts (7 פונקציות רגישות מחוברות ל-assertServiceIdentity), PRICE_ID הועבר מ-hardcode ל-SystemSettings.stripe_price_id. פתוח: Feature Flag מודל מלא (T8.6).
CH8 — אבטחה, אמינות, ניטור וחתימת כרך 1
Review v1.0 — Architecture Approved & Locked (11.8.2026). 8 עקרונות מחייבים. T8.1 ✅ Done, T8.2 ✅ Done (9/10 נפתרו), T8.3 ✅ Done (9/9), T8.4 ✅ Done (9/9). 7 פערי As-Is: 5 Fixed, 1 Partial (RPO/RTO), 1 Partial (Feature Flag). אישור 1.0 נועל מפרט בלבד — אינו סוגר פערי יישום ואינו Live-Go.
CH7 T7.4 — בדיקת קבלה משולבת וסגירת CH7
T7.4 v1.0 — סגור ✅ (11.8.2026). 17/17 PASS: רגרסיה CH1 20/20 + CH2 10/10 + CH3 21/21 + CH3-003 10/10 + CH4 29/29 + CH5-004 15/15 + CH5-005 15/15 + CH5-006 15/15 + CIO Shadow 50/50 (0 mismatch) + 9 מטריצות CH7 (Override/Freeze/Emergency/Re-auth/Threshold/Approval/Audit). תוקן bug: verifyHashChain לא כלל actor_type/logical_role ב-hash. משולב בבדיקת בוקר (ch7). Live-Go נשאר חסום.
CH7 T7.3 — Override, Freeze ופעולות חירום
T7.3 v1.0 — מטריצת Override/Freeze/Emergency מאומתת מול הקוד. 2/2 פערי P1 תוקנו: (1) isEmergencyLiquidation קיבל earlyHolding במקום null — Case 2 (loss limit) כעת פעיל; (2) נוספה פונקציית approveBreakGlass לאישור BreakGlassEvent. legacy:true עוקף רק Decision Gate; אפס עקיפות Risk/Freeze/TTL/Validity/Audit. מוכן ל-T7.4.
CH7 T7.1 — Registry As-Is (נתיבי ביצוע, ספים, זהויות)
T7.1 v1.0 Registry — מיפוי As-Is חתום: 4/4 נתיבי ביצוע, 4/4 ספים מאומתים, 5/5 שדות מאומתים, 7/7 זהויות מאומתות. 5/5 פערים נסגרו (0 P0, 0 P1, 0 Info פתוחים) — 3 P1 נפתרו ב-T7.2, 2 Info נסגרו בתיעוד. קריאת קוד בלבד. T7.1 סגור ✅.
אודיט ארכיטקטוני
דוח אודיט מלא של ארכיטקטורת InvestIQ — ניתוח פערים מול ספר הארכיטקטורה.
מדריך המערכת
מדריך משתמש — היכרות עם הפלטפורמה, מצבי ניהול, חיבור ברוקר/בנק ונהלי חירום.
תכנית ביצוע — Incident-First
9 שלבי תיקון CH4 הושלמו: קנוניזציה 8/8, CH4 29/29, 0 הפרות, 6/6 Snapshots/Profiles. Continuous Agent Scan הופעל מחדש. מערכת פעילה ב-Paper/Shadow (אוטומטי/חצי/ידני). Broker אמיתי חסום. v0.3 — APPROVED, System Operational.
דוח ביצוע — שלבים 1–8
דוח מצטבר: Group A (10/10), CIO Shadow, CH3-002 (21/21), CH3-003 (10/10), CH4-014 (29/29), CH5-004 (15/15), CH5-005 (15/15), CH4 Canon Migration (8/8), CH5-006 (15/15). סה"כ 123 בדיקות, CH4+CH5 סגורים ✅. v0.5.
דוח אירוע — כשל זרימה וטיפול
דוח דו-לשוני (עברית/English) לקבוצת הבקרה: כשל 5 הרצות ב-Continuous Agent Scan (CH4-001 Fail-Safe), גורם שורש (Hash מיושן), טיפול (re-baseline 6 סוכנים), אימות ואמצעי מניעה. סטטוס עודכן ל-REMEDIATION_PENDING_GOVERNANCE_REVIEW. כולל כפתור הורדת PDF.
שגרת בוקר — בדיקות קבלה CH1–CH8
הרצה מבוקרת של בדיקות קבלה בשלבים קטנים עם דוח לכל פרק. מתוזמן אוטומטית כל בוקר 08:00 (א׳-ה׳). CH1: 20/20, CH2: 10/10, CH3: 21/21+10/10, CH4: 29/29, CH5: 45/45, CH6: 3/3+50/50, CH7: 17/17, CH8: 9+9+9+12. כולל CH6 (Background+CIO Shadow) ו-CH8 (Audit, Observability, DR Drill, E2E). דוח נשמר ומוחלף אוטומטית בכל ריצה.
שגרת אחה"צ — בדיקות קבלה CH1–CH8 + שוק חי
הרצה מבוקרת של בדיקות קבלה + ולידציית e2e בשוק פתוח. כולל CH7 (רגרסיה + CIO Shadow) ו-CH8 (Audit, Observability, DR Drill, E2E). Live e2e: PASS. דוח נשמר ומוחלף אוטומטית בכל ריצה.
דוח פעולה מתקנת — סקירת Governance
סקירת CH4-001: ניתוח שדה-אחר-שדה ל-6 סוכנים, Hash לפני/אחרי, פערי קוד, 7 פערי Governance, 7 המלצות. מיגרציית קנוניזציה v2.0 מבוקרת: 8/8 בדיקות קנוניזציה + 29/29 CH4 + 6 AuditEvents. Workflow PAUSED. סטטוס: REMEDIATION_PENDING_FINAL_APPROVAL. כולל כפתור הורדת PDF.