حاسبة ميزانية وقت الرحلة

يعود الهامش والفيض والاستخدام وعلامة fits مع الساعات الموصى بها لكل صف، فيشترك المخطّط البشري وعميل API في حساب واحد. الميزانيات الصفرية أو السالبة، والتنقّل أو الراحة السالبان، والزوج المحجوز الذي يتجاوز اليوم سلفاً تفشل بـ invalid_input بدل اختراع جدول.

كيف يقلّص التنقّل والراحة المحجوزان غلاف الأنشطة

تعامل ميزانية وقت البرنامج نافذة اليقظة كغلاف صارم لا كقائمة أمنيات. يُطرح التنقّل والراحة أولاً لأنهما ليسا اختياريين في يوم واقعي. يحتفظ كل نشاط باسم ورقم ساعات مخطّطة حتى يبقى مقطع اللوفر وسوق ونزهة نهرية متمايزة. الساعات المخطّطة المتساوية تبقى متساوية بعد التصغير؛ وكاتدرائية من أربع ساعات بجانب متحف من ساعتين تحفظ النسبة اثنين إلى واحد. يمتصّ غبار الفاصلة العائمة في آخر نشاط مخطّط موجب حتى تجتمع الساعات الموصى بها تماماً مع الحوض المتبقي في يوم فيض. الحقل available_hours هو ذلك الغلاف: أربع عشرة ساعة من الإفطار إلى الفندق، أو عشر ساعات بين انطلاق متأخر وحجز عشاء. المشي بين المتاحف، وقفزة المترو، وسيارة الأجرة إلى المطلّ، والدقائق الضائعة عند الشبابيك تعيش في transit_hours. الوجبات وقهوة جلوساً وتسجيل الوصول إلى الفندق والاستراحة التي يحتاجها المسافر حقاً تعيش في rest_hours. مجموعهما reserved_hours. وما يبقى هو remaining_for_activities، الحوض الوحيد الذي يجوز للمحطات المخطّطة إنفاقه. عندما لا يتجاوز المجموع المخطّط الحوض المتبقي، تساوي الساعات الموصى بها الساعات المخطّطة ويكون slack_hours هو الباقي غير المستخدم. عندما يكون المجموع المخطّط أكبر، يُصغَّر كل نشاط بـ remaining_for_activities مقسوماً على المجموع المخطّط حتى يُغلق اليوم الموصى به. قد يتجاوز الاستخدام مئة في المئة عندما يتخطى committed_hours حسب الخطة الميزانية؛ تلك إشارة إلى القطع لا إلى ادّعاء أن الساعة تمتد.

عقد الإدخال وشكل الاستجابة وسلوك الخطأ

الحقل activities مصفوفة غير فارغة من كائنات، لكل منها name غير فارغ و hours منتهٍ غير سالب، وبحدٍّ أقصى خمسين صفاً على مسار parse المجاني هذا. صلوا نموذج المتصفح المجاني بالتخطيط البشري، واستدعوا العقد نفسه من بانٍ للرحلات عندما تحتاج الأتمتة الأرقام ذاتها. أرسلوا بـ POST جسماً JSON بأربعة حقول إلزامية. الحقل available_hours عدد منتهٍ أكبر قطعاً من الصفر وبحدٍّ أقصى مئة وثمانٍ وستين، يكفي ليوم طويل أو غلاف قصير لعدة أيام. الحقلان transit_hours و rest_hours منتهيان وغير سالبين، وكلٌّ منهما محدود أيضاً بمئة وثمانٍ وستين. يجب ألا يتجاوز مجموعهما available_hours؛ الزوج المحجوز الذي يلتهم الميزانية كلها وزيادة يفشل بـ invalid_input لأنه لا يبقى غلاف أنشطة نزيه للتوزيع. الحقول الناقصة والقوائم الفارغة والصفوف غير الكائنية والأسماء البيضاء والأعداد غير المنتهية والساعات السالبة والميزانية المتاحة الصفرية أو السالبة تفشل كلها بـ invalid_input ولا تُفوتر. عند النجاح يعيد الجسم مدخلات الساعات الثلاث ويبلّغ reserved_hours و remaining_for_activities و planned_activity_hours و recommended_activity_hours و committed_hours و slack_hours و overflow_hours وعلَماً منطقياً fits وحالة status من fits أو tight أو overflow و utilization_percent و scale_factor و activity_count. يحمل كل صف نشاط index و name و planned_hours و recommended_hours و share_of_activities و percent_of_day. القيمة Method هي reserve_then_scale. وتعيد Formula أن remaining يساوي available ناقص transit ناقص rest، وأن recommended_i يساوي planned_i مضروباً في أصغر الواحد و remaining على المجموع المخطّط. اليوم tight يوم يتّسع وهامشه عشرة في المئة من available_hours على الأكثر. تستخدم استدعاءات API الناجحة السعر الأساسي المنشور $0.002 لكل عنصر؛ وإخفاقات التحقق لا تستهلك الرصيد المدفوع مسبقاً.

أين تثبت ميزانية وقت البرنامج اليومية نفعها

يستخدم منظّمو الرحلات حاسبة ميزانية وقت برنامج الرحلة حتى يصمد قالب استراحة حضرية أمام نافذة ضوء شتوية أقصر: أبقوا المحطات المخطّطة ذاتها، وارفعوا transit_hours عندما يمشي الجمع أبطأ، ثم أعيدوا التشغيل. يحجز منظّمو الخلوات المؤسسية الغداء وحافلة الفندق كـ rest و transit ثم ينظرون إن كانت ثلاث ورش ما تزال تتّسع في يوم من عشر ساعات. ولأن التنفيذ parse خالص من المستوى A، تكلف كل دعوة ناجحة السعر الأساسي المنشور $0.002 بلا رموز نموذج ولا شبكة صادرة.