کنترل بودجهٔ ماهانه

هدف و راهنمای انجام با روش CRAFT

C · Challenge | چالش

هزینه‌ها را با سقف بودجه مقایسه و وضعیت را گزارش کن.

مدیریت مقدارهای عددی و وضعیت روشن

R · Route | مسیر

1. قرارداد ورودی را بخوان و دادهٔ خام را بدون تغییر ناخواسته نگه دار.
2. اعتبار داده و حالت‌های مرزی را پیش از محاسبه بررسی کن.
3. محاسبه را در تابع solve انجام بده و خروجی ساختاریافته بساز.
4. نتیجه را در result.json بنویس و با چند ورودی متفاوت آزمایش کن.

A · Applicable Knowledge | دانش کاربردی

Python · Comparisons · Reports

کتابخانه‌های موردنیاز این مسئله: json, pathlib

F · Forge | ساختن

در main.py تابع solve را کامل کن؛ پاسخ را طبق قرارداد زیر برگردان تا در result.json ذخیره شود. اجرای عادی برای بررسی خروجی است و ارزیابی برای سنجش حل مسئله با ورودی‌های دیگر.

ورودی

budget: عدد صحیح غیرمنفی در یک واحد ثابت؛ spent: فهرست هزینه‌های صحیح غیرمنفی. خالی بودن هزینه‌ها مجاز است.

خروجی

spent: جمع هزینه‌ها؛ remaining: بودجه منهای مصرف و ممکن است منفی شود؛ within_budget: مصرف کمتر یا مساوی بودجه.

Python 3؛ تابع solve(data) را پیاده‌سازی کنید و بخش خواندن و نوشتن فایل را حفظ کنید.

مثال ورودی و خروجی

{
    "input": {
        "budget": 500,
        "spent": [
            120,
            80,
            90
        ]
    },
    "output": {
        "spent": 290,
        "remaining": 210,
        "within_budget": true
    }
}

T · Transfer | انتقال

آستانهٔ هشدار هشتاد درصد را بدون تغییر معنای مصرف و باقیمانده به گزارش اضافه کنید.

این تمرین انتقال برای خودآزمایی است و جزو ارزیابی خودکار و XP این پروژه نیست.

معیارهای موفقیت

• ساختار خروجی با قرارداد برابر است.
• نتیجه برای ورودی‌های متنوع و حالت‌های مرزی درست می‌ماند.
• کد از دادهٔ request.json استفاده می‌کند و پاسخ ثابت مثال نیست.