🤖 Smart Query AI

מערכת PWA מתקדמת לשאילת נתונים בשפה טבעית באמצעות בינה מלאכותית של Claude.

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

• 🗣️ שאלות בעברית - שאל שאלות טבעיות על הנתונים שלך
• 📊 תמיכה ב-CSV - העלאה קלה עם זיהוי אוטומטי של מבנה הנתונים
• 🤖 בחירת מנוע AI - תמיכה ב-Claude 4 או ChatGPT (OpenAI) לבחירתך
• 📱 PWA מלא - התקנה על המובייל, עבודה offline
• 🎨 ממשק בעברית - עיצוב נקי ונגיש

🚀 התחלה מהירה

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

• Node.js 16+
• npm או yarn
• Claude API Key (מ-Anthropic Console)

התקנה

1. שכפול והתקנה

git clone [repository-url]
cd smart-query-ai
npm install

2. הגדרת Environment

# העתק את .env.example ל-.env
cp .env.example .env

# ערוך את .env והוסף את המפתחות שלך
CLAUDE_API_KEY=your_claude_api_key_here
REACT_APP_CLAUDE_API_KEY=your_claude_api_key_here
OPENAI_API_KEY=your_openai_api_key_here  # <--- חדש לצ'אט GPT

3. הרצה

# פיתוח מלא (קליינט + שרת)
npm run full-dev

# או build ו-serve
npm run build-and-serve

4. גש לאפליקציה
   • React Dev: http://localhost:3000
   • Production: http://localhost:3001

🧪 בדיקת המערכת

# בדיקת שרת
npm run server

# בדיקת API
npm run test-server

# health check
curl http://localhost:3001/api/health

# בדיקת ChatGPT (OpenAI)
curl -X POST http://localhost:3001/api/openai/messages -H "Content-Type: application/json" -H "x-api-key: $OPENAI_API_KEY" -d '{"model":"gpt-4o","messages":[{"role":"user","content":"שלום, מה שלומך?"}]}'

לבדיקה מפורטת: ראה TESTING.md

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

1. העלה קובץ CSV

גרור או בחר קובץ CSV עם הנתונים שלך

2. שאל שאלות

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

3. קבל תשובות

המערכת מחזירה:

• ✅ הסבר מה נמצא
• 📊 טבלת תוצאות
• 🎯 סיכום ברור

🏗️ ארכיטקטורה

┌─────────────┐    ┌─────────────────┐    ┌─────────────────┐    ┌─────────────┐
│ User Input  │───►│ React Client    │───►│ Express Server  │───►│ Claude API  │
│ (CSV + Q&A) │    │ (localhost:3000)│    │ (localhost:3001)│    │ (Anthropic) │
└─────────────┘    └─────────────────┘    └─────────────────┘    └─────────────┘
                            ▲                        ▲
                            │                        │
                   ┌─────────────────┐    ┌─────────────────┐
                   │ Schema Manager  │    │ Data Executor   │
                   │ (Auto Analysis) │    │ (Smart Filter)  │
                   └─────────────────┘    └─────────────────┘

רכיבי המערכת

• React Client - ממשק משתמש, העלאת קבצים, צ'אט
• Express Server - פרוקסי ל-Claude API, error handling
• ChatGPT (OpenAI) - עיבוד שאלות טבעיות (ברירת מחדל חדשה)
• Schema Manager - זיהוי אוטומטי של מבנה CSV
• Data Executor - ביצוע שאילתות וחישובים

🛠️ טכנולוגיות

Frontend

• React 19 + TypeScript
• Tailwind CSS לעיצוב
• Papa Parse לעיבוד CSV
• Recharts לגרפים

Backend

• Express.js proxy server
• CORS support
• dotenv למשתני סביבה

AI & APIs

• Claude 4 Sonnet (Anthropic)
• Smart prompting לניתוח נתונים

📁 מבנה הפרויקט

smart-query-ai/
├── public/
│   ├── manifest.json          # PWA config
│   ├── sw.js                  # Service Worker
│   └── sample-projects.csv    # דוגמת נתונים
├── src/
│   ├── components/
│   │   ├── ChatInterface.tsx  # צ'אט עיקרי
│   │   └── SchemaSetup.tsx    # העלאת קבצים
│   ├── services/
│   │   ├── aiProcessor.ts     # Claude API client
│   │   ├── dataExecutor.ts    # ביצוע שאילתות
│   │   └── schemaManager.ts   # ניהול סכימה
│   └── types/
│       └── index.ts           # הגדרות TypeScript
├── server.js                  # Express proxy server
├── test-server.js            # בדיקות שרת
└── TESTING.md                # מדריך בדיקה

🔒 אבטחה

• ✅ API Keys מוגנים בשרת
• ✅ CORS מוגדר נכון
• ✅ בחירת מנוע AI מהצ'אט (Claude או ChatGPT)
• ✅ Error handling מקיף
• ✅ Input validation לקבצים

🐛 פתרון בעיות

בעיות נפוצות

1. "API key required"

   • בדוק .env file
   • הפעל מחדש את השרת

2. "Port already in use"

   lsof -i :3001
   kill -9 [PID]

3. Claude API errors

   • בדוק יתרת חשבון ב-Anthropic
   • בדוק תקינות המפתח

למידע מלא: TESTING.md

🚀 פיתוח עתידי

שלב הבא (v1.1)

• תמיכה ב-JSON ו-API endpoints
• ויזואליזציות מתקדמות (גרפים)
• שמירת היסטוריית שיחות
• ייצוא תוצאות

רחוק יותר (v2.0)

• Speech-to-Text (קלט קולי)
• Text-to-Speech (תשובות קוליות)
• תמיכה במסדי נתונים
• שיתוף ושיתוף פעולה

📄 רישיון

MIT License - ראה LICENSE

🤝 תרומה

תרומות מתקבלות בברכה! אנא פתח Issue או Pull Request.

📞 יצירת קשר

לשאלות או תמיכה, פתח Issue בפרויקט.

---

Built with ❤️ and Claude AI