קטלוג מוצרים / שירותים בMewayz
תוסף המוצר/שירות הוא קטלוג המלאי המשותף המשמש את הנהלת החשבונות, CRM, POS, EcomStore והזמנות.
Mewayz-מודול מקורי - אין Mewayz במעלה הזרם. תיעוד נכתב ממקור החבילה בכתובת
packages/mewayz/ProductService/.





הקדמה
תוסף המוצר/שירות הוא מקור יחיד של אמת עבור כל פריט שניתן למכירה בפלטפורמת Mewayz. במקום שכל מודול (מכירות, קופה, EcomStore, הזמנות) ישמור על רשימת מוצרים משלו, כולם קוראים וכותבים לקטלוג משותף אחד. המשמעות היא שכאשר מפעיל יוצר מוצר חדש במוצר / שירות, המוצר הזה ניתן לשימוש מיידי בכל משטח מכירה, עם ספירת מלאי מסונכרנת וכללי מס.
המודול מכסה סחורות פיזיות עם מעקב אחר מלאי, שירותים שאינם במלאי במחיר לשעה או לכל סשן, מלאי מרובה מחסנים, קטגוריות היררכיות, כללי מס לפי שורה ויחידות מידה.
כיצד להפעיל מודול זה
כדי להגדיר את תוסף המוצר/שירות, אתה יכול לעקוב אחר הקישור הזה: הגדר תוסף.
התוסף נסגר על ידי PlanModuleCheck:ProductService. רוב התוכניות הפונות למכירות מאגדות אותו כברירת מחדל - קופה, חשבון, EcomStore והזמנות תלויים כולם בהיותו פעיל.
פריטים
עיין בפריטים
- נווט אל מוצר ושירות ← פריטים בסרגל הצד.
- תצוגת הרשימה מציגה את כל הפריטים שהמפעיל יכול לנהל, עם מסננים עבורם שם, הקלד (מוצר או שירות), קטגוריה, ו סטטוס פעיל.
- כל שורה מציגה מק"ט, מחיר מכירה, מחיר רכישה, סך מלאי המחסן הנוכחי ולחצני פעולה מהירה (הצג, ערוך, מחק).
צור פריט חדש
- לחץ + פריט חדש בפינה השמאלית העליונה של רשימת הפריטים.
- בטופס יש את השדות הבאים:
- שם - שם תצוגה מוצג בתפריטים נפתחים ברחבי הפלטפורמה
- הקלד - מוצר (במעקב אחר מלאי) או שירות (ללא מלאי)
- מק"ט - יחידת אחזקת מלאי אופציונלית (ייחודית לכל דייר)
- קטגוריה - בחר מתוך קטגוריות קיימות, או צור קטגוריה חדשה בשורה
- יחידה - יחידת מידה (כל אחד, ק"ג, שעה, מ"ר וכו')
- Sale Price - מחיר ברירת מחדל כאשר פריט זה מופיע בחשבונית או בהזמנה
- מחיר רכישה - עלות ברירת מחדל בעת קבלת מלאי
- מיסים - מבחר רב של שיעורי מס החלים על פריט זה
- תמונה — תמונת מוצר בשימוש על ידי EcomStore + POS
- תיאור - תיאור ארוך צורה; בשימוש על ידי דפי הפרטים של EcomStore
- לחץ שמור כדי ליצור את הפריט. אירוע (
CreateProductServiceItem) נשלח כך שמאזינים במודולים אחרים יוכלו להגיב (למשל, אינדקס מחדש של אינדקס חיפוש).
ערוך / מחק פריט
- מרשימת הפריטים, לחץ על לחצן העריכה של השורה כדי לפתוח את אותו טופס המאוכלס בנתוני הפריט.
- מחיקת פריט שיגור
DestroyProductServiceItem. אם הפריט מופנה באמצעות חשבונית, הזמנה או מכירת קופה קיימת, השורה הבסיסית היא נמחק רך כך שהרישומים ההיסטוריים שומרים על הנתונים שלהם ללא פגע.
ניהול מלאי
- נווט אל מוצר ושירות ← מלאי בסרגל הצד.
- תצוגת המלאי מקבצת פריטים לפי מחסן כך שמפעיל עם מספר מיקומים פיזיים יכול לראות כמויות מדויקות בכל מיקום.
- כל שורה מציגה פריט, מחסן, כמות נוכחית ותאריך תנועה אחרונה.
הוסף או התאם מלאי
- לחץ הוסף מלאי כדי לרשום תנועת מניות.
- בחר את פריט, ה מַחסָן, ה כמות (חיובי עבור נכנס, שלילי עבור התאמה-out), וכן א הערה.
- כל תנועה מתועדת; הקטלוג אף פעם לא רק "מעדכן מספר" - כל שינוי ניתן לביקורת.
קטגוריות
- נווט אל מוצר ושירות ← קטגוריות.
- הקטגוריות הן שטוחות או היררכיות (הורה → ילד). לכל קטגוריה יכולה להיות א תג צבע זה משתקף ברשימת הפריטים ובדפי הרישום של EcomStore.
- פעולות יצירה/עריכה/מחיקה עקוב אחר דפוס ה-CRUD הסטנדרטי.
מיסים
- נווט אל מוצר ושירות ← מיסים.
- הוסף את שיעורי המס שהעסק צריך (למשל מע"מ 15%, מס מכירה 7.25% וכו').
- לכל מס יש א שם, שיעור (אחוז), ואופציונלי תיאור.
- לאחר מכן מצורפים מיסים לפריטים באמצעות בחירה מרובה בטופס הפריט.
יחידות
- נווט אל מוצר ושירות ← יחידות.
- היחידות הן התוויות המוצגות בשורת העגלה / החשבונית - "כל אחד", "ק"ג", "שעה", "מפגש", "מ"ר" וכו'.
- Mewayz שולח ערכת התחלה; הוסף או שנה שם כדי להתאים לאוצר המילים בתעשייה של המפעיל.
התנהגות חוצת מודולים
מודולים אחרים של Mewayz לצרוך קטלוג המוצרים/שירותים:
- חשבון מודול - חשבוניות מכירה וחשבוניות רכישה בוחרים פריטים מקטלוג זה.
- CRM / מכירות - פריטי דיל ופריטי התייחסות להצעות.
- קופה מודול - מכירות קופה מושכים רשימת מוצרים ישירות.
- EcomStore מודול - מוצרי חזית החנות מוצגים מקטלוג זה עם עיון מבוסס קטגוריות.
- הזמנות מודול - קטלוג שירותים לשירותים שניתן להזמין.
- ApiDocsGenerator מודול - מתעד את נקודות הקצה הציבוריות של ממשק API לגישה פרוגרמטית (
/api/productsוכו').
הרשאות
החבילה מגדירה הרשאות מפורטות:
manage-product-service-item- ניהול מלאcreate-product-service-item— צור פריטים חדשיםmanage-any-product-service-item— ערוך כל פריט דיירmanage-own-product-service-item- ערוך רק פריטים שנוצרו בעצמך
הקצה אלה באמצעות הגדרות ← תפקידים והרשאות.
גישת API
החבילה גם חושפת GET /api/product-service/items כנקודת קצה מאומתת פנימית שבה מופיעים מודולים אחרים ומחולל מסמכי ה-API GET /api/products.
הערות מפעיל
- תנועות המניות אינן ניתנות לשינוי - כדי "להפוך" תנועה, רשום תנועה חדשה בכיוון ההפוך במקום לערוך את השורה המקורית.
- בעת מחיקת פריטים שיש להם מלאי בהישג יד, המערכת מזהירה לפני שמתירה את הפעולה.
- תמונות פריט מאוחסנות תחת
storage/app/public/product-service/ומוגש דרך הstorageקישור סימלי. לאחר העלאת תמונה חדשה, היא מנורמלת לשם קובץ בודד ב-DB; כתובת האתר הציבורית מחושבת בזמן העיבוד.