ארכיטקטורה.

פלטפורמת Graph-RAG דואל-סטור. סוכנים מתוזמני cron מעל Cosmos Gremlin ו-Azure AI Search, מוטמע ילידי ל-Microsoft 365. השרטוטים נשארים ב-Autodesk; הרשומה שייכת למרגולין.

01 SYSTEM

ארכיטקטורת מערכת.

מקצה-לקצה ואינטראקטיבי. רחפו על צומת לעקוב אחר שכניו · קליק לפרטים · החליפו סוגי קשתות.

גררו כל צומת לסידור מחדש. פאנל סינון (פינה שמאלית-עליונה) מחליף סוגי קשתות — התחילו עם זרימת דאטה + שליפה; הפעילו Auth כדי לכסות אכיפת Entra-ID. גרירה להזזה, גלילה לזום, כפתור fit (פינה ימנית-תחתונה) לאיפוס. השרטוטים (DWG/RVT בינארי) נשארים ב-Autodesk — מוח החברה מחזיק מטא-דאטה ומצביעי מהדורות בלבד.

הציגו גרסה סטטית (לא-אינטראקטיבית) של התרשים
Sources · external systems Ingestion · APIs · webhooks · OCR · normalization Data plane · Graph-RAG dual store · audit Runtime · agents · orchestration UX · Microsoft 365 surfaces Autodesk ACC Forma · BIM 360 Ramdor Israeli PM Ziv · Exponent Vipplan · Pilton MS Project .mpp files DocuSign Ack signing Outlook · Email Attachments + threads OneDrive · SharePoint Manual uploads WhatsApp · ZIPs · scans Field artefacts APS APIs Data Mgmt · Model Derivative · Webhooks MS Graph delta SharePoint change notif. Azure AI Document Intel. PDF · Office · Hebrew OCR .mpp parser Schedule entities FR-012a · Normalization Layer drawing IDs · revisions · ack tiers · authority records Cosmos DB · Gremlin Property graph Project · Drawing · Revision · … Azure AI Search Hybrid vector + keyword + semantic ACL filters · per-project Purview · Audit · Retention 7-yr retention · Preservation Hold Immutable access log Microsoft Fabric Lakehouse שלב 3 · historical analytics Power BI semantic model · ML features Project Agent Per-project conversational chat Cited answers · scope-locked Process Agents · cron Defects · Transmittal · Submittal · Work Log Gantt · Budget · RFP · Change Order · Monthly Report Azure Container Apps Jobs Long-running cron · doc sync Embedding refresh · ACC polling Durable Functions · Service Bus HITL approval state machine Async queue · retries · fan-out Teams · chat tab Per-project agent Teams · approval queue Personal app SharePoint pages Dashboard · lists · libraries Word Online Auto-drafted reports Outlook Auto-filing add-in Power Apps mobile Field capture · offline Entra ID Tenant isolation · app roles
02 INGEST

קליטה ונרמול.

עבודת מסד-נתונים לפני AI. שש שלבים עם תנאי-מקדים ל-Graph-RAG: זיהוי · חילוץ · נרמול · ציון · אינדוקס · ביקורת.

1
Detect · זיהוי
ACC webhook · MS Graph delta · email watcher
2
Extract · חילוץ
APS · Doc Intelligence · OCR · .mpp parser
3
Canonicalize · נרמול
מזהי שרטוט · קוד דיסציפלינה · שושלת מהדורות · רשומת סמכות
4
Score & Tag · ציון ותיוג
דרגת איכות אישור · ביטחון OCR · תור סקירה אם < 0.7
5
Index · אינדוקס
chunks → AI Search · entities → Cosmos
6
Audit · ביקורת
Purview retention · יומן גישה · 7 שנים
FR-016 טיפול בכשלי קליטה שלבים 3–4 שולחים מקרי קצה לכאן
  • שרטוטים כפולים — מזהה קנוני זהה, SHA שונה
  • OCR עברי < 0.7 ביטחון → תור סקירה אנושית
  • קבצים ששמם שונה — מעקב לפי MS Graph item ID, לא path
  • קלטים גולמייםZIPs · screenshots · WhatsApp · scanned PDFs
03 LAYERS

איפה חי כל דבר.

ארבע שכבות, כולן בתוך הטננט המיקרוסופטי. דאטה · סוכנים · ריצה · UX.

שכבה 1 · דאטה

דואל-סטור Graph-RAG

