راهنمای توسعه و یکپارچه‌سازی مدل

{
    "success": true,
    "schema": {
        "all_required": true,
        "fields": [
            {
                "name": "age",
                "label_fa": "سن بیمار",
                "label_en": "Patient Age",
                "type": "number",
                "required": true,
                "min": 30,
                "max": 79,
                "step": 1,
                "help_text_fa": "سن باید بین ۳۰ تا ۷۹ سال باشد",
                "help_text_en": "Age must be between 30 and 79 years",
                "order": 1
            },
            {
                "name": "sex",
                "label_fa": "جنسیت",
                "label_en": "Sex",
                "type": "select",
                "required": true,
                "options": [
                    {"value": "male", "label_fa": "مرد", "label_en": "Male"},
                    {"value": "female", "label_fa": "زن", "label_en": "Female"}
                ],
                "order": 2
            },
            {
                "name": "total_cholesterol",
                "label_fa": "کلسترول کل (mmol/L)",
                "label_en": "Total Cholesterol (mmol/L)",
                "type": "number",
                "required": true,
                "min": 3,
                "max": 9,
                "step": 0.1,
                "help_text_fa": "میزان کلسترول کل آزمایشگاهی",
                "help_text_en": "Total blood cholesterol level",
                "order": 3
            },
            {
                "name": "hdl_cholesterol",
                "label_fa": "کلسترول HDL (mmol/L)",
                "label_en": "HDL Cholesterol (mmol/L)",
                "type": "number",
                "required": true,
                "min": 0.5,
                "max": 4.0,
                "step": 0.1,
                "help_text_fa": "کلسترول خوب",
                "help_text_en": "High-density lipoprotein cholesterol",
                "order": 4
            },
            {
                "name": "systolic_bp",
                "label_fa": "فشار خون سیستولیک (mmHg)",
                "label_en": "Systolic Blood Pressure (mmHg)",
                "type": "number",
                "required": true,
                "min": 90,
                "max": 200,
                "step": 1,
                "help_text_fa": "عدد بالای فشار خون",
                "help_text_en": "Top number of blood pressure reading",
                "order": 5
            },
            {
                "name": "bp_treated",
                "label_fa": "تحت درمان دارویی فشار خون",
                "label_en": "Treated for High Blood Pressure",
                "type": "select",
                "required": true,
                "options": [
                    {"value": "no", "label_fa": "خیر", "label_en": "No"},
                    {"value": "yes", "label_fa": "بله", "label_en": "Yes"}
                ],
                "help_text_fa": "آیا بیمار داروی کاهش فشار خون مصرف می‌کند؟",
                "help_text_en": "Is the patient currently taking hypertension medication?",
                "order": 6
            },
            {
                "name": "smoker",
                "label_fa": "مصرف سیگار",
                "label_en": "Smoker",
                "type": "select",
                "required": true,
                "options": [
                    {"value": "no", "label_fa": "خیر", "label_en": "No"},
                    {"value": "yes", "label_fa": "بله", "label_en": "Yes"}
                ],
                "help_text_fa": "آیا بیمار سیگاری است؟",
                "help_text_en": "Does the patient currently smoke?",
                "order": 7
            }
        ],
        "field_groups": [
            {
                "name_fa": "اطلاعات دموگرافیک",
                "name_en": "Demographic Information",
                "fields": ["age", "sex", "smoker"]
            },
            {
                "name_fa": "علائم بالینی و آزمایشگاهی",
                "name_en": "Clinical & Laboratory Factors",
                "fields": ["total_cholesterol", "hdl_cholesterol", "systolic_bp", "bp_treated"]
            }
        ]
    }
}

{
    "success": true,
    "info": {
        "name_fa": "تخمین خطر ۱۰ ساله بیماری سخت عروق کرونر (فرامینگهام)",
        "name_en": "Framingham 10-Year Hard CHD Risk Score",
        "description_fa": "تخمین میزان احتمال ۱۰ ساله ابتلا به حوادث سخت عروق کرونر (سکته قلبی یا مرگ ناشی از بیماری قلبی) بر اساس الگوریتم دقیق رگرسیون کوکس (Cox Model) و ۸ شاخص بالینی و آزمایشگاهی.",
        "description_en": "Estimates the 10-year probability of hard coronary heart disease events (myocardial infarction or CHD death) using the continuous Cox proportional hazards model based on 8 clinical and laboratory variables.",
        "developer": {
            "name": "علیرضا خزاعی زاده",
            "name_en": "Alireza Khazaeizadeh",
            "email": "alireza.khazaeizadeh80@gamil.com",
            "phone": "",
            "institution_fa": "دانشگاه فردوسی مشهد",
            "institution_en": "Ferdowsi University of Mashhad"
        },
        "authors": [
            {
                "name": "Ralph B. D'Agostino Sr",
                "affiliation_fa": "دانشگاه بوستون و مطالعه قلب فرامینگهام",
                "affiliation_en": "Boston University & Framingham Heart Study",
                "orcid": "https://orcid.org/0000-0000-0000-0000"
            }
        ],
        "version": "1.0",
        "last_updated": "2026-07-06",
        "algorithm": "Cox Proportional Hazards Model",
        "followup": {
            "enabled": false,
            "days": 0,
            "question_fa": "",
            "question_en": "",
            "options": []
        },
        "metrics": {
            "auc": 0.77,
            "accuracy": 0.73,
            "sensitivity": 0.71,
            "specificity": 0.74,
            "f1": 0.38
        },
        "clinical_notes": {
            "input_type": "سن، جنسیت، کلسترول کل، کلسترول HDL، فشار خون سیستولیک، وضعیت درمان فشار خون و مصرف سیگار",
            "benefit": "غربالگری و طبقه‌بندی خطر بیماران بدون سابقه قبلی بیماری قلبی جهت تصمیم‌گیری برای شروع درمان دارویی (استاتین و ضد فشارخون)"
        },
        "tags": [
            "فرامینگهام",
            "خطر ۱۰ ساله قلبی",
            "عروق کرونر"
        ],
        "tags_en": [
            "Framingham Risk Score",
            "Hard CHD",
            "Cardiovascular Risk"
        ]
    }
}

{
    "success": true,
    "prediction": {
        "probability": 0.75,
        "probability_formatted": "75.0٪",
        "gauge_title_fa": "احتمال بیماری قلبی",
        "gauge_title_en": "Heart Disease Probability",
        "class": 1,
        "class_label_fa": "در معرض خطر",
        "class_label_en": "At Risk",
        "risk_category": "high",
        "risk_label_fa": "ریسک بالا",
        "risk_label_en": "High Risk",
        "risk_color": "#f44336"
    },
    "explanations": {
        "shap": {
            "format": "image",
            "waterfall": "data:image/png;base64,iVBORw0KGgo..."
        },
        "feature_importance": {
            "format": "data",
            "values": [
                {
                    "feature": "age",
                    "feature_fa": "سن",
                    "feature_en": "Age",
                    "importance": 0.45,
                    "contribution": 0.30,
                    "effect": "positive",
                    "active": true
                }
            ]
        }
    },
    "interpretation": {
        "summary_fa": "احتمال بیماری قلبی ۷۵٪ است.",
        "summary_en": "Heart disease probability is 75%.",
        "key_factors_fa": ["سن: افزایش ریسک"],
        "recommendation_fa": "توصیه می‌شود ویزیت متخصص قلب انجام شود."
    }
}