• 01 - Overview
    • 02 - User Guide
    • 03 - Technical Guide
    • 04 - Operations
    • App
      • Get application hello response
    • Users
      • Kullanıcı profili
      • Update current user profile
      • Opsiyonel kimlik doğrulama
      • Tüm kullanıcıları listele
      • Get user by id (Admin)
      • Kullanıcı sil
      • Update user profile by id (Admin)
      • Update user email by id (Admin)
      • Update user role by id (Superadmin)
    • Auth
      • Token yenileme
      • Kullanıcı çıkışı
      • Request OTP (Login or Register)
      • Verify OTP (Login or Register)
      • Complete registration
      • Get registration status
    • Courses
      • Create a new course (Admin only)
      • Get all courses
      • Duplicate an existing course
      • Kurs detayını görüntüle
      • Update an existing course (Admin only)
      • Delete a course (Admin only)
    • Storage
      • Upload a file to storage
    • Proficiency Tests
      • Create a new proficiency test
      • List available proficiency tests
      • Duplicate an existing proficiency test
      • Update an existing proficiency test
      • Get test details
      • Delete proficiency test (Admin)
      • Get available target languages
      • Get detailed test result (Admin)
      • Delete test result (Admin)
      • Get all test results (Admin)
      • Get test results for a specific user (Admin)
      • Get current user results
      • Get detailed test result
      • Check if user has completed the test
      • Submit a proficiency test
    • Settings
      • Get setting by key
      • Create or update a setting (Admin)
    • Education Materials
      • Create a new education material with multiple PDFs and videos
      • List all education materials with optional locale filtering
      • Assign an education material to one or more users (Admin)
      • Get assigned education materials for current user
      • Get assigned education materials for a specific user (Admin)
      • Get detailed information about a specific education material
      • Update education material details and/or add new PDFs
      • Delete an education material
    • Contact
      • Submit a contact request
      • Get contact requests (Admin)
      • Reply to a contact request (Admin)
      • Delete a contact request (Admin)
      • Update contact status (Admin)
    • Admin Dashboard
      • Get aggregated dashboard metrics for admin panel
    • Schemas
      • UserDocument
      • BaseResponseDto
      • RequestOtpDto
      • VerifyOtpDto
      • HelloResponseDto
      • AuthResponseDto
      • UserProfileDto
      • UserProfileResponseDto
      • UserResponseDto
      • UpdateMeProfileDto
      • OptionalAuthResponseDto
      • PaginationDto
      • AdminUpdateUserProfileDto
      • AdminUpdateUserEmailDto
      • OtpResponseDto
      • UpdateUserRoleDto
      • DeleteResponseDto
      • RefreshTokenDto
      • LogoutResponseDto
      • RequestOtpUnifiedDto
      • VerifyOtpUnifiedDto
      • CompleteRegistrationResponseDto
      • CompleteRegistrationDto
      • RegistrationStatusResponseDto
      • CourseResponseDto
      • UploadFileResponseDto
      • LevelRangeResponseDto
      • ProficiencyOptionResponseDto
      • ProficiencyQuestionResponseDto
      • ProficiencyTestDetailResponseDto
      • OptionDto
      • QuestionDto
      • LevelRangeDto
      • CreateProficiencyTestDto
      • UpdateProficiencyTestDto
      • ProficiencyTestListResponseDto
      • TargetLanguagesResponseDto
      • UserTestAnswerResponseDto
      • UserTestResultUserSummaryDto
      • UserTestResultTestSummaryDto
      • UserTestResultResponseDto
      • DeleteUserTestResultResponseDto
      • UserTestResultListResponseDto
      • UserTestStatusSummaryDto
      • UserTestStatusResponseDto
      • DeleteProficiencyTestResponseDto
      • AnswerDto
      • SubmitTestDto
      • SettingValueResponseDto
      • SettingResponseDto
      • UpsertSettingDto
      • MaterialPdfResponseDto
      • MaterialVideoResponseDto
      • EducationMaterialResponseDto
      • CreateEducationMaterialDto
      • AssignEducationMaterialSummaryDto
      • AssignEducationMaterialDto
      • AssignedByResponseDto
      • AssignedEducationMaterialResponseDto
      • MyAssignedEducationMaterialsResponseDto
      • UserSummaryForAssignmentsDto
      • AdminUserAssignedMaterialsResponseDto
      • UpdateEducationMaterialDto
      • DeleteEducationMaterialResponseDto
      • ContactResponseDto
      • CreateContactRequestDto
      • ReplyContactRequestDto
      • UpdateContactStatusRequestDto
      • DashboardUsersOverviewDto
      • DashboardCoursesOverviewDto
      • DashboardTestsOverviewDto
      • DashboardContactsOverviewDto
      • DashboardMaterialsOverviewDto
      • DashboardOverviewDto
      • DashboardTrendDto
      • DashboardDistributionItemDto
      • DashboardLevelDistributionItemDto
      • DashboardLanguageDistributionItemDto
      • DashboardDistributionsDto
      • DashboardRecentContactDto
      • DashboardRecentResultDto
      • DashboardRecentActivityDto
      • AdminDashboardStatsResponseDto

    AdminDashboardStatsResponseDto

    {
        "generatedAt": "2026-02-14T08:21:20.120Z",
        "months": 6,
        "overview": {
            "users": {
                "total": 1500,
                "admins": 15,
                "registrationCompleted": 1280,
                "completionRate": 85.33,
                "newLast30Days": 54,
                "monthlyGrowthRate": 8.2
            },
            "courses": {
                "total": 42
            },
            "tests": {
                "totalTests": 28,
                "totalSubmissions": 2048,
                "averageScore": 71.2,
                "submissionsLast30Days": 176,
                "monthlyGrowthRate": 6.5
            },
            "contacts": {
                "total": 340,
                "pending": 58,
                "replied": 282,
                "replyRate": 82.94,
                "newLast30Days": 23
            },
            "materials": {
                "total": 60,
                "assignments": 812,
                "assignedUsers": 403,
                "avgAssignmentsPerUser": 2.01,
                "assignmentsLast30Days": 91
            }
        },
        "trends": [
            {
                "month": "2026-02",
                "label": "Feb 2026",
                "users": 120,
                "testSubmissions": 87,
                "contacts": 16,
                "materialAssignments": 43
            }
        ],
        "distributions": {
            "roles": [
                {
                    "key": "user",
                    "label": "User",
                    "count": 42,
                    "percentage": 66.67
                }
            ],
            "contactsByStatus": [
                {
                    "key": "user",
                    "label": "User",
                    "count": 42,
                    "percentage": 66.67
                }
            ],
            "levels": [
                {
                    "key": "user",
                    "label": "User",
                    "count": 42,
                    "percentage": 66.67,
                    "averageScore": 72.5
                }
            ],
            "languages": [
                {
                    "key": "en",
                    "label": "EN",
                    "submissions": 124,
                    "averageScore": 69.2
                }
            ]
        },
        "recentActivity": {
            "contacts": [
                {
                    "id": "67aeef90b2c7d32d4f6f4f11",
                    "fullName": "John Doe",
                    "email": "john@example.com",
                    "status": "PENDING",
                    "createdAt": "2026-02-14T08:21:20.120Z",
                    "repliedAt": "2026-02-14T08:45:10.903Z",
                    "source": "instagram"
                }
            ],
            "testResults": [
                {
                    "id": "67aeef90b2c7d32d4f6f4f12",
                    "userName": "John Doe",
                    "userEmail": "john@example.com",
                    "level": "B2",
                    "totalScore": 78,
                    "targetLanguage": "en",
                    "testTitle": "English Placement Test",
                    "completedAt": "2026-02-14T08:21:20.120Z"
                }
            ]
        }
    }
    Built with