מערכת להזמנת רכב משותף

מימוש של שלב א׳ (MVP) לפי מסמך האפיון (גרסה 1.0): הרשמה ואזור אישי, אישור משתמשים ורישיונות, יומן זמינות, בקשות הזמנה ואישור מנהל, מניעת הזמנות כפולות, מיילים אוטומטיים, ניהול נהלים, ניהול הרכב והרשאות. הממשק בעברית, מימין לשמאל, ומותאם לטלפון ולמחשב.

הפעלה

דרישות: Node.js 22.13 ומעלה (המערכת משתמשת ב־SQLite המובנה ב־Node, בלי שרת מסד נתונים נפרד), או Docker.

הפעלה מהירה על המחשב שלך

• Windows: לחיצה כפולה על start.cmd
• Mac/Linux: ./start.sh

הסקריפט מתקין תלויות, יוצר נתוני דמו, מפעיל את השרת ופותח את https://localhost:3000. בפעם הראשונה הדפדפן יזהיר על התעודה, כי היא תעודה עצמית ל־localhost: בוחרים "מתקדם" ואז "המשך ל־localhost". כניסה: [email protected] / Password1.

גישה מהרשת הביתית (Wi-Fi) ומהאינטרנט

מכשירים באותה רשת Wi-Fi

1. מפעילים את האפליקציה (start.cmd או npm run dev). בהפעלה מוצגת כתובת הרשת, למשל:

   Network:    https://192.168.1.23:3000   (other devices on the same Wi-Fi)
   

2. Windows, פעם אחת: לחיצה כפולה על allow-wifi.cmd. הקובץ פותח את פורט 3000 ב־Firewall לרשתות פרטיות בלבד ומציג את הכתובות. רשת ה־Wi-Fi צריכה להיות מוגדרת כ־"Private": הגדרות ← רשת ואינטרנט ← Wi-Fi ← הרשת שלך ← רשת פרטית.
3. בטלפון או במחשב אחר באותה רשת פותחים את הכתובת. בפעם הראשונה יש לאשר את אזהרת התעודה. התעודה העצמית כוללת אוטומטית את כתובות ה־IP של המחשב, ונוצרת מחדש אם הכתובת משתנה.

גישה מהאינטרנט (Cloudflare Tunnel)

winget install --id Cloudflare.cloudflared     # פעם אחת (macOS: brew install cloudflared)
npm run tunnel                                 # בחלון נוסף, כשהאפליקציה רצה

מוצגת כתובת https://<אקראי>.trycloudflare.com שנגישה מכל מקום, כל עוד שני החלונות פתוחים. אין צורך בחשבון ואין צורך לפתוח פורטים בראוטר.

• אבטחה: הפקודה מסרבת לפרסם את האתר כל עוד קיים משתמש עם סיסמת הדמו Password1, שמופיעה ב־README וידועה לכולם. לפני הפרסום צריך להחליף סיסמאות (npm run create-admin -- --email [email protected] --password …), או להתחיל ממסד נתונים חדש בלי נתוני דמו.
• הכתובת משתנה בכל הפעלה. כדי שקישורים במיילים יפנו אליה, מגדירים BASE_URL=<הכתובת> ב־.env ומפעילים מחדש.
• לכתובת קבועה: Cloudflare Tunnel עם דומיין משלכם, או ngrok עם הדומיין הסטטי החינמי: ngrok http https://localhost:3000 --url=<השם-שלכם>.ngrok-free.app. בשני המקרים מגדירים את BASE_URL לכתובת הקבועה.
• המחשב צריך להישאר דלוק ומחובר. לסביבת פיתוח שזמינה תמיד באינטרנט, ומתעדכנת אוטומטית בכל push ל־dev, ראו את המדריך docs/dev-environment.md. לאחסון בחינם (Oracle Cloud Always Free) ראו docs/free-hosting.md. לפריסה ב־Vercel ראו docs/vercel.md. שם מחברים מסד נתונים של Turso (חינם), כדי שהנתונים יישמרו גם אחרי העלאת גרסה חדשה.

התחברות עם Google

כשמוגדרים GOOGLE_CLIENT_ID ו־GOOGLE_CLIENT_SECRET, מופיע כפתור "התחברות עם Google" בדפי ההתחברות וההרשמה.

