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

מה זה?
------
"ממשקי משתמשים" הם אוסף מסכים ותהליכים אינטראקטיביים ב‑WebApp שמאפשרים לבצע פעולות מורכבות בנוחות: טפסים ממוקדים, אשפים רב‑שלביים, ותצוגות מצב. הפיצ'ר מיועד גם לשימוש ישיר ע"י משתמשי קצה וגם להפעלה מונחית ע"י סוכני AI.

היכן זה נמצא?
--------------
- בבוט: תפריט ראשי > "ממשקי משתמשים (web 🌐)" – פתיחת דפי ה‑WebApp הרלוונטיים בדפדפן.
- ב‑WebApp: פריטי תפריט ייעודיים יוצגו בהתאם להרשאות ולזמינות פיצ'רים.

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

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

1. פתיחה מהירה: בתפריט הראשי לחצו "ממשקי משתמשים (web 🌐)".
2. מעבר למסך היעד: בחרו תהליך/טופס נדרש.
3. מילוי שדות חובה ושליחה.
4. מעקב אחר חיווי מצב (התקדמות/הצלחה/כשל) והנחיות המשך.

שדות חובה ולוגיקת ולידציה
---------------------------
- שדות חובה מסומנים בכוכבית (*) ומאומתים בצד הלקוח לפני שליחה.
- ערכים לא חוקיים יציגו הודעת שגיאה צמודה לשדה. שליחה נחסמת עד לתיקון.
- הודעות שגיאה אינן מכילות מידע רגיש; ערכים רגישים מושחרים בלוגים.

חיווי מצב תהליך
----------------
- In‑Progress: מחווני טעינה/התקדמות.
- Success: חיווי "בוצע" וקישור להמשך פעולה (לדוגמה: צפייה בפריט/חזרה לרשימה).
- Failure: הודעת כשל עם קוד שגיאה קצר וטיפים לפתרון.

ממשק אדמין
-----------
- הרשאות: גישה מותנית ב‑`ADMIN_USER_IDS` או מדיניות הרשאות ארגונית.
- ניהול: צפייה/אישור/דחייה של בקשות, עדכון תצורה נקודתית.
- תצפיות: מומלץ להצליב עם דפי Observability (:doc:`/observability`, :doc:`/rate-limiting`, :doc:`/metrics`) בעת תחקור תקלות.

דוגמאות שימוש לסוכני AI
------------------------
- פתיחת זרימה: "פתח/י את 'ממשקי משתמשים (web 🌐)' ובחר/י בתהליך הרלוונטי".
- מילוי טופס: "מלא/י את כל השדות המסומנים ב‑``*``; עצור/י על שגיאה, הצג/י טקסט שגיאה קצר והצע/י ערך תקין".
- מעקב הצלחה: "וודא/י שהתקבל חיווי Success; אם לא – הבטח/י פעולה מתקנת בהתאם לטיפים על המסך".

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

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