initial

models/users/user_groups.mdl.js

@@ -0,0 +1,70 @@
+/***********************************************************************************************************************************************************************
+ * File Name: user_groups.mdl.js
+ * Type of Program: Model
+ * Description: Sequelize models for `user_groups` and `user_group_members` tables.
+ *              Implements a Many-to-Many self-contained group system.
+ *              Groups are used as named permission bundles.
+ * Author: rgrgogu
+ * Date Created: Oct. 6, 2025
+ ***********************************************************************************************************************************************************************
+ * HOW TO USE:
+ *   const { mdl_UserGroups, mdl_UserGroupMembers } = require('./models/user_groups.mdl');
+ ***********************************************************************************************************************************************************************/
+const { DataTypes } = require('sequelize');
+const sequelize = require('../../config/db.config');
+const mdl_Users = require('./users.mdl');
+
+// ─── UserGroups ────────────────────────────────────────────────────────────────
+const mdl_UserGroups = sequelize.define('UserGroup', {
+  group_id: { type: DataTypes.BIGINT, primaryKey: true, autoIncrement: true },
+  name: { type: DataTypes.STRING(50), allowNull: false },
+  description: { type: DataTypes.TEXT },
+  is_active: { type: DataTypes.BOOLEAN, defaultValue: true },
+
+  // ── Audit trails ────────────────────────────────────────────────────────────
+  createdBy: { type: DataTypes.BIGINT, allowNull: true, label: "Created By" },
+  updatedBy: { type: DataTypes.BIGINT, allowNull: true, label: "Modified By" },
+  deletedBy: { type: DataTypes.BIGINT, allowNull: true, label: "Deleted By" },
+}, {
+  tableName: 'user_groups',
+  timestamps: true,
+  paranoid: true,
+});
+
+// ─── Junction: UserGroupMembers ────────────────────────────────────────────────
+const mdl_UserGroupMembers = sequelize.define('UserGroupMember', {
+  group_id: { type: DataTypes.BIGINT, primaryKey: true },
+  user_id: { type: DataTypes.BIGINT, primaryKey: true },
+  joined_at: { type: DataTypes.DATE, defaultValue: DataTypes.NOW },
+
+  // ── Audit trails ────────────────────────────────────────────────────────────
+  createdBy: { type: DataTypes.BIGINT, allowNull: true, label: "Created By" },
+  updatedBy: { type: DataTypes.BIGINT, allowNull: true, label: "Modified By" },
+  deletedBy: { type: DataTypes.BIGINT, allowNull: true, label: "Deleted By" },
+}, {
+  tableName: 'user_group_members',
+  timestamps: true,
+  paranoid: true,
+});
+
+// ─── Associations ──────────────────────────────────────────────────────────────
+mdl_Users.belongsToMany(mdl_UserGroups, { through: mdl_UserGroupMembers, foreignKey: 'user_id', otherKey: 'group_id', as: 'groups' });
+mdl_UserGroups.belongsToMany(mdl_Users, { through: mdl_UserGroupMembers, foreignKey: 'group_id', otherKey: 'user_id', as: 'members', });
+
+mdl_UserGroups.hasMany(mdl_UserGroupMembers, { foreignKey: 'group_id' });
+mdl_UserGroupMembers.belongsTo(mdl_UserGroups, { foreignKey: 'group_id' });
+
+mdl_Users.hasMany(mdl_UserGroupMembers, { foreignKey: 'user_id' });
+mdl_UserGroupMembers.belongsTo(mdl_Users, { foreignKey: 'user_id' });
+
+// models/users/user_groups.mdl.js — add at the bottom
+mdl_UserGroups.belongsTo(mdl_Users, { as: 'creator', foreignKey: 'createdBy' });
+mdl_UserGroups.belongsTo(mdl_Users, { as: 'modifier', foreignKey: 'updatedBy' });
+mdl_UserGroups.belongsTo(mdl_Users, { as: 'deleter', foreignKey: 'deletedBy' });
+
+// Self-referencing associations for audit fields
+mdl_Users.belongsTo(mdl_Users, { as: 'creator', foreignKey: 'createdBy' });
+mdl_Users.belongsTo(mdl_Users, { as: 'modifier', foreignKey: 'updatedBy' });
+mdl_Users.belongsTo(mdl_Users, { as: 'deleter', foreignKey: 'deletedBy' });
+
+module.exports = { mdl_UserGroups, mdl_UserGroupMembers };