@octo-cyber/quiz-engine 0.5.0

package/dist/services/statistics.service.js

@@ -0,0 +1,134 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StatisticsService = void 0;
+const core_1 = require("@octo-cyber/core");
+const quiz_attempt_entity_js_1 = require("../entities/quiz-attempt.entity.js");
+const quiz_answer_entity_js_1 = require("../entities/quiz-answer.entity.js");
+const quiz_exam_entity_js_1 = require("../entities/quiz-exam.entity.js");
+const quiz_paper_entity_js_1 = require("../entities/quiz-paper.entity.js");
+let StatisticsService = class StatisticsService {
+    attemptRepo;
+    answerRepo;
+    examRepo;
+    paperRepo;
+    initialized = false;
+    initialize() {
+        const db = core_1.Container.get(core_1.DatabaseService);
+        this.attemptRepo = db.getRepository(quiz_attempt_entity_js_1.QuizAttempt);
+        this.answerRepo = db.getRepository(quiz_answer_entity_js_1.QuizAnswer);
+        this.examRepo = db.getRepository(quiz_exam_entity_js_1.QuizExam);
+        this.paperRepo = db.getRepository(quiz_paper_entity_js_1.QuizPaper);
+        this.initialized = true;
+    }
+    ensureInitialized() {
+        if (!this.initialized) {
+            try {
+                this.initialize();
+            }
+            catch {
+                throw new core_1.AppError('StatisticsService not initialized', 500);
+            }
+        }
+    }
+    async getExamStats(examId) {
+        this.ensureInitialized();
+        const exam = await this.examRepo.findOne({ where: { id: examId } });
+        if (!exam)
+            throw core_1.AppError.notFound('Exam not found');
+        const paper = await this.paperRepo.findOne({ where: { id: exam.paperId } });
+        const passingScore = paper?.passingScore ?? 60;
+        const attempts = await this.attemptRepo.find({ where: { examId } });
+        const graded = attempts.filter((a) => a.status === 'GRADED');
+        const submitted = attempts.filter((a) => a.status === 'SUBMITTED' || a.status === 'GRADED');
+        const scores = graded.map((a) => a.totalScore);
+        const averageScore = scores.length > 0
+            ? scores.reduce((s, v) => s + v, 0) / scores.length
+            : 0;
+        const highestScore = scores.length > 0 ? Math.max(...scores) : 0;
+        const lowestScore = scores.length > 0 ? Math.min(...scores) : 0;
+        const passCount = graded.filter((a) => a.isPassed || a.totalScore >= passingScore).length;
+        const passRate = graded.length > 0 ? passCount / graded.length : 0;
+        const distribution = this.buildScoreDistribution(scores, paper?.totalScore ?? 100);
+        return {
+            examId,
+            title: exam.title,
+            totalAttempts: attempts.length,
+            submittedAttempts: submitted.length,
+            gradedAttempts: graded.length,
+            averageScore: Math.round(averageScore * 10) / 10,
+            highestScore,
+            lowestScore,
+            passRate: Math.round(passRate * 100) / 100,
+            scoreDistribution: distribution,
+        };
+    }
+    async getUserStats(userId) {
+        this.ensureInitialized();
+        const attempts = await this.attemptRepo.find({
+            where: { userId },
+            order: { createdAt: 'DESC' },
+        });
+        const graded = attempts.filter((a) => a.status === 'GRADED');
+        const scores = graded.map((a) => a.totalScore);
+        const averageScore = scores.length > 0
+            ? scores.reduce((s, v) => s + v, 0) / scores.length
+            : 0;
+        const highestScore = scores.length > 0 ? Math.max(...scores) : 0;
+        const passCount = graded.filter((a) => a.isPassed).length;
+        return {
+            userId,
+            totalAttempts: attempts.length,
+            averageScore: Math.round(averageScore * 10) / 10,
+            highestScore,
+            passCount,
+            passRate: graded.length > 0 ? Math.round((passCount / graded.length) * 100) / 100 : 0,
+            recentAttempts: attempts.slice(0, 10),
+        };
+    }
+    async getRanking(examId, limit = 20) {
+        this.ensureInitialized();
+        const attempts = await this.attemptRepo.find({
+            where: { examId, status: 'GRADED' },
+            order: { totalScore: 'DESC' },
+        });
+        const seen = new Set();
+        const ranked = [];
+        let rank = 1;
+        for (const a of attempts) {
+            if (!seen.has(a.userId)) {
+                seen.add(a.userId);
+                ranked.push({ userId: a.userId, score: a.totalScore, rank: rank++ });
+            }
+            if (ranked.length >= limit)
+                break;
+        }
+        return ranked;
+    }
+    buildScoreDistribution(scores, totalScore) {
+        const buckets = [
+            { label: '0-59', min: 0, max: 59 },
+            { label: '60-69', min: 60, max: 69 },
+            { label: '70-79', min: 70, max: 79 },
+            { label: '80-89', min: 80, max: 89 },
+            { label: '90-100', min: 90, max: 100 },
+        ];
+        return buckets.map(({ label, min, max }) => ({
+            range: label,
+            count: scores.filter((s) => {
+                const pct = totalScore > 0 ? (s / totalScore) * 100 : 0;
+                return pct >= min && pct <= max;
+            }).length,
+        }));
+    }
+};
+exports.StatisticsService = StatisticsService;
+exports.StatisticsService = StatisticsService = __decorate([
+    (0, core_1.Service)()
+], StatisticsService);
+//# sourceMappingURL=statistics.service.js.map

