Skip to content

rdiol12/SalaryApp

Repository files navigation

אפליקציית מעקב משכורת ומשמרות

אפליקציה מקצועית לניהול משמרות, חישוב שכר ומעקב פיננסי - מותאמת במיוחד לשוק העבודה הישראלי.

תיאור

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

תכונות עיקריות

מעקב משמרות

  • רישום משמרות עבודה, שבת, מחלה וחופש
  • תבניות משמרות מוכנות (בוקר, צהריים, לילה, רגיל)
  • יומן משמרות בתצוגת לוח שנה ותצוגת רשימה
  • צירוף תמונות קבלות למשמרות
  • שכפול משמרות קיימות

חישוב שכר

  • חישוב שעות נוספות בשכבות (125%, 140% ומעלה)
  • ניכוי הפסקות אוטומטי
  • חישוב ימי מחלה לפי חוק (יום 1: 0%, יום 2-3: 50%, יום 4+: 100%)
  • קצובת נסיעה יומית
  • בונוס חודשי

חישובי נטו ישראליים

  • מדרגות מס הכנסה עדכניות (10% עד 50%)
  • נקודות זיכוי ממס (ברירת מחדל: 2.25 נקודות)
  • ניכוי פנסיה (ברירת מחדל: 6%)
  • ביטוח לאומי (3.5%-12% לפי מדרגת הכנסה)

ניתוח וסטטיסטיקות

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

ייצוא ושיתוף

  • תלושי שכר
  • שיתוף דרך וואטסאפ
  • גיבוי ושחזור נתונים
  • ייצוא מסמכים

טכנולוגיות

טכנולוגיה שימוש
React Native + Expo פריימוורק הפיתוח
React Native Reanimated אנימציות מתקדמות
AsyncStorage אחסון נתונים מקומי
React Native Calendars תצוגת לוח שנה
Chart Kit גרפים וניתוח נתונים
Expo Image Picker צירוף תמונות

התקנה

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

  • Node.js גרסה 20 ומעלה
  • npm
  • Expo CLI

שלבי התקנה

# שכפול הפרויקט
git clone https://github.com/rdiol12/SalaryApp.git
cd SalaryApp

# התקנת תלויות
npm install

# הפעלת שרת הפיתוח
npx expo start

הרצה על מכשיר

# אנדרואיד
npm run android

# iOS
npm run ios

בנייה (Build)

בנייה מקומית עם EAS

# התקנת EAS CLI
npm install -g eas-cli

# בניית APK לאנדרואיד (פיתוח)
eas build --platform android --profile development

# בניית APK לאנדרואיד (הפצה)
eas build --platform android --profile production

# בניית iOS
eas build --platform ios --profile production

בנייה אוטומטית (CI/CD)

הפרויקט כולל GitHub Actions שמבצע בנייה אוטומטית של iOS ו-Android בכל push ל-main:

  • iOS: בנייה על macOS עם xcodebuild, יצירת קובץ IPA
  • Android: בנייה על Ubuntu עם Gradle, יצירת קובץ APK

קבצי הבנייה זמינים להורדה כ-Artifacts ב-GitHub Actions.

מבנה הפרויקט

SalaryApp/
├── App.js                    # קומפוננטת שורש
├── app.json                  # הגדרות Expo
├── eas.json                  # הגדרות EAS Build
├── src/
│   ├── components/           # קומפוננטות UI
│   │   ├── Header.js         # כותרת עליונה
│   │   ├── BottomTabs.js     # ניווט תחתון
│   │   ├── CalendarView.js   # תצוגת לוח שנה
│   │   ├── ListView.js       # תצוגת רשימה
│   │   ├── AddShiftModal.js  # הוספת משמרת
│   │   ├── AdvancedStats.js  # סטטיסטיקות חודשיות
│   │   ├── YearlyStats.js    # סטטיסטיקות שנתיות
│   │   ├── SettingsModal.js  # הגדרות
│   │   ├── PayslipModal.js   # תלוש שכר
│   │   ├── settings/         # קומפוננטות הגדרות
│   │   └── insights/         # תובנות וניתוחים
│   ├── hooks/                # Custom Hooks
│   │   ├── useShifts.js      # ניהול משמרות
│   │   └── useSettings.js    # ניהול הגדרות
│   ├── utils/                # פונקציות עזר
│   │   ├── calculations.js   # חישובי שכר ומס
│   │   ├── overtimeUtils.js  # חישובי שעות נוספות
│   │   └── __tests__/        # בדיקות יחידה
│   └── constants/
│       └── theme.js          # עיצוב וצבעים
└── assets/                   # אייקונים ותמונות

הגדרות ברירת מחדל

הגדרה ערך
שכר שעתי 40 ש"ח
תקופת שכר 25 עד 24 בחודש
ניכוי הפסקה 30 דקות
קצובת נסיעה 22.60 ש"ח ליום
יעד חודשי 10,000 ש"ח
שעות נוספות 125% שעה 8-10
שעות נוספות 140% שעה 10+
.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors