feat(role): enhance Role schema with permissions and system flags

- Add new fields to Role schema:
  - description (String, optional)
  - permissions (Array of Permission ObjectIds)
  - isSystem (Boolean) for system-level roles
- Update validation schemas for create and update operations
- Add ObjectId validation for permission references

Author: foyzulkarim

src/domains/role/request.js

@@ -3,12 +3,32 @@ const mongoose = require('mongoose');
 
 const createSchema = Joi.object().keys({
   name: Joi.string().required(),
-  displayName: Joi.string().required()
+  displayName: Joi.string().required(),
+  description: Joi.string().allow('').optional(),
+  permissions: Joi.array().items(
+    Joi.string().custom((value, helpers) => {
+      if (!mongoose.Types.ObjectId.isValid(value)) {
+        return helpers.error('any.invalid');
+      }
+      return value;
+    }, 'ObjectId validation')
+  ).optional(),
+  isSystem: Joi.boolean().default(false)
 });
 
 const updateSchema = Joi.object().keys({
   name: Joi.string(),
-  displayName: Joi.string()
+  displayName: Joi.string(),
+  description: Joi.string().allow(''),
+  permissions: Joi.array().items(
+    Joi.string().custom((value, helpers) => {
+      if (!mongoose.Types.ObjectId.isValid(value)) {
+        return helpers.error('any.invalid');
+      }
+      return value;
+    }, 'ObjectId validation')
+  ),
+  isSystem: Joi.boolean()
 });
 
 const idSchema = Joi.object().keys({

src/domains/role/schema.js

@@ -12,6 +12,18 @@ const schema = new mongoose.Schema({
   displayName: {
     type: String,
     required: true,
+  },
+  description: {
+    type: String,
+    default: '',
+  },
+  permissions: [{
+    type: mongoose.Schema.Types.ObjectId,
+    ref: 'Permission'
+  }],
+  isSystem: {
+    type: Boolean,
+    default: false  // To mark system-level roles like 'superadmin'
   }
 });