feat:【IoT 物联网】新增 OTA 固件管理功能,包括固件列表、搜索、添加、修改和删除操作的前端实现

This commit is contained in:
YunaiV
2025-06-30 19:07:55 +08:00
parent a37c168efe
commit 9e948bdbdd
3 changed files with 431 additions and 0 deletions

View File

@ -0,0 +1,42 @@
import request from '@/config/axios'
/** IoT OTA 固件信息 */
export interface IoTOtaFirmware {
id: number // 固件编号
name?: string // 固件名称
description: string // 固件描述
version?: string // 版本号
productId?: number // 产品编号
fileUrl?: string // 固件文件 URL
fileSize?: number // 固件文件大小
fileDigestAlgorithm?: string // 固件文件签名算法
fileDigestValue?: string // 固件文件签名结果
}
// IoT OTA 固件 API
export const IoTOtaFirmwareApi = {
// 查询 OTA 固件分页
getOtaFirmwarePage: async (params: any) => {
return await request.get({ url: `/iot/ota-firmware/page`, params })
},
// 查询 OTA 固件详情
getOtaFirmware: async (id: number) => {
return await request.get({ url: `/iot/ota-firmware/get?id=` + id })
},
// 新增 OTA 固件
createOtaFirmware: async (data: IoTOtaFirmware) => {
return await request.post({ url: `/iot/ota-firmware/create`, data })
},
// 修改 OTA 固件
updateOtaFirmware: async (data: IoTOtaFirmware) => {
return await request.put({ url: `/iot/ota-firmware/update`, data })
},
// 删除 OTA 固件
deleteOtaFirmware: async (id: number) => {
return await request.delete({ url: `/iot/ota-firmware/delete?id=` + id })
}
}

View File

@ -0,0 +1,169 @@
<template>
<Dialog :title="dialogTitle" v-model="dialogVisible">
<el-form
ref="formRef"
:model="formData"
:rules="formRules"
label-width="100px"
v-loading="formLoading"
>
<el-form-item label="固件名称" prop="name">
<el-input v-model="formData.name" placeholder="请输入固件名称" />
</el-form-item>
<el-form-item label="固件描述" prop="description">
<el-input
v-model="formData.description"
type="textarea"
:rows="3"
placeholder="请输入固件描述"
/>
</el-form-item>
<el-form-item label="所属产品" prop="productId">
<el-select
v-model="formData.productId"
placeholder="请选择产品"
clearable
class="!w-100%"
:disabled="formType === 'update'"
>
<el-option
v-for="product in productList"
:key="product.id"
:label="product.name"
:value="product.id"
/>
</el-select>
</el-form-item>
<el-form-item label="版本号" prop="version" v-if="formType === 'create'">
<el-input v-model="formData.version" placeholder="请输入版本号" />
</el-form-item>
<el-form-item label="固件文件" prop="fileUrl" v-if="formType === 'create'">
<UploadFile
v-model="formData.fileUrl"
:file-type="['bin', 'zip', 'pdf']"
:file-size="50"
:limit="1"
/>
</el-form-item>
<!-- 更新时显示只读信息 -->
<template v-if="formType === 'update'">
<el-form-item label="版本号">
<el-input v-model="formData.version" readonly />
</el-form-item>
<el-form-item label="固件文件">
<el-link
type="primary"
:href="formData.fileUrl"
target="_blank"
download
v-if="formData.fileUrl"
>
<Icon icon="ep:download" class="mr-5px" />
下载固件文件
</el-link>
<span v-else>无文件</span>
</el-form-item>
</template>
</el-form>
<template #footer>
<el-button @click="submitForm" type="primary" :disabled="formLoading"> </el-button>
<el-button @click="dialogVisible = false"> </el-button>
</template>
</Dialog>
</template>
<script setup lang="ts">
import { IoTOtaFirmwareApi, IoTOtaFirmware } from '@/api/iot/ota/firmware'
import { ProductApi, ProductVO } from '@/api/iot/product/product'
import { UploadFile } from '@/components/UploadFile'
/** IoT OTA 固件表单 */
defineOptions({ name: 'IoTOtaFirmwareForm' })
const { t } = useI18n() // 国际化
const message = useMessage() // 消息弹窗
const dialogVisible = ref(false) // 弹窗的是否展示
const dialogTitle = ref('') // 弹窗的标题
const formLoading = ref(false) // 表单的加载中1修改时的数据加载2提交的按钮禁用
const formType = ref('') // 表单的类型create - 新增update - 修改
const productList = ref<ProductVO[]>([]) // 产品列表
const formData = ref({
id: undefined,
name: undefined,
description: undefined,
version: undefined,
productId: undefined,
fileUrl: ''
})
const formRules = reactive({
name: [{ required: true, message: '固件名称不能为空', trigger: 'blur' }],
version: [{ required: true, message: '版本号不能为空', trigger: 'blur' }],
productId: [{ required: true, message: '产品不能为空', trigger: 'change' }],
fileUrl: [{ required: true, message: '固件文件不能为空', trigger: 'blur' }]
})
const formRef = ref() // 表单 Ref
/** 打开弹窗 */
const open = async (type: string, id?: number) => {
dialogVisible.value = true
dialogTitle.value = t('action.' + type)
formType.value = type
resetForm()
// 修改时,设置数据
if (id) {
formLoading.value = true
try {
formData.value = await IoTOtaFirmwareApi.getOtaFirmware(id)
} finally {
formLoading.value = false
}
}
// 获取产品列表
productList.value = await ProductApi.getSimpleProductList()
}
defineExpose({ open }) // 提供 open 方法,用于打开弹窗
/** 提交表单 */
const emit = defineEmits(['success']) // 定义 success 事件,用于操作成功后的回调
const submitForm = async () => {
// 校验表单
await formRef.value.validate()
// 提交请求
formLoading.value = true
try {
const data = formData.value as unknown as IoTOtaFirmware
if (formType.value === 'create') {
await IoTOtaFirmwareApi.createOtaFirmware(data)
message.success(t('common.createSuccess'))
} else {
// 更新时只提交可编辑的字段
await IoTOtaFirmwareApi.updateOtaFirmware({
id: data.id,
name: data.name,
description: data.description
})
message.success(t('common.updateSuccess'))
}
dialogVisible.value = false
// 发送操作成功的事件
emit('success')
} finally {
formLoading.value = false
}
}
/** 重置表单 */
const resetForm = () => {
formData.value = {
id: undefined,
name: undefined,
description: undefined,
version: undefined,
productId: undefined,
fileUrl: ''
}
formRef.value?.resetFields()
}
</script>

