ManageHouse: ניהול הוצאות והכנסות

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

כתובות (אותה אפליקציה, כניסה עם חשבון Google מורשה בלבד):

• https://car-qr-counter.firebaseapp.com (Firebase Hosting, הכתובת הראשית)
• https://gavishori.github.io/Manage_House/ ו-car-qr-counter.web.app מעבירות אוטומטית לכתובת הראשית, כי כניסה עם Google בנייד עובדת רק באותו דומיין של Firebase Auth

איך זה בנוי

docs/                האפליקציה שמתפרסמת ב-Firebase Hosting וב-GitHub Pages (בלי שום נתון אישי)
  index.html         הדשבורד
  app.js             התחברות עם Google, טעינה ושמירה מול Firestore
  firebase-config.js הגדרות הפרויקט ב-Firebase (ציבוריות מטבען)
  files.js           לשונית ״מסמכים״: העלאה, בדיקת כפילות וגרסאות, ומיזוג של השינויים בלבד
  reader.js          קריאת PDF: טקסט מסודר בשורות, ו-OCR לסריקות. עצמאי, אפשר להעתיק לפרויקט אחר
scripts/build.py     הופך קבצי ייצוא לקובץ נתונים אחד, data.json
firestore.rules      מי מורשה לקרוא ולכתוב את הנתונים
finance/private/     לא נכנס ל-git: קבצי ייצוא, config.json, data.json

הנתונים לא נמצאים בריפו. הם שמורים ב-Firestore, במסמכים finance/data (התנועות) ו-finance/state (תקציב ותשובות). לפי firestore.rules, רק הבעלים ומי שהוא שיתף איתם יכולים לקרוא או לכתוב אותם. הריפו ציבורי, ולכן אין להכניס אליו את finance/private/. התיקייה מוחרגת ב-.gitignore.

עדכון חודשי

1. מורידים קבצי ייצוא ושמים אותם ב-finance/private/raw/. אין צורך למחוק קבצים ישנים: כפילויות מזוהות ונספרות פעם אחת.
   • הבנק: תנועות עו״ש (.xls)
   • מקס: עסקאות של כל הכרטיסים (.xlsx)
   • ישראכרט: דפי הפירוט החודשיים (PDF). הנחות מועדון נרשמות כזיכוי, והסכום נבדק מול החיוב בבנק
   • bit: היסטוריה (.csv)
   • תלושי פנסיה: PDF
2. מריצים:

   python scripts/build.py
   

   (בפעם הראשונה: pip install xlrd openpyxl pdfplumber)
3. בפעם הראשונה: נכנסים לאתר, לוחצים ״עדכון נתונים״ ובוחרים את finance/private/data.json. ב-Chrome וב-Edge האתר זוכר את הקובץ, ומאז מספיק ללחוץ ״רענון״: אם הקובץ השתנה, הוא עולה אוטומטית. בדפדפנים אחרים בוחרים את הקובץ מחדש בכל פעם.

הגדרות (finance/private/config.json)

• categories: קטגוריות, הסוג של כל אחת ותקציב מומלץ. income / expense נספרות במאזן החודשי. *_oneoff (חד-פעמי) ו-pass (כסף שרק עובר דרככם) מוצגות בנפרד. ignore מוחרגת לגמרי ולא מגיעה לאפליקציה, למשל כרטיס ששייך למישהו אחר.
• bank_rules ו-card_rules: כללי סיווג (ביטוי רגולרי על תיאור התנועה). הכלל הראשון שמתאים קובע. @card מסמן את החיוב הכולל של כרטיס האשראי בבנק, שמוחלף בפירוט העסקאות מקובץ הכרטיס.
• forecast: סכומים קבועים לתחזית של חודש רגיל.
• fixed_commitments, insights, learned, questions: הטקסטים שבלשוניות. לכל שאלה אפשר להוסיף src: הסבר (note), תנועות קשורות (match, ביטוי רגולרי על התיאור, ואופציונלית cat, issuer, from ו-to) ומסמכים (docs, שמות מתוך manual_sources). לחיצה על השאלה באתר מציגה אותם. summary הוא כרטיס תמונת המצב בראש התובנות, ו-{{tin}}, {{tout}}, {{gap}} ו-{{fixed}} מתמלאים בו מהתחזית.
• manual_sources, missing_sources: לשונית ״מקורות״, עם מסמכים שהתקבלו ידנית ומה שעוד חסר. את רשימת הקבצים האוטומטיים והתקופה שכל אחד מכסה build.py מפיק בעצמו.

אחרי שינוי בהגדרות מריצים שוב את build.py ומעלים את הקובץ החדש.

הרשאות ופריסה

• שיתוף: הבעלים (המייל שמוגדר ב-firestore.rules וב-docs/firebase-config.js) לוחץ באפליקציה על ״שיתוף״ ומוסיף או מסיר כתובות Gmail. הרשימה נשמרת ב-Firestore, באוסף access, ולא בריפו הציבורי. מי שברשימה מתחבר עם Google ורואה ועורך את כל הנתונים.
• קישור זמני עם סיסמה: ב״שיתוף״ ← ״קישור זמני עם סיסמה״ בוחרים סיסמה ומקבלים קישור לצפייה בלבד. השעה מתחילה ברגע שמכניסים את הסיסמה הנכונה. קישור שלא נפתח תוך 7 ימים פג מעצמו. הנתונים מוצפנים בדפדפן (AES-GCM, מפתח PBKDF2 מהסיסמה). ב-shareSalts/{id} נשמר רק ה-salt, וב-shares/{id} המידע המוצפן, שנחסם לקריאה עד הפתיחה. הפתיחה הראשונה מחייבת הוכחה שנגזרת מהסיסמה (השרת בודק SHA-256), השרת חותם את זמן הפתיחה וחוסם את הקריאה אחרי שעה. אפשר לבטל קישור בכל רגע.
• פריסת חוקי האבטחה אחרי שינוי ב-firestore.rules:

  npx firebase-tools deploy --only firestore:rules
  

• פריסת האפליקציה אחרי שינוי בקוד:

  npx firebase-tools deploy --only hosting
  

• הגדרה חד-פעמית: ב-Firebase Console, בתפריט Authentication ← Sign-in method, מפעילים את Google. ב-Authentication ← Settings ← Authorized domains מוסיפים את gavishori.github.io.