כלי דוחות למהנדסי בניין

הבעיה

מהנדסי בניין שכותבים דוחות בדיקה נתקעים בתהליך מתיש: הם מקבלים PDF עם עשרות ליקויים, בודקים כל אחד מהם פיזית, מצלמים, ואז מרכיבים ידנית מסמך Word מעוצב עם תגובות, מחירים והפניות לתקנים.

התהליך מועד לטעויות, איטי, וכמעט בלתי אפשרי לביצוע מהשטח על טלפון.

מה הכלי עושה

Pilot הופך את התהליך הזה לצינור מסודר:

1. מעלים את המסמך - המסמך שיכול להיות מורכב גם מצילומים מועלה למודל שמפרק את הדוח לליקויים בודדים
2. מגיבים בשטח: בוט טלגרם מוביל את המהנדס ליקוי אחרי ליקוי, או ישרות לזה שנבחר; המהנדס מגיב בתמונות ישירות ממצלמת הטלפון או מהאחסון במכשיר, והערות נרשמות בזמן אמת.
3. עורכים על המחשב: כלי ווב (Vue 3) נותן תצוגת עריכה מלאה: המידע מהשטח מרוכז פר סעיף ומאפשר ניהול תמונות, תמחור ומעקב סטטוס
4. יצוא: לחיצה אחת מייצרת DOCX בעברית בפורמט תקין, עם אישורי המהנדס, טבלת הליקויים, המחירים ובלוק החתימה

שני הממשקים חולקים את אותו מידע - המהנדס יכול להתחיל בטלפון ולסיים בדסקטופ ולהפך באופן רציף וזורם.

נקודות טכניות

• ארכיטקטורת שני ממשקים: בוט הטלגרם (Telegraf) ופורטל הווב (Vue 3 + Vite) קוראים שניהם לאותה שכבת שירות Express/Remult; אין לוגיקה כפולה
• פירוק PDF ב-AI: הטקסט מחולץ מקומית עם pdf-parse ונשלח ל-Gemini Flash לחילוץ JSON מובנה; מתמודד עם PDF-ים מהעולם האמיתי על כל הבלגן שבהם
• Remult ORM: מייצר נקודות REST אוטומטית ממחלקות הישויות; מקור אמת אחד לוולידציה ולבקרת גישה
• מלכודות AsyncLocalStorage: הקשר הבקשה של Remult יושב על AsyncLocalStorage; לעקוף את המידלוור של Telegraf ואת קריאות ה-stream של multer דרש סדר עטיפה מדויק
• ייצור DOCX: מסמך עברית RTL עם תמונות משובצות, טבלת סיכום מחירים ובלוק אישורי המהנדס, בעזרת ספריית docx

מה למדנו

המהנדס כבר ניסה כלים לדסקטופ והתאכזב מהם. לכן היה חשוב לפגוש אותו איפה שהוא כבר נמצא ולהשתמש בכלי שהוא מכיר ועובד היטב, במקרה הזה טלגרם כבר על הטלפון.

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

עבודה עם מסמכי הנדסה אמיתיים בעברית גם אילצה להתמודד עם פריסת RTL, פורמט תאריך עברי ונוסח משפטי כבר בהתחלה ולא כמחשבה שנייה.