ساخت گزارش عملکرد

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

C · Challenge | چالش

از چند شاخص عددی یک گزارش خلاصه و وضعیت عملکرد بساز.

ترکیب توابع، میانگین و وضعیت‌گذاری

R · Route | مسیر

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

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

Python · Functions · Statistics

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

F · Forge | ساختن

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

ورودی

metrics: نگاشت نام شاخص به عدد متناهی بین صفر و صد با وزن برابر. فهرست تهی مجاز است.

خروجی

average: میانگین حسابی؛ status: از ۹۰ excellent، از ۷۰ good و کمتر needs_review؛ best_metric: نام بیشترین مقدار، در تساوی کوچک‌ترین نام Unicode. خالی: فقط error=empty_metrics.

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

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

{
    "input": {
        "metrics": {
            "speed": 80,
            "quality": 90,
            "reliability": 70
        }
    },
    "output": {
        "average": 80,
        "status": "good",
        "best_metric": "quality"
    }
}

T · Transfer | انتقال

نسخهٔ وزن‌دار گزارش را بسازید؛ مجموع وزن صفر باید قرارداد روشن و آزمون مستقل داشته باشد.

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

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

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