starr-philproperties/apps/api/database/migrations/20270101000049-create-lesson-reading-progress.js

'use strict';

// course_id and unit_id are nullable — the junction revamp (20260707000001)
// allows standalone (course-less / unit-less) lesson reads.
module.exports = {
  async up(queryInterface, Sequelize) {
    await queryInterface.createTable('lesson_reading_progress', {
      progress_id:      { type: Sequelize.UUID, defaultValue: Sequelize.UUIDV4, primaryKey: true },
      user_id:          { type: Sequelize.BIGINT, allowNull: false, references: { model: 'users',   key: 'user_id'   }, onDelete: 'CASCADE' },
      course_id:        { type: Sequelize.BIGINT, allowNull: true,  references: { model: 'courses', key: 'course_id' }, onDelete: 'CASCADE' },
      unit_id:          { type: Sequelize.BIGINT, allowNull: true,  references: { model: 'units',   key: 'unit_id'   }, onDelete: 'CASCADE' },
      lesson_id:        { type: Sequelize.BIGINT, allowNull: false, references: { model: 'lessons', key: 'lesson_id' }, onDelete: 'CASCADE' },
      status:           { type: Sequelize.ENUM('in_progress', 'completed'), allowNull: false, defaultValue: 'in_progress' },
      completed_at:     { type: Sequelize.DATE, allowNull: true },
      last_accessed_at: { type: Sequelize.DATE, allowNull: false, defaultValue: Sequelize.literal('CURRENT_TIMESTAMP') },
      createdBy:        { type: Sequelize.BIGINT, allowNull: true },
      updatedBy:        { type: Sequelize.BIGINT, allowNull: true },
      createdAt:        { type: Sequelize.DATE, allowNull: false },
      updatedAt:        { type: Sequelize.DATE, allowNull: false },
    });

    await queryInterface.addIndex('lesson_reading_progress', {
      fields: ['user_id', 'lesson_id'],
      unique: true,
      name:   'uq_lrp_user_lesson',
    });

    await queryInterface.addIndex('lesson_reading_progress', { fields: ['user_id'],   name: 'idx_lrp_user_id'   });
    await queryInterface.addIndex('lesson_reading_progress', { fields: ['course_id'], name: 'idx_lrp_course_id' });
    await queryInterface.addIndex('lesson_reading_progress', { fields: ['unit_id'],   name: 'idx_lrp_unit_id'   });
    await queryInterface.addIndex('lesson_reading_progress', { fields: ['lesson_id'], name: 'idx_lrp_lesson_id' });
    await queryInterface.addIndex('lesson_reading_progress', { fields: ['status'],    name: 'idx_lrp_status'    });
  },

  async down(queryInterface) {
    await queryInterface.dropTable('lesson_reading_progress');
  },
};