perform test

test to courses

Signed-off-by: Kenneth Obsequio <k80308392@gmail.com>

models/courses/assessment_session.mdl.js

@@ -0,0 +1,21 @@
+const { DataTypes } = require("sequelize");
+const sequelize = require("../../config/db.config");
+
+const AssessmentSession = sequelize.define("AssessmentSession", {
+  session_id:    { type: DataTypes.BIGINT, primaryKey: true, autoIncrement: true },
+  uuid:          { type: DataTypes.UUID, defaultValue: DataTypes.UUIDV4, unique: true },
+  user_id:       { type: DataTypes.BIGINT, allowNull: false },
+  assessment_id: { type: DataTypes.BIGINT, allowNull: false },
+  course_id:     { type: DataTypes.BIGINT, allowNull: true },
+  started_at:    { type: DataTypes.DATE, allowNull: false, defaultValue: DataTypes.NOW },
+  expires_at:    { type: DataTypes.DATE, allowNull: true },   // null = no time limit
+  status:        { type: DataTypes.STRING(20), allowNull: false, defaultValue: 'in_progress' }, // 'in_progress' | 'completed' | 'expired'
+  attempt_id:       { type: DataTypes.BIGINT, allowNull: true },  // FK → quiz_attempts once graded/expired
+  draft_answers:    { type: DataTypes.JSONB, allowNull: true, defaultValue: null },
+  last_heartbeat_at: { type: DataTypes.DATE, allowNull: true, defaultValue: null },
+}, {
+  tableName: "assessment_sessions",
+  timestamps: true,
+});
+
+module.exports = AssessmentSession;

models/courses/course_assessment.mdl.js

@@ -9,7 +9,9 @@ const CourseAssessment = sequelize.define("CourseAssessment", {
   is_required:   { type: DataTypes.BOOLEAN, defaultValue: false },
   passing_score: { type: DataTypes.INTEGER, defaultValue: 70 },
   time_limit_minutes: { type: DataTypes.INTEGER, allowNull: true }, // null = no limit
-  max_questions: { type: DataTypes.INTEGER, allowNull: true }, // null = show all
+  max_questions:  { type: DataTypes.INTEGER, allowNull: true },     // null = show all
+  max_attempts:   { type: DataTypes.INTEGER, defaultValue: 3 },     // failed attempts before cooldown
+  cooldown_hours: { type: DataTypes.INTEGER, defaultValue: 24 },    // hours locked after hitting max_attempts
   createdBy:     { type: DataTypes.BIGINT, allowNull: true },
   updatedBy:     { type: DataTypes.BIGINT, allowNull: true },
   deletedBy:     { type: DataTypes.BIGINT, allowNull: true },

models/courses/courses.associations.js

@@ -13,6 +13,7 @@ const QuizQuestion = require("./quiz_question.mdl");
 const QuizOption = require("./quiz_option.mdl");
 const mdl_Users = require("../users/users.mdl");
 const QuizAttempt = require("./quiz_attempt.mdl");
+const AssessmentSession       = require("./assessment_session.mdl");
 const mdl_Category            = require("./categories.mdl");
 const Certificate             = require("./certificate.mdl");
 const CourseInstructor        = require("./course_instructor.mdl");
@@ -79,12 +80,18 @@ QuizAttempt.belongsTo(mdl_Users, { as: "user", foreignKey: "user_id" });
 UnitQuiz.hasMany(QuizAttempt, { as: "attempts", foreignKey: "quiz_id" });
 CourseAssessment.hasMany(QuizAttempt, { as: "attempts", foreignKey: "assessment_id" });
 
+// ── AssessmentSession ─────────────────────────────────────────────────────────
+AssessmentSession.belongsTo(CourseAssessment, { as: "assessment", foreignKey: "assessment_id" });
+AssessmentSession.belongsTo(mdl_Users,        { as: "user",       foreignKey: "user_id" });
+CourseAssessment.hasMany(AssessmentSession,   { as: "sessions",   foreignKey: "assessment_id" });
+
 module.exports = {
     Course, CourseProductCategory,
     Unit, Lesson, LessonPage,
     CourseObjective, LessonObjective,
     CoursePrerequisite, CourseAssessment,
     UnitQuiz, QuizQuestion, QuizOption, QuizAttempt,
+    AssessmentSession,
     mdl_Category, Certificate, CourseInstructor,
     CourseReadingProgress,
 };

models/courses/pending_certificate.mdl.js

@@ -0,0 +1,34 @@
+/***********************************************************************************************************************************************************************
+ * File Name: pending_certificate.mdl.js
+ * Type of Program: Model
+ * Description: Holds certificates queued for issuance after a 45-minute delay
+ *              following a passed course assessment. The cron job
+ *              (cron/jobs/issue_certificates.cron.js) polls this table every
+ *              5 minutes and processes rows where issue_at <= NOW().
+ *
+ * Author: Kenneth Obsequio (@lash0000)
+ * Date Created: Jun. 24, 2026
+ ***********************************************************************************************************************************************************************/
+const { DataTypes } = require('sequelize');
+const sequelize     = require('../../config/db.config');
+
+const PendingCertificate = sequelize.define('PendingCertificate', {
+  pending_id:   { type: DataTypes.BIGINT,     primaryKey: true, autoIncrement: true },
+  user_id:      { type: DataTypes.BIGINT,     allowNull: false },
+  course_id:    { type: DataTypes.BIGINT,     allowNull: false },
+  course_uuid:  { type: DataTypes.STRING(36), allowNull: false },
+  course_title: { type: DataTypes.TEXT,       allowNull: true  },
+  passed_at:    { type: DataTypes.DATE,       allowNull: false },
+  issue_at:     { type: DataTypes.DATE,       allowNull: false },
+  processed_at: { type: DataTypes.DATE,       allowNull: true  },
+}, {
+  tableName:  'pending_certificates',
+  timestamps: true,
+  indexes: [
+    { fields: ['user_id'] },
+    { fields: ['issue_at'] },
+    { unique: true, fields: ['user_id', 'course_id'] },
+  ],
+});
+
+module.exports = PendingCertificate;