rez_core 5.0.182 → 6.5.0

package/src/module/workflow/workflow.module.ts

@@ -1,180 +1,180 @@
-import { Module, Res } from '@nestjs/common';
-import { TypeOrmModule } from '@nestjs/typeorm';
-import { ListMasterModule } from '../listmaster/listmaster.module';
-import { EntityModule } from '../meta/entity.module';
-import { ActionTemplateMappingController } from './controller/action-template-mapping.controller';
-import { ActionController } from './controller/action.controller';
-import { CommTemplateController } from './controller/comm-template.controller';
-import { EntityModificationController } from './controller/entity-modification.controller';
-import { StageGroupController } from './controller/stage-group.controller';
-import { StageController } from './controller/stage.controller';
-import { WorkflowListMasterController } from './controller/workflow-list-master.controller';
-import { WorkflowMetaController } from './controller/workflow-meta.controller';
-import { WorkflowController } from './controller/workflow.controller';
-import { ActionCategory } from './entity/action-category.entity';
-import { ActionTemplateMapping } from './entity/action-template-mapping.entity';
-import { ActionEntity } from './entity/action.entity';
-import { CommTemplate } from './entity/comm-template.entity';
-import { EntityModification } from './entity/entity-modification.entity';
-import { StageActionMapping } from './entity/stage-action-mapping.entity';
-import { StageGroup } from './entity/stage-group.entity';
-import { StageMovementData } from './entity/stage-movement-data.entity';
-import { Stage } from './entity/stage.entity';
-import { TemplateAttach } from './entity/template-attach-mapper.entity';
-import { Workflow } from './entity/workflow.entity';
-import { CommTemplateRepository } from './repository/comm-template.repository';
-import { StageGroupRepository } from './repository/stage-group.repository';
-import { StageRepository } from './repository/stage.repository';
-import { WorkflowRepository } from './repository/workflow.repository';
-import { ActionCategoryService } from './service/action-category.service';
-import { ActionTemplateMappingService } from './service/action-template-mapping.service';
-import { ActionService } from './service/action.service';
-import { CommTemplateService } from './service/comm-template.service';
-import { EntityModificationService } from './service/entity-modification.service';
-import { PopulateWorkflowService } from './service/populate-workflow.service';
-import { StageActionMappingService } from './service/stage-action-mapping.service';
-import { StageGroupService } from './service/stage-group.service';
-import { StageService } from './service/stage.service';
-import { WorkflowListMasterService } from './service/workflow-list-master.service';
-import { WorkflowMetaService } from './service/workflow-meta.service';
-import { WorkflowService } from './service/workflow.service';
-import { ActionCategoryController } from './controller/action-category.controller';
-import { StageMovementRepository } from './repository/stage-movement.repository';
-import { WorkflowLevelMappingEntity } from './entity/workflow-level-mapping.entity';
-import { TaskDataEntity } from './entity/task-data.entity';
-import { ActionDataEntity } from './entity/action-data.entity';
-import { TaskController } from './controller/task.controller';
-import { TaskService } from './service/task.service';
-import { TaskRepository } from './repository/task.repository';
-import { ActionRepository } from './repository/action.repository';
-import { ActionDataRepository } from './repository/action-data.repository';
-import { ActionDataService } from './service/action-data.service';
-import { FormMasterController } from './controller/form-master.controller';
-import { FormMasterService } from './service/form-master.service';
-import { FormMasterRepository } from './repository/form-master.repository';
-import { ActionResourcesMapping } from './entity/action-resources-mapping.entity';
-import { ActionResourcesMappingService } from './service/action-resources-mapping.service';
-import { ActionResourcesMappingController } from './controller/action-resource-mapping.controller';
-import { ActionCategoryRepository } from './repository/action-category.repository';
-import { ActivityLog } from './entity/activity-log.entity';
-import { ActivityLogService } from './service/activity-log.service';
-import { ActivityLogRepository } from './repository/activity-log.repository';
-import { ActivityLogController } from './controller/activity-log.controller';
-import { NotificationModule } from '../notification/notification.module';
-import { MapperModule } from '../mapper/mapper.module';
-import { WorkflowAutomationModule } from '../workflow-automation/workflow-automation.module';
-import { ListMasterData } from '../listmaster/entity/list-master.entity';
-import { ListMasterItems } from '../listmaster/entity/list-master-items.entity';
-
-@Module({
-  imports: [
-    TypeOrmModule.forFeature([
-      Workflow,
-      ActionEntity,
-      ActionCategory,
-      Stage,
-      StageGroup,
-      CommTemplate,
-      ActionTemplateMapping,
-      StageActionMapping,
-      StageMovementData,
-      EntityModification,
-      TemplateAttach,
-      WorkflowLevelMappingEntity,
-      TaskDataEntity,
-      ActionDataEntity,
-      ActionResourcesMapping,
-      ActivityLog,
-      ListMasterData,
-      ListMasterItems
-    ]),
-    ListMasterModule,
-    EntityModule,
-    NotificationModule,
-    MapperModule,
-    WorkflowAutomationModule,
-  ],
-  providers: [
-    { provide: 'ActionCategoryService', useClass: ActionCategoryService },
-    { provide: 'CommTemplateService', useClass: CommTemplateService },
-    {
-      provide: 'StageActionMappingService',
-      useClass: StageActionMappingService,
-    },
-    { provide: 'ActionService', useClass: ActionService },
-    { provide: 'StageService', useClass: StageService },
-    { provide: 'TaskService', useClass: TaskService },
-    { provide: 'StageGroupService', useClass: StageGroupService },
-    { provide: 'WorkflowService', useClass: WorkflowService },
-    {
-      provide: 'EntityModificationService',
-      useClass: EntityModificationService,
-    },
-    { provide: 'FormMasterService', useClass: FormMasterService },
-    {
-      provide: 'ActionResourcesMappingService',
-      useClass: ActionResourcesMappingService,
-    },
-    {
-      provide: 'ActivityLogService',
-      useClass: ActivityLogService,
-    },
-
-    WorkflowListMasterService,
-    ActionTemplateMappingService,
-    WorkflowRepository,
-    CommTemplateService,
-    CommTemplateRepository,
-    StageGroupRepository,
-    StageRepository,
-    WorkflowService,
-    WorkflowMetaService,
-    PopulateWorkflowService,
-    StageMovementRepository,
-    TaskRepository,
-    ActionRepository,
-    ActionDataRepository,
-    ActionDataService,
-    FormMasterRepository,
-    ActionCategoryRepository,
-    ActivityLogRepository,
-  ],
-  exports: [
-    'ActionCategoryService',
-    'CommTemplateService',
-    'StageActionMappingService',
-    'ActionService',
-    'StageService',
-    'StageGroupService',
-    'EntityModificationService',
-    'FormMasterService',
-    'ActionResourcesMappingService',
-    'TaskService',
-    'ActivityLogService',
-    WorkflowRepository,
-    StageGroupRepository,
-    StageRepository,
-    WorkflowMetaService,
-    PopulateWorkflowService,
-    ActionCategoryRepository,
-    ActivityLogRepository,
-    ActionDataService,
-  ],
-  controllers: [
-    WorkflowListMasterController,
-    ActionTemplateMappingController,
-    WorkflowController,
-    CommTemplateController,
-    StageGroupController,
-    StageController,
-    ActionController,
-    WorkflowMetaController,
-    EntityModificationController,
-    ActionCategoryController,
-    TaskController,
-    FormMasterController,
-    ActionResourcesMappingController,
-    ActivityLogController,
-  ],
-})
-export class WorkflowModule {}
+import { Module, Res } from '@nestjs/common';
+import { TypeOrmModule } from '@nestjs/typeorm';
+import { ListMasterModule } from '../listmaster/listmaster.module';
+import { EntityModule } from '../meta/entity.module';
+import { ActionTemplateMappingController } from './controller/action-template-mapping.controller';
+import { ActionController } from './controller/action.controller';
+import { CommTemplateController } from './controller/comm-template.controller';
+import { EntityModificationController } from './controller/entity-modification.controller';
+import { StageGroupController } from './controller/stage-group.controller';
+import { StageController } from './controller/stage.controller';
+import { WorkflowListMasterController } from './controller/workflow-list-master.controller';
+import { WorkflowMetaController } from './controller/workflow-meta.controller';
+import { WorkflowController } from './controller/workflow.controller';
+import { ActionCategory } from './entity/action-category.entity';
+import { ActionTemplateMapping } from './entity/action-template-mapping.entity';
+import { ActionEntity } from './entity/action.entity';
+import { CommTemplate } from './entity/comm-template.entity';
+import { EntityModification } from './entity/entity-modification.entity';
+import { StageActionMapping } from './entity/stage-action-mapping.entity';
+import { StageGroup } from './entity/stage-group.entity';
+import { StageMovementData } from './entity/stage-movement-data.entity';
+import { Stage } from './entity/stage.entity';
+import { TemplateAttach } from './entity/template-attach-mapper.entity';
+import { Workflow } from './entity/workflow.entity';
+import { CommTemplateRepository } from './repository/comm-template.repository';
+import { StageGroupRepository } from './repository/stage-group.repository';
+import { StageRepository } from './repository/stage.repository';
+import { WorkflowRepository } from './repository/workflow.repository';
+import { ActionCategoryService } from './service/action-category.service';
+import { ActionTemplateMappingService } from './service/action-template-mapping.service';
+import { ActionService } from './service/action.service';
+import { CommTemplateService } from './service/comm-template.service';
+import { EntityModificationService } from './service/entity-modification.service';
+import { PopulateWorkflowService } from './service/populate-workflow.service';
+import { StageActionMappingService } from './service/stage-action-mapping.service';
+import { StageGroupService } from './service/stage-group.service';
+import { StageService } from './service/stage.service';
+import { WorkflowListMasterService } from './service/workflow-list-master.service';
+import { WorkflowMetaService } from './service/workflow-meta.service';
+import { WorkflowService } from './service/workflow.service';
+import { ActionCategoryController } from './controller/action-category.controller';
+import { StageMovementRepository } from './repository/stage-movement.repository';
+import { WorkflowLevelMappingEntity } from './entity/workflow-level-mapping.entity';
+import { TaskDataEntity } from './entity/task-data.entity';
+import { ActionDataEntity } from './entity/action-data.entity';
+import { TaskController } from './controller/task.controller';
+import { TaskService } from './service/task.service';
+import { TaskRepository } from './repository/task.repository';
+import { ActionRepository } from './repository/action.repository';
+import { ActionDataRepository } from './repository/action-data.repository';
+import { ActionDataService } from './service/action-data.service';
+import { FormMasterController } from './controller/form-master.controller';
+import { FormMasterService } from './service/form-master.service';
+import { FormMasterRepository } from './repository/form-master.repository';
+import { ActionResourcesMapping } from './entity/action-resources-mapping.entity';
+import { ActionResourcesMappingService } from './service/action-resources-mapping.service';
+import { ActionResourcesMappingController } from './controller/action-resource-mapping.controller';
+import { ActionCategoryRepository } from './repository/action-category.repository';
+import { ActivityLog } from './entity/activity-log.entity';
+import { ActivityLogService } from './service/activity-log.service';
+import { ActivityLogRepository } from './repository/activity-log.repository';
+import { ActivityLogController } from './controller/activity-log.controller';
+import { NotificationModule } from '../notification/notification.module';
+import { MapperModule } from '../mapper/mapper.module';
+import { WorkflowAutomationModule } from '../workflow-automation/workflow-automation.module';
+import { ListMasterData } from '../listmaster/entity/list-master.entity';
+import { ListMasterItems } from '../listmaster/entity/list-master-items.entity';
+
+@Module({
+  imports: [
+    TypeOrmModule.forFeature([
+      Workflow,
+      ActionEntity,
+      ActionCategory,
+      Stage,
+      StageGroup,
+      CommTemplate,
+      ActionTemplateMapping,
+      StageActionMapping,
+      StageMovementData,
+      EntityModification,
+      TemplateAttach,
+      WorkflowLevelMappingEntity,
+      TaskDataEntity,
+      ActionDataEntity,
+      ActionResourcesMapping,
+      ActivityLog,
+      ListMasterData,
+      ListMasterItems
+    ]),
+    ListMasterModule,
+    EntityModule,
+    NotificationModule,
+    MapperModule,
+    WorkflowAutomationModule,
+  ],
+  providers: [
+    { provide: 'ActionCategoryService', useClass: ActionCategoryService },
+    { provide: 'CommTemplateService', useClass: CommTemplateService },
+    {
+      provide: 'StageActionMappingService',
+      useClass: StageActionMappingService,
+    },
+    { provide: 'ActionService', useClass: ActionService },
+    { provide: 'StageService', useClass: StageService },
+    { provide: 'TaskService', useClass: TaskService },
+    { provide: 'StageGroupService', useClass: StageGroupService },
+    { provide: 'WorkflowService', useClass: WorkflowService },
+    {
+      provide: 'EntityModificationService',
+      useClass: EntityModificationService,
+    },
+    { provide: 'FormMasterService', useClass: FormMasterService },
+    {
+      provide: 'ActionResourcesMappingService',
+      useClass: ActionResourcesMappingService,
+    },
+    {
+      provide: 'ActivityLogService',
+      useClass: ActivityLogService,
+    },
+
+    WorkflowListMasterService,
+    ActionTemplateMappingService,
+    WorkflowRepository,
+    CommTemplateService,
+    CommTemplateRepository,
+    StageGroupRepository,
+    StageRepository,
+    WorkflowService,
+    WorkflowMetaService,
+    PopulateWorkflowService,
+    StageMovementRepository,
+    TaskRepository,
+    ActionRepository,
+    ActionDataRepository,
+    ActionDataService,
+    FormMasterRepository,
+    ActionCategoryRepository,
+    ActivityLogRepository,
+  ],
+  exports: [
+    'ActionCategoryService',
+    'CommTemplateService',
+    'StageActionMappingService',
+    'ActionService',
+    'StageService',
+    'StageGroupService',
+    'EntityModificationService',
+    'FormMasterService',
+    'ActionResourcesMappingService',
+    'TaskService',
+    'ActivityLogService',
+    WorkflowRepository,
+    StageGroupRepository,
+    StageRepository,
+    WorkflowMetaService,
+    PopulateWorkflowService,
+    ActionCategoryRepository,
+    ActivityLogRepository,
+    ActionDataService,
+  ],
+  controllers: [
+    WorkflowListMasterController,
+    ActionTemplateMappingController,
+    WorkflowController,
+    CommTemplateController,
+    StageGroupController,
+    StageController,
+    ActionController,
+    WorkflowMetaController,
+    EntityModificationController,
+    ActionCategoryController,
+    TaskController,
+    FormMasterController,
+    ActionResourcesMappingController,
+    ActivityLogController,
+  ],
+})
+export class WorkflowModule {}

