feat(docs): Enhance API documentation for AssignMenusToRole and RemoveMenusFromRole endpoints

modules/role/controller/role_controller.go

@@ -38,7 +38,17 @@ type (
 	}
 )
 
-// AssignMenusToRole implements RoleController.
+// AssignMenusToRole godoc
+// @Summary      Assign menus to role
+// @Description  Assign menus to a role by role ID.
+// @Tags         Roles
+// @Accept       json
+// @Produce      json
+// @Param        id    path      string                      true  "Role ID"
+// @Param        body  body      dto.AssignMenuRequest true  "Assign menus payload"
+// @Success      200   {object}  map[string]interface{}
+// @Failure      400   {object}  map[string]interface{}
+// @Router       /roles/{id}/assign-menus [post]
 func (r *roleController) AssignMenusToRole(ctx *gin.Context) {
 	id := ctx.Param("id")
 	var req dto.AssignMenuRequest
@@ -56,7 +66,17 @@ func (r *roleController) AssignMenusToRole(ctx *gin.Context) {
 	ctx.JSON(http.StatusOK, res)
 }
 
-// RemoveMenusFromRole implements RoleController.
+// RemoveMenusFromRole godoc
+// @Summary      Remove menus from role
+// @Description  Remove menus from a role by role ID.
+// @Tags         Roles
+// @Accept       json
+// @Produce      json
+// @Param        id    path      string                      true  "Role ID"
+// @Param        body  body      dto.RemoveMenuRequest true  "Remove menus payload"
+// @Success      200   {object}  map[string]interface{}
+// @Failure      400   {object}  map[string]interface{}
+// @Router       /roles/{id}/remove-menus [post]
 func (r *roleController) RemoveMenusFromRole(ctx *gin.Context) {
 	id := ctx.Param("id")
 	var req dto.RemoveMenuRequest