package/dist/services/statistics.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"statistics.service.js","sourceRoot":"","sources":["../../src/services/statistics.service.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,85 @@
+{
+  "name": "@octo-cyber/quiz-engine",
+  "version": "0.5.0",
+  "description": "Octo quiz engine module — question bank, smart paper generation, online exam, auto grading, statistics",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./web": {
+      "types": "./web/index.ts",
+      "import": "./web/index.ts",
+      "default": "./web/index.ts"
+    },
+    "./web/pages/*": {
+      "types": "./web/pages/*.tsx",
+      "import": "./web/pages/*.tsx",
+      "default": "./web/pages/*.tsx"
+    }
+  },
+  "dependencies": {
+    "zod": "^3.24.0",
+    "@octo-cyber/core": "^0.5.4",
+    "@octo-cyber/auth": "^0.5.6"
+  },
+  "peerDependencies": {
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "next-intl": "^4.0.0",
+    "lucide-react": ">=0.400.0",
+    "sonner": "^2.0.0",
+    "zustand": "^5.0.0",
+    "@octo-cyber/ui": "^0.5.3",
+    "@octo-cyber/layout": "^0.5.2"
+  },
+  "peerDependenciesMeta": {
+    "@octo-cyber/ui": {
+      "optional": true
+    },
+    "@octo-cyber/layout": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    },
+    "next-intl": {
+      "optional": true
+    },
+    "lucide-react": {
+      "optional": true
+    },
+    "sonner": {
+      "optional": true
+    },
+    "zustand": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "typescript": "^5.8.0",
+    "vitest": "^3.0.0"
+  },
+  "files": [
+    "dist",
+    "web"
+  ],
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/web/index.ts

@@ -0,0 +1,51 @@
+/**
+ * @octo-cyber/quiz-engine — Frontend entry point.
+ */
+
+// Manifest
+export { quizEngineFrontendManifest } from './manifest'
+
+// Pages
+export { default as QuestionBankPage } from './pages/QuestionBankPage'
+export { default as PapersPage } from './pages/PapersPage'
+export { default as ExamsPage } from './pages/ExamsPage'
+export { default as ExamRoomPage } from './pages/ExamRoomPage'
+export { default as StatisticsPage } from './pages/StatisticsPage'
+
+// Services
+export { categoryApi } from './services/category-service'
+export { questionApi } from './services/question-service'
+export { paperApi } from './services/paper-service'
+export { examApi } from './services/exam-service'
+export { attemptApi } from './services/attempt-service'
+export { statisticsApi } from './services/statistics-service'
+
+// Store
+export { useQuizStore } from './stores/quiz-store'
+
+// Types
+export type {
+  QuizCategory,
+  QuizQuestion,
+  QuestionType,
+  QuizOption,
+  QuizPaper,
+  PaperStatus,
+  QuizPaperQuestion,
+  PaperWithQuestions,
+  QuizExam,
+  ExamStatus,
+  QuizAttempt,
+  AttemptStatus,
+  QuizAnswer,
+  AttemptDetail,
+  PaginatedResponse,
+  ExamStats,
+  UserStats,
+  RankingEntry,
+  SmartGenerateRule,
+} from './types/quiz'
+
+// i18n messages
+export { default as quizEngineMessagesZhCN } from './messages/zh-CN.json'
+export { default as quizEngineMessagesEnUS } from './messages/en-US.json'

