Skip to content

🛒💵 Cibus & tenbis (10bis) vouchers manager application + AI based Smart groceries list

License

Notifications You must be signed in to change notification settings

LeviEyal/Cibuson-app

Repository files navigation

🎫 סיבוסון - ניהול חכם לשוברי סיבוס ותן ביס

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

לינק לאפליקציה

📸 תצלומי מסך

דשבורד ראשי

Dashboard

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

Dashboard

קבלת שוברים מתאימים לקנייה שלך

Dashboard Dashboard

✨ יכולות עיקריות

  • 🔄 סריקה אוטומטית: האפליקציה סורקת את תיבת הדואר שלכם ומייבאת את כל השוברים באופן אוטומטי
  • 📊 ניהול שוברים:
    • מעקב אחר שוברים פעילים
    • סימון שוברים שנוצלו
    • סימון שוברים תקולים
  • 📝 רשימת קניות חכמה:
    • כתיבה חופשית של פריטים
    • סיווג אוטומטי לקטגוריות
    • ארגון חכם של רשימת הקניות

🚀 התקנה למפתחים

דרישות מקדימות

שלבי התקנה

  1. שכפול הפרויקט
git clone https://github.com/LeviEyal/Cibuson-app.git
cd Cibuson-app
npm install
  1. הגדרת משתני סביבה

צור קובץ .env והוסף את המשתנים הבאים:

NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=
CLERK_SECRET_KEY=
NEXT_PUBLIC_CONVEX_URL=
NEXT_PUBLIC_CLERK_SIGN_IN_URL=/sign-in
NEXT_PUBLIC_CLERK_SIGN_UP_URL=/sign-up
NEXT_PUBLIC_CLERK_AFTER_SIGN_IN_URL=/
NEXT_PUBLIC_CLERK_AFTER_SIGN_UP_URL=/
  1. הפעלת סביבת פיתוח
npm run dev

🏗️ ארכיטקטורה

Frontend

  • Framework: Next.js
  • Styling: Tailwind CSS
  • State Management: React Hooks
  • Authentication: Clerk

Backend

  • Database: Convex
  • APIs:
    • Gmail API לסריקת מיילים
    • Text Analysis לקטגוריזציה של פריטי קניות

📦 דיפלוי

  1. התחבר ל-Vercel והגדר את משתני הסביבה
  2. חבר את הריפוזיטורי ל-Vercel
  3. בצע דיפלוי

🤝 תרומה לפרויקט

נשמח לקבל תרומות! אנא צרו issue או הגישו pull request.

📄 רישיון

MIT License - ראה LICENSE לפרטים נוספים.