• משתמש קיים מתחבר עם חשבון Google שכתובת הדואר שלו זהה לזו הרשומה במערכת. החשבון מקושר אוטומטית.
• משתמש חדש מגיע לטופס ההרשמה עם השם והדואר האלקטרוני מ־Google. עדיין צריך להשלים ת"ז, טלפון ורישיון נהיגה, ולחכות לאישור מנהל.

הגדרה (פעם אחת):

1. נכנסים ל־Google Cloud Console ויוצרים פרויקט.
2. ב־APIs & Services ← OAuth consent screen (או Google Auth Platform) בוחרים External, ממלאים שם אפליקציה ודוא"ל תמיכה. כל עוד האפליקציה במצב Testing, רק משתמשים שמוסיפים ב־Test users יכולים להתחבר. כדי לפתוח לכולם לוחצים Publish app.
3. ב־Credentials ← Create credentials ← OAuth client ID בוחרים Web application, ותחת Authorized redirect URIs מוסיפים כל כתובת שבה המערכת רצה:
   • https://localhost:3000/auth/google/callback (פיתוח על המחשב)
   • https://<הכתובת-בשרת>/auth/google/callback (למשל https://dev.129-146-10-20.sslip.io/auth/google/callback)
4. מעתיקים את ה־Client ID וה־Client secret לקובץ .env ומפעילים מחדש:

   GOOGLE_CLIENT_ID=1234567890-abc.apps.googleusercontent.com
   GOOGLE_CLIENT_SECRET=GOCSPX-...
   

בדיקת ההגדרה: ב־הגדרות (/admin/settings) יש לוח "התחברות עם Google" שמראה מה מוגדר ומה חסר, את הכתובות המדויקות שצריך להזין ב־Google Cloud Console ואת השגיאה האחרונה.

מה רואים	הסיבה והפתרון
אין כפתור Google	GOOGLE_CLIENT_ID או GOOGLE_CLIENT_SECRET חסרים ב־.env (בלי # בתחילת השורה), או שהשרת לא הופעל מחדש אחרי העריכה
במקום כפתור יש הודעה "זמינה בכתובת…"	האתר נפתח בכתובת אחרת מ־BASE_URL (למשל 127.0.0.1 או IP של ה־Wi-Fi). פותחים את הכתובת שבהודעה
דף שגיאה של Google: redirect_uri_mismatch	ב־Google Cloud Console, תחת Authorized redirect URIs, צריך להופיע בדיוק https://localhost:3000/auth/google/callback (או הכתובת שבלוח ההגדרות)
דף שגיאה של Google: "Access blocked" / "has not completed the Google verification process"	מסך ההסכמה במצב Testing: מוסיפים את החשבון תחת Test users, או לוחצים Publish app
"הגדרות Google שגויות"	ה־Client ID או ה־Client secret שגויים או הועתקו חלקית
"לא ניתן להתחבר לשרתי Google"	למחשב שעליו רץ השרת אין גישה לאינטרנט, או שחומת אש חוסמת אותו

ההתחברות עם Google עובדת רק בכתובת שב־BASE_URL, כי Google מחזיר את המשתמש בדיוק לכתובת שנרשמה. Google לא מאפשר כתובות IP של הרשת הביתית (למשל 192.168.x.x), אז ממכשירים ב־Wi-Fi מתחברים עם סיסמה או קוד חד־פעמי.

הוספת משתמשים ידנית

מנהל יכול לפתוח חשבון בלי שהמשתמש יירשם בעצמו: משתמשים ← הוספת משתמש. ממלאים שם, ת"ז, טלפון ודואר אלקטרוני, ואפשר גם תפקיד (משתמש רגיל או מנהל), תאריך תוקף וצילום של רישיון הנהיגה.

• עם תאריך תוקף לרישיון: החשבון פעיל מיד וניתן להזמין (המנהל אישר את הרישיון).
• בלי תאריך: המשתמש יתבקש להעלות רישיון נהיגה, ואחרי אישור המנהל יוכל להזמין.
• המשתמש מקבל במייל קישור לבחירת סיסמה (תקף ל־7 ימים). אם המייל לא נשלח (לא הוגדר SMTP), הקישור מוצג למנהל כדי להעביר אותו בעצמו. אפשר גם להתחבר עם קוד חד־פעמי במייל או עם Google.
• את נהלי השאלת הרכב המשתמש מאשר בעצמו לפני ההזמנה הראשונה.

This is the beginning of the README. Read the rest at the original. Read the full README ↗