خلاصه‌ساز هزینه‌های ماهانه

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

C · Challenge | چالش

فهرست هزینه‌ها را دسته‌بندی و جمع ماهانه را محاسبه کن.

ساخت گزارش قابل‌اعتماد از داده‌های مالی کوچک

R · Route | مسیر

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

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

Python · Dictionaries · Aggregation

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

F · Forge | ساختن

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

ورودی

expenses: فهرست رکوردهای category (رشتهٔ غیرخالی) و amount (عدد صحیح غیرمنفی). دسته‌ها عیناً حفظ می‌شوند؛ فهرست خالی مجاز است.

خروجی

by_category: جمع هر دسته؛ total: مجموع همهٔ هزینه‌ها؛ فهرست خالی نگاشت خالی و مجموع صفر دارد.

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

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

{
    "input": {
        "expenses": [
            {
                "category": "خوراک",
                "amount": 120
            },
            {
                "category": "رفت‌وآمد",
                "amount": 80
            },
            {
                "category": "خوراک",
                "amount": 50
            }
        ]
    },
    "output": {
        "by_category": {
            "خوراک": 170,
            "رفت‌وآمد": 80
        },
        "total": 250
    }
}

T · Transfer | انتقال

گزارش را به تفکیک ماه توسعه دهید؛ کلید ترکیبی ماه و دسته چه تغییری در ساختار داده می‌دهد؟

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

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

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