Cosmos DB Gremlinגרף property · traversals
Azure AI Searchhybrid וקטור + מילת מפתח
Document IntelligencePDF · Office · OCR עברי
APS Model Derivativeמטא-דאטה DWG · RVT · IFC
MS Graph deltaקליטה מ-SharePoint · OneDrive
נורמליזציה FR-012aמזהי שרטוט · מהדורות · דרגות אישור
Purviewשמירת מידע + ביקורת גישה
שכבה 2 · סוכנים

צ׳אט פר-פרויקט + סוכני תהליך מתוזמני cron

סוכן פרויקטשיחתי · מצוטט
סוכן ליקוייםיומי
סוכן טרנסמיטלשעתי + webhook
סוכן סאבמיטליומי · SLA
סוכן יומן עבודהיומי · פערים
סוכן גאנטשבועי · החלקות
סוכן תקציברבעוני
סוכן דוח חודשיחודשי
סוכן RFPלפי דרישה
סוכן הגדלותעל הגשה
סוכן פיקוח עליוןאבני דרך
סוכן חוצה-פרויקטP2
שכבה 3 · ריצה

Azure Container Apps · Durable Functions · Service Bus

Container Apps Jobscron · ריצות ארוכות
Durable Functionsזרימות HITL
Service Busתור אסינכרוני
Key Vaultסודות · Managed Identity
Entra IDבידוד טננט
Power Automateדבק low-code
שכבה 4 · UX · בתוך M365

Teams · SharePoint · Word · Outlook · Power Apps

Teams · לשונית צ׳אטפר-פרויקט
Teams · אפליקציה אישיתתור אישורים
דפי SharePointדשבורדים · רשימות
Word Onlineטיוטה אוטומטית + עריכה
תוסף Outlookסינון אוטומטי
Power Appsמובייל שטח
04 SCHEMA

סכמת הגרף.

31 ישויות. 54 קשרים. שבע קטגוריות סמנטיות. מודלים יסודיים של חברת ניהול-פיתוח-בנייה — אינטראקטיבי · קליק על ישות לפתוח פאנל פרטים וקפיצה לשכנים.

31 ישויות · 54 קשרים · מקובץ ב-7 קטגוריות סמנטיות. הצמתים ממוקמים ידנית סביב צומת ה-Project המרכזי — שכבת ארגון (כחול-נייבי), אנשים (ירוק), מסמכים (כחול-מלכותי), מנוע טפסים (תכלת), תהליכים (חום-חלודה), החלטות (אדום עמוק), כסף ולוז (טורקיז). רחפו על צומת כדי להאיר את שכניו ולעמעם את היתר; קליק פותח פאנל פרטים עם מאפיינים וקפיצה לישויות מקושרות. מומש כ-SVG וניל ללא תלות חיצונית — מתאים להפעלה מקומית מ-file://.

הציגו את הסכמה כטבלאות סטטיות (לעיון מהיר / להדפסה)

סוגי צמתים · 31 ישויות

מסגרת ארגונית · 5
Projectמיכל עליון · partition key · ב-Cosmos · 40–50 פעילים במקביל
Buildingבניין פיזי · קומות · ספירת דירות · ב-Project
Unitיחידה למסירה (דירה · חנות · חניה) · יעד DeliveryProtocol
Packageקיבוץ דיסציפלינה · חשמל · אינסטלציה · קונסטרוקציה · אדריכלות
CampusRefמספור צולב חוצה-פרויקטים · CMPS10-BD02-MOM-21-00001
אנשים וסמכות · 5
Companyחברה · יזם · קבלן · יועץ · אדריכל · לקוח · ישות אחת · עם score
Personזהות בודדת · מקושרת ל-Entra ID · עובד או חיצוני
ProjectRolePerson × Project × role · תפקיד פנים-מרגולין
CompanyRoleCompany × Project × role · יזם/קבלן/יועץ לפי פרויקט
AuthorityRecordמי בחברה מוסמך לאשר מה · נחתם בהשקה
מסמכים · 5
Drawingזהות לוגית של גליון (A-103) · קושר את כל המהדורות
Revisionגרסה פיזית · מצביע ל-APS · שרשרת supersession
Referenceאסמכתא · התכתבות יוצאת · מכתב · אישור · ממוספר ע״י CampusRef
Fileבינארי כללי · קשור פולימורפית (parent_type) לכל ישות
Photoראייה ויזואלית · ליקוי / יומן / פורם / אלבום
מנוע טפסים · 2
FormTemplateתבנית פורם דינמי · טקסט/תאריך/בחירה/תמונה/חתימה · משמשת לכל הצ׳קליסטים
FormSubmissionמופע של תבנית · kind discriminator · ליקוי/בדיקה/מסירה/בקרת איכות
תהליכים · 8
Protocolפרוטוקול ישיבה · ניתן לנעילה · גרסה אנגלית · מקור לפעילויות והחלטות
Activityפריט פעולה בתוך פרוטוקול · לא משימה גנרית · הקשר ישיבתי
JobJournalיומן עבודה יומי באתר · דרישת חוק · שני קולות (מפקח + קבלן)
Transmittalמסירת שרטוט לקבלן · עם דרגת איכות אישור (tier 1-4)
Submittalהצעת חומר/מפרט · מכונת מצבים · יועץ → קבלן
RFIבקשת מידע · קבלן → יועץ · על שרטוט/מפרט
Defectליקוי · נרשם כ-FormSubmission · מצולם · משוייך ליחידה
DeliveryProtocolפרוטוקול מסירה · דירה לרוכש · קישור חיצוני · דרישת חוק המכר
החלטות ושינויים · 2
Decisionהחלטה אטומית · provenance למקור (סעיף פרוטוקול) · קביל בבית משפט
ChangeOrderהגדלת חוזה · Δcost + Δdays · השפעה על שורת תקציב
כסף ולוז · 4
Contractהסכם מול חברה · תנאי תשלום · בסיס משפטי · קושר ל-AuthorityRecord
Paymentחשבון יוצא · נגד אבן דרך · נגד שורת תקציב · תחת חוזה
BudgetItemשורה בעץ תקציב 4 רמות (40.01.0000) · variance בזמן אמת
ScheduleTaskמשימת גאנט · בייסליין מול בפועל · אבן דרך לתשלום