package/web/manifest.ts

@@ -0,0 +1,36 @@
+import type { IFrontendManifest } from '@octo-cyber/core';
+
+export const quizEngineFrontendManifest: IFrontendManifest = {
+  moduleId: 'quiz-engine',
+  icon: 'GraduationCap',
+  color: 'violet',
+  position: 'main',
+  titleKey: 'quizEngine.title',
+  descriptionKey: 'quizEngine.description',
+  pages: [
+    {
+      path: '/quiz/questions',
+      titleKey: 'quizEngine.pages.questionBank',
+      icon: 'BookOpen',
+      component: '@octo-cyber/quiz-engine/web/pages/QuestionBankPage',
+    },
+    {
+      path: '/quiz/papers',
+      titleKey: 'quizEngine.pages.papers',
+      icon: 'FileText',
+      component: '@octo-cyber/quiz-engine/web/pages/PapersPage',
+    },
+    {
+      path: '/quiz/exams',
+      titleKey: 'quizEngine.pages.exams',
+      icon: 'ClipboardList',
+      component: '@octo-cyber/quiz-engine/web/pages/ExamsPage',
+    },
+    {
+      path: '/quiz/stats',
+      titleKey: 'quizEngine.pages.statistics',
+      icon: 'BarChart2',
+      component: '@octo-cyber/quiz-engine/web/pages/StatisticsPage',
+    },
+  ],
+};

package/web/messages/en-US.json

