Masuri Core Logo

Masuri Core

תיעוד טכני - EventMaster Pro

ניתוח הנדסה-לאחור לצורך מיזוג למערכת מאוחדת

מסמך מפרט טכני - EventMaster Pro

ניתוח הנדסה-לאחור לצורך מיזוג


1. ישויות (Entities)

1.1 ישויות ליבה עסקיות

Company

{
  "name": "string",
  "logo_url": "string", 
  "owner_email": "string"
}

ישות מרכזית המייצגת את החברה/עסק שמנהל אירועים

User (מורחבת)

{
  "can_edit_event_prices": "boolean"
}

הרחבת ישות המשתמש הבסיסית עם הרשאות עריכת מחירים

Client

{
  "company_id": "string",
  "name": "string",
  "first_name": "string",
  "middle_name": "string", 
  "last_name": "string",
  "company": "string",
  "email": "string",
  "phone": "string",
  "address": "string",
  "client_type": "enum[private,corporate,government]",
  "status": "enum[potential,active,inactive]",
  "rating": "enum[A,B,C,D]",
  "notes": "string",
  "source": "enum[website,referral,social_media,advertisement,other]"
}

ניהול מאגר לקוחות עם דירוג וקטגוריזציה

Event

{
  "company_id": "string",
  "price_list_header_id": "string",
  "price_tier_id": "string", 
  "title": "string",
  "client_id": "string",
  "event_type": "string",
  "event_date": "date",
  "venue": "string",
  "venue_address": "string",
  "expected_guests": "number",
  "status": "enum[planning,confirmed,in_progress,completed,cancelled]",
  "budget": "number",
  "notes": "string",
  "event_items": "array[object]",
  "total_revenue": "number"
}

ליבת המערכת - ניהול אירועים עם פרטים מלאים ופריטים

1.2 ישויות מכירות ומימון

Lead

{
  "company_id": "string",
  "name": "string",
  "phone": "string", 
  "email": "string",
  "status": "enum[new,in_progress,quote_sent,closed_won,closed_lost]",
  "source": "string",
  "medium": "string",
  "campaign_name": "string",
  "notes": "string",
  "next_follow_up_date": "datetime",
  "estimated_value": "number",
  "assigned_to": "string",
  "campaign_id": "string"
}

מערכת CRM לניהול לידים וצינור מכירות

Quote

{
  "company_id": "string",
  "quote_number": "string",
  "client_id": "string",
  "event_id": "string",
  "total_amount": "number",
  "status": "enum[draft,sent,viewed,accepted,rejected,expired]",
  "valid_until": "date",
  "items": "array[object]",
  "notes": "string"
}

הצעות מחיר ללקוחות עם מעקב סטטוס

CustomerOrder

{
  "company_id": "string",
  "order_number": "string",
  "quote_id": "string",
  "event_id": "string",
  "client_id": "string",
  "order_date": "date",
  "event_date": "date",
  "venue": "string",
  "expected_guests": "number", 
  "status": "enum[draft,confirmed,in_production,ready,delivered,completed]",
  "items": "array[object]",
  "subtotal": "number",
  "vat_amount": "number",
  "total_amount": "number",
  "special_instructions": "string",
  "notes": "string"
}

הזמנות לקוחות שנוצרות מהצעות מחיר מאושרות

1.3 ישויות חשבונאות ורכש

Invoice

{
  "company_id": "string",
  "invoice_number": "string",
  "invoice_type": "enum[sale,purchase,pro_forma_sale,pro_forma_purchase,credit_note_client,credit_note_supplier,tax_invoice]",
  "original_invoice_id": "string",
  "quote_id": "string",
  "customer_order_id": "string", 
  "receipt_id": "string",
  "client_id": "string",
  "supplier_id": "string",
  "event_id": "string",
  "issue_date": "date",
  "due_date": "date",
  "subtotal": "number",
  "vat_amount": "number",
  "total_amount": "number",
  "currency": "string",
  "status": "enum[draft,sent,paid,overdue,cancelled]",
  "payment_terms": "string",
  "notes": "string",
  "items": "array[object]"
}

מערכת חשבוניות מקיפה לכל סוגי העסקאות

Receipt

{
  "company_id": "string",
  "receipt_number": "string",
  "invoice_id": "string",
  "customer_order_id": "string",
  "quote_id": "string", 
  "event_id": "string",
  "client_id": "string",
  "receipt_date": "date",
  "amount": "number",
  "payment_method": "string",
  "reference_number": "string",
  "bank_account": "string",
  "notes": "string",
  "creates_tax_invoice": "boolean"
}

