פיתוח מקומי

המדריך הזה מריץ את הפלטפורמה מקומית לפיתוח או הערכה.

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

דרישה	תיאור	למה זה נחוץ
Python 3.12+	סביבת ריצה של ה-backend	מריץ את אפליקציית FastAPI
Node.js 18+	כלי ה-frontend	בונה/מגיש את ממשק React
PostgreSQL 16	בסיס נתונים, נגיש דרך `DATABASE_URL`	מאחסן משתמשים, סריקות, ממצאים ויומני ביקורת
gcloud CLI	מאומת (`gcloud auth application-default login`)	איסוף GCP ובדיקות אישורים

Backend

משורש המאגר:

pip install -r requirements.txt

# הפעלת ה-backend (לא `python main.py`):
python -m uvicorn api.app:app --host 0.0.0.0 --port 9900

ה-backend זקוק גם לשורש המאגר וגם לתיקיית extension/ ב-PYTHONPATH. המשגרים המצורפים מגדירים זאת עבורכם; אם אתם מריצים uvicorn ידנית, הפעילו משורש המאגר.

Frontend

cd insightful-web-main
npm install
npm run dev          # מפעיל את Vite על 8200 וגם את ה-backend (עם --reload) יחד
# frontend בלבד:
npm run dev:frontend

בפיתוח, שרת ה-Vite מבצע proxy של כל נתיבי ה-API ל-localhost:9900, כך שאין תצורת CORS לבצע.

שרת רישוי

cd license_server
python server.py --port 7700

משגרים בלחיצה אחת

כדי להפעיל את ה-backend, ה-frontend ושרת הרישוי יחד (וליצור את התיקיות logs/,‏ out/scans ו-credentials/):

Windows: start-servers.bat — משחרר תחילה את הפורטים 9900/8200/7700, ואז מפעיל כל שירות ומבצע בדיקת בריאות ל-backend ולשרת הרישוי. עצירה: stop-servers.bat.
Linux / macOS: ./start-servers.sh — כותב קובצי PID תחת logs/, מגדיר PYTHONPATH, ומפעיל את ה-backend עם שני workers. עצירה: ./stop-servers.sh.

אשף ההתקנה

להתקנה מודרכת ראשונה, הריצו:

python setup_wizard.py

הוא מזהה את פרויקט ה-gcloud והאימות שלכם, בודק קריאת IAM לדוגמה, מאפשר להגדיר ספק AI אחד ופרופיל סריקה ברירת-מחדל, וכותב קובץ .env. בסיום הוא מדפיס את פקודת ההפעלה הנכונה.

אימות

‏GET http://localhost:9900/health מחזיר 200.
ממשק הווב נטען ב-http://localhost:8200 (פיתוח) ומאפשר להתחבר.
‏GET http://localhost:9900/health?deep=true מדווח על סטטוס בסיס הנתונים, הדיסק ו-gcloud.

שלבים הבאים

הגדירו סודות והגדרות ייצור בתצורה.
נתקלתם בשגיאה? ראו פתרון תקלות.