admin
123 lines
4.8 KiB
TypeScript
123 lines
4.8 KiB
TypeScript
// File: src/modules/workflow-engine/workflow-engine.controller.ts
|
|
|
|
import {
|
|
Body,
|
|
Controller,
|
|
Get,
|
|
Param,
|
|
Patch,
|
|
Post,
|
|
Request,
|
|
UseGuards,
|
|
} from '@nestjs/common';
|
|
import {
|
|
ApiBearerAuth,
|
|
ApiOperation,
|
|
ApiParam,
|
|
ApiResponse,
|
|
ApiTags,
|
|
} from '@nestjs/swagger';
|
|
|
|
// Services
|
|
import { WorkflowEngineService } from './workflow-engine.service';
|
|
|
|
// DTOs
|
|
import { CreateWorkflowDefinitionDto } from './dto/create-workflow-definition.dto';
|
|
import { EvaluateWorkflowDto } from './dto/evaluate-workflow.dto';
|
|
import { UpdateWorkflowDefinitionDto } from './dto/update-workflow-definition.dto';
|
|
import { WorkflowTransitionDto } from './dto/workflow-transition.dto';
|
|
|
|
// Guards & Decorators (อ้างอิงตามโครงสร้าง src/common ในแผนงาน)
|
|
import { RequirePermission } from '../../common/decorators/require-permission.decorator';
|
|
import { JwtAuthGuard } from '../../common/guards/jwt-auth.guard';
|
|
import { RbacGuard } from '../../common/guards/rbac.guard';
|
|
import type { RequestWithUser } from '../../common/interfaces/request-with-user.interface';
|
|
|
|
@ApiTags('Workflow Engine')
|
|
@ApiBearerAuth() // ระบุว่าต้องใช้ Token ใน Swagger
|
|
@Controller('workflow-engine')
|
|
@UseGuards(JwtAuthGuard, RbacGuard) // บังคับ Login และตรวจสอบสิทธิ์ทุก Request
|
|
export class WorkflowEngineController {
|
|
constructor(private readonly workflowService: WorkflowEngineService) {}
|
|
|
|
// =================================================================
|
|
// Definition Management (Admin / Developer)
|
|
// =================================================================
|
|
|
|
@Post('definitions')
|
|
@ApiOperation({ summary: 'สร้าง Workflow Definition ใหม่ (Auto Versioning)' })
|
|
@ApiResponse({ status: 201, description: 'Created successfully' })
|
|
// ใช้ Permission 'system.manage_all' (Admin) หรือสร้าง permission ใหม่ 'workflow.manage' ในอนาคต
|
|
@RequirePermission('system.manage_all')
|
|
async createDefinition(@Body() dto: CreateWorkflowDefinitionDto) {
|
|
return this.workflowService.createDefinition(dto);
|
|
}
|
|
|
|
@Get('definitions')
|
|
@ApiOperation({ summary: 'ดึง Workflow Definition ทั้งหมด' })
|
|
@RequirePermission('system.manage_all')
|
|
async getDefinitions() {
|
|
return this.workflowService.getDefinitions();
|
|
}
|
|
|
|
@Get('definitions/:id')
|
|
@ApiOperation({ summary: 'ดึง Workflow Definition ด้วย ID' })
|
|
@RequirePermission('system.manage_all')
|
|
async getDefinitionById(@Param('id') id: string) {
|
|
return this.workflowService.getDefinitionById(id);
|
|
}
|
|
|
|
@Patch('definitions/:id')
|
|
@ApiOperation({ summary: 'แก้ไข Workflow Definition (Re-compile DSL)' })
|
|
@RequirePermission('system.manage_all')
|
|
async updateDefinition(
|
|
@Param('id') id: string,
|
|
@Body() dto: UpdateWorkflowDefinitionDto
|
|
) {
|
|
return this.workflowService.update(id, dto);
|
|
}
|
|
|
|
@Post('evaluate')
|
|
@ApiOperation({ summary: 'ทดสอบ Logic Workflow (Dry Run) ไม่บันทึกข้อมูล' })
|
|
@RequirePermission('system.manage_all')
|
|
async evaluate(@Body() dto: EvaluateWorkflowDto) {
|
|
return this.workflowService.evaluate(dto);
|
|
}
|
|
|
|
// =================================================================
|
|
// Runtime Engine (User Actions)
|
|
// =================================================================
|
|
|
|
@Post('instances/:id/transition')
|
|
@ApiOperation({ summary: 'สั่งเปลี่ยนสถานะเอกสาร (User Action)' })
|
|
@ApiParam({ name: 'id', description: 'Workflow Instance ID (UUID)' })
|
|
// Permission จะถูกตรวจสอบ Dynamic ภายใน Service ตาม State ของ Workflow แต่ขั้นต้นต้องมีสิทธิ์ทำงาน Workflow
|
|
@RequirePermission('workflow.action_review')
|
|
async processTransition(
|
|
@Param('id') instanceId: string,
|
|
@Body() dto: WorkflowTransitionDto,
|
|
@Request() req: RequestWithUser
|
|
) {
|
|
// ดึง User ID จาก Token (req.user มาจาก JwtStrategy)
|
|
const userId = req.user?.user_id;
|
|
|
|
return this.workflowService.processTransition(
|
|
instanceId,
|
|
dto.action,
|
|
userId,
|
|
dto.comment,
|
|
dto.payload
|
|
);
|
|
}
|
|
|
|
@Get('instances/:id/actions')
|
|
@ApiOperation({
|
|
summary: 'ดึงรายการปุ่ม Action ที่สามารถกดได้ ณ สถานะปัจจุบัน',
|
|
})
|
|
@RequirePermission('document.view') // ผู้ที่มีสิทธิ์ดูเอกสาร ควรดู Action ได้
|
|
async getAvailableActions(@Param('id') instanceId: string) {
|
|
// Note: Logic การดึง Action ตาม Instance ID จะถูก Implement ใน Task ถัดไป
|
|
return { message: 'Pending implementation in Service layer' };
|
|
}
|
|
}
|