תיק המשפחה 📁

אפליקציית ניהול מסמכים משפחתית - ביטוחים, פיננסים, זיכויים, קבלות ועוד - עם מעקב הוצאות/הכנסות ולוח שנה עברי. נבנתה כ-PWA שמתקינים ישירות למסך הבית באייפון (או כל טלפון אחר), ב-$0 עלות חודשית.

הסטאק

שכבה	טכנולוגיה	עלות
פרונטאנד + backend	Next.js 16 (App Router), פרוס ל-Vercel	חינם
מסד נתונים	MongoDB Atlas (טיר M0)	חינם
אימות	Auth.js (NextAuth) עם Credentials, JWT	חינם
אוטומציית תשלומים חודשיים	GitHub Actions (cron חודשי)	חינם
חגי ישראל	Hebcal API (ציבורי)	חינם

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

הקמה מאפס

1. מסד נתונים - MongoDB Atlas

1. הרשם ב-mongodb.com/cloud/atlas וצור פרויקט חדש.
2. צור Cluster מטיר M0 (Free).
3. תחת Database Access - צור משתמש עם סיסמה.
4. תחת Network Access - הוסף 0.0.0.0/0 (כדי ש-Vercel יוכל להתחבר; אין IP קבוע בטיר החינמי).
5. לחץ "Connect" → "Drivers" והעתק את ה-connection string (מתחיל ב-mongodb+srv://).

2. הרצה מקומית

git clone <כתובת ה-repo שלך>
cd family-docs
npm install
cp .env.example .env.local

מלא ב-.env.local:

• MONGODB_URI - ה-connection string מ-Atlas (הוסף בסופו שם database, לדוגמה /familydocs)
• AUTH_SECRET - הרץ openssl rand -base64 32 והדבק את הפלט
• CRON_SECRET - מחרוזת אקראית נוספת (לדוגמה גם עם openssl rand -base64 32)
• RESEND_API_KEY - מפתח API מ-resend.com (טיר חינמי מספיק), לשליחת קוד האימות הדו-שלבי לאזור הניהול
• ADMIN_OTP_FROM_EMAIL - כתובת שולח מאומתת ב-Resend (לדוגמה אזור ניהול <[email protected]> לבדיקות, או דומיין משלך לאחר אימות)

npm run dev

אין הרשמה עצמית. יצירת משתמשים והקצאתם ל-workspace-ים נעשית אך ורק דרך אזור הניהול (/admin/login). כדי ליצור את משתמש ה-admin הראשון ולבצע הגירה חד-פעמית של נתונים קיימים ל-workspace הראשון:

node scripts/migrate-to-workspaces.js [email protected]

הסקריפט יוצר workspace ראשון בשם "המשפחה" (ניתן לשינוי עם --name="שם אחר"), משייך אליו את כל המשתמשים הקיימים, מתייג את כל המסמכים/האירועים/המשימות הקיימים אליו, ומסמן את המשתמש עם האימייל שסופק כ-admin. בטוח להרצה כמה פעמים. אם עדיין אין משתמשים כלל, ניתן ליצור משתמש ראשון ישירות מ-MongoDB Atlas (Collections → users) או דרך mongosh, ואז להריץ את הסקריפט כדי לסמן אותו כ-admin וליצור עבורו workspace.

לאחר מכן היכנס לאזור הניהול ב-/admin/login עם האימייל/סיסמה של אותו משתמש (יישלח קוד אימות למייל), וצור/שייך משתמשים ו-workspace-ים נוספים.

שכחת את הסיסמה? אפשר לאפס אותה בכל שלב (גם לפני שיש admin) עם:

node scripts/reset-password.js [email protected] --password="סיסמה חדשה"

3. פריסה ל-Vercel (חינם)

1. הרשם ב-vercel.com עם GitHub.
2. "Add New Project" → בחר את ה-repo הזה.
3. תחת Environment Variables הוסף את חמשת המשתנים מ-.env.local (עם ה-URI האמיתי, לא placeholder).
4. Deploy.

בסיום תקבל כתובת כמו https://family-docs-yourname.vercel.app.

4. התקנה על מסך הבית באייפון

1. פתח את הכתובת שקיבלת מ-Vercel ב-Safari באייפון.
2. לחץ על כפתור השיתוף (הריבוע עם החץ) → "הוסף למסך הבית".
3. האפליקציה תופיע כאייקון רגיל שנפתח במסך מלא, בלי סרגל כתובות.

חזור על זה בכל טלפון של בן משפחה.

5. אוטומציית תשלומים חודשיים (אופציונלי אך מומלץ)

כדי שהמערכת תיצור אוטומטית רשומת הוצאה בתחילת כל חודש עבור מסמכים עם "תשלום חודשי":

1. ב-GitHub, בעמוד ה-repo → Settings → Secrets and variables → Actions.
2. הוסף שני secrets:
   • APP_URL - כתובת האפליקציה שלך מ-Vercel (בלי / בסוף)
   • CRON_SECRET - בדיוק אותו ערך שהזנת ב-Vercel
3. ה-workflow ב-.github/workflows/monthly-expenses.yml ירוץ אוטומטית פעם בחודש. אפשר גם להריץ ידנית מטאב "Actions" ב-GitHub → "Monthly Expenses Automation" → "Run workflow".

6. התראות Push (אופציונלי)

כדי לאפשר התראות קופצות למכשירים (על משימות באיחור, תאריכי יעד מתקרבים, ותזכורות חודשיות - ראו "אזור אישי" באפליקציה):

1. ייצר זוג מפתחות: npx web-push generate-vapid-keys.
2. הוסף ב-Vercel (Environment Variables) ובקובץ .env.local המקומי:
   • NEXT_PUBLIC_VAPID_PUBLIC_KEY - המפתח הציבורי מהפלט
   • VAPID_PRIVATE_KEY - המפתח הפרטי מהפלט (סודי - לא לחשוף)
   • VAPID_SUBJECT - כתובת מייל ליצירת קשר, לדוגמה mailto:[email protected]
3. כדי שההתראות היומיות (משימות/תאריכי יעד/תזכורות חודשיות) באמת יישלחו, צריך גם cron יומי - בדיוק כמו תשלומים חודשיים (שלב 5 למעלה), אבל עם ה-workflow .github/workflows/daily-reminders.yml (רץ אוטומטית כל 30 דקות ושולח כל התראה פעם ביום בשעה שהוגדרה - שעה גלובלית באזור הניהול, או שעה ייעודית לכל תזכורת חודשית; אותם שני secrets APP_URL/CRON_SECRET משמשים גם אותו, אין צורך להגדיר שוב).
4. בלי שלבים 1-2, האפליקציה ממשיכה לעבוד כרגיל - רק כפתור "הפעלת התראות" באזור האישי יציג שגיאה.
5. הערה ל-iPhone: התראות Push בדפדפן נתמכות ב-iOS רק מגרסה 16.4 ואילך, ורק כשהאפליקציה מותקנת למסך הבית (לא בטאב Safari רגיל) - ראו שלב 4 למעלה.

מגבלות ידועות

• גודל קובץ מקסימלי: כ-11MB (מגבלת מסמך MongoDB). מתאים למרבית הסריקות/PDF-ים/תמונות, לא לסרטונים או קבצים כבדים.
• הטיר החינמי של MongoDB Atlas מוגבל ל-512MB אחסון כולל - מספיק בנוחות לשימוש משפחתי (עד 10 משתמשים) לאורך זמן רב.
• הרשאות הן פר-workspace בלבד (גישה מלאה לכל workspace שהמשתמש שויך אליו, ללא הבחנה בין צפייה לעריכה בתוך אותו workspace).

This is the beginning of the README. Read the rest at the original. Read the full README ↗