My First Console Application Project (QuizApp)

README.md

🎓 QuizApp Console - C# Terminal-Based Quiz System

QuizApp - bu C# tilida yozilgan va Spectre.Console kutubxonasi yordamida terminal interfeysga ega bo‘lgan interaktiv quiz (test) tizimidir. Ushbu dastur ikki asosiy muhitda ishlaydi: Teacher Mode va Student Mode.

---

📂 Project Structure

📁 Models
│   ├── Question.cs
│   ├── McqQuestion.cs
│   ├── TrueFalseQuestion.cs
│   ├── ShortAnswerQuestion.cs
│   └── QuizMeta.cs

📁 Services
│   ├── QuizBuilder.cs
│   ├── QuizManager.cs
│   └── QuizRunner.cs

📁 Helpers
│   └── InputHelper.cs

📁 Data
│   └── Quizzes/
│       └── *.json

📄 Program.cs

---

🔧 Features

👨‍🏫 Teacher Mode

• ✅ Yangi test yaratish (Create Quiz)
• ✅ Savollar qo‘shish (MCQ, True/False, Short Answer)
• ✅ Savollarga vaqt chegarasi o‘rnatish
• ✅ JSON formatda saqlash
• ✅ Testni ko‘rish, faollashtirish/yopish, o‘chirish (Manage Quizzes)

👨‍🎓 Student Mode

• ✅ Faol testlar ro‘yxatidan tanlash
• ✅ Har bir savolga javob berish (interaktiv)
• ✅ Savol turi bo‘yicha ball baholash
• ✅ Vaqt tugaganda yarim ball berish
• ✅ Umumiy bahoni ko‘rsatish (% va Pass/Fail)

---

🌐 Technologies Used

• C# 10 / .NET 6+ – zamonaviy C# sintaksisi va .NET platformasi asosida qurilgan.
• Spectre.Console – foydalanuvchiga interaktiv va rangli konsol interfeysi taqdim etish uchun ishlatilgan.
• System.Text.Json – quiz va savollarni .json formatida saqlash va o‘qish uchun ishlatilgan.
• System.IO – fayllarni yaratish, o‘chirish, saqlash va o‘qish amallarini bajarish uchun.
• Polymorphic JSON Serialization – Question klasining MCQ, TrueFalse, ShortAnswer merosxo‘rlar bilan JsonPolymorphic orqali moslashuvchan serializatsiya.

---

📌 Example Code Snippet

Quyidagi kod yangi QuizMeta obyektini JSON faylga saqlash jarayonini ko‘rsatadi. Fayl nomi avtomatik tarzda sarlavhaga asoslanadi va mavjud bo‘lsa, ustiga yoziladi:

public static void SaveQuiz(QuizMeta quiz, string quizzesDirectory)
{
    if (quiz == null || string.IsNullOrWhiteSpace(quiz.Title))
    {
        AnsiConsole.MarkupLine("[red]Invalid quiz data![/]");
        return;
    }

    string sanitizedTitle = string.Join("_", quiz.Title.Split(Path.GetInvalidFileNameChars()));
    string filePath = Path.Combine(quizzesDirectory, sanitizedTitle + ".json");

    var options = new JsonSerializerOptions
    {
        WriteIndented = true,
        DefaultIgnoreCondition = JsonIgnoreCondition.WhenWritingNull,
        Encoder = JavaScriptEncoder.UnsafeRelaxedJsonEscaping
    };

    try
    {
        string json = JsonSerializer.Serialize(quiz, options);
        File.WriteAllText(filePath, json);
        AnsiConsole.MarkupLine("[green]Quiz saved successfully![/]");
    }
    catch (Exception ex)
    {
        AnsiConsole.MarkupLine($"[red]Error saving quiz: {ex.Message}[/]");
    }
}

Ushbu kod quyidagilarni o‘z ichiga oladi:

• ✅ Fayl nomini tozalash: Path.GetInvalidFileNameChars() yordamida fayl nomidan yaroqsiz belgilar olib tashlanadi.
• ✅ JSON formatga mos ravishda serializatsiya qilish: System.Text.Json.JsonSerializer yordamida QuizMeta obyekt JSON formatga o‘tkaziladi.
• ✅ Faylga yozish: File.WriteAllText() orqali JSON fayl diskka yoziladi.
• ✅ Foydalanuvchiga natijani ko‘rsatish: Spectre.Console orqali saqlash jarayoni muvaffaqiyatli yoki xato bo‘lganini rangli terminal xabarlari orqali bildiriladi.

Bu funksiya QuizBuilder.cs faylining oxirida joylashgan va o‘qituvchi rejimidagi "Save Quiz" jarayonida ishlatiladi.

---

🧠 Design Overview

flowchart LR
  subgraph Teacher_Mode
    Program --> QuizBuilder
    QuizBuilder --> QuizManager
  end

  subgraph Student_Mode
    Program --> QuizRunner
  end

  QuizBuilder -->|Creates| QuizMeta
  QuizManager -->|Manages| QuizMeta
  QuizRunner -->|Runs| QuizMeta
  QuizMeta --> Question
  Question --> McqQuestion
  Question --> TrueFalseQuestion
  Question --> ShortAnswerQuestion

Loading

---

🧾 JSON Format

Har bir test fayli Data/Quizzes/ papkada .json formatda saqlanadi. Savollar type maydoni bilan aniqlanadi:

{
  "Title": "C# Basics",
  "IsActive": true,
  "Questions": [
    {
      "type": "MCQ",
      "Prompt": "Which keyword defines a constant in C#?",
      "Options": {
        "A": "static",
        "B": "const",
        "C": "readonly",
        "D": "final"
      },
      "Answer": "B",
      "TimeLimitSeconds": 15
    }
  ]
}

---

📌 Example Screenshot (CLI)

Select application mode:
> Teacher Mode
  Student Mode
  Exit

---

📣 Summary

• 🔹 Interaktiv quiz yaratish va bajarish imkoniyati
• 🔹 JSON asosida test saqlash va o‘qish
• 🔹 Vaqtli savollar va baholash tizimi
• 🔹 C# OOP, fayl bilan ishlash, Spectre.Console tajribasi

---

💡 Tip

InputHelper.cs sinfi foydalanuvchi kirituvlarini validatsiya qilish, tanlovlar kiritish, vaqt so‘rash, va matn uzunligini cheklash funksiyalarini bajaradi. Masalan:

public static bool AskConfirmation(string message)
{
    return AnsiConsole.Prompt(
        new ConfirmationPrompt($"[yellow]{message} (Yes/No)?[/]")
    );
}

---

🏁 Finish

Ushbu loyiha C# asoslari, terminal ilova yaratish va OOP konsepsiyalarini mustahkamlash uchun zo‘r amaliy tajriba beradi. 👨‍💻

---