סוגי קשתות · 54 יחסים

מבני · scope · 16
belongs-toBuilding · Package · Reference · JobJournal · FormSubmission → Project
insideUnit → Building · יחידה בתוך בניין
in-packageDrawing → Package · גליון בדיסציפלינה
revision-ofRevision → Drawing · גרסה קנונית
succeeded-byRevision → Revision · supersession
numbers / numbered-byCampusRef ↔ Reference · Protocol · Transmittal · מספור צולב
instance-ofFormSubmission → FormTemplate · המופע למקור
attached-toFile · Photo → Project (פולימורפי · parent_type)
אישורים וסמכות · 15
transmitted-toTransmittal → Company · קבלן/יועץ שקיבל
acknowledged-byTransmittal → Person · חתם · דרגת איכות
signed-underTransmittal → AuthorityRecord · אימות סמכות
referencesTransmittal → Revision · מה נשלח
approved-bySubmittal · Decision · ChangeOrder · Payment → Person
signed-by-buyerDeliveryProtocol → Person · רוכש חתם בקבלת דירה
binds-roleAuthorityRecord → CompanyRole · מי בחברה
held-byAuthorityRecord · ProjectRole · CompanyRole → Person/Company
scoped-toProjectRole · CompanyRole → Project · M:N תפקידים
פעולות ולוז · 14
insideActivity → Protocol · פעילות בתוך פרוטוקול
assigned-toActivity · Defect → Person · מי אחראי
in-unitDefect → Unit · ליקוי משוייך לדירה ספציפית
recorded-asDefect → FormSubmission · ליקוי הוא הגשת טופס
evidence-forPhoto → Defect · תמונה כראייה
for-unit / uses-checklistDeliveryProtocol → Unit · FormSubmission
inspector-signed / contractor-signedJobJournal → Person · Company · שני קולות
asked-of-consultant / aboutRFI → Company · Drawing
depends-onScheduleTask → ScheduleTask · תלות גאנט
paid-against-milestonePayment → ScheduleTask · אבן דרך
משפטי ולמידה · 9
cites §Decision → Protocol § · provenance לסעיף
binds / governsContract → Company · Project · בסיס משפטי
governed-byPayment → Contract · בסיס חוזי
budgeted-for / against-lineBudgetItem → Project · Payment → BudgetItem
impacts / amendsChangeOrder → BudgetItem · Contract · השפעה ושינוי
similar-toSubmittal → Submittal חוצה-פרויקט · P2
05 TIERS

איכות האישור.

סולם ההגנה המשפטית: מ-DocuSign (קביל בבית משפט) עד סימון פנימי (בסיכון). יעד שנה ראשונה: 80% Tier 1–2.

Tier 1
DocuSign · חתום דיגיטלית
חתימה דיגיטלית עם audit trail · חותם מוסמך אומת מול AuthorityRecord · חותם זמן קריפטוגרפי (RFC 3161)
קביל בבית משפט
Tier 2
מאושר במייל
אישור במייל פשוט מתיבת קבלן ידועה · DKIM מאומת · חותם זמן מ-MS Graph
חזק
Tier 3
סריקת חתימה ידנית
חתימת ידיים על נייר, סרוקה ומאומתת ב-OCR · הועלתה ע״י PM עם הערת שרשרת ראיות
סביר
Tier 4
סימון פנימי
הערת PM שהקבלן עודכן בטלפון או באתר · אין חתימת קבלן · מסומן כסיכון
בסיכון

