Bino Dashboard
Bino (Building Intelligence & Operations) — מערכת SaaS רב-דיירית לזיכרון תפעולי חכם לכל בניין (לא «עוד מערכת תקלות»).
הבידול: למידה מהיסטוריית תקלות/ציוד/ספקים/עלויות; המלצה אוטומטית לעובד או ספק; זיהוי תקלות חוזרות; התראות SLA מוקדמות; חיזוי כשלים; והוכחת חיסכון בזמן וכסף לחברת הניהול. מדדי ליבה: זמן עד שיוך, זמן עד פתרון, שיעור תקלות חוזרות, עלות תחזוקה לבניין, אחוז טיפול ללא התערבות מנהל. עקרונות מחייבים: .cursor/rules/bino-product-differentiation.mdc ו־CLAUDE.md.
דיירים מדווחים דרך טופס ציבורי (/report) או WhatsApp (סריקת QR לפרויקט).
מנהל העסק מנהל תקלות, פרויקטים, עובדים ודיירים; מקבל סיכומים, חיוב לפי תוכנית, ויכולות משרד (יומן, שעון נוכחות).
עובדי שטח עובדים בפורטל נפרד (/worker) עם PWA והתראות push.
סטאק: Next.js 16 (App Router) · React 19 · TypeScript · Supabase (PostgreSQL + Auth + RLS) · Vercel · Zod · Vitest · Playwright · Sentry · Vercel Analytics / Speed Insights
סביבת עבודה
ריפו יחיד: YoniLevy10/Bino · ענף ברירת מחדל main (ייצור ב־Vercel).
כללי פיתוח (API, SMS, Supabase): CLAUDE.md.
פריסה / דומיין: ייצור ב־https://bino.casa (NEXT_PUBLIC_APP_URL ב־Vercel — לא *.vercel.app). פרטי חיבור: docs/DOMAIN.md. SEO / Analytics: docs/SEO.md. מדריכי תוכן: /guides.
מפת דפים — מנהל (tenant)
| נתיב | תפקיד | גישה |
|---|
/login | כניסה עם Google | ציבורי |
/ | לוח בקרה — KPI, תקלות אחרונות, פתיחה מהירה | מחובר |
/tickets | כל התקלות — סינון, Excel, מגירה, מיזוג, מחיקה | מחובר |
/projects | בניינים — יצירה ועריכה (API) | מחובר |
/workers | עובדי שטח — פורטל, SMS, התראות תקלה | מחובר |
/residents | פנקס דיירים — ייבוא Excel, טאב ממתינים | מחובר |
/pending-residents | דיירים שדיווחו וטרם אושרו בפנקס | מחובר |
/summary | דוחות ניהוליים + Excel | מחובר |
/calendar | יומן משרד — חודש/שבוע, iCal, סנכרון Google Calendar | מחובר |
/attendance | חתמת עובדים — NFC, משמרות, דוחות שעות, Excel | מחובר |
/qr | קודי QR לפרויקט (WhatsApp + Web) | מחובר |
/settings | הגדרות — WhatsApp, SMS, push, סדר תפריט, לוגו | מחובר |
/settings/whatsapp-templates | עריכת תבניות הודעות Meta | מחובר |
/billing | תוכנית, מכסות, צריכה חודשית | מחובר |
/collections | גביית ועד (Grow) | מחובר + addon |
/guides | מדריכי SEO | ציבורי |
/vaad-pay | דף תשלום ציבורי | ציבורי |
/resident | פורטל דיירים | Auth דייר |
/privacy | מדיניות פרטיות | ציבורי / מחובר |
ניווט: סדר פריטי התפריט נשמר ב-clients.sidebar_nav_order (מיגרציה 048). במובייל — 4 פריטים קבועים בתחתית (בית, תקלות, פרויקטים, עובדים); כפתור «עוד» או תפריט ההמבורגר פותחים את התפריט המלא.
אבחון פלטפורמה (לא ללקוחות): דפי /error-logs, /health, /system-map וכו' הוסרו — תפעול דרך /superadmin + מייל ל-PLATFORM_OPS_EMAIL.
דפים ציבוריים ועובד שטח
| נתיב | תפקיד | גישה |
|---|
/report | טופס דיווח לדייר | ציבורי |
/worker-login | כניסת עובד → /worker?token= | ציבורי |
/worker | פורטל עובד — תקלות, סטטוסים, צ'אט, סיורים, push | ?token= / מחובר |
/worker/nfc | החתמת NFC — כניסה/יציאה/ביקור | ?t= + token עובד |
/attendance/scan | הוצא משימוש — מפנה לחתמת NFC | ציבורי (legacy) |
הקמת לקוח חדש — ויזארד מנהל
נתיב: /admin/setup (מוגן ב-ADMIN_SETUP_SECRET)
- הזנת סוד גישה → טופס (שם חברה, תוכנית, WhatsApp, אימייל מנהל, פרויקטים, עובדים).
- לחיצה על «הקם לקוח» → יצירת
clients + organizations, הזמנת Auth, פרויקטים עם qr_identifier, קישורי QR להעתקה.
בפיתוח: http://localhost:3000/admin/setup
הפעלה מקומית
דרישות
- Node.js 20+ (מומלץ; CI רץ על 20)
- פרויקט Supabase עם כל המיגרציות בתיקייה
supabase/migrations/ (עד 113 (כולל פורטל דיירים + תיקוני ביקורת) ומעלה)
התקנה
npm install
# העתיקו משתני סביבה מ-Vercel או מלאו ידנית ל-.env.local
npm run dev
http://localhost:3000 · LAN: npm run dev:lan
מיגרציות וטיפוסים
npm run db:migration:list # מצב מול Supabase מקושר
npm run db:types # lib/database.types.ts אחרי שינוי סכמה
דפי יומן ו-שעון דורשים מיגרציות 045–047 (ולפחות 048 לסדר תפריט).
משתני סביבה (עיקריים)
| משתנה | תיאור |
|---|
NEXT_PUBLIC_SUPABASE_URL | URL פרויקט Supabase |
NEXT_PUBLIC_SUPABASE_ANON_KEY | מפתח anon (דפדפן) |
SUPABASE_SERVICE_ROLE_KEY | service role — שרת בלבד |
NEXT_PUBLIC_APP_URL | כתובת האפליקציה (קישורים ב-SMS/WhatsApp) |
ADMIN_SETUP_SECRET | סוד ל-/admin/setup ו-APIי admin |
WHATSAPP_VERIFY_TOKEN | אימות webhook Meta (GET) |
WHATSAPP_ACCESS_TOKEN | שליחת הודעות (גם נשמר per-tenant ב-DB) |
WHATSAPP_PHONE_NUMBER_ID | מזהה מספר Meta (גם ב-DB) |
WHATSAPP_APP_SECRET | חתימת webhook — מומלץ בפרודקשן |
SMS_019_USERNAME / SMS_019_TOKEN | 019SMS (Bearer API token; SMS_019_PASSWORD רק fallback זמני עד 1.1.2027) |
SMS_019_SENDER | שולח SMS — חייב 972xxxxxxxxx (לא שם טקסט) |
CRON_SECRET | אימות /api/cron/* |
VAPID_* / NEXT_PUBLIC_VAPID_PUBLIC_KEY | Web Push (מנהל + עובד) |
NEXT_PUBLIC_SENTRY_DSN | Sentry (production) |
BAMAKOR_CLIENT_ID | fallback ל-client ב-dev |
PLATFORM_OPS_EMAIL / RESEND_API_KEY | התראות תפעול פלטפורמה |
SMS: בלי אימוג'י בהודעות. כתיבות ל-clients / הגדרות — רק דרך /api/settings/update (לא מ-supabase בדפדפן).
סקריפטים
| פקודה | תיאור |
|---|
npm run dev | שרת פיתוח |
npm run dev:lan | פיתוח ברשת מקומית (מובייל) |
npm run build | בניית production |
npm run start | הרצה אחרי build |
npm run lint | ESLint |
npm run typecheck | TypeScript |
npm test | Vitest |
npm run test:e2e | Playwright |
npm run db:migration:list | רשימת מיגרציות Supabase |
npm run db:types | יצירת טיפוסי DB |
בדיקות ו-CI
GitHub Actions
על כל PR: lint → typecheck → vitest → next build (.github/workflows/ci.yml).
Vitest
npm test
lib/*.test.ts — לוגיקת WhatsApp, דיירים, dedupetests/whatsapp-webhook.post.test.ts — webhooktests/tenant-resolution-fields.test.ts — regression לשדות waClienttests/integration/ — סכמת Supabase (דורש .env.local + service role)
Playwright
npm run build && npm run start # בטרמינל נפרד
npm run test:e2e
tests/e2e/full-coverage.spec.ts — כיסוי רחב (auth, API, מובייל)tests/e2e/flows.spec.ts — זרימות ציבוריות ו-admintests/e2e/client-soft-launch.spec.ts — soft launch מצד לקוח/דייר/עובד (+ צ׳קליסט הקמה)tests/e2e/dashboard.spec.ts, tests/e2e/mobile.spec.ts- בדיקות חיות ידניות:
docs/CLIENT_SOFT_LAUNCH_SMOKE.md
Cron (Vercel)
| Job | תדירות |
|---|
/api/cron/sla-check | יומי 07:00 UTC |
/api/cron/health-check | יומי 06:00 UTC |
/api/cron/whatsapp-retry | כל 15 דקות |
/api/cron/cleanup-webhooks | שבועי |
תוכניות מחיר
| תוכנית | מחיר/חודש | בניינים | עובדים | תקלות/חודש |
|---|
| Starter | ₪299 | 3 | 5 | 300 |
| Pro | ₪499 | 10 | 20 | 1,000 |
| Business | ₪699 | 30 | 60 | 5,000 |
| Enterprise | ₪899+ | ללא הגבלה | ללא הגבלה | ללא הגבלה |
מכסות נאכפות ב-API (יצירת פרויקט/עובד/תקלה); תצוגה ב-/billing.
Sentry
@sentry/nextjs — sentry.client.config.ts / server / edge.
פעיל ב-production עם NEXT_PUBLIC_SENTRY_DSN.
תיעוד
| קובץ | תוכן |
|---|
CLAUDE.md | כללי פיתוח — API, SMS 019, Supabase, env, מובייל |
PRIVACY_POLICY_TEMPLATE.md | מדיניות פרטיות (/privacy) |
Hydration / SW ישן ב-dev: DevTools → Application → Service Workers → Unregister, Clear site data.
עודכן: ספטמבר 2026