package/src/module/workflow-automation/SCHEDULING_GUIDE.md

@@ -1,145 +1,145 @@
-# Workflow Automation Scheduling Guide
-
-## Overview
-This module integrates with `WorkflowScheduleModule` to enable creating scheduled workflow automations. You can create schedules that run automatically via cron, or create them in a disabled state for manual triggering only.
-
-## Controlling Auto-Scheduling Behavior
-
-### Option 1: Create Schedules WITHOUT Auto-Execution
-When creating a schedule, set `is_enabled: false` to prevent it from running automatically:
-
-```typescript
-// Inject WorkflowScheduleService in your controller/service
-constructor(
-  private readonly workflowScheduleService: WorkflowScheduleService,
-) {}
-
-// Create schedule without auto-execution
-const schedule = await this.workflowScheduleService.createSchedule(
-  {
-    workflow_id: workflowId,
-    workflow_name: 'My Workflow',
-    name: 'My Schedule',
-    cron_expression: '0 9 * * *', // Every day at 9 AM
-    timezone: 'America/New_York',
-    is_enabled: false, // 👈 This prevents auto-execution
-    // ... other fields
-  },
-  loggedInUser,
-);
-```
-
-### Option 2: Create Schedules WITH Auto-Execution
-Simply set `is_enabled: true` (or omit it, as it defaults to true):
-
-```typescript
-const schedule = await this.workflowScheduleService.createSchedule(
-  {
-    workflow_id: workflowId,
-    workflow_name: 'My Workflow',
-    name: 'My Schedule',
-    cron_expression: '0 9 * * *',
-    timezone: 'America/New_York',
-    is_enabled: true, // 👈 Schedule will run automatically on cron
-    // ... other fields
-  },
-  loggedInUser,
-);
-```
-
-## How It Works
-
-The scheduling logic in `WorkflowScheduleService.createSchedule()` (line 101-103) only adds jobs to the Bull queue if:
-1. `is_enabled === true`
-2. `schedule_status === 'ACTIVE'`
-
-If either condition is false, the schedule is saved to the database but NOT added to the queue, meaning the cron processor won't execute it.
-
-## Manual Triggering
-
-You can manually trigger any schedule (enabled or disabled) using:
-
-```typescript
-const result = await this.workflowScheduleService.triggerManualExecution(
-  scheduleId,
-  loggedInUser,
-  { /* optional metadata */ },
-);
-```
-
-## Enabling/Disabling Schedules Later
-
-### To Enable a Disabled Schedule:
-```typescript
-await this.workflowScheduleService.updateSchedule(
-  {
-    id: scheduleId,
-    is_enabled: true,
-  },
-  loggedInUser,
-);
-```
-
-### To Disable an Active Schedule:
-```typescript
-await this.workflowScheduleService.updateSchedule(
-  {
-    id: scheduleId,
-    is_enabled: false,
-  },
-  loggedInUser,
-);
-```
-
-### To Pause a Schedule Temporarily:
-```typescript
-await this.workflowScheduleService.pauseSchedule(scheduleId, loggedInUser);
-```
-
-### To Resume a Paused Schedule:
-```typescript
-await this.workflowScheduleService.resumeSchedule(scheduleId, loggedInUser);
-```
-
-## Best Practices
-
-1. **Testing**: Create schedules with `is_enabled: false` during development and testing
-2. **Staged Rollout**: Create schedules disabled, test manually, then enable when ready
-3. **Monitoring**: Use `getExecutionLogs()` and `getExecutionStats()` to monitor schedule performance
-4. **Cleanup**: Use `deleteSchedule()` to soft-delete schedules you no longer need
-
-## Example: Complete Workflow
-
-```typescript
-// 1. Create schedule (disabled)
-const schedule = await this.workflowScheduleService.createSchedule({
-  workflow_id: 123,
-  workflow_name: 'Send Daily Report',
-  name: 'Daily Report Schedule',
-  cron_expression: '0 9 * * *',
-  is_enabled: false, // Start disabled
-}, loggedInUser);
-
-// 2. Test manually
-const testResult = await this.workflowScheduleService.triggerManualExecution(
-  schedule.id,
-  loggedInUser,
-);
-
-// 3. Check execution logs
-const logs = await this.workflowScheduleService.getExecutionLogs({
-  schedule_id: schedule.id,
-}, loggedInUser);
-
-// 4. If tests pass, enable for auto-execution
-if (logs.data[0].execution_status === 'COMPLETED') {
-  await this.workflowScheduleService.updateSchedule({
-    id: schedule.id,
-    is_enabled: true, // Now it will run on cron
-  }, loggedInUser);
-}
-```
-
-## Environment Configuration
-
-The Bull queue (Redis) connection is configured in `src/config/bull.config.ts`. Ensure Redis is running and accessible for the scheduler to work.
+# Workflow Automation Scheduling Guide
+
+## Overview
+This module integrates with `WorkflowScheduleModule` to enable creating scheduled workflow automations. You can create schedules that run automatically via cron, or create them in a disabled state for manual triggering only.
+
+## Controlling Auto-Scheduling Behavior
+
+### Option 1: Create Schedules WITHOUT Auto-Execution
+When creating a schedule, set `is_enabled: false` to prevent it from running automatically:
+
+```typescript
+// Inject WorkflowScheduleService in your controller/service
+constructor(
+  private readonly workflowScheduleService: WorkflowScheduleService,
+) {}
+
+// Create schedule without auto-execution
+const schedule = await this.workflowScheduleService.createSchedule(
+  {
+    workflow_id: workflowId,
+    workflow_name: 'My Workflow',
+    name: 'My Schedule',
+    cron_expression: '0 9 * * *', // Every day at 9 AM
+    timezone: 'America/New_York',
+    is_enabled: false, // 👈 This prevents auto-execution
+    // ... other fields
+  },
+  loggedInUser,
+);
+```
+
+### Option 2: Create Schedules WITH Auto-Execution
+Simply set `is_enabled: true` (or omit it, as it defaults to true):
+
+```typescript
+const schedule = await this.workflowScheduleService.createSchedule(
+  {
+    workflow_id: workflowId,
+    workflow_name: 'My Workflow',
+    name: 'My Schedule',
+    cron_expression: '0 9 * * *',
+    timezone: 'America/New_York',
+    is_enabled: true, // 👈 Schedule will run automatically on cron
+    // ... other fields
+  },
+  loggedInUser,
+);
+```
+
+## How It Works
+
+The scheduling logic in `WorkflowScheduleService.createSchedule()` (line 101-103) only adds jobs to the Bull queue if:
+1. `is_enabled === true`
+2. `schedule_status === 'ACTIVE'`
+
+If either condition is false, the schedule is saved to the database but NOT added to the queue, meaning the cron processor won't execute it.
+
+## Manual Triggering
+
+You can manually trigger any schedule (enabled or disabled) using:
+
+```typescript
+const result = await this.workflowScheduleService.triggerManualExecution(
+  scheduleId,
+  loggedInUser,
+  { /* optional metadata */ },
+);
+```
+
+## Enabling/Disabling Schedules Later
+
+### To Enable a Disabled Schedule:
+```typescript
+await this.workflowScheduleService.updateSchedule(
+  {
+    id: scheduleId,
+    is_enabled: true,
+  },
+  loggedInUser,
+);
+```
+
+### To Disable an Active Schedule:
+```typescript
+await this.workflowScheduleService.updateSchedule(
+  {
+    id: scheduleId,
+    is_enabled: false,
+  },
+  loggedInUser,
+);
+```
+
+### To Pause a Schedule Temporarily:
+```typescript
+await this.workflowScheduleService.pauseSchedule(scheduleId, loggedInUser);
+```
+
+### To Resume a Paused Schedule:
+```typescript
+await this.workflowScheduleService.resumeSchedule(scheduleId, loggedInUser);
+```
+
+## Best Practices
+
+1. **Testing**: Create schedules with `is_enabled: false` during development and testing
+2. **Staged Rollout**: Create schedules disabled, test manually, then enable when ready
+3. **Monitoring**: Use `getExecutionLogs()` and `getExecutionStats()` to monitor schedule performance
+4. **Cleanup**: Use `deleteSchedule()` to soft-delete schedules you no longer need
+
+## Example: Complete Workflow
+
+```typescript
+// 1. Create schedule (disabled)
+const schedule = await this.workflowScheduleService.createSchedule({
+  workflow_id: 123,
+  workflow_name: 'Send Daily Report',
+  name: 'Daily Report Schedule',
+  cron_expression: '0 9 * * *',
+  is_enabled: false, // Start disabled
+}, loggedInUser);
+
+// 2. Test manually
+const testResult = await this.workflowScheduleService.triggerManualExecution(
+  schedule.id,
+  loggedInUser,
+);
+
+// 3. Check execution logs
+const logs = await this.workflowScheduleService.getExecutionLogs({
+  schedule_id: schedule.id,
+}, loggedInUser);
+
+// 4. If tests pass, enable for auto-execution
+if (logs.data[0].execution_status === 'COMPLETED') {
+  await this.workflowScheduleService.updateSchedule({
+    id: schedule.id,
+    is_enabled: true, // Now it will run on cron
+  }, loggedInUser);
+}
+```
+
+## Environment Configuration
+
+The Bull queue (Redis) connection is configured in `src/config/bull.config.ts`. Ensure Redis is running and accessible for the scheduler to work.