@@ -0,0 +1,143 @@
+{
+  "quizEngine": {
+    "title": "Online Exam",
+    "description": "Question bank, paper builder, online exams and result statistics",
+    "pages": {
+      "questionBank": "Question Bank",
+      "papers": "Papers",
+      "exams": "Exams",
+      "statistics": "Statistics"
+    },
+    "question": {
+      "title": "Question Bank",
+      "description": "Manage questions: single choice, multiple choice, true/false, fill-blank, essay",
+      "create": "New Question",
+      "createTitle": "New Question",
+      "searchPlaceholder": "Search question content...",
+      "filterType": "Type",
+      "filterCategory": "Category",
+      "filterDifficulty": "Difficulty",
+      "noData": "No questions yet",
+      "createSuccess": "Question created",
+      "createFailed": "Failed to create question",
+      "deleteSuccess": "Question deleted",
+      "deleteFailed": "Failed to delete question",
+      "contentPlaceholder": "Enter question content (Markdown supported)...",
+      "types": {
+        "single_choice": "Single",
+        "multiple_choice": "Multiple",
+        "true_false": "T/F",
+        "fill_blank": "Fill",
+        "essay": "Essay"
+      },
+      "col": {
+        "type": "Type",
+        "content": "Content",
+        "difficulty": "Difficulty",
+        "score": "Score",
+        "useCount": "Used"
+      }
+    },
+    "paper": {
+      "title": "Papers",
+      "description": "Create and manage exam papers",
+      "create": "New Paper",
+      "createTitle": "New Paper",
+      "titlePlaceholder": "Enter paper title...",
+      "noData": "No papers yet",
+      "createSuccess": "Paper created",
+      "createFailed": "Failed to create paper",
+      "deleteSuccess": "Paper deleted",
+      "deleteFailed": "Failed to delete paper",
+      "publishSuccess": "Paper published",
+      "publishFailed": "Failed to publish paper",
+      "publish": "Publish",
+      "titleRequired": "Please enter a title",
+      "totalScore": "Total",
+      "passingScore": "Pass",
+      "timeLimit": "Time",
+      "statuses": {
+        "draft": "Draft",
+        "published": "Published",
+        "archived": "Archived"
+      },
+      "col": {
+        "title": "Title",
+        "description": "Description"
+      }
+    },
+    "exam": {
+      "title": "Exams",
+      "description": "Create exam sessions with time windows and rules",
+      "create": "New Exam",
+      "createTitle": "New Exam",
+      "noData": "No exams yet",
+      "createSuccess": "Exam created",
+      "createFailed": "Failed to create exam",
+      "deleteSuccess": "Exam deleted",
+      "deleteFailed": "Failed to delete exam",
+      "statusUpdated": "Status updated",
+      "updateFailed": "Update failed",
+      "formRequired": "Please fill required fields",
+      "selectPaper": "Select a paper",
+      "maxAttempts": "Max attempts",
+      "shuffleQuestions": "Shuffle questions",
+      "showAnswerAfterSubmit": "Show answers after submit",
+      "startTime": "Start time",
+      "endTime": "End time",
+      "schedule": "Schedule",
+      "start": "Start",
+      "end": "End",
+      "statuses": {
+        "draft": "Draft",
+        "scheduled": "Scheduled",
+        "ongoing": "Ongoing",
+        "ended": "Ended",
+        "cancelled": "Cancelled"
+      },
+      "col": {
+        "title": "Title",
+        "paper": "Paper",
+        "description": "Description"
+      }
+    },
+    "examRoom": {
+      "startFailed": "Failed to start exam, please try again",
+      "loadFailed": "Failed to load exam",
+      "submitted": "Exam submitted",
+      "yourScore": "Your score",
+      "passed": "Passed",
+      "failed": "Failed",
+      "question": "Q",
+      "score": "Score",
+      "answered": "Answered {count}/{total}",
+      "submit": "Submit",
+      "submitSuccess": "Submitted! Score: {score}",
+      "submitFailed": "Submit failed, please try again",
+      "confirmSubmitTitle": "Confirm Submit",
+      "confirmSubmitDesc": "You answered {answered}/{total} questions. Submit now?",
+      "trueLabel": "True",
+      "falseLabel": "False",
+      "fillBlankPlaceholder": "Fill in your answer...",
+      "essayPlaceholder": "Write your answer..."
+    },
+    "statistics": {
+      "title": "Statistics",
+      "description": "View exam statistics, score distribution and ranking",
+      "selectExam": "Select exam",
+      "selectExamHint": "Select an exam to view statistics",
+      "totalAttempts": "Participants",
+      "gradedAttempts": "Graded",
+      "averageScore": "Average",
+      "passRate": "Pass rate",
+      "highestScore": "Highest",
+      "lowestScore": "Lowest",
+      "scoreDistribution": "Score distribution",
+      "ranking": "Ranking",
+      "noRanking": "No ranking data",
+      "rank": "Rank",
+      "userId": "User",
+      "score": "Score"
+    }
+  }
+}

package/web/messages/zh-CN.json

