Skip to content

Latest commit

 

History

3 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎯 מערכת חיזוי הצלחת לידים - Lead Success Predictor

מערכת Fullstack + AI לחיזוי הסתברות הצלחה של לידים (Python FastAPI + React).


📋 תוכן עניינים

  1. דרישות מקדימות
  2. התקנה והכנה
  3. הרצת המערכת
  4. שימוש
  5. מבנה הפרויקט (ליבה)

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

ודא שמותקנים: Python 3.9+, Node.js 18+.

API Key: יש צורך ב-OpenAI API Key פעיל.

נתונים: יש למקם קובץ Leads_table.xlsx בתיקיית backend/.


📥 התקנה והכנה

שלב 1: Backend (Python + FastAPI)

cd backend
python -m venv venv
source venv/bin/activate  # או venv\Scripts\activate ב-Windows
pip install -r requirements.txt
קובץ .env: צור קובץ זה והחלף את המפתח שלך:

OPENAI_API_KEY=sk-proj-YOUR-KEY-HERE
PORT=8000
שלב 2: Frontend (React)
Bash

cd ../frontend
npm install
🚀 הרצת המערכת
יש להפעיל שני טרמינלים במקביל:

1. Backend: (טרמינל 1)
Bash

cd backend
# הפעל את הסביבה הוירטואלית
python main.py
# כתובת API: http://localhost:8000/
2. Frontend: (טרמינל 2)
Bash

cd frontend
npm run dev
# כתובת הממשק: http://localhost:3000/
💡 שימוש
גש ל-http://localhost:3000 בדפדפן.

מלא את חמשת הפרמטרים (ID's ותאריך פגישה).

לחץ על "🔮 חזה הצלחה" לקבלת אחוז הצלחה, גורמים משפיעים וניתוח AI.

📁 מבנה הפרויקט (ליבה)
leads/
├── backend/
│   ├── main.py             # נקודת כניסה לשרת FastAPI
│   ├── config.py           # הגדרות כלליות
│   ├── data_utils.py       # עיבוד נתונים
│   ├── ai_client.py        # תקשורת עם OpenAI
│   ├── models.py           # מודלים / DTOs
│   ├── requirements.txt    # תלויות
│   ├── Leads_table.xlsx    # נתונים
│   └── .env                # מפתח OpenAI

└── frontend/
    ├── src/
    │   ├── components/     # רכיבים (טופס, גרף, תוצאות)
    │   ├── services/api.ts # קריאות ל-Backend
    │   └── App.tsx         # רכיב ראשי
    ├── package.json
    └── vite.config.ts

🧩 הנחות עבודה

קובץ הנתונים Leads_table.xlsx נמצא בתיקיית backend/

אין שימוש בבסיס נתונים חיצוני – הנתונים נשלפים מקובץ Excel בלבד

המערכת נועדה להרצה מקומית, אך ניתנת לפריסה ב-Docker

נדרש מפתח OpenAI תקין בקובץ .env

בהנחה שכל שדות הקלט מגיעים מה-Frontend בפורמט תקין

About

Fullstack + AI

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages