מעקב חבילות

כוונה ומשתמשים: הכלי פותר מעקב חבילות בין משלחים שונים עבור צוותי תפעול ותמיכה. הוא מקבל אחד או יותר מספרי מעקב עם מזהים שליחים אפשריים כדי לשלוף סטטוס נוכחי, מיקום ו-ETA. הכלי משמש מימוש מסחר אלקטרוני, מתכנני לוגיסטיקה ונציגי תמיכה להענקת עדכונים מדויקים ללקוחות או להזנת לוחות בקרה. הלוגיקה המרכזית כוללת נורמליזציה של קלט, מיפוי משלחים ואורקסטורציה של API כדי לקבל מצב בזמן אמת מהמשלחים או מאגרי נתונים. פונקציות חובה: חיפוש מרובה-מספרים, סכמת תציאה תקנית, ולידציה של קלט ובקרות עדכניות נתונים. פונקציות מתקדמות: עיבוד בבאצים עם התחשבות בהגבלות מהירות, אחסון מטמון, התראות webhook ופורמטים ליצוא (JSON/CSV) עם תמיכת לוקליזציה.
קלטים & פלטים: קלטים כוללים tracking_numbers (מערך טקסטים, נדרשים), carriers (אפשרי מערך או mapping), include_eta (בוליאני, ברירת מחדל true), locale (אופציונלי). פלטים הם shipments (מערך אובייקטים) עם שדות: tracking_number, carrier, status, location, timestamp, eta, history (מערך אירועים). כללי אימות: יש להבטיח tracking_numbers שאינם ריקים וזיהויים מוכרים של carriers אם מספקים, תאריכי ISO 8601 לפלט.
אלגוריתמים וחישובים: הכלי משתמש בקריאות REST API אל carriers או Aggregators עם זמנים ו-policy retry. כללי ETA: שימוש ב-ETA מספקי carrier אם זמין; אחרת הערכה בהתאם זמני מעבר טיפוסיים לנתיב והאירוע האחרון. נורמליזציה של סטטוס: תואם סטטוסי carrier לאונטולוגיה משותפת (In Transit, Out for Delivery, Delivered, Exception, Pending).
שגיאות ותרחישי קצה: כניסות לא תקינות, carriers לא מוכרים או קלטים חסרים גורמים לשגיאות אימות. תוצאות חלקיות עם קודי שגיאה לכל משלוח כאשר carrier אינו נגיש. זמן-המתנה, גבולות קצב או תקלות API מחייבים retry או fallback לנתונים האחרונים המותרים.
תעשייה/אזור ולוקליזציה: תקנים ISO 8601, זמן UTC ו taxonomy סטנדרטי של סטטוס. כיסוי גלובלי; פורמטים תואמים לנהלי תעשייה. פרטיות לפי GDPR ונהלים אזוריים; המטבע אינו רלוונטי. הנחות והחרגות: נדרש גישה ל-API של carriers או Aggregators מורשים; אין ממשק משתמש; נתונים שאינם זמינים מסומנים; אין Streaming בזמן אמת; חריגה מלוגיקת ניתוב פנים-ארגוני או נתוני מלאי.