Menu
Coddy logo textTech
flag Ar iconالعربيةdown icon

إنشاء التقارير

جزء من قسم المنطق وتدفق التنفيذ في رحلة C# على Coddy. الدرس 44 من 66.

challenge icon

التحدي

متوسط

الآن بعد أن أصبح لدينا نظام الدرجات، لننشئ وحدة تقارير لإنشاء تقارير منسّقة حول أداء الطلاب. أنشئ فئة تُسمّى ReportGenerator باستخدام هذه الأساليب:

  1. GenerateStudentReport(int[][] scoreGrid, int studentIndex): تُرجع سلسلة منسّقة تعرض درجات طالب محدد، ومتوسطه، وتقديره الحرفي.
    • التنسيق: "Student #X | Average: YY.Y | Grade: Z\nAssignment scores: S1, S2, S3, ..." حيث إن S1 وS2 وS3 و... هي الدرجات الرقمية لكل assignment.
    • بالنسبة إلى assignments غير المُقيّمة (الدرجة -1)، اعرض "N/A" بدلًا من الدرجة.
    • أعِد "Invalid student index" لأي student index غير صالح.
  2. GenerateClassSummary(int[][] scoreGrid): تُرجع سلسلة منسّقة تلخّص أداء الفئة.
    • التنسيق: "Class Summary\nTotal Students: X\nClass Average: YY.Y\nGrade Distribution: A: #, B: #, C: #, D: #, F: #"
  3. GenerateAssignmentReport(int[][] scoreGrid, int assignmentIndex): تُرجع سلسلة منسّقة تحتوي على إحصاءات حول assignment محدد.
    • التنسيق: "Assignment #X | Average: YY.Y | Completion Rate: Z%"
    • معدل الإكمال هو النسبة المئوية للطلاب الذين لديهم درجة لهذا assignment (وليست -1).
    • أعِد "Invalid assignment index" لأي assignment index غير صالح.

جرّب بنفسك

using System; // لا تحذف هذا السطر
using System.Text;

public class ReportGenerator
{
    public static string GenerateStudentReport(int[][] scoreGrid, int studentIndex)
    {
        // اكتب الكود الخاص بك هنا
        
    }
    
    public static string GenerateClassSummary(int[][] scoreGrid)
    {
        // اكتب الكود الخاص بك هنا
        
    }
    
    public static string GenerateAssignmentReport(int[][] scoreGrid, int assignmentIndex)
    {
        // اكتب الكود الخاص بك هنا
        
    }
}

// مطلوب للاختبار - لا تعدّل
public class DataCollector
{
    public static int[][] CreateScoreGrid(int students, int assignments)
    {
        int[][] scoreGrid = new int[students][];
        for (int i = 0; i < students; i++)
        {
            scoreGrid[i] = new int[assignments];
        }
        return scoreGrid;
    }
    
    public static bool ValidateScore(int score)
    {
        return score >= 0 && score <= 100;
    }
    
    public static int[][] PopulateWithDefaultValues(int[][] scoreGrid)
    {
        for (int i = 0; i < scoreGrid.Length; i++)
        {
            for (int j = 0; j < scoreGrid[i].Length; j++)
            {
                scoreGrid[i][j] = -1;
            }
        }
        return scoreGrid;
    }
}

public class DataEntry
{
    public static int SetStudentScore(int[][] scoreGrid, int studentIndex, int assignmentIndex, int score)
    {
        // تحقق من الفهارس خارج الحدود
        if (studentIndex < 0 || studentIndex >= scoreGrid.Length || 
            assignmentIndex < 0 || assignmentIndex >= scoreGrid[studentIndex].Length)
        {
            return -1;
        }
        
        // تحقق من صحة الدرجة
        if (!DataCollector.ValidateScore(score))
        {
            return -2;
        }
        
        // عيّن الدرجة
        scoreGrid[studentIndex][assignmentIndex] = score;
        return 0;
    }
    
    public static int UpdateAllScores(int[][] scoreGrid, int[] studentIndices, int assignmentIndex, int score)
    {
        int successCount = 0;
        
        for (int i = 0; i < studentIndices.Length; i++)
        {
            int result = SetStudentScore(scoreGrid, studentIndices[i], assignmentIndex, score);
            if (result == 0)
            {
                successCount++;
            }
        }
        
        return successCount;
    }
}

