האוספים שלי (My Collections)
==============================

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

יכולות מרכזיות
---------------
- יצירה/עריכה/מחיקה של אוסף
- הוספת פריטים לאוסף (קבצים, סימניות, מקטעים)
- שינוי סדר הפריטים באוסף בגרירה ושחרור
- תיוג פריטים באוסף באמצעות תגיות אימוג'י (עד 10 תגיות לפריט)
- שולחן עבודה (Workspace) כקנבן אנכי בשלושה סטטוסים (לטיפול/בתהליך/הושלם)
- סינון/חיפוש בתוך האוסף + סינון/מיון לפי תגיות
- שיתוף אוסף לקריאה בלבד (אופציונלי)

איך משתמשים
------------

.. list-table::
   :header-rows: 1
   :widths: 26 44 30

   * - פעולה
     - איך עושים
     - הערות
   * - יצירת אוסף
     - בתפריט הראשי של האוספים: "➕ צור אוסף" והשלמת שם/תיאור
     - ניתן לעדכן מאוחר יותר
   * - הוספת פריטים
     - מתוך תצוגת קובץ/סימניות: "📚 הוסף לאוסף" ובחירת האוסף היעד
     - אפשר ליצור אוסף חדש תוך כדי
   * - שינוי סדר
     - גרירת פריט מעלה/מטה בתוך רשימת האוסף
     - הסדר נשמר מידית
   * - עריכת פרטי אוסף
     - "✏️ ערוך" בעמוד האוסף
     - שינוי שם/תיאור/ניראות
   * - מחיקה
     - "🗑️ מחק" בעמוד האוסף
     - פעולה בלתי הפיכה; הפריטים עצמם אינם נמחקים מהמערכת

תיוג פריטים באוספים
--------------------
תיוג מאפשר לסמן כל פריט באוסף בעזרת אימוג'ים לפי עדיפות, קטגוריה, סטטוס וסדר טיפול.
התיוג הוא ברמת הפריט בתוך האוסף (אותו קובץ יכול לקבל תגיות שונות באוספים שונים).

**איך מתייגים?**
- לחצו על כפתור 🏷️ ליד פריט כדי לפתוח עורך תגיות.
- ניתן לבחור עד 10 תגיות לפריט.
- שינויים נשמרים מיד.

**תגיות נפוצות (דוגמאות):**
- עדיפות: 🐢 לא דחוף, 🔥 דחוף
- סנטימנט: 🔮 קסום, ♥️ מועדף
- אבטחה: 🔐 סודי
- סטטוס: 💭 רעיון, ⏸️ מושהה, 🎯 מטרה
- קטגוריה: 🐛 באג, 🗄️ דאטה-בייס, 🧪 ניסיוני
- סדר: 1️⃣ ראשון, 2️⃣ שני, 3️⃣ שלישי

הערה: אפשר לתייג פריטים ולערוך תגיות לכל פריט בנפרד דרך כפתור 🏷️ לידו.

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

מגבלות ופרטיות
----------------
- מגבלות שימוש: עד 200 אוספים למשתמש.
- שיתוף: ניתן להפיק קישור קריאה בלבד (אם מופעל), ללא עריכה.
- פרטיות: כברירת מחדל אוספים הינם פרטיים.

API קצר (למפתחים)
------------------
ראו `webapp/collections_api.py` לרפרנס endpoints. הפעולות אופייניות: יצירה, עדכון פרטים,
הוספה/הסרה של פריטים, שינוי סדר, ושליפה לפי מזהה משתמש/אוסף. שימו לב למגבלות rate limit.
לתיוג: `PATCH /api/collections/items/<item_id>/tags` ו-`GET /api/collections/tags/metadata`.

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

מובייל/טאבלט – גרירה לסידור
-----------------------------
- גרירה מתבצעת מהידית ``⋮⋮`` בצד הפריט.
- הסדר נשמר אוטומטית בשחרור – אין צורך בכפתור שמירה.
- בדסקטופ אין שינוי (Drag & Drop רגיל עם עכבר).
- אם הדף "נגרר" במקום הפריט, התחילו את הגרירה ישירות על הידית.

לוח Kanban עבור *שולחן העבודה*
------------------------------
``שולחן עבודה`` הוא אוסף ברירת-מחדל שמוצג כלוח משימות אנכי:

- **מבנה הלוח** – שלוש עמודות קבועות: ``לטיפול`` (todo), ``בתהליך`` (in_progress) ו-``הושלם`` (done). כל פריט שומר את הסטטוס שלו ברמת ה-Workspace בלבד, ולכן שינוי פריט בלוח לא משפיע על אותו קובץ באוספים אחרים.
- **גרירה** – הלוח משתמש ב-SortableJS עם ``forceFallback=true`` ו-``fallbackTolerance=8`` כדי לשמור על חווית מובייל טבעית. ניתן לגרור פריטים רק מהידית הייעודית כדי למנוע "קפיצות" בעת גלילה.
- **קיצורי מקלדת** – ניתן להעביר פריט שנמצא בפוקוס בין העמודות באמצעות ``Shift+1`` (לטיפול), ``Shift+2`` (בתהליך), ``Shift+3`` (הושלם). פוקוס על כרטיס (או הכרטיס האחרון שנגעתם בו) ממשיך את הזרימה.
- **נגישות** – עדכוני סטטוס מוקראים דרך אזור ``aria-live`` ייעודי, כך שמשתמשי קורא מסך מקבלים משוב אם המשימה הועברה לעמודה אחרת.
- **API ייעודי** – מעבר סטטוסים מתבצע ע"י `PATCH /api/workspace/items/:id/state` עם גוף ``{"state": "todo|in_progress|done"}``. ה-API מאמת שהפריט שייך לשולחן העבודה ולא יאשר ערכים מחוץ לסט הטבעי.
- **שילוב עם שאר היכולות** – גם בלוח הקנבן ניתן להצמיד/להסיר/לפתוח תצוגה מקדימה בדיוק כמו בתצוגת הרשימה, וכל פעולת גרירה מעדכנת את הספירות בעמודות בזמן אמת.

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