Skip to content
palmoni5 edited this page Jul 17, 2026 · 1 revision

תוכן אישי: סימניות, היסטוריה והערות

סימניות — lib/bookmarks/

  • Bookmark — מודל עשיר המשמש גם להיסטוריה: ‏ref, ‏book, ‏index, מפרשים להצגה, שדות חיפוש מלאים (לשחזור טאב חיפוש: אפשרויות, מילים חלופיות, מרווחים, שאילתה שלילית, מצב, היקף), ‏targetKind (ספר/כרטיסיית מפרשים), ‏label (ניתן לעריכה), ‏createdAt.
  • bookIdentity — זהות חזקה של ספר: ‏id ← מזהה חיצוני ← נתיב ← קטגוריה+כותרת ← כותרת.
  • BookmarkBloc (Cubit) — הוספה (כפילות נבדקת לפי זהות+אינדקס+סוג), עריכת תווית, הסרה, ניקוי.
  • BookmarkRepository — יורש BaseListRepository<Bookmark>, ‏Hive box בשם bookmarks.

היסטוריית קריאה — lib/history/

  • HistoryBloc — מנגנון snapshot: ‏CaptureStateForHistory יוצר Bookmark מהטאב הפעיל (תומך בכל סוגי הטאבים כולל חיפוש — עם בניית שאילתה מעוצבת), צובר עם debounce של 1.5 שניות, ופולט BulkAddHistory.
  • הסרת כפילויות לפי historyKey (מפתח יציב פר־ספר כולל מהדורה) והכנסה לראש; מוגבל ל־200 רשומות.
  • ‏flush לפני סגירת האפליקציה דרך PreCloseRegistry.
  • ‏UI: מסך "מועדפים" (FavouritesScreen) עם שתי לשוניות — סימניות והיסטוריה.

הערות אישיות — lib/personal_notes/

מודל ואחסון

  • PersonalNote — ‏bookId, ‏lineNumber, כותרת תצוגה, מערכת עיגון: ‏anchorText/prefix/suffix/start/end — עיגון למילים ספציפיות בשורה, או לשורה כולה. ‏status‏ (located/missing), תוכן ב־plain או Quill Delta.
  • PersonalNotesDatabase — ‏SQLite‏ (personal_notes.db) עם אינדקסים לפי ספר ושורה, ומיגרציית סכמה לעמודות העיגון.

שירותים

  • PersonalNotesService — הליבה: ‏loadNotes מבצע reconciliation של מיקום כל הערה מול תוכן הספר הנוכחי — אם הטקסט זז (עדכון ספרייה), מחפש ±5 שורות סביב; לא נמצא = מסומן missing (לא נמחק). ב־PDF‏ lineNumber = מספר עמוד.
  • PersonalNoteDraftService — טיוטות אוטומטיות ב־Hive, פר ספר/שורה/הערה.
  • PersonalNotesImportExportService — ייצוא JSON (גיבוי) וייצוא טקסט קריא (כולל שימור יעדי קישורים מ־Quill בתבנית טקסט (יעד)); ייבוא עם אסטרטגיות קונפליקט: מיזוג / דילוג / שמור שניים / דריסה.

תצוגה

עורך inline בתוך הקורא, עורך מלא, דיאלוג קישור, ‏sidebar בפאנל המפרשים (כרטיסייה שלישית), וייצוא.

שמור וזכור

כלי מעקב הלימוד "שמור וזכור" (פותח במקור כפרויקט נפרד) יושב ב־lib/tools/shamor_zachor/ — ראו כלים. הנתונים שלו (מפתחות sz: ב־Hive) נכללים בגיבוי.

דפים קשורים

Clone this wiki locally