public class DataAnalyzer
{
    public static double CalculateStudentAverage(int[][] scoreGrid, int studentIndex)
    {
        // Check if student index is valid
        if (studentIndex < 0 || studentIndex >= scoreGrid.Length)
        {
            return -1;
        }
        
        int sum = 0;
        int count = 0;
        
        // احسب مجموع الدرجات الصالحة
        for (int j = 0; j < scoreGrid[studentIndex].Length; j++)
        {
            int score = scoreGrid[studentIndex][j];
            if (score != -1)  // تجاهل الواجبات غير المُقيَّمة
            {
                sum += score;
                count++;
            }
        }
        
        // أرجع المتوسط أو 0 إذا لم تكن هناك درجات صالحة
        return count > 0 ? (double)sum / count : 0;
    }
    
    public static double CalculateAssignmentAverage(int[][] scoreGrid, int assignmentIndex)
    {
        // تحقق مما إذا كان هناك أي طلاب
        if (scoreGrid.Length == 0)
        {
            return -1;
        }
        
        // Check if assignment index is valid
        if (assignmentIndex < 0 || assignmentIndex >= scoreGrid[0].Length)
        {
            return -1;
        }
        
        int sum = 0;
        int count = 0;
        
        // احسب مجموع الدرجات الصالحة للواجب
        for (int i = 0; i < scoreGrid.Length; i++)
        {
            if (assignmentIndex < scoreGrid[i].Length)
            {
                int score = scoreGrid[i][assignmentIndex];
                if (score != -1)  // تجاهل الواجبات غير المُقيَّمة
                {
                    sum += score;
                    count++;
                }
            }
        }
        
        // أرجع المتوسط أو 0 إذا لم تكن هناك درجات صالحة
        return count > 0 ? (double)sum / count : 0;
    }
    
    public static int[] FindHighestScore(int[][] scoreGrid)
    {
        int highestStudentIndex = 0;
        int highestAssignmentIndex = 0;
        int highestScore = -1;
        
        // ابحث عن أعلى درجة
        for (int i = 0; i < scoreGrid.Length; i++)
        {
            for (int j = 0; j < scoreGrid[i].Length; j++)
            {
                int currentScore = scoreGrid[i][j];
                if (currentScore > highestScore)
                {
                    highestScore = currentScore;
                    highestStudentIndex = i;
                    highestAssignmentIndex = j;
                }
            }
        }
        
        return new int[] { highestStudentIndex, highestAssignmentIndex, highestScore };
    }
}

public class GradingSystem
{
    public static string ConvertToLetterGrade(double score)
    {
        if (score < 0 || score > 100)
        {
            return "N/A";
        }
        else if (score >= 90)
        {
            return "A";
        }
        else if (score >= 80)
        {
            return "B";
        }
        else if (score >= 70)
        {
            return "C";
        }
        else if (score >= 60)
        {
            return "D";
        }
        else
        {
            return "F";
        }
    }
    
    public static string GetStudentGrade(int[][] scoreGrid, int studentIndex)
    {
        double average = DataAnalyzer.CalculateStudentAverage(scoreGrid, studentIndex);
        
        if (average == -1)
        {
            return "N/A";
        }
        
        return ConvertToLetterGrade(average);
    }
    
    public static int[] GetClassDistribution(int[][] scoreGrid)
    {
        int[] distribution = new int[5]; // [A, B, C, D, F]
        
        for (int i = 0; i < scoreGrid.Length; i++)
        {
            string grade = GetStudentGrade(scoreGrid, i);
            
            switch (grade)
            {
                case "A":
                    distribution[0]++;
                    break;
                case "B":
                    distribution[1]++;
                    break;
                case "C":
                    distribution[2]++;
                    break;
                case "D":
                    distribution[3]++;
                    break;
                case "F":
                    distribution[4]++;
                    break;
                // N/A grades are not counted in the distribution
            }
        }
        
        return distribution;
    }
}

جميع دروس المنطق وتدفق التنفيذ

تدرّب بنفسك: مترجم C# عبر الإنترنت