יעד שנה ראשונה: ≥ 80% מהאישורים ב-Tier 1 או Tier 2. סירוב של קבלן נרשם כ-Tier 4 — הסירוב עצמו הופך לראייה.

06 LINEAGE

שושלת מהדורות.

"הראה לי הכל על שרטוט E-302 ברגע זה" — שער לאחזור מחלוקת. תחת 60 שניות, חמש שנים אחורה.

שרטוט · E-302 · חשמל · קומה 3 · שערי צדק W3
מהדורה 1 · 2025-09-12 · פורסם ע״י היועץ אבי כהן · הוחלפה
מהדורה 2 · 2025-10-04 · הגדלת תכולה · מקושר ל-ChangeOrder #03 · הוחלפה
מהדורה 3 · 2025-12-21 · אישור סטייה בפיקוח עליון · הוחלפה
מהדורה 4 · 2026-02-15 · בדיקת בטיחות לאחר ליקוי #41 · הוחלפה
מהדורה 5 · 2026-04-15 · החלפת כבל לפי החלטה #87 · הוחלפה
מהדורה 6 · 2026-05-02 · תיקון מסלול ניתוב לפינוי תעלת כבלים · הוחלפה
מהדורה 7 · 2026-05-18 · נוכחית · טרנסמיטל TR-044 · אישור ממתין
טרנסמיטל TR-044 · נשלח לדניה סיבוס 2026-05-18 14:22 · חותם: ענת ברק (AuthorityRecord #A-2026-04-11)
איכות אישור: חתום ב-DocuSign (Tier 1) · ממתין לאישור PM לשליחה

בעוד חמש שנים, אם קבלן יטען שבנה לפי מהדורה לא עדכנית — את כל השושלת הזו, עם חותמי זמן קריפטוגרפיים + דרגות אישור + קישורים לרשומות סמכות, אפשר להפיק תוך פחות מ-60 שניות. זה FR-010 במונחים תפעוליים.

07 DECISIONS

הוכרעו, ונדחו.

מה החלטנו עכשיו, ומה נשאיר לבירור. הוכרעו ימינה. נדחו שמאלה.

הוכרעושלב 1

  • דואל-סטור (Cosmos Gremlin + AI Search) במקום מסד גרף יחיד או מסד וקטורי יחיד — מעבר גרף ושליפה סמנטית הן תבניות גישה שונות.
  • השרטוטים נשארים חיצוניים ב-Autodesk/Ramdor — מרגולין מחזיקה מטא-דאטה, מצביעי מהדורות ורשומות אישור, לא בינארים.
  • עבודת מסד-נתונים לפני AI — נורמליזציית FR-012a שערה ל-Graph-RAG. בלעדיה, השליפה היא שטויות בביטחון.
  • דרגות איכות אישור (לא pass/fail) — הגנה משפטית היא ספקטרום, מוצגת מפורשות על כל טרנסמיטל.
  • התערבות בתוך הזרימה ללמידה חוצת-פרויקטים — לא דשבורד. תבנית Procore Insights / Construction IQ נכשלה כי דרשה תיוג ידני.
  • HITL על כל artifact משפטי/פיננסי — סוכנים מנסחים, PMs מאשרים. אפס פרסום אוטומטי.
  • משטחי M365 ילידיים במקום אפליקציה עצמאית — אימוץ הוא הסיכון העליון; הפחתת חיכוך משטחים.

נדחו לבירור

  • בחירת מודל אמבדינגtext-embedding-3-large מול רב-לשוני בהוסטינג עצמי. ההחלטה מונעת ע״י בנצ׳מארק עברית + Heblish בשלב 0.5.
  • DocuSign מול חתימה ילידית של MicrosoftDocuSign ברירת מחדל; בחינת חלופות קלות יותר בשלב 2.
  • משטח הצ׳אט — לשונית Teams ברירת מחדל; וריאנט Power Apps מובייל; בחינת הטמעת SharePoint למשתמשי חוץ-Teams.
  • Fabric מול Power BI ישיר — שכבת אנליטיקה בשלב 3; נדחה עד שנפח חוצה-פרויקטים יצדיק.
  • גרף בהוסטינג עצמי מול מנוהלCosmos Gremlin נבחר, אך Neo4j על Azure VM הוא גיבוי אם עלויות Cosmos מתפוצצות.