# 🚀 התחלה מהירה - TenLight

ברוכים הבאים לפרויקט TenLight! מדריך זה יעזור לכם להתחיל במהירות עם הפרויקט.

## 🎯 מה זה TenLight?

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

## ⚡ התחלה מהירה

### 1. שכפול המאגר
```bash
git clone https://github.com/tenlight/tenlight.git
cd tenlight
```

### 2. התקנת תלויות
```bash
# Node.js dependencies
npm install

# Python dependencies
pip install -r requirements.txt
```

### 3. הפעלת הפרויקט
```bash
# שרת פיתוח
npm run dev

# או עם Python
python scripts/dev.py
```

### 4. פתיחת הדפדפן
עברו לכתובת: http://localhost:3000

## 🏗️ מבנה הפרויקט

```
tenlight/
├── 📄 README.md              # דף הבית
├── 📁 src/                   # קוד מקור
├── 📁 docs/                  # תיעוד
├── 📁 tests/                 # בדיקות
├── 📁 scripts/               # כלי CLI
├── 📁 assets/                # נכסים
└── 📁 .github/               # הגדרות GitHub
```

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

### 📜 עשרת הדיברות
- תיעוד מקיף של כל דיבר
- פרשנויות מסורתיות ומודרניות
- הקשרים היסטוריים ותרבותיים

### ✨ הקבלות קבליות
- הקשרים בין דיברות לספירות
- ניתוח אנרגטי ורוחני
- מפת עץ החיים

### 🛠️ כלים אינטראקטיביים
- מנוע חיפוש מתקדם
- ויזואליזציות דינמיות
- כלי ניתוח טקסט

### 🌍 תמיכה בשפות
- עברית (שפת המקור)
- אנגלית
- ערבית
- שפות נוספות

## 🔧 כלי CLI

### פקודות בסיסיות
```bash
# הצגת עזרה
tenlight --help

# אתחול פרויקט חדש
tenlight init my-project

# בניית הפרויקט
tenlight build

# הרצת בדיקות
tenlight test

# דיפלוי
tenlight deploy
```

### פקודות מתקדמות
```bash
# יצירת רכיב חדש
tenlight generate component CommandmentCard

# יצירת עמוד חדש
tenlight generate page KabbalahStudy

# ניתוח קוד
tenlight analyze

# ניקוי קבצים
tenlight clean
```

## 📚 למידה נוספת

### מדריכים מפורטים
- [ארכיטקטורה](ARCHITECTURE.md) - מבנה הפרויקט
- [מדריך API](API.md) - ממשקי תכנות
- [מדריך פיתוח](DEVELOPMENT.md) - הנחיות פיתוח
- [מדריך בדיקות](TESTING.md) - בדיקות ואיכות

### תוכן רוחני
- [עשרת הדיברות](COMMANDMENTS.md) - תיעוד מקיף
- [הקבלות קבליות](KABBALAH.md) - הקשרים רוחניים
- [ניתוחי תורה](TORAH_ANALYSIS.md) - מחקרים ופרשנויות

### כלים ושירותים
- [כלי אינטראקטיביים](INTERACTIVE_TOOLS.md) - אפליקציות
- [כלי מחקר](RESEARCH_TOOLS.md) - כלי מחקר
- [כלי תרגום](TRANSLATION_TOOLS.md) - תרגום

## 🎯 מקרי שימוש נפוצים

### 1. חוקר רוחני
```bash
# התקנת כלי מחקר
tenlight install research-tools

# הפעלת מנוע חיפוש
tenlight search "ספירת כתר"

# יצירת דוח מחקר
tenlight generate report kabbalah-study
```

### 2. מפתח
```bash
# יצירת רכיב חדש
tenlight generate component SefiraVisualization

# הוספת בדיקות
tenlight generate test SefiraVisualization

# בנייה ובדיקה
tenlight build && tenlight test
```

### 3. מתרגם
```bash
# יצירת תרגום חדש
tenlight generate translation hebrew-to-arabic

# בדיקת תרגום
tenlight validate translation

# עדכון תרגום
tenlight update translation
```

## 🔍 פתרון בעיות נפוצות

### בעיה: שגיאת התקנה
```bash
# פתרון: ניקוי cache
npm cache clean --force
rm -rf node_modules
npm install
```

### בעיה: שגיאת הרצה
```bash
# פתרון: בדיקת גרסאות
node --version
npm --version
python --version
```

### בעיה: שגיאת דיפלוי
```bash
# פתרון: בדיקת הגדרות
tenlight config check
tenlight deploy --dry-run
```

## 📞 תמיכה ועזרה

### דרכי תמיכה
- **GitHub Issues** - דיווח על בעיות
- **GitHub Discussions** - שאלות ודיונים
- **Email** - יצירת קשר ישיר
- **Discord** - קהילה פעילה

### מידע ליצירת קשר
- **Email**: support@tenlight.org
- **GitHub**: https://github.com/tenlight/tenlight
- **Website**: https://tenlight.org
- **Discord**: https://discord.gg/tenlight

## 🎉 הצעדים הבאים

### 1. חקרו את התוכן
- עברו על [עשרת הדיברות](COMMANDMENTS.md)
- חקרו את [הקבלות הקבליות](KABBALAH.md)
- קראו את [ניתוחי התורה](TORAH_ANALYSIS.md)

### 2. נסו את הכלים
- השתמשו ב[כלי החיפוש](INTERACTIVE_TOOLS.md)
- יצרו [ויזואליזציות](INTERACTIVE_TOOLS.md)
- נסו את [כלי המחקר](RESEARCH_TOOLS.md)

### 3. תרמו לפרויקט
- קראו את [מדריך התרומה](CONTRIBUTING.md)
- בחרו [Issue](https://github.com/tenlight/tenlight/issues) לתרומה
- התחילו עם [תיקון באגים](CONTRIBUTING.md#תיקון-באגים)

### 4. הצטרפו לקהילה
- הצטרפו ל[Discord](https://discord.gg/tenlight)
- עקבו אחר [GitHub](https://github.com/tenlight/tenlight)
- הירשמו ל[Newsletter](https://tenlight.org/newsletter)

## 📚 משאבים נוספים

### תיעוד חיצוני
- [Semantic Versioning](https://semver.org/)
- [Conventional Commits](https://www.conventionalcommits.org/)
- [Keep a Changelog](https://keepachangelog.com/)

### כלים מומלצים
- [VS Code](https://code.visualstudio.com/)
- [Git](https://git-scm.com/)
- [Node.js](https://nodejs.org/)
- [Python](https://www.python.org/)

---

## 🙏 תודה

תודה שהצטרפתם לפרויקט TenLight! יחד נוכל להפוך את חכמת הדיברות לנגישה ומשמעותית יותר עבור כל אדם.

> "וְהָיָה כִּי יִקְרָא אֶתְכֶם מֹשֶׁה, וְנִגַּשׁ אֲלֵיכֶם כָּל אֲשֶׁר נְדָבוֹ רוּחוֹ" — שמות ל״ה:כ״א

*כל תרומה, קטנה כגדולה, מביאה אור לעולם.*

---

**עדכון אחרון**: 29 באוקטובר 2025  
**גרסה**: 1.0.0  
**מחבר**: צוות TenLight
