מפרט טכני: שיפורי מסך אירועים ואינטגרציות

גרסה: 1.1 (עודכן עם חידודים) תאריך: 04/09/2024

1. תקציר מנהלים (מעודכן)

מסמך זה מרחיב את מפרט השיפורים למודול "אירועים". הגרסה הנוכחית מדייקת את סכימת הנתונים של ישות Event עם טיפוסי נתונים מחמירים (decimal, enum), מוסיפה ישויות תומכות (Population, Attachment), מפרטת את מבנה ה-UI בלשוניות, ומגדירה כללי סינון שדות (Field-Level Filtering) לשליחת מסמכים והודעות מותאמות ללקוחות וספקים. בנוסף, המפרט כולל את הפתרון הטכני המלא והביצועי ליצוא פקודות יומן למערכת "ריווחית".

2. קטלוג שיפורים ותעדוף (ללא שינוי)

...

3. אפיון מפורט (מעודכן)

MBE-EV-201: הרחבת ישות Event ושדות נלווים

סכימת נתונים מעודכנת:

• Event:
  • date: date, חובה
  • time_range: string (פורמט HH:MM–HH:MM), חובה
  • type: enum('יחיד','מתמשך'), חובה
  • budget: decimal(12,2) ≥ 0
  • status: enum('ניתנה הצעה','כיוון חיובי','נסגר'), חובה
  • suppliers: array<Supplier.id>
  • location_address: אובייקט כתובת (street, city, zip, notes), חובה
  • safety_check_time: time (פורמט HH:MM), חובה אם אחד משדות הבטיחות=true
  • collection_status: enum('טרם חיוב','נשלחה דרישה','שולם חלקית','שולם'), ברירת־מחדל: 'טרם חיוב'
  • ... (יתר השדות כפי שהוגדרו בפרומפט)
• Population (חדש): ישות לניהול אוכלוסיות עם id, name, active.
• Attachment (חדש): ישות לניהול קבצים מצורפים עם id, type, url, וקישורים ל-event_id/supplier_id.

שינויי UI:

• הטופס יחולק ללשוניות: "פרטי אירוע", "אנשי קשר", "בטיחות", "נספחים", "גבייה/סטטוס".
• שדה "אוכלוסייה" יהיה Dropdown מקושר לישות Population עם כפתור לניווט למסך ניהול.
• הצגה מותנית של שדה "שעת ביצוע בדיקות" בהתאם לבחירה בשדות הבטיחות.

MBE-EV-202: אוטומציית מסמכים והודעות WhatsApp (מעודכן)

סינון שדות (Field-Level Filtering): הודעות ומסמכים שישלחו מהמערכת יכילו רק את השדות הרלוונטיים לנמען:

• הזמנה ללקוח: event_id, date, time_range, location_address, participants_count, client_po_terms_text
• הזמנה לספק: event_id, date, time_range, location_address, items_for_supplier, safety_*
• דרישת תשלום (לקוח): sale_price, vat, client_po_number, payment_link

תבניות הודעות WhatsApp מעודכנות:

• גבייה: שלום {client_name}, מצורפת דרישת תשלום עבור אירוע {event_title} בסך {sale_price} ש"ח. לתשלום: {payment_link}

MBE-EV-203: פתרון יצוא לריווחית (בוצע)

הפתרון המלא, כולל קוד וקבצים, מוטמע בדף "אינטגרציית ריווחית" במערכת.

4. RBAC (מעודכן)

• בעלי תפקידים חדשים: owner_gati, owner_avital ישויכו לפלואים הרלוונטיים (לדוגמה, אישור הצעות מחיר).
• הרשאות חדשות:
  • send_whatsapp_*: admin, sales_mgr, owner_gati, owner_avital
  • export_rivhit: admin, finance
  • update:collection_status: admin, finance

5. תוכנית הטמעה (Migration)

• Event Entity: יש להריץ סקריפט Backfill שיגדיר collection_status = 'טרם חיוב' לכל הרשומות הקיימות שבהן השדה ריק.