perf: 【IoT 物联网】场景联动首页优化

pull/808/head
puhui999 2025-08-07 17:44:24 +08:00
parent 93311f8bd7
commit 5b38c9c394
2 changed files with 586 additions and 123 deletions

491
src/utils/cron.ts Normal file
View File

@ -0,0 +1,491 @@
/**
* CRON
* CRON
*/
/** CRON 字段类型枚举 */
export enum CronFieldType {
SECOND = 'second',
MINUTE = 'minute',
HOUR = 'hour',
DAY = 'day',
MONTH = 'month',
WEEK = 'week',
YEAR = 'year'
}
/** CRON 字段配置 */
export interface CronFieldConfig {
key: CronFieldType
label: string
min: number
max: number
names?: Record<string, number> // 名称映射,如月份名称
}
/** CRON 字段配置常量 */
export const CRON_FIELD_CONFIGS: Record<CronFieldType, CronFieldConfig> = {
[CronFieldType.SECOND]: { key: CronFieldType.SECOND, label: '秒', min: 0, max: 59 },
[CronFieldType.MINUTE]: { key: CronFieldType.MINUTE, label: '分', min: 0, max: 59 },
[CronFieldType.HOUR]: { key: CronFieldType.HOUR, label: '时', min: 0, max: 23 },
[CronFieldType.DAY]: { key: CronFieldType.DAY, label: '日', min: 1, max: 31 },
[CronFieldType.MONTH]: {
key: CronFieldType.MONTH,
label: '月',
min: 1,
max: 12,
names: {
JAN: 1,
FEB: 2,
MAR: 3,
APR: 4,
MAY: 5,
JUN: 6,
JUL: 7,
AUG: 8,
SEP: 9,
OCT: 10,
NOV: 11,
DEC: 12
}
},
[CronFieldType.WEEK]: {
key: CronFieldType.WEEK,
label: '周',
min: 0,
max: 7,
names: {
SUN: 0,
MON: 1,
TUE: 2,
WED: 3,
THU: 4,
FRI: 5,
SAT: 6
}
},
[CronFieldType.YEAR]: { key: CronFieldType.YEAR, label: '年', min: 1970, max: 2099 }
}
/** 解析后的 CRON 字段 */
export interface ParsedCronField {
type: 'any' | 'specific' | 'range' | 'step' | 'list' | 'last' | 'weekday' | 'nth'
values: number[]
original: string
description: string
}
/** 解析后的 CRON 表达式 */
export interface ParsedCronExpression {
second: ParsedCronField
minute: ParsedCronField
hour: ParsedCronField
day: ParsedCronField
month: ParsedCronField
week: ParsedCronField
year?: ParsedCronField
isValid: boolean
description: string
nextExecutionTime?: Date
}
/** 常用 CRON 表达式预设 */
export const CRON_PRESETS = {
EVERY_SECOND: '* * * * * ?',
EVERY_MINUTE: '0 * * * * ?',
EVERY_HOUR: '0 0 * * * ?',
EVERY_DAY: '0 0 0 * * ?',
EVERY_WEEK: '0 0 0 ? * 1',
EVERY_MONTH: '0 0 0 1 * ?',
EVERY_YEAR: '0 0 0 1 1 ?',
WORKDAY_9AM: '0 0 9 ? * 2-6', // 工作日上午9点
WORKDAY_6PM: '0 0 18 ? * 2-6', // 工作日下午6点
WEEKEND_10AM: '0 0 10 ? * 1,7' // 周末上午10点
} as const
/** CRON 表达式工具类 */
export class CronUtils {
/**
* CRON
*/
static validate(cronExpression: string): boolean {
if (!cronExpression || typeof cronExpression !== 'string') {
return false
}
const parts = cronExpression.trim().split(/\s+/)
// 支持 5-7 个字段的 CRON 表达式
if (parts.length < 5 || parts.length > 7) {
return false
}
// 基本格式验证
const cronRegex = /^[0-9*\/\-,?LW#]+$/
return parts.every((part) => cronRegex.test(part))
}
/**
* CRON
*/
static parseField(
fieldValue: string,
fieldType: CronFieldType,
config: CronFieldConfig
): ParsedCronField {
const field: ParsedCronField = {
type: 'any',
values: [],
original: fieldValue,
description: ''
}
// 处理特殊字符
if (fieldValue === '*' || fieldValue === '?') {
field.type = 'any'
field.description = `${config.label}`
return field
}
// 处理最后一天 (L)
if (fieldValue === 'L' && fieldType === CronFieldType.DAY) {
field.type = 'last'
field.description = '每月最后一天'
return field
}
// 处理范围 (-)
if (fieldValue.includes('-')) {
const [start, end] = fieldValue.split('-').map(Number)
if (!isNaN(start) && !isNaN(end) && start >= config.min && end <= config.max) {
field.type = 'range'
field.values = Array.from({ length: end - start + 1 }, (_, i) => start + i)
field.description = `${config.label} ${start}-${end}`
}
return field
}
// 处理步长 (/)
if (fieldValue.includes('/')) {
const [base, step] = fieldValue.split('/')
const stepNum = Number(step)
if (!isNaN(stepNum) && stepNum > 0) {
field.type = 'step'
if (base === '*') {
field.description = `${stepNum}${config.label}`
} else {
const startNum = Number(base)
field.description = `${startNum}开始每${stepNum}${config.label}`
}
}
return field
}
// 处理列表 (,)
if (fieldValue.includes(',')) {
const values = fieldValue
.split(',')
.map(Number)
.filter((n) => !isNaN(n))
if (values.length > 0) {
field.type = 'list'
field.values = values
field.description = `${config.label} ${values.join(',')}`
}
return field
}
// 处理具体数值
const numValue = Number(fieldValue)
if (!isNaN(numValue) && numValue >= config.min && numValue <= config.max) {
field.type = 'specific'
field.values = [numValue]
field.description = `${config.label} ${numValue}`
}
return field
}
/**
* CRON
*/
static parse(cronExpression: string): ParsedCronExpression {
const result: ParsedCronExpression = {
second: { type: 'any', values: [], original: '*', description: '每秒' },
minute: { type: 'any', values: [], original: '*', description: '每分' },
hour: { type: 'any', values: [], original: '*', description: '每时' },
day: { type: 'any', values: [], original: '*', description: '每日' },
month: { type: 'any', values: [], original: '*', description: '每月' },
week: { type: 'any', values: [], original: '?', description: '任意周' },
isValid: false,
description: ''
}
if (!this.validate(cronExpression)) {
result.description = '无效的 CRON 表达式'
return result
}
const parts = cronExpression.trim().split(/\s+/)
const fieldTypes = [
CronFieldType.SECOND,
CronFieldType.MINUTE,
CronFieldType.HOUR,
CronFieldType.DAY,
CronFieldType.MONTH,
CronFieldType.WEEK
]
// 如果只有5个字段则第一个字段是分钟
const startIndex = parts.length === 5 ? 1 : 0
for (let i = 0; i < parts.length; i++) {
const fieldType = fieldTypes[i + startIndex]
if (fieldType && CRON_FIELD_CONFIGS[fieldType]) {
const config = CRON_FIELD_CONFIGS[fieldType]
result[fieldType] = this.parseField(parts[i], fieldType, config)
}
}
// 处理年份字段(如果存在)
if (parts.length === 7) {
const yearConfig = CRON_FIELD_CONFIGS[CronFieldType.YEAR]
result.year = this.parseField(parts[6], CronFieldType.YEAR, yearConfig)
}
result.isValid = true
result.description = this.generateDescription(result)
return result
}
/**
* CRON
*/
static generateDescription(parsed: ParsedCronExpression): string {
const parts: string[] = []
// 构建时间部分描述
if (parsed.hour.type === 'specific' && parsed.minute.type === 'specific') {
const hour = parsed.hour.values[0]
const minute = parsed.minute.values[0]
parts.push(`${hour.toString().padStart(2, '0')}:${minute.toString().padStart(2, '0')}`)
} else if (parsed.hour.type === 'specific') {
parts.push(`每天${parsed.hour.values[0]}`)
} else if (parsed.minute.type === 'specific' && parsed.minute.values[0] === 0) {
if (parsed.hour.type === 'any') {
parts.push('每小时整点')
}
} else if (parsed.minute.type === 'step') {
const step = parsed.minute.original.split('/')[1]
parts.push(`${step}分钟`)
} else if (parsed.hour.type === 'step') {
const step = parsed.hour.original.split('/')[1]
parts.push(`${step}小时`)
}
// 构建日期部分描述
if (parsed.day.type === 'specific') {
parts.push(`每月${parsed.day.values[0]}`)
} else if (parsed.week.type === 'specific') {
const weekNames = ['周日', '周一', '周二', '周三', '周四', '周五', '周六']
const weekDay = parsed.week.values[0]
if (weekDay >= 0 && weekDay <= 6) {
parts.push(`${weekNames[weekDay]}`)
}
} else if (parsed.week.type === 'range') {
parts.push('工作日')
}
// 构建月份部分描述
if (parsed.month.type === 'specific') {
parts.push(`${parsed.month.values[0]}`)
}
return parts.length > 0 ? parts.join(' ') : '自定义时间规则'
}
/**
* CRON
*/
static format(cronExpression: string): string {
if (!cronExpression) return ''
const parsed = this.parse(cronExpression)
return parsed.isValid ? parsed.description : cronExpression
}
/**
* CRON
*/
static getPresets() {
return Object.entries(CRON_PRESETS).map(([key, value]) => ({
label: this.format(value),
value,
key
}))
}
/**
* CRON
*/
static getNextExecutionTime(cronExpression: string, fromDate?: Date): Date | null {
const parsed = this.parse(cronExpression)
if (!parsed.isValid) {
return null
}
const now = fromDate || new Date()
// eslint-disable-next-line prefer-const
let nextTime = new Date(now.getTime() + 1000) // 从下一秒开始
// 简化版本:处理常见的 CRON 表达式模式
// 对于复杂的 CRON 表达式,建议使用专门的库如 node-cron 或 cron-parser
// 处理每分钟执行
if (parsed.second.type === 'specific' && parsed.minute.type === 'any') {
const targetSecond = parsed.second.values[0]
nextTime.setSeconds(targetSecond, 0)
if (nextTime <= now) {
nextTime.setMinutes(nextTime.getMinutes() + 1)
}
return nextTime
}
// 处理每小时执行
if (
parsed.second.type === 'specific' &&
parsed.minute.type === 'specific' &&
parsed.hour.type === 'any'
) {
const targetSecond = parsed.second.values[0]
const targetMinute = parsed.minute.values[0]
nextTime.setMinutes(targetMinute, targetSecond, 0)
if (nextTime <= now) {
nextTime.setHours(nextTime.getHours() + 1)
}
return nextTime
}
// 处理每天执行
if (
parsed.second.type === 'specific' &&
parsed.minute.type === 'specific' &&
parsed.hour.type === 'specific'
) {
const targetSecond = parsed.second.values[0]
const targetMinute = parsed.minute.values[0]
const targetHour = parsed.hour.values[0]
nextTime.setHours(targetHour, targetMinute, targetSecond, 0)
if (nextTime <= now) {
nextTime.setDate(nextTime.getDate() + 1)
}
return nextTime
}
// 处理步长执行
if (parsed.minute.type === 'step') {
const step = parseInt(parsed.minute.original.split('/')[1])
const currentMinute = nextTime.getMinutes()
const nextMinute = Math.ceil(currentMinute / step) * step
if (nextMinute >= 60) {
nextTime.setHours(nextTime.getHours() + 1, 0, 0, 0)
} else {
nextTime.setMinutes(nextMinute, 0, 0)
}
return nextTime
}
// 对于其他复杂情况,返回一个估算时间
return new Date(now.getTime() + 60000) // 1分钟后
}
/**
* CRON
*/
static getFrequencyDescription(cronExpression: string): string {
const parsed = this.parse(cronExpression)
if (!parsed.isValid) {
return '无效表达式'
}
// 计算大概的执行频率
if (parsed.second.type === 'any' && parsed.minute.type === 'any') {
return '每秒执行'
}
if (parsed.minute.type === 'any' && parsed.hour.type === 'any') {
return '每分钟执行'
}
if (parsed.hour.type === 'any' && parsed.day.type === 'any') {
return '每小时执行'
}
if (parsed.day.type === 'any' && parsed.month.type === 'any') {
return '每天执行'
}
if (parsed.month.type === 'any') {
return '每月执行'
}
return '按计划执行'
}
/**
* CRON
*/
static willExecuteAt(cronExpression: string, targetDate: Date): boolean {
const parsed = this.parse(cronExpression)
if (!parsed.isValid) {
return false
}
// 检查各个字段是否匹配
const second = targetDate.getSeconds()
const minute = targetDate.getMinutes()
const hour = targetDate.getHours()
const day = targetDate.getDate()
const month = targetDate.getMonth() + 1
const weekDay = targetDate.getDay()
return (
this.fieldMatches(parsed.second, second) &&
this.fieldMatches(parsed.minute, minute) &&
this.fieldMatches(parsed.hour, hour) &&
this.fieldMatches(parsed.day, day) &&
this.fieldMatches(parsed.month, month) &&
(parsed.week.type === 'any' || this.fieldMatches(parsed.week, weekDay))
)
}
/**
*
*/
private static fieldMatches(field: ParsedCronField, value: number): boolean {
if (field.type === 'any') {
return true
}
if (field.type === 'specific' || field.type === 'list') {
return field.values.includes(value)
}
if (field.type === 'range') {
return value >= field.values[0] && value <= field.values[field.values.length - 1]
}
if (field.type === 'step') {
const [base, step] = field.original.split('/').map(Number)
if (base === 0 || field.original.startsWith('*')) {
return value % step === 0
}
return value >= base && (value - base) % step === 0
}
return false
}
}

View File

@ -136,13 +136,13 @@
<div
class="w-48px h-48px rounded-8px flex items-center justify-center text-24px text-white mr-16px bg-gradient-to-br from-[#43e97b] to-[#38f9d7]"
>
<Icon icon="ep:lightning" />
<Icon icon="ep:timer" />
</div>
<div>
<div class="text-24px font-600 text-[#303133] leading-none">{{
statistics.triggered
statistics.timerRules
}}</div>
<div class="text-14px text-[#909399] mt-4px">今日触发</div>
<div class="text-14px text-[#909399] mt-4px">定时规则</div>
</div>
</div>
</el-card>
@ -165,12 +165,27 @@
</template>
</el-table-column>
<!-- 触发条件列 -->
<el-table-column label="触发条件" min-width="250">
<el-table-column label="触发条件" min-width="280">
<template #default="{ row }">
<div class="flex flex-wrap gap-4px">
<el-tag type="primary" size="small" class="m-0">
{{ getTriggerSummary(row) }}
</el-tag>
<div class="space-y-4px">
<div class="flex flex-wrap gap-4px">
<el-tag type="primary" size="small" class="m-0">
{{ getTriggerSummary(row) }}
</el-tag>
</div>
<!-- 显示定时触发器的额外信息 -->
<div v-if="hasTimerTrigger(row)" class="mt-4px">
<el-tooltip :content="getCronExpression(row)" placement="top">
<el-tag size="small" type="info" class="mr-4px">
<Icon icon="ep:timer" class="mr-2px" />
{{ getCronFrequency(row) }}
</el-tag>
</el-tooltip>
<div v-if="getNextExecutionTime(row)" class="text-12px text-[#909399] mt-2px">
<Icon icon="ep:clock" class="mr-2px" />
下次执行: {{ formatDate(getNextExecutionTime(row)!) }}
</div>
</div>
</div>
</template>
</el-table-column>
@ -210,7 +225,14 @@
@click="handleToggleStatus(row)"
>
<Icon :icon="row.status === 0 ? 'ep:video-pause' : 'ep:video-play'" />
{{ getDictLabel(DICT_TYPE.COMMON_STATUS, row.status === 0 ? 1 : 0) }}
{{
getDictLabel(
DICT_TYPE.COMMON_STATUS,
row.status === CommonStatusEnum.ENABLE
? CommonStatusEnum.DISABLE
: CommonStatusEnum.ENABLE
)
}}
</el-button>
<el-button type="danger" class="!mr-10px" link @click="handleDelete(row.id)">
<Icon icon="ep:delete" />
@ -236,18 +258,18 @@
</template>
<script setup lang="ts">
import { DICT_TYPE, getIntDictOptions, getDictLabel } from '@/utils/dict'
import { DICT_TYPE, getDictLabel, getIntDictOptions } from '@/utils/dict'
import { ContentWrap } from '@/components/ContentWrap'
import RuleSceneForm from './form/RuleSceneForm.vue'
import { IotSceneRule } from '@/api/iot/rule/scene'
import { RuleSceneApi } from '@/api/iot/rule/scene'
import { IotSceneRule, RuleSceneApi } from '@/api/iot/rule/scene'
import {
IotRuleSceneTriggerTypeEnum,
IotRuleSceneActionTypeEnum,
getActionTypeLabel,
getTriggerTypeLabel,
getActionTypeLabel
IotRuleSceneTriggerTypeEnum
} from '@/views/iot/utils/constants'
import { formatDate } from '@/utils/formatTime'
import { CommonStatusEnum } from '@/utils/constants'
import { CronUtils } from '@/utils/cron'
/** 场景联动规则管理页面 */
defineOptions({ name: 'IoTSceneRule' })
@ -260,7 +282,7 @@ const queryParams = reactive({
pageNo: 1,
pageSize: 10,
name: '',
status: undefined as number | undefined
status: undefined
})
const loading = ref(true) //
@ -278,85 +300,28 @@ const statistics = ref({
total: 0,
enabled: 0,
disabled: 0,
triggered: 0
triggered: 0,
timerRules: 0 //
})
/** 格式化 CRON 表达式显示 */
/** 注:后续可考虑将此功能移至 CRON 组件内部 */
// TODO @puhui999format
const formatCronExpression = (cron: string): string => {
if (!cron) return ''
// CRON
const parts = cron.trim().split(' ')
if (parts.length < 5) return cron
const [second, minute, hour] = parts
//
let description = ''
if (second === '0' && minute === '0') {
if (hour === '*') {
description = '每小时'
} else if (hour.includes('/')) {
const interval = hour.split('/')[1]
description = `${interval}小时`
} else {
description = `每天${hour}`
}
} else if (second === '0') {
if (minute === '*') {
description = '每分钟'
} else if (minute.includes('/')) {
const interval = minute.split('/')[1]
description = `${interval}分钟`
} else {
description = `每小时第${minute}分钟`
}
} else {
if (second === '*') {
description = '每秒'
} else if (second.includes('/')) {
const interval = second.split('/')[1]
description = `${interval}`
}
}
return description || cron
}
/** 获取规则摘要信息 */
const getRuleSceneSummary = (rule: IotSceneRule) => {
const triggerSummary =
rule.triggers?.map((trigger: any) => {
//
let description = ''
let description = getTriggerTypeLabel(trigger.type)
switch (trigger.type) {
case IotRuleSceneTriggerTypeEnum.DEVICE_STATE_UPDATE:
description = '设备状态变更'
break
case IotRuleSceneTriggerTypeEnum.DEVICE_PROPERTY_POST:
description = '属性上报'
if (trigger.identifier) {
description += ` (${trigger.identifier})`
}
break
case IotRuleSceneTriggerTypeEnum.DEVICE_EVENT_POST:
description = '事件上报'
if (trigger.identifier) {
description += ` (${trigger.identifier})`
}
break
case IotRuleSceneTriggerTypeEnum.DEVICE_SERVICE_INVOKE:
description = '服务调用'
if (trigger.identifier) {
description += ` (${trigger.identifier})`
}
break
case IotRuleSceneTriggerTypeEnum.TIMER:
description = `定时触发 (${formatCronExpression(trigger.cronExpression || '')})`
description = `${getTriggerTypeLabel(trigger.type)} (${CronUtils.format(trigger.cronExpression || '')})`
break
default:
description = getTriggerTypeLabel(trigger.type)
@ -375,24 +340,7 @@ const getRuleSceneSummary = (rule: IotSceneRule) => {
const actionSummary =
rule.actions?.map((action: any) => {
//
let description = ''
switch (action.type) {
case IotRuleSceneActionTypeEnum.DEVICE_PROPERTY_SET:
description = '设备属性设置'
break
case IotRuleSceneActionTypeEnum.DEVICE_SERVICE_INVOKE:
description = '设备服务调用'
break
case IotRuleSceneActionTypeEnum.ALERT_TRIGGER:
description = '发送告警通知'
break
case IotRuleSceneActionTypeEnum.ALERT_RECOVER:
description = '发送恢复通知'
break
default:
description = getActionTypeLabel(action.type)
}
let description = getActionTypeLabel(action.type)
//
if (action.deviceId) {
@ -419,26 +367,12 @@ const getRuleSceneSummary = (rule: IotSceneRule) => {
const getList = async () => {
loading.value = true
try {
// TODO @puhui999
// API
const data = await RuleSceneApi.getRuleScenePage(queryParams)
list.value = data.list
total.value = data.total
//
updateStatistics()
} catch (error) {
console.error('获取列表失败:', error)
// TODO @puhui999
ElMessage.error('获取列表失败')
//
list.value = []
total.value = 0
//
updateStatistics()
} finally {
//
updateStatistics()
loading.value = false
}
}
@ -447,10 +381,12 @@ const getList = async () => {
const updateStatistics = () => {
statistics.value = {
total: list.value.length,
enabled: list.value.filter((item) => item.status === 0).length,
disabled: list.value.filter((item) => item.status === 1).length,
enabled: list.value.filter((item) => item.status === CommonStatusEnum.ENABLE).length,
disabled: list.value.filter((item) => item.status === CommonStatusEnum.DISABLE).length,
// (使)
triggered: list.value.filter((item) => item.status === 0).length
triggered: list.value.filter((item) => item.status === CommonStatusEnum.ENABLE).length,
//
timerRules: list.value.filter((item) => hasTimerTrigger(item)).length
}
}
@ -464,6 +400,43 @@ const getActionSummary = (rule: IotSceneRule) => {
return getRuleSceneSummary(rule).actionSummary
}
/** 检查规则是否包含定时触发器 */
const hasTimerTrigger = (rule: IotSceneRule): boolean => {
return (
rule.triggers?.some((trigger) => trigger.type === IotRuleSceneTriggerTypeEnum.TIMER) || false
)
}
/** 获取 CRON 表达式的执行频率描述 */
const getCronFrequency = (rule: IotSceneRule): string => {
const timerTrigger = rule.triggers?.find(
(trigger) => trigger.type === IotRuleSceneTriggerTypeEnum.TIMER
)
if (timerTrigger?.cronExpression) {
return CronUtils.getFrequencyDescription(timerTrigger.cronExpression)
}
return ''
}
/** 获取下次执行时间 */
const getNextExecutionTime = (rule: IotSceneRule): Date | null => {
const timerTrigger = rule.triggers?.find(
(trigger) => trigger.type === IotRuleSceneTriggerTypeEnum.TIMER
)
if (timerTrigger?.cronExpression) {
return CronUtils.getNextExecutionTime(timerTrigger.cronExpression)
}
return null
}
/** 获取 CRON 表达式原始值 */
const getCronExpression = (rule: IotSceneRule): string => {
const timerTrigger = rule.triggers?.find(
(trigger) => trigger.type === IotRuleSceneTriggerTypeEnum.TIMER
)
return timerTrigger?.cronExpression || ''
}
/** 搜索按钮操作 */
const handleQuery = () => {
queryParams.pageNo = 1
@ -499,28 +472,27 @@ const handleDelete = async (id: number) => {
message.success(t('common.delSuccess'))
//
await getList()
} catch (error) {
console.error('删除失败:', error)
ElMessage.error('删除失败')
}
} catch (error) {}
}
/** 修改状态 */
const handleToggleStatus = async (row: IotSceneRule) => {
try {
//
// TODO @puhui999status
const text = row.status === 0 ? '禁用' : '启用'
const text = row.status === CommonStatusEnum.ENABLE ? '禁用' : '启用'
await message.confirm('确认要' + text + '"' + row.name + '"吗?')
//
await RuleSceneApi.updateRuleSceneStatus(row.id!, row.status === 0 ? 1 : 0)
await RuleSceneApi.updateRuleSceneStatus(
row.id!,
row.status === CommonStatusEnum.ENABLE ? CommonStatusEnum.DISABLE : CommonStatusEnum.ENABLE
)
message.success(text + '成功')
//
await getList()
updateStatistics()
} catch {
//
row.status = row.status === 0 ? 1 : 0
row.status =
row.status === CommonStatusEnum.ENABLE ? CommonStatusEnum.DISABLE : CommonStatusEnum.ENABLE
}
}