ממשקי משתמשים (Web)

summary:

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

היכן זה נמצא?

  • בבוט: תפריט ראשי > ”ממשקי משתמשים (web 🌐)“ – פתיחת דפי ה‑WebApp הרלוונטיים בדפדפן.

  • ב‑WebApp: פריטי תפריט ייעודיים יוצגו בהתאם להרשאות ולזמינות פיצ’רים.

מסכים בולטים

  • Code Execution Playground: /tools/code (פתוח לכל משתמש מחובר; הרצת קוד Premium/Admin בלבד + FEATURE_CODE_EXECUTION=true). לפרטים מלאים (אבטחה, API, מגבלות, ותפעול) ראו הרצת קוד (Code Execution Playground).

גרסאות: צפייה והשוואה

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

  • פתיחת גרסה: בתפריט ”עוד“ ← ”🕐 היסטוריה“. כל שורה ברשימה מקשרת אל /file/<id> של אותה גרסה. העמוד שנפתח הוא אותו עמוד קובץ רגיל, עם אותה הדגשת תחביר ואותה בדיקת בעלות — לא מסלול תצוגה נפרד. אותו דבר ב-/md/<id> לקובצי Markdown.

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

  • קובץ בסל המיחזור: העברה לסל מסמנת את כל הגרסאות של אותו שם קובץ יחד, ולכן אין לקובץ כזה ”גרסה אחרונה פעילה“. במקום באנר הגרסאות מוצגת הפניה אל סל המיחזור (/trash) — הפעולה הנכונה היא שחזור הקובץ, לא הוספת גרסה חדשה לקובץ מחוק.

  • קבצים גדולים: large_files הוא אוסף דריסה ואין בו מספור גרסאות, ולכן אין שם באנר.

השוואה בין שתי גרסאות

/compare/<file_id> מקבל ?left= ו-?right= ומשווה כל שתי גרסאות. ברירת המחדל היא הקודמת מול הנוכחית.

  • ברשימת ההיסטוריה אפשר לסמן שתי גרסאות ולפתוח את הדיף ביניהן. סימון שלישי מחליף את הוותיקה מבין השתיים.

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

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

  • ”הגרסה הנוכחית“ נגזרת מהקובץ ולא מהמסמך שבכתובת, כך שפתיחת השוואה מתוך עמוד של גרסה ישנה מתנהגת אותו דבר.

זרימת עבודה דרך הבוט

הבוט פועל כ‑Launcher ל‑WebApp ומספק קישורים ישירים למסכים. הזרימה הטיפוסית לסוכן AI:

  1. פתיחה מהירה: בתפריט הראשי לחצו ”ממשקי משתמשים (web 🌐)“.

  2. מעבר למסך היעד: בחרו תהליך/טופס נדרש.

  3. מילוי שדות חובה ושליחה.

  4. מעקב אחר חיווי מצב (התקדמות/הצלחה/כשל) והנחיות המשך.

שדות חובה ולוגיקת ולידציה

  • שדות חובה מסומנים בכוכבית (*) ומאומתים בצד הלקוח לפני שליחה.

  • ערכים לא חוקיים יציגו הודעת שגיאה צמודה לשדה. שליחה נחסמת עד לתיקון.

  • הודעות שגיאה אינן מכילות מידע רגיש; ערכים רגישים מושחרים בלוגים.

חיווי מצב תהליך

  • In‑Progress: מחווני טעינה/התקדמות.

  • Success: חיווי ”בוצע“ וקישור להמשך פעולה (לדוגמה: צפייה בפריט/חזרה לרשימה).

  • Failure: הודעת כשל עם קוד שגיאה קצר וטיפים לפתרון.

ממשק אדמין

  • הרשאות: גישה מותנית ב‑ADMIN_USER_IDS או מדיניות הרשאות ארגונית.

  • ניהול: צפייה/אישור/דחייה של בקשות, עדכון תצורה נקודתית.

  • תצפיות: מומלץ להצליב עם דפי Observability (אובזרווביליות (Observability), Rate Limiting, מדדים (Metrics)) בעת תחקור תקלות.

דוגמאות שימוש לסוכני AI

  • פתיחת זרימה: ”פתח/י את »ממשקי משתמשים (web 🌐)« ובחר/י בתהליך הרלוונטי“.

  • מילוי טופס: ”מלא/י את כל השדות המסומנים ב‑*; עצור/י על שגיאה, הצג/י טקסט שגיאה קצר והצע/י ערך תקין“.

  • מעקב הצלחה: ”וודא/י שהתקבל חיווי Success; אם לא – הבטח/י פעולה מתקנת בהתאם לטיפים על המסך“.

אבטחה ופרטיות

  • אין לרשום סודות/PII בטפסים שאינם מיועדים לכך; שימוש במנהל הסודות בלבד.

  • לוגים ודשבורדים אינם מציגים ערכים גולמיים רגישים; יש השחרה אוטומטית.

הערות תאימות

  • זמינות מסכים עשויה להשתנות בין סביבות; ייתכנו דפים ניסיוניים בהדרגה.

  • קישורי הבוט יפתחו בדפדפן ברירת המחדל של המשתמש.