אירועים, תזמונים וזרימות עבודה
כרך 1 — יסודות הארכיטקטורה · פרק 6 · מפרט תכנון ויישום ממוקד ליום עבודה אחד
CH6 מוכן ✅ — T6.1-T6.4 מאומתות (רגרסיה 105/105, Double-fire No-Op, CIO Shadow 0 mismatch, Background 3/3). CH1 סגור ✅ (20/20 PASS, gate OPEN). מוכן לשגרת בוקר/אחה"צ.
1מטרת הפרק ומצבו התפעולי
פרק 6 מגדיר כיצד InvestIQ מפעילה תהליכים: איזה טריגר פותח מחזור, כיצד נשמרת זהות אחת לאורך הזרימה, כיצד נמנעת הרצה כפולה, כיצד מטופלים Timeout, Retry וכשל, ואיזה תהליך דורש אישור אנושי. המטרה היא לשמר את המסלולים הפעילים שכבר עברו בדיקות, לעטוף אותם בחוזה הפעלה ניתן לביקורת ולהוכיח ב־Paper וב־Shadow שהם מתנהגים באופן דטרמיניסטי ובטוח.
2Baseline תפעולי מחייב ומפת תזמונים
| רכיב/נתיב | טריגר פעיל | תדירות/מצב | כלל שימור והבהרה |
|---|---|---|---|
| US Scanner / IL Scanner | runAgentScan | כל 15 דקות | אין Rename ואין שינוי תוצאה עסקית. |
| Portfolio Risk | refreshPortfolioPrices | כל 30 דקות | תהליך מתוזמן עצמאי לחלוטין. מובהר בזאת שאינו חלק ממחזור הסוכנים הרגיל. |
| News | Scheduler/AgentConfig | כל 30 דקות | כשל אינו הצלחה שקטה. |
| Technical | Scheduler/AgentConfig | כל 60 דקות | פלט תקף או מצב כשל מפורש. |
| Financial Reports | ללא הפעלה | Paused; 720 דקות מוגדרות | נשאר מושהה; אין Scheduler פעיל. |
| CIO | איסוף פלטים | Shadow בלבד | אין השפעה על Trade ואין סמכות ביצוע. |
| עסקה ידנית מהגרף | פעולת משתמש | לפי דרישה | מנגנון legacy: true נשמר; כל הגנות הביצוע נשמרות (ראה סעיף 5). |
3עקרונות מחייבים לזרימה
4מפת ארבע המשימות ותנאי סגירה תלויים
| משימה | תוצאה מחייבת | תלויות ספציפיות | תנאי עצירה / חסמים |
|---|---|---|---|
| T6.1 | Registry מאושר של טריגרים ו־Workflows; מיפוי נפרד ל-Portfolio Risk כתהליך עצמאי. | CH4/CH5 (הושלם) | טריגר פעיל לא ממופה; הרצה המשנה תוצאה עסקית מול ה-Baseline. |
| T6.2 | הפעלה Idempotent ללא חפיפה (Overlap Guard). מניעת יצירת רשומות כפולות. | T6.1 מאושר | הרצה כפולה שיוצרת Trade/Order נוסף; חסימת Exit/Stop. |
| T6.3⛔ חסום | חיבור למכונת המצבים ושערי אישור (Risk Gate, TTL, Validity) ללא מעקפים. | T6.2 + סגירה מלאה של CH3 (פתוח/חוסם) | עקיפת Gate/TTL/Validity; אי-סגירה של הבדיקה הפתוחה ב-CH3 חוסמת משימה זו. |
| T6.4⛔ חסום | בדיקת קבלה משולבת על ישראל וארה"ב, דוח סגירה ללא המלצת Live-Go. | T6.1–T6.3 + השלמת CH3 | כשל P0/P1; רגרסיה בפרקים קודמים; סימון חוסם של NOT TESTABLE ברמות P0/P1. |
5כללי מסגרת מחייבים לחריגות וסימוני בדיקות
אמנגנון legacy: true — ניהול כחוב טכנולוגי
השימוש ב-legacy: true עבור מסלול עסקאות ידניות מהגרף מתקבל בהסתייגות. אין לקבוע כבר עכשיו שהקוד יוסר לחלוטין, אלא הוא מוגדר כחוב טכנולוגי מנוהל תחת הכללים הבאים:
- בעלים מוגדר: BAROUCH SHALIT.
- בקרת תצורה: חובה לשייך את המנגנון ל-Feature Flag ייעודי, לקיים תיעוד Audit מלא לכל הפעלה שלו, ולהחזיק נתיב Rollback מיידי זמין.
- תנאי הכרעה/הסרה: תאריך בחינה עתידי ייקבע בתיעוד. הסרה או החלפה של מנגנון זה תתאפשר אך ורק לאחר שמסלול חלופי מוגדר עבר בדיקות E2E מלאות ללא רגרסיה.
בכלל אכיפה מחייב לסימון NOT TESTABLE
סימון בדיקה במצב NOT TESTABLE אינו נחשב להצלחה (NOT PASS). מדובר בכלל מחייב הדורש כי כל רשומה במצב זה תכיל את ארבעת המרכיבים הבאים:
- 1.פירוט מלא של סיבת אי-היכולת לבצע את הבדיקה.
- 2.ציון הראיה המדויקת או תנאי השוק/הנתונים הספציפיים החסרים.
- 3.קביעת אחראי מפורש לבדיקה החוזרת.
- 4.הגדרת מועד קלנדרי או טריגר מערכתי ברור לביצוע הבדיקה מחדש.
6פירוט משימות לביצוע
7Checklist יומי קצר
8Definition of Done — CH6
- ארבע המשימות אושרו, בוצעו ונבדקו לפי הסדר.
- Registry הטריגרים מלא ותואם לקוד הפעיל.
- אין הרצות כפולות, חפיפה מזיקה או יצירת רשומות עסקיות כפולות.
- כל Workflow שומר id_cycle_decision ו־id_correlation מתחילתו ועד סופו.
- Timeout, Retry, Approval, Freeze, Validity, Risk וכשל נתונים מתועדים ומתנהגים לפי החוזים הקיימים.
- P0 של Stop/Exit/Reduction אינו נחסם בידי Scheduler, Overlap או שירות AI.
- Financial Reports נשאר Paused; CIO נשאר Shadow; אין סמכות חדשה.
- העסקה הידנית מן הגרף ושגרת הבוקר עברו רגרסיה.
- CH3–CH5 עברו רגרסיה ללא נסיגה.
- Rollback נבדק, Audit נשמר ודוח ביצוע מסכם אושר.
- סטטוס הסיום הוא CH6 Closed ב־Paper/Shadow בלבד; Live-Go נשאר חסום כל עוד שלושת P0 של CH1 פתוחים.