תקבולים מלקוחות עם יצירת חשבונית מס אוטומטית

Payment

{
  "company_id": "string",
  "payment_number": "string",
  "invoice_id": "string",
  "supplier_id": "string",
  "payment_date": "date",
  "amount": "number",
  "payment_method": "string", 
  "reference_number": "string",
  "bank_account": "string",
  "notes": "string"
}

תשלומים לספקים

1.4 ישויות ספקים ומלאי

Supplier

{
  "company_id": "string",
  "name": "string",
  "category": "string",
  "contact_person": "string",
  "phone": "string",
  "email": "string",
  "address": "string",
  "rating": "number",
  "notes": "string",
  "products": "array[object]",
  "default_price_list_id": "string",
  "payment_terms": "string",
  "delivery_time": "string"
}

ניהול ספקים עם מוצרים ותנאי עבודה

Order

{
  "company_id": "string",
  "order_number": "string",
  "supplier_id": "string",
  "event_id": "string",
  "order_date": "date",
  "required_date": "date",
  "status": "enum[draft,sent,confirmed,in_progress,delivered,completed,cancelled]",
  "priority": "enum[low,normal,high,urgent]",
  "items": "array[object]",
  "subtotal": "number",
  "vat_amount": "number",
  "total_amount": "number",
  "payment_terms": "string",
  "delivery_address": "string",
  "special_instructions": "string",
  "notes": "string"
}

הזמנות רכש מספקים

Inventory

{
  "company_id": "string",
  "item_code": "string",
  "item_name": "string",
  "category": "string",
  "description": "string",
  "current_stock": "number",
  "min_stock_level": "number",
  "max_stock_level": "number",
  "unit_cost": "number",
  "rental_price_per_day": "number",
  "location": "string",
  "condition": "enum[excellent,good,fair,needs_repair,out_of_service]",
  "supplier_id": "string",
  "purchase_date": "date",
  "warranty_until": "date",
  "last_maintenance": "date",
  "next_maintenance": "date",
  "is_rentable": "boolean",
  "is_active": "boolean"
}

ניהול מלאי ציוד להשכרה ומכירה

1.5 ישויות תמחור ומחירונים

ServiceItem

{
  "company_id": "string",
  "item_code": "string",
  "name": "string",
  "description": "string",
  "category": "string",
  "base_cost_price": "number",
  "base_selling_price": "number",
  "is_active": "boolean",
  "created_date": "date",
  "last_updated": "date",
  "supplier_id": "string",
  "unit_type": "enum[per_hour,per_day,per_event,per_person,per_item,fixed]"
}

קטלוג שירותים ומוצרים למכירה

PriceListHeader

{
  "company_id": "string",
  "name": "string",
  "description": "string",
  "price_list_type": "enum[supplier,client,internal]",
  "currency": "string",
  "is_active": "boolean",
  "valid_from": "date",
  "valid_until": "date",
  "default_markup_percentage": "number",
  "service_item_ids": "array[string]"
}

כותרות מחירונים לקבוצות שונות

PriceTier

{
  "company_id": "string", 
  "name": "string",
  "description": "string",
  "is_active": "boolean",
  "valid_from": "date",
  "valid_until": "date",
  "default_discount_percentage": "number",
  "sort_order": "number"
}

