Stugether
חדרי למידה קבוצתיים לסטודנטים, עם עוזר AI שמשתתף בשיחה.
דרישות
- Node.js 22
- Docker Desktop (עבור Supabase המקומי)
הקמה
npm install
cp .env.example .env.local
# מפתח חתימה מקומי (ES256). הקובץ ב-.gitignore — לא לקמט אותו.
npx supabase gen signing-key --algorithm ES256 > supabase/signing_keys.json
npm run db:start # Supabase מקומי — מדפיס URL ומפתחות
signing_keys.json חייב להיות מערך JSON. אם הפקודה כתבה אובייקט בודד, עוטפים אותו ב-[ ].
בזכות המפתח האסימטרי, auth.getClaims() מאמת את ה-session מקומית, בלי קריאה לשרת האימות בכל עמוד.
מעתיקים מהפלט של db:start ל-.env.local:
| פלט | משתנה |
|---|
API_URL | NEXT_PUBLIC_SUPABASE_URL |
PUBLISHABLE_KEY | NEXT_PUBLIC_SUPABASE_ANON_KEY |
SECRET_KEY | SUPABASE_SERVICE_ROLE_KEY |
המפתחות הישנים (ANON_KEY/SERVICE_ROLE_KEY, JWT בחתימת HS256) לא עובדים כשמפתח החתימה מופעל.
npm run dev # http://localhost:3000
Supabase Studio: http://localhost:54323
ב-Git Bash על Windows, אם supabase start לא מוצא את docker:
export PATH="/c/Program Files/Docker/Docker/resources/bin:$PATH".
משתמשי seed
סיסמה לכולם: Password123!
סקריפטים
| פקודה | |
|---|
npm run dev | שרת פיתוח |
npm run build | build ל-production |
npm run lint | ESLint, כולל כללי הגבולות |
npm run typecheck | TypeScript |
npm run format | Prettier |
npm run db:start / db:stop | Supabase מקומי |
npm run db:reset | מריץ מחדש migrations + seed |
כללי ארכיטקטורה
קומפוננטות ודפים לא מייבאים Supabase. ESLint נכשל אם כן.
| צריך | משתמשים ב- |
|---|
| DB | lib/repositories/ |
| Realtime | hooks/useRoomChannel.ts |
| קבצים | lib/storage/ |
פירוט: TECHNICAL_SPEC.md §2.2.
בדיקת RTL
בפיתוח בלבד: http://localhost:3000/dev/rtl
מצב דמו (UX/UI)
כפתור צף בצד ימין למטה עובר בין מצב דמו למצב רגיל. כרגע מצב דמו פעיל כברירת מחדל (מוגדר בקוד, בלי משתנה סביבה). הבחירה נשמרת ב-cookie stugether_demo.
במצב דמו האפליקציה מציגה נתוני דוגמה (lib/demo/fixtures.ts) בלי לגשת ל-Supabase, וכל פעולת כתיבה נחסמת ("מצב דמו — הפעולה לא נשמרת"). אין שינוי במשתמשים או בנתונים האמיתיים.
