Md Afiq Iskandar ed00664882 Implement Node Validation System for Process Flow
- Introduced a comprehensive node validation system in the process flow builder, enhancing the user experience by providing real-time feedback on node configurations and process integrity.
- Added `useNodeValidation` composable to manage validation logic, including checks for required nodes, configuration completeness, and flow logic.
- Integrated validation indicators in node components (ApiNode, FormNode, GatewayNode, ScriptNode) to visually represent validation issues.
- Created `ValidationIndicator` and `ValidationTooltip` components for displaying validation statuses and detailed messages.
- Updated `ProcessFlowCanvas.vue` to trigger validation on node and edge changes, ensuring immediate feedback during process design.
- Enhanced `processBuilder` store to manage validation results and summary statistics, allowing for a centralized validation state.
- Documented the validation system implementation plan to guide future enhancements and user training.
2025-07-28 11:35:38 +08:00

314 lines
7.4 KiB
Vue

<script setup>
import { Handle, Position } from '@vue-flow/core'
import { useProcessBuilderStore } from '~/stores/processBuilder'
import ValidationIndicator from '../ValidationIndicator.vue'
// Define props that Vue Flow passes to custom nodes
const props = defineProps([
'id', // Node ID
'type', // Node type
'label', // Node label
'selected', // Selection state
'data' // Custom data object
])
// Validation functionality - get from store
const processStore = useProcessBuilderStore()
// Get validation issues for this node
const validationIssues = computed(() => {
return processStore.getNodeValidation(props.id)
})
// Computed properties for node display
const nodeLabel = computed(() => {
return props.label || (props.data && props.data.label) || 'API Call'
})
const apiUrl = computed(() => {
return props.data?.apiUrl || 'No URL specified'
})
const apiMethod = computed(() => {
return props.data?.apiMethod || 'GET'
})
const isConfigured = computed(() => {
return !!props.data?.apiUrl
})
// Computed for node styling based on colors
const nodeStyle = computed(() => {
const backgroundColor = props.data?.backgroundColor || '#eff6ff'
const borderColor = props.data?.borderColor || '#3b82f6'
const textColor = props.data?.textColor || '#1e40af'
return {
'--node-bg-color': backgroundColor,
'--node-border-color': borderColor,
'--node-text-color': textColor,
backgroundColor: backgroundColor,
borderColor: borderColor,
color: textColor
}
})
// Computed for shape class
const shapeClass = computed(() => {
const shape = props.data?.shape || 'rectangle'
return `shape-${shape}`
})
// Handle node click event
const emit = defineEmits(['node-click'])
const onClick = () => {
emit('node-click', props.id)
}
</script>
<template>
<div
:class="['custom-node', 'node-api', shapeClass, { 'selected': selected }]"
:style="nodeStyle"
@click="onClick"
>
<!-- Input handles -->
<Handle
type="target"
:position="Position.Top"
class="handle-api-input handle-top"
:id="id + '-top'"
:style="{ zIndex: 1000 }"
:isConnectable="true"
:isValidConnection="() => true"
/>
<Handle
type="target"
:position="Position.Left"
class="handle-api-input handle-left"
:id="id + '-left'"
:style="{ zIndex: 1000 }"
:isConnectable="true"
:isValidConnection="() => true"
/>
<!-- Output handles -->
<Handle
type="source"
:position="Position.Right"
class="handle-api-output handle-right"
:id="id + '-right'"
:style="{ zIndex: 1000 }"
:isConnectable="true"
:isValidConnection="() => true"
/>
<Handle
type="source"
:position="Position.Bottom"
class="handle-api-output handle-bottom"
:id="id + '-bottom'"
:style="{ zIndex: 1000 }"
:isConnectable="true"
:isValidConnection="() => true"
/>
<!-- Validation Indicator -->
<ValidationIndicator
:node-id="id"
:validation-issues="validationIssues"
/>
<div class="custom-node-content">
<div class="flex items-center mb-1">
<div class="custom-node-icon">
<i class="material-icons text-indigo-500">api</i>
</div>
<div class="custom-node-label" :title="nodeLabel">{{ nodeLabel }}</div>
</div>
<div class="node-details">
<p class="node-description">{{ data?.description || 'External API call' }}</p>
<div class="node-rule-detail flex items-center justify-between text-xs mt-1">
<span class="node-rule-detail-label">Method:</span>
<span class="node-rule-detail-value ml-1 font-medium text-indigo-600">
{{ apiMethod }}
</span>
</div>
<div class="node-rule-detail flex items-center justify-between text-xs mt-1">
<span class="node-rule-detail-label">URL:</span>
<span
:class="isConfigured ? 'node-rule-detail-value ml-1 font-medium text-indigo-600' : 'node-rule-detail-value ml-1 italic text-gray-400'"
style="max-width: 120px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap;"
>
{{ apiUrl }}
</span>
</div>
</div>
</div>
</div>
</template>
<style scoped>
/* API node specific styling */
.node-api {
width: 180px;
background: white;
border-radius: 4px;
box-shadow: 0 1px 3px rgba(0, 0, 0, 0.1);
min-height: 50px;
display: flex;
flex-direction: column;
padding: 0;
border: 1px solid #ddd;
border-left: 4px solid #6366f1;
position: relative;
font-size: 12px;
transition: all 0.2s;
}
.node-api.selected {
border-color: #ff6b6b;
box-shadow: 0 0 0 2px rgba(255, 107, 107, 0.2);
}
.custom-node-content {
padding: 8px;
position: relative;
z-index: 2;
}
.custom-node-icon {
margin-right: 6px;
display: inline-flex;
align-items: center;
}
.custom-node-icon .material-icons {
font-size: 16px;
}
.custom-node-label {
font-weight: 500;
font-size: 11px;
white-space: nowrap;
overflow: hidden;
text-overflow: ellipsis;
max-width: 120px;
}
.node-details {
margin-top: 4px;
}
.node-description {
margin-bottom: 2px;
color: #666;
white-space: normal;
overflow: hidden;
display: -webkit-box;
-webkit-line-clamp: 2;
-webkit-box-orient: vertical;
font-size: 10px;
}
.node-rule-detail {
display: flex;
font-size: 10px;
color: #666;
align-items: center;
margin-bottom: 2px;
}
.node-rule-detail-label {
font-weight: 500;
margin-right: 4px;
}
.node-rule-detail-value {
white-space: nowrap;
overflow: hidden;
text-overflow: ellipsis;
max-width: 100px;
}
/* Handle styles */
.handle-top, .handle-bottom, .handle-left, .handle-right {
width: 12px !important;
height: 12px !important;
border-radius: 50% !important;
background: #fff !important;
border: 2px solid #666 !important;
opacity: 0;
transition: all 0.2s ease;
cursor: crosshair;
z-index: 100 !important;
position: absolute !important;
}
.handle-top {
top: -6px !important;
left: 50% !important;
transform: translateX(-50%) !important;
border-color: #2196F3 !important;
background: #e3f2fd !important;
}
.handle-bottom {
bottom: -6px !important;
left: 50% !important;
transform: translateX(-50%) !important;
border-color: #4CAF50 !important;
background: #e8f5e9 !important;
}
.handle-left {
left: -6px !important;
top: 50% !important;
transform: translateY(-50%) !important;
border-color: #2196F3 !important;
background: #e3f2fd !important;
}
.handle-right {
right: -6px !important;
top: 50% !important;
transform: translateY(-50%) !important;
border-color: #4CAF50 !important;
background: #e8f5e9 !important;
}
/* Show handles on hover */
.node-api:hover .handle-top,
.node-api:hover .handle-bottom,
.node-api:hover .handle-left,
.node-api:hover .handle-right {
opacity: 1;
}
/* Handle hover effects */
.handle-top:hover {
transform: translateX(-50%) scale(1.1);
background: #2196F3 !important;
border-color: #1565C0 !important;
}
.handle-bottom:hover {
transform: translateX(-50%) scale(1.1);
background: #4CAF50 !important;
border-color: #2E7D32 !important;
}
.handle-left:hover {
transform: translateY(-50%) scale(1.1);
background: #2196F3 !important;
border-color: #1565C0 !important;
}
.handle-right:hover {
transform: translateY(-50%) scale(1.1);
background: #4CAF50 !important;
border-color: #2E7D32 !important;
}
</style>