@@ -0,0 +1,143 @@
+{
+  "quizEngine": {
+    "title": "在线考试",
+    "description": "题库管理、试卷组卷、在线考试与成绩统计",
+    "pages": {
+      "questionBank": "题库",
+      "papers": "试卷",
+      "exams": "考试",
+      "statistics": "成绩统计"
+    },
+    "question": {
+      "title": "题库管理",
+      "description": "管理题目，支持单选、多选、判断、填空、简答",
+      "create": "新建题目",
+      "createTitle": "新建题目",
+      "searchPlaceholder": "搜索题目内容...",
+      "filterType": "题型",
+      "filterCategory": "分类",
+      "filterDifficulty": "难度",
+      "noData": "暂无题目",
+      "createSuccess": "题目创建成功",
+      "createFailed": "题目创建失败",
+      "deleteSuccess": "题目已删除",
+      "deleteFailed": "题目删除失败",
+      "contentPlaceholder": "输入题目内容，支持 Markdown...",
+      "types": {
+        "single_choice": "单选",
+        "multiple_choice": "多选",
+        "true_false": "判断",
+        "fill_blank": "填空",
+        "essay": "简答"
+      },
+      "col": {
+        "type": "题型",
+        "content": "题目内容",
+        "difficulty": "难度",
+        "score": "分值",
+        "useCount": "使用次数"
+      }
+    },
+    "paper": {
+      "title": "试卷管理",
+      "description": "创建和管理试卷，支持智能组卷",
+      "create": "新建试卷",
+      "createTitle": "新建试卷",
+      "titlePlaceholder": "输入试卷标题...",
+      "noData": "暂无试卷",
+      "createSuccess": "试卷创建成功",
+      "createFailed": "试卷创建失败",
+      "deleteSuccess": "试卷已删除",
+      "deleteFailed": "试卷删除失败",
+      "publishSuccess": "试卷发布成功",
+      "publishFailed": "试卷发布失败",
+      "publish": "发布",
+      "titleRequired": "请输入试卷标题",
+      "totalScore": "总分",
+      "passingScore": "及格分",
+      "timeLimit": "时限",
+      "statuses": {
+        "draft": "草稿",
+        "published": "已发布",
+        "archived": "已归档"
+      },
+      "col": {
+        "title": "试卷名称",
+        "description": "描述"
+      }
+    },
+    "exam": {
+      "title": "考试管理",
+      "description": "创建考试活动，设置时间和规则",
+      "create": "新建考试",
+      "createTitle": "新建考试",
+      "noData": "暂无考试",
+      "createSuccess": "考试创建成功",
+      "createFailed": "考试创建失败",
+      "deleteSuccess": "考试已删除",
+      "deleteFailed": "考试删除失败",
+      "statusUpdated": "状态已更新",
+      "updateFailed": "更新失败",
+      "formRequired": "请填写必填项",
+      "selectPaper": "选择试卷",
+      "maxAttempts": "最大次数",
+      "shuffleQuestions": "随机题目顺序",
+      "showAnswerAfterSubmit": "提交后展示答案",
+      "startTime": "开始时间",
+      "endTime": "结束时间",
+      "schedule": "发布",
+      "start": "开始",
+      "end": "结束",
+      "statuses": {
+        "draft": "草稿",
+        "scheduled": "已发布",
+        "ongoing": "进行中",
+        "ended": "已结束",
+        "cancelled": "已取消"
+      },
+      "col": {
+        "title": "考试名称",
+        "paper": "试卷",
+        "description": "描述"
+      }
+    },
+    "examRoom": {
+      "startFailed": "开始考试失败，请重试",
+      "loadFailed": "加载考试信息失败",
+      "submitted": "答卷已提交",
+      "yourScore": "你的得分",
+      "passed": "通过",
+      "failed": "未通过",
+      "question": "第",
+      "score": "分值",
+      "answered": "已答 {count}/{total} 题",
+      "submit": "提交答卷",
+      "submitSuccess": "提交成功，得分: {score}",
+      "submitFailed": "提交失败，请重试",
+      "confirmSubmitTitle": "确认提交",
+      "confirmSubmitDesc": "你已完成 {answered}/{total} 题，确定提交吗？",
+      "trueLabel": "正确",
+      "falseLabel": "错误",
+      "fillBlankPlaceholder": "填写你的答案...",
+      "essayPlaceholder": "写下你的回答..."
+    },
+    "statistics": {
+      "title": "成绩统计",
+      "description": "查看考试统计、成绩分布和排名",
+      "selectExam": "选择考试",
+      "selectExamHint": "请选择考试查看统计",
+      "totalAttempts": "参与人数",
+      "gradedAttempts": "已阅卷",
+      "averageScore": "平均分",
+      "passRate": "通过率",
+      "highestScore": "最高分",
+      "lowestScore": "最低分",
+      "scoreDistribution": "成绩分布",
+      "ranking": "排行榜",
+      "noRanking": "暂无排名数据",
+      "rank": "排名",
+      "userId": "用户",
+      "score": "得分"
+    }
+  }
+}