שמור וזכור - מערכת מעקב לימוד 📖

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

📸 תמונת מסך

✨ מאפייני היישום

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

🚀 הורדה והפעלה

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

🔗 הורד את הגרסה האחרונה מכאן

הורידו את קובץ ההתקנה המתאים למערכת ההפעלה שלכם (לדוגמה, APK עבור Android, קובץ התקנה עבור Windows, וכו') והפעילו/התקינו אותו בהתאם להוראות הפלטפורמה.

🔍 אופן השימוש

1. ניווט: השתמשו בסרגל הניווט התחתון כדי לעבור בין מסך ה"מעקב" (סקירה כללית) למסך ה"ספרים" (בחירת לימוד).
2. בחירת ספר: במסך ה"ספרים", בחרו את הקטגוריה (תנ"ך, ש"ס וכו') ואז את הספר/מסכת שברצונכם ללמוד או לעדכן. ניתן להשתמש בשורת החיפוש לאיתור מהיר.
3. מעקב אחר ההתקדמות: במסך הספר/מסכת שנבחר, סמנו את תיבות הסימון המתאימות עבור כל דף/עמוד/פרק:
   • התיבה הראשונה מייצגת לימוד ראשוני.
   • שלוש התיבות הבאות מייצגות חזרות נוספות.
4. צפייה בהתקדמות: חזרו למסך ה"מעקב" כדי לראות סקירה כללית של הפריטים בתהליך ואלו שהושלמו, כולל סרגל התקדמות ותאריך סיום (אם רלוונטי).
5. שמירה אוטומטית: כל שינוי נשמר באופן אוטומטי באחסון המקומי של המכשיר.

📂 מבנה הקבצים (למפתחים)

הפרויקט פותח באמצעות Flutter ומאורגן במבנה הסטנדרטי של פרויקטי Flutter:

• src/lib/main.dart: נקודת הכניסה הראשית של היישום. מכיל את הגדרות האפליקציה והניווט הראשי.
• src/lib/models/: מכיל את מודלי הנתונים של האפליקציה (למשל, book_model.dart, progress_model.dart).
• src/lib/providers/: מכיל את ספקי המצב (Providers) לניהול מצב האפליקציה (למשל, data_provider.dart, progress_provider.dart).
• src/lib/screens/: מכיל את קבצי הווידג'טים המייצגים את המסכים השונים באפליקציה (למשל, books_screen.dart, tracking_screen.dart).
• src/lib/services/: מכיל לוגיקה עסקית ושירותים, כגון טעינת נתונים (data_loader_service.dart) וניהול התקדמות (progress_service.dart).
• src/lib/widgets/: מכיל ווידג'טים לשימוש חוזר ברחבי האפליקציה.
• src/pubspec.yaml: קובץ התצורה של הפרויקט, המגדיר את התלויות (dependencies), נכסים (assets) ופרטים נוספים של הפרויקט.
• src/assets/data/: תיקייה המכילה קבצי JSON עם המבנה והמידע עבור כל קטגוריית לימוד (תנ"ך, תלמוד בבלי וכו').
• src/assets/images/: תיקייה המכילה קבצי תמונות ואייקונים המשמשים באפליקציה.
• legacy/: תיקייה המכילה את קוד המקור של הגרסה הקודמת של היישום, שהייתה מבוססת Python.

📋 דרישות מערכת (להרצה מקוד המקור)

• Flutter SDK (יש לוודא התקנה תקינה וזמינות הפקודה flutter בשורת הפקודה)
• סביבת פיתוח מתאימה לפלטפורמה הרצויה (למשל, Android Studio עבור פיתוח לאנדרואיד, Xcode עבור iOS, וכו').

לפני ההרצה הראשונה, יש למשוך את התלויות של הפרויקט. בתיקיית השורש של הפרויקט (src/), הריצו:

flutter pub get

לאחר מכן, ניתן להריץ את האפליקציה באמצעות הפקודה הבאה (מומלץ להריץ מתוך תיקיית src/):

flutter run

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

🤝 תרומה ושיפור

נשמח לקבל תרומות קוד ושיפורים! אם ברצונכם לעזור ולשפר את היישום, אתם מוזמנים לשבט את הריפו, לבצע את השיפורים הנדרשים, ולפתוח Pull Request. לשאלות ותקלות, פתחו דיווח בעיה (Issue) בגיטהאב.