Feat 83 recording (socket profiler recording & replay)

.gitignore

@@ -14,6 +14,7 @@ backend/sessions
 backend/node_modules
 backend/logs
 backend/coverage
+logs/
 
 # ignore build files
 dist/
@@ -47,4 +48,4 @@ utils/rpcs/moodleAPI/moodle_api/__pycache__
 *.pyc 
 email-mappings.py
 gitleaks-clean.sh
-.mailmap
+.mailmap.DS_Store

backend/db/migrations/20260322000001-extend-nav-socket-profiler.js

@@ -0,0 +1,50 @@
+'use strict';
+
+const navElements = [
+  {
+    name: "Socket Profiler",
+    groupId: "Admin",
+    icon: "record-circle",
+    order: 16,
+    admin: true,
+    path: "Socket_Profiler",
+    component: "SocketProfiler",
+  }
+];
+
+/** @type {import('sequelize-cli').Migration} */
+module.exports = {
+  async up(queryInterface, Sequelize) {
+    await queryInterface.bulkInsert(
+      "nav_element",
+      await Promise.all(
+        navElements.map(async (t) => {
+          const groupId = await queryInterface.rawSelect(
+            "nav_group",
+            {
+              where: { name: t.groupId },
+            },
+            ["id"]
+          );
+
+          t["createdAt"] = new Date();
+          t["updatedAt"] = new Date();
+          t["groupId"] = groupId;
+
+          return t;
+        }),
+        {}
+      )
+    );
+  },
+
+  async down(queryInterface, Sequelize) {
+    await queryInterface.bulkDelete(
+      "nav_element",
+      {
+        name: navElements.map((t) => t.name),
+      },
+      {}
+    );
+  },
+};

backend/db/migrations/20260412231117-create-recording.js

@@ -0,0 +1,82 @@
+'use strict';
+
+module.exports = {
+  async up(queryInterface, Sequelize) {
+    await queryInterface.createTable('recording', {
+      id: {
+        type: Sequelize.INTEGER,
+        primaryKey: true,
+        autoIncrement: true,
+        allowNull: false,
+      },
+      name: {
+        type: Sequelize.STRING,
+        allowNull: true,
+      },
+      status: {
+        type: Sequelize.STRING,
+        allowNull: false,
+        defaultValue: 'recording',
+      },
+      startTime: {
+        type: Sequelize.DATE,
+        allowNull: true,
+        defaultValue: null,
+      },
+      endTime: {
+        type: Sequelize.DATE,
+        allowNull: true,
+        defaultValue: null,
+      },
+      userId: {
+        type: Sequelize.INTEGER,
+        allowNull: false,
+        references: {
+          model: 'user',
+          key: 'id',
+        },
+        onDelete: 'CASCADE',
+        onUpdate: 'CASCADE',
+      },
+      participantUserIds: {
+        type: Sequelize.JSONB,
+        allowNull: true,
+        defaultValue: null,
+      },
+      participantSocketIds: {
+        type: Sequelize.JSONB,
+        allowNull: true,
+        defaultValue: null,
+      },
+      excludeEvents: {
+        type: Sequelize.JSONB,
+        allowNull: true,
+        defaultValue: null,
+      },
+      deleted: {
+        type: Sequelize.BOOLEAN,
+        allowNull: false,
+        defaultValue: false,
+      },
+      deletedAt: {
+        type: Sequelize.DATE,
+        allowNull: true,
+        defaultValue: null,
+      },
+      createdAt: {
+        type: Sequelize.DATE,
+        allowNull: false,
+        defaultValue: Sequelize.fn('NOW'),
+      },
+      updatedAt: {
+        type: Sequelize.DATE,
+        allowNull: false,
+        defaultValue: Sequelize.fn('NOW'),
+      },
+    });
+  },
+
+  async down(queryInterface, Sequelize) {
+    await queryInterface.dropTable('recording');
+  },
+};

backend/db/migrations/20260412231119-create-trace.js

@@ -0,0 +1,86 @@
+'use strict';
+
+module.exports = {
+  async up(queryInterface, Sequelize) {
+    await queryInterface.createTable('trace', {
+      id: {
+        type: Sequelize.INTEGER,
+        primaryKey: true,
+        autoIncrement: true,
+        allowNull: false,
+      },
+      recordingId: {
+        type: Sequelize.INTEGER,
+        allowNull: false,
+        references: {
+          model: 'recording',
+          key: 'id',
+        },
+        onDelete: 'CASCADE',
+        onUpdate: 'CASCADE',
+      },
+      userId: {
+        type: Sequelize.INTEGER,
+        allowNull: true,
+        references: {
+          model: 'user',
+          key: 'id',
+        },
+        onDelete: 'SET NULL',
+        onUpdate: 'CASCADE',
+      },
+      socketId: {
+        type: Sequelize.STRING,
+        allowNull: true,
+      },
+      action: {
+        type: Sequelize.STRING,
+        allowNull: false,
+      },
+      payload: {
+        type: Sequelize.JSONB,
+        allowNull: true,
+      },
+      direction: {
+        type: Sequelize.BOOLEAN,
+        allowNull: false,
+      },
+      startTime: {
+        type: Sequelize.DATE,
+        allowNull: true,
+      },
+      endTime: {
+        type: Sequelize.DATE,
+        allowNull: true,
+      },
+      deleted: {
+        type: Sequelize.BOOLEAN,
+        allowNull: false,
+        defaultValue: false,
+      },
+      deletedAt: {
+        type: Sequelize.DATE,
+        allowNull: true,
+        defaultValue: null,
+      },
+      createdAt: {
+        type: Sequelize.DATE,
+        allowNull: false,
+        defaultValue: Sequelize.fn('NOW'),
+      },
+      updatedAt: {
+        type: Sequelize.DATE,
+        allowNull: false,
+        defaultValue: Sequelize.fn('NOW'),
+      },
+    });
+
+    await queryInterface.addIndex('trace', ['socketId'], {
+      name: 'trace_socketId_idx',
+    });
+  },
+
+  async down(queryInterface, Sequelize) {
+    await queryInterface.dropTable('trace');
+  },
+};

