מסמך מעבר מתכנון מאושר לחבילת הפיילוט
Planning-to-Pilot Work Order & Documentation Record
1. מטרת המסמך
מסמך זה משמש בו-זמנית כתיעוד החלטות וכסדר עבודה מחייב לאחר אישור Target Architecture v0.2 ו-Migration Plan v0.2. הוא נועד למנוע סחיפת Scope, עבודה במקביל במקום שיש תלות, או התחלת קוד לפני הגדרת חוזים וקריטריוני קבלה.
המסמך אינו מחליף את שני מסמכי היסוד המאושרים ואינו נותן הרשאה לשינוי Base44, להרצה, ל-Local Engine פעיל או למסחר.
2. מסמכי יסוד מאושרים
| מסמך | סטטוס | תפקיד |
|---|---|---|
| InvestIQ Target Architecture v0.2 | מאושר | מגדיר לאן המערכת הולכת ומהם גבולות הסמכויות והארכיטקטורה. |
| InvestIQ Migration Plan v0.2 | מאושר | מגדיר את סדר M0-M9, Shadow, Gates, Rollback וקריטריוני מעבר. |
3. סדר העבודה המחייב מכאן
| סדר | מסמך/פעולה | תלות | תוצר נדרש לפני המשך |
|---|---|---|---|
| 1 | Local Engine Pilot Specification v0.3 | Target Architecture v0.2 + Migration Plan v0.2 | אישור Scope/Out-of-Scope ו-Derivation Trace |
| 2 | Canonical Event Schema v0.1 | Pilot Specification v0.3 | אישור חוזה events ו-versioning |
| 3 | Trigger Engine Specification v0.1 | Canonical Event Schema מאושר | אישור triggers, priorities, debounce/cooldown ו-policy config |
| 4 | Heartbeat/Freshness Policy v0.1 | Canonical Event Schema מאושר | אישור states, thresholds, freshness ו-recovery |
| 5 | Pilot Acceptance Test Plan v0.1 | שלושת המפרטים 2-4 מאושרים | PASS/FAIL מלא לפני קוד |
| 6 | Pre-M0 Baseline Preservation | Acceptance Plan מאושר | snapshot/ארכיון בלתי משתנה של נתוני baseline |
| 7 | M0 — Baseline & Freeze | כל החבילה לעיל מאושרת | Quality/Cost/Operational Baseline מתועד ו-PASS M0 |
| 8 | M1 — Local Engine Skeleton | PASS M0 + אישור ביצוע מפורש | ביצוע מוגבל לשלד בלבד |
4. תלות בין המפרטים
5. Local Engine Pilot Specification v0.3 — גבולות מחייבים
v0.3 יהיה המסמך הבא לעבודה. בתחילתו יופיע סעיף Out-of-Scope בולט.
בתוך Scope
- • הגדרת Local Engine pilot, contracts, local service, config, cache, queue, logs, health
- • הכנה ל-M1-M3
- • Shadow/parallel architecture
- • AI architecture כהמשך מתוכנן ל-M4
- • single-user pilot
- • Windows Service לפיילוט
מחוץ ל-Scope בשלב המתאים
- • אין שינוי Risk Gate / Decision / Execution Authority
- • אין Broker integration ב-M1-M3
- • אין החלפת Base44 workflows; Strangler — ריצה לצד הקיים בלבד
- • אין AI/LLM ב-M1-M3; Direct AI נכנס רק ב-M4 לאחר PASS/Gate
- • אין multi-user rollout בפיילוט הראשוני
- • אין נעילת ליבת המערכת ל-Windows לטווח הארוך
6. Derivation Trace
ב-v0.3 תתווסף טבלת Derivation Trace. לכל דרישה יהיה מקור מפורש: סעיף ב-Target Architecture v0.2 ו/או milestone/Gate ב-Migration Plan v0.2. דרישה שאינה ניתנת למיפוי תסומן New Requirement ותדרוש אישור לפני הכללה.
| Requirement | מקור | סטטוס |
|---|---|---|
| Base44 = Control Plane | Target Architecture v0.2 | מאושר |
| Local Engine = User Runtime | Target Architecture v0.2 | מאושר |
| Canonical Events לפני אינטגרציה | Target Architecture v0.2 + M1 | מאושר |
| Trigger thresholds configurable/versioned | Target Architecture v0.2 + M3 | מאושר |
| No AI in M1-M3 | Migration Plan v0.2 | מאושר |
| Direct AI רק ב-M4 + Quality Gate | Migration Plan v0.2 | מאושר |
| No Execution/Risk authority transfer | שני מסמכי היסוד | מאושר |
7. Pre-M0 Baseline Preservation
לפני M0 תבוצע פעולת שימור בלבד — לא הרצה ולא שינוי מערכת. המטרה היא למנוע מצב שבו Quality Baseline ההיסטורי משתנה או נעלם לפני שנמדד.
- • לוודא שנתוני 10 ימי המסחר ההיסטוריים עדיין נגישים.
- • לזהות את מקור הנתונים, טווח התאריכים וה-schema שבו נאספו.
- • לייצא snapshot קפוא/ארכיון read-only.
- • לתעד hash/filename/date/version או מנגנון זיהוי מקביל.
- • לא לשנות, לנקות או לנרמל את נתוני המקור כחלק מהשימור.
- • אם נתון חסר — לסמן Missing Evidence ולא להשלים אותו בהשערה.
8. Quality Baseline שיידרש ב-M0
- • זמן גילוי נכסים חדשים.
- • False positives / false negatives ככל שניתן למדידה מהנתונים.
- • Intraday coverage.
- • כיסוי שוק שקט ומגמות איטיות.
- • תדירות ואיכות protection analysis.
- • LLM/InvokeLLM calls ו-credit baseline.
- • latency, uptime/freshness וחריגות ידועות.
9. Gates — איסור מעבר אוטומטי
| Gate | מה נדרש |
|---|---|
| G-PILOT | אישור Local Engine Pilot Specification v0.3 |
| G-EVENT | אישור Canonical Event Schema v0.1 |
| G-TRIGGER | אישור Trigger Engine Specification v0.1 |
| G-HEALTH | אישור Heartbeat/Freshness Policy v0.1 |
| G-TEST | אישור Pilot Acceptance Test Plan v0.1 |
| G-M0 | Baseline Preservation הושלם + אישור להתחיל M0 |
| G-M1 | PASS M0 + אישור ביצוע מפורש לשלד Local Engine בלבד |
אין מעבר Gate על בסיס "נראה תקין". כל Gate נסגר במסמך/ראיות ובהחלטת אישור מפורשת.
10. מה אסור לבצע כעת
- • אין שינוי ב-Base44.
- • אין הפעלת workflows.
- • אין כתיבת Local Engine production code.
- • אין חיבור Broker.
- • אין AI/LLM integration.
- • אין שינוי schema חי.
- • אין שינוי Risk/Decision/Execution authority.
- • אין multi-user rollout.
- • אין מעבר ל-M0 לפני השלמת ואישור חבילת המפרטים.
11. תוצר העבודה הבא
התוצר הבא הוא InvestIQ — Local Engine Pilot Specification v0.3.
הוא ייגזר ישירות משני מסמכי היסוד המאושרים וממסמך עבודה זה, ויכלול בתחילתו Out-of-Scope מפורש ובהמשך Derivation Trace. רק לאחר אישורו מתחילים את Canonical Event Schema v0.1.
12. סטטוס ניהולי
| נושא | מצב |
|---|---|
| Target Architecture v0.2 | מאושר |
| Migration Plan v0.2 | מאושר |
| Base44 | מוקפא — ללא שינוי |
| Migration execution | לא התחיל |
| M0 | טרם התחיל |
| Local Engine | טרם אושר לביצוע |
| המשימה הפעילה | הכנת Local Engine Pilot Specification v0.3 |
13. החלטה
מסמך זה ננעל כ-Work Order לתיעוד ולניהול סדר העבודה עד תחילת M0. כל שינוי בסדר, Scope או Gate יירשם ויאושר לפני ביצוע.
InvestIQ | Planning-to-Pilot Work Order & Documentation Record v1.0 — ספטמבר 2026