View File

@ -0,0 +1,220 @@
<template>
<ContentWrap>
<!-- 搜索工作栏 -->
<el-form
class="-mb-15px"
:model="queryParams"
ref="queryFormRef"
:inline="true"
label-width="68px"
>
<el-form-item label="固件名称" prop="name">
<el-input
v-model="queryParams.name"
placeholder="请输入固件名称"
clearable
@keyup.enter="handleQuery"
class="!w-240px"
/>
</el-form-item>
<el-form-item label="产品" prop="productId">
<el-select
v-model="queryParams.productId"
placeholder="请选择产品"
clearable
@keyup.enter="handleQuery"
class="!w-240px"
>
<el-option
v-for="product in productList"
:key="product.id"
:label="product.name"
:value="product.id"
/>
</el-select>
</el-form-item>
<el-form-item label="创建时间" prop="createTime">
<el-date-picker
v-model="queryParams.createTime"
value-format="YYYY-MM-DD HH:mm:ss"
type="daterange"
start-placeholder="开始日期"
end-placeholder="结束日期"
:default-time="[new Date('1 00:00:00'), new Date('1 23:59:59')]"
class="!w-220px"
/>
</el-form-item>
<el-form-item>
<el-button @click="handleQuery"><Icon icon="ep:search" class="mr-5px" /> 搜索</el-button>
<el-button @click="resetQuery"><Icon icon="ep:refresh" class="mr-5px" /> 重置</el-button>
<el-button
type="primary"
plain
@click="openForm('create')"
v-hasPermi="['iot:ota-firmware:create']"
>
<Icon icon="ep:plus" class="mr-5px" /> 新增
</el-button>
</el-form-item>
</el-form>
</ContentWrap>
<!-- 列表 -->
<ContentWrap>
<el-table
row-key="id"
v-loading="loading"
:data="list"
:stripe="true"
:show-overflow-tooltip="true"
>
<el-table-column label="固件编号" align="center" prop="id" />
<el-table-column label="固件名称" align="center" prop="name" />
<el-table-column label="固件版本" align="center" prop="description" />
<el-table-column label="版本号" align="center" prop="version" />
<el-table-column label="所属产品" align="center" prop="productId">
<template #default="scope">
<el-link
@click="openProductDetail(scope.row.productId)"
v-if="getProductName(scope.row.productId)"
>
{{ getProductName(scope.row.productId) }}
</el-link>
<span v-else>加载中...</span>
</template>
</el-table-column>
<el-table-column label="固件文件" align="center" prop="fileUrl">
<template #default="scope">
<el-link :href="scope.row.fileUrl" target="_blank" download>
<Icon icon="ep:download" class="mr-5px" />
下载固件
</el-link>
</template>
</el-table-column>
<el-table-column
label="创建时间"
align="center"
prop="createTime"
:formatter="dateFormatter"
width="180px"
/>
<el-table-column label="操作" align="center" min-width="120px">
<template #default="scope">
<el-button
link
type="primary"
@click="openForm('update', scope.row.id)"
v-hasPermi="['iot:ota-firmware:update']"
>
编辑
</el-button>
<el-button
link
type="danger"
@click="handleDelete(scope.row.id)"
v-hasPermi="['iot:ota-firmware:delete']"
>
删除
</el-button>
</template>
</el-table-column>
</el-table>
<!-- 分页 -->
<Pagination
:total="total"
v-model:page="queryParams.pageNo"
v-model:limit="queryParams.pageSize"
@pagination="getList"
/>
</ContentWrap>
<!-- 表单弹窗添加/修改 -->
<OtaFirmwareForm ref="formRef" @success="getList" />
</template>
<script setup lang="ts">
import { dateFormatter } from '@/utils/formatTime'
import { IoTOtaFirmwareApi, IoTOtaFirmware } from '@/api/iot/ota/firmware'
import { ProductApi, ProductVO } from '@/api/iot/product/product'
import OtaFirmwareForm from './OtaFirmwareForm.vue'
/** IoT OTA 固件列表 */
defineOptions({ name: 'IoTOtaFirmware' })
const message = useMessage() // 消息弹窗
const { t } = useI18n() // 国际化
const { push } = useRouter() // 路由
const loading = ref(true) // 列表的加载中
const list = ref<IoTOtaFirmware[]>([]) // 列表的数据
const total = ref(0) // 列表的总页数
const productList = ref<ProductVO[]>([]) // 产品列表
const queryParams = reactive({
pageNo: 1,
pageSize: 10,
name: undefined,
productId: undefined,
createTime: []
})
const queryFormRef = ref() // 搜索的表单
/** 查询列表 */
const getList = async () => {
loading.value = true
try {
const data = await IoTOtaFirmwareApi.getOtaFirmwarePage(queryParams)
list.value = data.list
total.value = data.total
} finally {
loading.value = false
}
}
/** 根据产品编号,获取产品名称 */
const getProductName = (productId: number) => {
const product = productList.value.find((p) => p.id === productId)
return product?.name || ''
}
/** 打开产品详情 */
const openProductDetail = (productId: number) => {
push({ name: 'IoTProductDetail', params: { id: productId } })
}
/** 搜索按钮操作 */
const handleQuery = () => {
queryParams.pageNo = 1
getList()
}
/** 重置按钮操作 */
const resetQuery = () => {
queryFormRef.value.resetFields()
handleQuery()
}
/** 添加/修改操作 */
const formRef = ref()
const openForm = (type: string, id?: number) => {
formRef.value.open(type, id)
}
/** 删除按钮操作 */
const handleDelete = async (id: number) => {
try {
// 删除的二次确认
await message.delConfirm()
// 发起删除
await IoTOtaFirmwareApi.deleteOtaFirmware(id)
message.success(t('common.delSuccess'))
// 刷新列表
await getList()
} catch {}
}
/** 初始化 **/
onMounted(async () => {
productList.value = await ProductApi.getSimpleProductList()
getList()
})
</script>