backend/db/migrations/20260506220447-move-socket-profiler-to-manage.js

@@ -0,0 +1,51 @@
+'use strict';
+
+/**
+ * Move Socket Profiler nav element into the Manage group.
+ *
+ * The original `extend-nav-socket-profiler` migration (March 22, 2026)
+ * inserted Socket Profiler into groupId 2 (Admin). The later
+ * `restructure-nav_group` migration (April 25, 2026) replaced the old
+ * Admin-centric layout with category-based groups (Home, Study, Manage,
+ * Settings, AI), but didn't touch Socket Profiler because it lived on
+ * a separate feature branch at the time.
+ *
+ * After merge, Socket Profiler ends up stranded in the legacy Admin group.
+ * This migration relocates it into Manage, alongside other admin
+ * operational tools like Users.
+ */
+module.exports = {
+    async up(queryInterface, Sequelize) {
+        // Look up Manage group's id by name (don't hard-code 5; safer if IDs ever shift).
+        const [groups] = await queryInterface.sequelize.query(
+            `SELECT id FROM nav_group WHERE name = 'Manage' LIMIT 1`
+        );
+        if (!groups || groups.length === 0) {
+            // Manage group missing — bail out silently rather than failing migration.
+            return;
+        }
+        const manageId = groups[0].id;
+
+        await queryInterface.sequelize.query(
+            `UPDATE nav_element SET "groupId" = :manageId, "updatedAt" = NOW()
+             WHERE name = 'Socket Profiler'`,
+            { replacements: { manageId } }
+        );
+    },
+
+    async down(queryInterface, Sequelize) {
+        // Revert to the legacy Admin group (id 2 in the pre-restructure schema).
+        // If Admin no longer exists for any reason, do nothing.
+        const [groups] = await queryInterface.sequelize.query(
+            `SELECT id FROM nav_group WHERE name = 'Admin' LIMIT 1`
+        );
+        if (!groups || groups.length === 0) return;
+        const adminId = groups[0].id;
+
+        await queryInterface.sequelize.query(
+            `UPDATE nav_element SET "groupId" = :adminId, "updatedAt" = NOW()
+             WHERE name = 'Socket Profiler'`,
+            { replacements: { adminId } }
+        );
+    },
+};

backend/db/models/recording.js

@@ -0,0 +1,45 @@
+"use strict";
+const MetaModel = require("../MetaModel.js");
+
+module.exports = (sequelize, DataTypes) => {
+    class Recording extends MetaModel {
+        static autoTable = true;
+        static fields = [];
+        static publicTable = true;
+
+        static associate(models) {
+            Recording.belongsTo(models["user"], {
+                foreignKey: "userId",
+                as: "user",
+            });
+            Recording.hasMany(models["trace"], {
+                foreignKey: "recordingId",
+                as: "traces",
+            });
+        }
+    }
+
+    Recording.init(
+        {
+            name: DataTypes.STRING,
+            status: DataTypes.STRING,
+            startTime: DataTypes.DATE,
+            endTime: DataTypes.DATE,
+            userId: DataTypes.INTEGER,
+            participantUserIds: DataTypes.JSONB,
+            participantSocketIds: DataTypes.JSONB,
+            excludeEvents: DataTypes.JSONB,
+            deleted: DataTypes.BOOLEAN,
+            deletedAt: DataTypes.DATE,
+            createdAt: DataTypes.DATE,
+            updatedAt: DataTypes.DATE,
+        },
+        {
+            sequelize,
+            modelName: "recording",
+            tableName: "recording",
+        }
+    );
+
+    return Recording;
+};

backend/db/models/trace.js

@@ -0,0 +1,45 @@
+"use strict";
+const MetaModel = require("../MetaModel.js");
+
+module.exports = (sequelize, DataTypes) => {
+    class Trace extends MetaModel {
+        static autoTable = true;
+        static fields = [];
+        static publicTable = false;
+
+        static associate(models) {
+            Trace.belongsTo(models["recording"], {
+                foreignKey: "recordingId",
+                as: "recording",
+            });
+            Trace.belongsTo(models["user"], {
+                foreignKey: "userId",
+                as: "user",
+            });
+        }
+    }
+
+    Trace.init(
+        {
+            recordingId: DataTypes.INTEGER,
+            userId: DataTypes.INTEGER,
+            socketId: DataTypes.STRING,
+            action: DataTypes.STRING,
+            payload: DataTypes.JSONB,
+            direction: DataTypes.BOOLEAN,
+            startTime: DataTypes.DATE,
+            endTime: DataTypes.DATE,
+            deleted: DataTypes.BOOLEAN,
+            deletedAt: DataTypes.DATE,
+            createdAt: DataTypes.DATE,
+            updatedAt: DataTypes.DATE,
+        },
+        {
+            sequelize,
+            modelName: "trace",
+            tableName: "trace",
+        }
+    );
+
+    return Trace;
+};