רמות תמחור (VIP, רגיל, הנחה וכו')

SpecialPrice

{
  "company_id": "string",
  "price_list_header_id": "string",
  "service_item_id": "string",
  "price_tier_id": "string", 
  "price": "number"
}

מחירים מיוחדים למטריצת תמחור

1.6 ישויות משימות ותקשורת

Task

{
  "company_id": "string",
  "title": "string",
  "description": "string",
  "event_id": "string",
  "assigned_to": "string",
  "due_date": "date",
  "priority": "enum[low,medium,high,urgent]",
  "status": "enum[todo,in_progress,completed,cancelled]",
  "category": "enum[planning,logistics,communication,payment,setup,followup]",
  "estimated_hours": "number",
  "actual_hours": "number"
}

ניהול משימות עם קשר לאירועים

WhatsAppMessage

{
  "phone_number": "string",
  "client_id": "string",
  "event_id": "string",
  "message_text": "string",
  "message_type": "enum[incoming,outgoing,automated]",
  "status": "enum[sent,delivered,read,failed]",
  "template_used": "string",
  "scheduled_for": "datetime"
}

מעקב הודעות WhatsApp

MessageTemplate

{
  "name": "string",
  "category": "enum[quote,reminder,confirmation,followup,general]",
  "content": "string",
  "variables": "array[string]",
  "is_active": "boolean"
}

תבניות הודעות לשימוש חוזר

1.7 ישויות חשבונאות מתקדמת

VATCode, VATPeriod, AccountsChart, JournalEntry, BankTransaction, EventCost, EventRevenue, ProjectCost

ישויות מתקדמות לניהול חשבונאות, מע"מ, חשבונות בנק וניתוח רווחיות פרויקטים


2. דפים ומבנה ממשק משתמש

2.1 דפים מרכזיים

/pages/Dashboard.js

מטרה: דשבורד ראשי עם סקירת המצב העסקי
רכיבים: סטטיסטיקות מרכזות, גרפי הכנסות, אירועים אחרונים, משימות ממתינות

/pages/Events.js

מטרה: ניהול מלא של אירועים
רכיבים: טבלת אירועים, טופס יצירה/עריכה, סינון וחיפוש, כרטיסי אירוע עם פעולות

/pages/Clients.js

מטרה: מאגר לקוחות וניהולם
רכיבים: טבלת לקוחות עם דירוגים, יבוא/יצוא CSV, פיצול שמות אוטומטי, יצירת לידים

/pages/Suppliers.js

מטרה: ניהול ספקים ומוצריהם
רכיבים: רשימת ספקים, דירוגים, קטלוג מוצרים, יצירת הזמנות רכש

2.2 דפי מכירות ומימון

/pages/Leads.js

מטרה: ניהול לידים בממשק קנבן
רכיבים: לוח קנבן עם גרירה, המרה ללקוחות, מעקב מקורות

/pages/Quotes.js

מטרה: יצירת הצעות מחיר
רכיבים: כרטיסי הצעות מחיר, יצירה מאירועים, המרה להזמנות לקוח

/pages/Accounting.js

מטרה: מרכז חשבונאות מלא
רכיבים: חשבוניות, תקבולים, תשלומים, דוחות פיננסיים

2.3 דפי תמחור ומלאי

/pages/MatrixPricer.js

מטרה: מטריצת תמחור דינמית
רכיבים: טבלה אינטראקטיבית עם עריכה בזמן אמת

/pages/ServiceItems.js, /pages/PriceTiers.js, /pages/PriceListManager.js

מטרה: ניהול קטלוג שירותים ומחירונים
רכיבים: טבלאות עריכה, ייצוא לExcel, ניהול רמות תמחור

/pages/Orders.js, /pages/Inventory.js

מטרה: רכש ומלאי
רכיבים: הזמנות לספקים, מעקב מלאי, תחזוקה

2.4 דפי תקשורת ודוחות

/pages/WhatsApp.js

מטרה: מרכז תקשורת WhatsApp
רכיבים: שליחת הודעות, תבניות, היסטוריה

/pages/Reports.js, /pages/ProfitabilityReports.js

מטרה: דוחות עסקיים ורווחיות
רכיבים: גרפים אינטראקטיביים, ייצוא נתונים

/pages/Tasks.js

מטרה: ניהול משימות פרויקטלי
רכיבים: רשימת משימות עם סינונים, עדיפויות, מעקב זמנים


3. רכיבים מרכזיים לשימוש חוזר

3.1 רכיבי טפסים

  • EventForm.jsx - טופס מורכב ליצירת אירועים עם פריטים ותמחור
  • ClientForm.jsx - טופס לקוח עם וולידציה
  • QuoteForm.jsx - טופס הצעת מחיר דינמי
  • InvoiceForm.jsx, ReceiptForm.jsx, PaymentForm.jsx - טפסי חשבונאות

3.2 רכיבי תצוגה

  • EventCard.jsx - כרטיס אירוע עם פעולות מהירות
  • TaskCard.jsx, LeadCard.jsx - כרטיסי מידע מתקדמים
  • StatsOverview.jsx - סטטיסטיקות עם אנימציות

3.3 רכיבי עזר

  • ImportExport.jsx - יבוא/יצוא CSV גנרי עם וולידציה
  • SmartPricing.jsx - חישובי תמחור אינטליגנטיים
  • KanbanColumn.jsx - עמודת קנבן עם DnD

3.4 לוגיקה עסקית מורכבת

חישובי תמחור מטריציוני

// EventForm.jsx - רכיב מתקדם לחישוב מחירים דינמי
const updateItemPrice = (itemIndex) => {
  const specialPrice = allSpecialPrices.find(p => 
    p.service_item_id === item.service_item_id &&
    p.price_list_header_id === formData.price_list_header_id &&
    p.price_tier_id === formData.price_tier_id
  );
  const price = specialPrice ? specialPrice.price : baseItem?.base_selling_price || 0;
}

מנגנון יבוא חכם עם ניתוח שמות עברית

// Contacts.js - פרסור מתקדם לשמות עבריים
const parseHebrewName = (fullName) => {
  // זיהוי תבניות ארגון: "בית ספר דודיל" -> שם: דודיל, ארגון: בית ספר
  const orgPatterns = [
    /^בית\s+ספר\s+(.+)$/,
    /^חברת\s+(.+)$/
  ];
}

אוטומציה של תהליכי עסק

// Quotes.js - יצירת חשבונית אוטומטית מהזמנת לקוח
const createBusinessInvoice = async (customerOrder) => {
  const vatRate = 0.17;
  const subtotal = customerOrder.total_amount / (1 + vatRate);
  // יצירת חשבונית עסק אוטומטית
}

4. תבנית ראשית וניווט

Layout.js

מבנה:

  • Sidebar קבוע עם תפריט מתקפל
  • Header עליון עם כותרת ומידע משתמש
  • תמיכה במצב התחזות (impersonation) למנהלי פלטפורמה
  • עיצוב RTL מלא לעברית

ניווט מרכזי:

// קבוצות תפריט מאורגנות לפי תחומי עבודה:
- ניהול עיקרי: דשבורד, אירועים, לקוחות
- מכירות: לידים, הצעות מחיר, WhatsApp  
- כספים: חשבונאות, דוחות
- תפעול: ספקים, הזמנות, מלאי
- מערכת: הגדרות, משתמשים

תכונות מתקדמות:

  • מצב responsive מלא
  • תמיכה בהרשאות משתמש
  • מעבר חלק בין דפים ללא רענון

5. אינטגרציות

5.1 אינטגרציות Base44 Core

  • InvokeLLM - בינה מלאכותית לחישובי תמחור ותובנות עסקיות
  • UploadFile - העלאת קבצים לשרת
  • SendEmail - שליחת הודעות דוא"ל אוטומטיות
  • GenerateImage - יצירת תמונות לשיווק
  • ExtractDataFromUploadedFile - ניתוח קבצי CSV/PDF לייבוא

5.2 אינטגרציות חיצוניות

  • WhatsApp Web API - שליחת הודעות ללקוחות
  • Google Maps / Waze - ניווט למקומות אירועים
  • Excel Export - ייצוא דוחות מתקדמים

6. תכונות ייחודיות קריטיות

6.1 מערכת תמחור מטריציונית מתקדמת

  • מחירונים דינמיים עם רמות תמחור שונות (VIP, רגיל, הנחה)
  • מטריצת מחירים אינטראקטיבית - עריכה בזמן אמת של אלפי מחירים
  • מחירים מיוחדים פר לקוח - תמיכה במחירים מותאמים אישית

6.2 ניהול מחזור חיי לקוח מלא (Full CRM Lifecycle)

  • מסלול מלא: ליד → הצעת מחיר → הזמנת לקוח → חשבונית → תקבול
  • אוטומציה חכמה: יצירת מסמכים אוטומטית בכל שלב
  • מעקב רווחיות פרויקט - ברמת אירוע בודד

6.3 מערכת חשבונאות משולבת

  • ניהול מע"מ מלא עם קודי מס ותקופות דיווח
  • יומן חשבונאי אוטומטי - רישום אוטומטי של כל עסקה
  • התאמת בנקים - חשבונות בנק ורישום העברות

6.4 WhatsApp Marketing Hub

  • שליחה בכמויות עם מניעת חסימות
  • תבניות הודעות מותאמות אישית
  • מעקב סטטוסים - נשלח, נקרא, נענה

6.5 מנגנון יבוא חכם

  • ניתוח שמות עברית אוטומטי - הפרדת שם פרטי/משפחה/ארגון
  • זיהוי דפוסים - "בית ספר דודיל" → שם: דודיל, ארגון: בית ספר
  • וולידציה מתקדמת עם בדיקת איכות נתונים

6.6 דוחות בינה עסקית

  • ניתוח רווחיות פרויקטים ברזולוציה גבוהה
  • תחזיות מכירות מבוססות נתונים היסטוריים
  • דוחות פיננסיים אינטראקטיביים עם אפשרות קידוח למידע מפורט

6.7 ממשק מנהל פלטפורמה

  • מצב התחזות (Impersonation) - מנהלים יכולים להיכנס כמשתמש אחר
  • ניהול מנויים ותכניות תמחור
  • מעקב שימוש וביצועי פלטפורמה