Skip to content

omerElezra/Agala

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

80 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🛒 Agala — עגלה

רשימת קניות חכמה למשפחה

אפליקציה לניהול רשימת קניות משותפת עם חיזוי חכם מתי צריך לקנות שוב

Platform CI/CD Hebrew Author


מה זה עגלה?

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

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


✨ מה האפליקציה יודעת לעשות?

🛒 רשימת קניות

  • הוספת מוצרים — דרך שורת החיפוש במסך הראשי: חפשו מוצר קיים או הוסיפו מוצר חדש ישירות אם לא נמצא. הקטגוריה מזוהה אוטומטית (למשל: "חלב" → מוצרי חלב)
  • כמות — בחרו כמה יחידות צריך עם כפתורי +/−
  • סימון כנקנה — לחצו על הפריט כדי לסמן שקניתם. הרכישה נשמרת בהיסטוריה
  • החזרה לרשימה — לחצו על פריט שנקנה כדי להחזיר אותו לרשימה הפעילה
  • בחירת קטגוריה — כשהמערכת לא מזהה קטגוריה אוטומטית, נפתח חלון בחירת קטגוריה עם 16 קטגוריות (אמוג'י + שם). כל הקטגוריות מנוהלות ממקור אחד
  • מיון — מיינו לפי שונה לאחרונה (ברירת מחדל), שם, קטגוריה, או עומד להיגמר — חל גם על העגלה וגם על הקטלוג. לחצו שוב על מיון פעיל כדי להפוך את הכיוון (↑/↓)
  • מונה מוצרים — מספר הפריטים מוצג ליד כותרת הסקציה
  • כותרות נעולות — כותרות "עגלה שלי" ו"הקטלוג שלי" נשארות גלויות בזמן גלילה
  • כווץ/פתח — אפשר לכווץ ולפתוח את העגלה או הקטלוג בלחיצה על הכותרת
  • החלקה — החליקו שמאלה כדי לדחות מוצר או להסיר מהרשימה
  • רענון — משכו למטה כדי לרענן

🤖 חיזוי חכם — מתי לקנות שוב?

  • האפליקציה לומדת מההיסטוריה שלכם וחוזה כל כמה ימים תצטרכו לקנות כל מוצר
  • המלצות AI חכמות — שורת המלצות בראש המסך מראה מוצרים שעומדים להיגמר עם כפתורי "הוסף" ו"דלג". מתעדכנות מיד בלחיצה — בלי לחכות לרענון
  • מד מלאי בקטלוג — כל מוצר מציג אחוז מלאי בבית: 0% = נגמר, 100% = מלא, עם כיתוב ברור: "לך תקנה" (אדום), "תכף נגמר" (כתום), "חצי קלאץ'" (צהוב), "יש בשפע", "הרגע קנינו"
  • תדירות ליחידה — המחזור מחושב תמיד ליחידה אחת. קניתם 3 חבילות חלב? המערכת מכפילה באופן אוטומטי את המרווח ב×3
  • ברירות מחדל חכמות — גם בלי היסטוריה, המערכת יודעת שלחם קונים כל 3 ימים ומוצרי ניקיון כל 30 יום
  • מצב ידני — אם אתם יודעים טוב יותר, תגדירו את התדירות בעצמכם (ליחידה)
  • חיזוי — "בעוד 3 ימים", "מחר", "היום!" — תמיד תדעו מתי הזמן לקנות
  • חיזוי לילי (Nightly Prediction) — כל לילה ב-02:00, פונקציית שרת מחשבת מחדש את ה-EMA לכל מוצר, ומוסיפה אוטומטית מוצרים שהגיע זמנם לרשימת הקניות (ביטחון ≥85%) או להצעות (50–84%)

📊 היסטוריית רכישות

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

👨‍👩‍👧‍👦 משק בית משותף

  • רשימה אחת לכולם — כל בני המשפחה רואים ועורכים את אותה רשימה
  • הזמנה בקוד — שלחו קוד משק בית לבני המשפחה ויצטרפו בלחיצה
  • סנכרון בזמן אמת — שינויים מופיעים מיד אצל כולם

⚙️ הגדרות

  • עריכת שם תצוגה
  • ניהול משק בית (הצטרפות / שיתוף קוד)
  • 🤖 AI מזהה מה חסר — הפעלה/כיבוי של שורת המלצות
  • מד מלאי בקטלוג — הפעלה/כיבוי של אחוז ניצול מלאי
  • 🤖 AI ממלא את העגלה — הוספה אוטומטית של מוצרים שעומדים להיגמר
  • ייבוא רשימת קניות:
    • מקובץ — בחרו קובץ CSV/TXT מהמכשיר
    • מלוח — הדביקו טקסט מהלוח וייבאו
    • הקלדה ידנית — כתבו שמות מוצרים (אחד בכל שורה)
  • דרגו אותנו ב-Google Play
  • התנתקות

📱 איך זה נראה?

האפליקציה כוללת 3 מסכים עיקריים:

מסך תיאור
🛒 עגלה הרשימה הראשית — מוצרים שצריך לקנות
📊 היסטוריה רכישות קודמות עם סינון לפי תאריך
⚙️ הגדרות פרופיל, משק בית, ייבוא, דירוג

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

ניתן לפתוח את דף הפריט גם מתוך "הקטלוג שלי" ולא רק מהרשימה הפעילה.


🎨 עיצוב

  • מצב כהה — עיצוב כהה מודרני, נוח לעיניים
  • עברית מלאה — כל הטקסטים, הודעות שגיאה, וכפתורים בעברית
  • תמיכה מלאה ב-RTL — תצוגת עברית מיושרת מימין לשמאל באמצעות I18nManager.forceRTL(true) גלובלי + הגדרות supportsRTL/forcesRTL ב-app.json
  • רב-פלטפורמי — עובד על iPhone, Android, ודפדפן אינטרנט
  • Adaptive Icon — אייקון שמותאם לכל צורת מסך אנדרואיד (עיגול, מרובע מעוגל), ממוקם ב-63% עם שוליים בטוחים
  • מסך פתיחה — לוגו ממורכז וממוקד על רקע כהה, בגודל פרופורציונלי (~35% מרוחב המסך)

📥 ייבוא רשימה קיימת

יש לכם רשימת קניות בקובץ? ניתן לייבא אותה בקלות:

פורמט CSV — שם מוצר בכל שורה:

חלב
ביצים,2
לחם
גבינה צהובה,1
  • במחשב: לחצו "ייבוא" בהגדרות ובחרו אחת משלוש אפשרויות: מקובץ, מלוח, או הקלדה ידנית
  • בטלפון: העתיקו את הטקסט ללוח או כתבו ידנית ולחצו "ייבא"

הקטגוריות מזוהות אוטומטית ומוצרים שכבר קיימים לא יתווספו פעמיים.


🧠 איך החיזוי החכם עובד?

ככל שתקנו מוצר יותר פעמים, המערכת לומדת את הקצב שלכם:

קטגוריה ברירת מחדל
🍞 לחם ומאפים כל 3 ימים
🥬 פירות וירקות כל 4 ימים
🥛 מוצרי חלב כל 5 ימים
🍗 בשר ועוף כל 6 ימים
🥤 משקאות כל 7 ימים
🥚 ביצים כל 10 ימים
🍝 דגנים ואורז כל 18 ימים
🧹 מוצרי ניקיון כל 30 ימים
🧂 תבלינים כל 45 ימים

אחרי 2 רכישות ומעלה, המערכת מחשבת את הקצב האישי שלכם (ליחידה) ומעדכנת את החיזוי. אם קניתם 3 יחידות, המערכת מכפילה את המרווח ב-3 באופן אוטומטי.


❓ שאלות נפוצות

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

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

ש: איך מוסיפים בן משפחה? הגדרות → "קוד משק בית" → לחצו להעתיק → שלחו לבן המשפחה. הם מדביקים את הקוד בהגדרות שלהם ולוחצים "הצטרף".

ש: אפשר להשתמש בדפדפן? כן! האפליקציה עובדת גם בדפדפן אינטרנט במחשב.

ש: איך לשנות את תדירות הקנייה של מוצר? לחצו על המוצר → בכרטיס "חיזוי קנייה" → עברו למצב "ידני" → שנו את מספר הימים (ליחידה) → "אישור". המערכת תכפיל אוטומטית בכמות שקניתם.


🔗 למפתחים

מחפשים מידע טכני? ראו DEVELOPMENT.md.

מעקב התקדמות ושלבי בנייה: PROGRESS.md.


נבנה עם ❤️ עבור משפחות ישראליות

עגלה — קניות חכמות, יחד.


עוצב ופותח על ידי Omer Elezra

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors