תיעוד מפורט - פרויקט חמישה חומשי תורה

🔧 ארכיטקטורת המערכת

מבנה הקוד

  • Frontend:
    • HTML5 לתצוגת התוכן
    • CSS3 לעיצוב ואנימציות
    • JavaScript לאינטראקטיביות
  • Backend:
    • Node.js לשרת
    • MongoDB לאחסון נתונים
    • Express.js למסגרת העבודה

תלויות ורכיבים

  • ספריית Hebcal לחישובי תאריכים עבריים
  • ספריית Torah.js לניהול טקסט התורה
  • מערכת ניקוד וטעמים מותאמת אישית

🔐 אבטחה ופרטיות

אמצעי אבטחה

  • הצפנת SSL/TLS לתקשורת מאובטחת
  • אימות דו-שלבי למשתמשים רשומים
  • הגנה מפני XSS ו-CSRF

מדיניות פרטיות

  • שמירה על פרטיות המשתמשים
  • מדיניות שימוש בקובצי Cookie
  • הגנה על מידע אישי

📡 API Documentation

נקודות קצה זמינות

GET /api/torah/chapter/:book/:chapter

קבלת פרק מספר תורה מסוים

דוגמה לתגובה:
{
    "book": "בראשית",
    "chapter": 1,
    "verses": [
        {"number": 1, "text": "בְּרֵאשִׁית..."},
        // ...
    ]
}
GET /api/torah/verse/:book/:chapter/:verse

קבלת פסוק ספציפי

GET /api/commentaries/:book/:chapter

קבלת פרשנויות לפרק

דוגמאות שימוש


fetch('/api/torah/chapter/bereshit/1')
    .then(response => response.json())
    .then(data => console.log(data));
                

🔄 תהליכי פיתוח

תהליך הפיתוח

  • שימוש ב-Git לניהול גרסאות
  • CI/CD באמצעות GitHub Actions
  • בדיקות אוטומטיות לפני כל שחרור

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

  1. יצירת fork של הפרויקט
  2. פיתוח בענף נפרד
  3. הגשת Pull Request
  4. סקירת קוד ומיזוג

📊 ניטור וביצועים

כלי ניטור

  • שימוש ב-Google Analytics לניתוח תנועה
  • ניטור שגיאות באמצעות Sentry
  • מעקב אחר ביצועי המערכת

אופטימיזציה

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