docs: add cell storage protocol modules design for 2.2.6–2.2.10

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
zlwuandCursor committed 2026-05-13 17:48:22 +08:00
1 parent 058811ae77
commit 246ad2228e
153 files changed
+20578 -2040

No files matched your search

+494
View File
@@ -0,0 +1,494 @@
<!-- 菜单管理 -->
<template>
<div class="page-container">
<header class="page-head">
<h1>菜单管理</h1>
<p class="page-desc">管理系统菜单树,支持目录、菜单、按钮三种类型。</p>
</header>
<section class="panel">
<div class="panel-top">
<h2 class="title-bar-heading">菜单列表</h2>
</div>
<div class="filter-block">
<el-form :model="searchForm" class="filter-form" @submit.prevent>
<div class="filter-grid">
<el-form-item label="关键词">
<el-input v-model="searchForm.keyword" placeholder="菜单名称" clearable />
</el-form-item>
</div>
<div class="filter-actions-row">
<span class="filter-hint">按菜单名称模糊查询。</span>
<div class="filter-actions-end">
<el-button class="btn-ghost" @click="handleReset">重置</el-button>
<el-button class="btn-main" type="primary" @click="handleSearch">搜索</el-button>
</div>
</div>
</el-form>
</div>
<div class="list-toolbar">
<div class="list-toolbar-row">
<div class="list-toolbar-selected">
已选 <span class="sel-num">{{ selectedRows.length }}</span> 项
</div>
<el-button class="btn-main" type="primary" @click="handleAdd">
<el-icon><Plus /></el-icon>
新增
</el-button>
<el-button class="btn-ghost" @click="toggleExpand">
{{ isExpandAll ? '全部折叠' : '全部展开' }}
</el-button>
</div>
</div>
<div class="list-body list-wrap">
<el-table
ref="tableRef"
class="list-table"
:data="tableData"
v-loading="loading"
stripe
row-key="id"
:tree-props="{ children: 'children', hasChildren: 'hasChildren' }"
:default-expand-all="isExpandAll"
@selection-change="handleSelectionChange"
>
<el-table-column
type="selection"
width="55"
align="center"
header-align="center"
/>
<el-table-column
prop="menuName"
label="菜单名称"
min-width="180"
/>
<el-table-column
prop="menuType"
label="类型"
width="90"
align="center"
header-align="center"
>
<template #default="{ row }">
<el-tag
:type="menuTypeTagMap[row.menuType]?.type || 'info'"
size="small"
>
{{ menuTypeTagMap[row.menuType]?.label || row.menuType }}
</el-tag>
</template>
</el-table-column>
<el-table-column
prop="path"
label="路由路径"
min-width="140"
align="center"
header-align="center"
>
<template #default="{ row }">
{{ row.path || '-' }}
</template>
</el-table-column>
<el-table-column
prop="component"
label="组件路径"
min-width="160"
align="center"
header-align="center"
>
<template #default="{ row }">
{{ row.component || '-' }}
</template>
</el-table-column>
<el-table-column
prop="perms"
label="权限标识"
min-width="140"
align="center"
header-align="center"
>
<template #default="{ row }">
{{ row.perms || '-' }}
</template>
</el-table-column>
<el-table-column
prop="visible"
label="可见"
width="80"
align="center"
header-align="center"
>
<template #default="{ row }">
<el-tag :type="row.visible === '1' ? 'success' : 'info'" size="small">
{{ row.visible === '1' ? '显示' : '隐藏' }}
</el-tag>
</template>
</el-table-column>
<el-table-column
prop="status"
label="状态"
width="80"
align="center"
header-align="center"
>
<template #default="{ row }">
<el-tag :type="row.status === '1' ? 'success' : 'danger'" size="small">
{{ row.status === '1' ? '正常' : '停用' }}
</el-tag>
</template>
</el-table-column>
<el-table-column
prop="orderNum"
label="排序"
width="70"
align="center"
header-align="center"
/>
<el-table-column
label="操作"
width="320"
fixed="right"
align="center"
header-align="center"
>
<template #default="{ row }">
<el-button class="btn-op-item primary" @click="handleAddChild(row)">
新增子菜单
</el-button>
<el-button class="btn-op-item" @click="handleEdit(row)">编辑</el-button>
<el-button class="btn-op-item" @click="handleDelete(row)">删除</el-button>
</template>
</el-table-column>
</el-table>
</div>
<el-dialog
v-model="dialogVisible"
:title="dialogTitle"
width="560px"
class="dialog-form-layout"
align-center
destroy-on-close
:close-on-click-modal="false"
@close="handleDialogClose"
>
<el-form
ref="formRef"
:model="formData"
:rules="formRules"
label-position="top"
class="menu-dialog-form"
scroll-to-error
:scroll-into-view-options="{ behavior: 'smooth', block: 'center' }"
>
<div class="form-grid-2">
<el-form-item
v-if="formData.parentId && formData.parentId !== '0'"
label="上级菜单"
style="grid-column: 1 / -1"
>
<el-input :model-value="parentMenuName" disabled />
</el-form-item>
<el-form-item label="菜单名称" prop="menuName" style="grid-column: 1 / -1">
<el-input v-model="formData.menuName" placeholder="请输入菜单名称" />
</el-form-item>
<el-form-item label="菜单类型" prop="menuType">
<el-select v-model="formData.menuType" placeholder="请选择菜单类型">
<el-option label="目录" value="M" />
<el-option label="菜单" value="C" />
<el-option label="按钮" value="F" />
</el-select>
</el-form-item>
<el-form-item label="是否外链">
<el-select v-model="formData.isFrame" placeholder="请选择">
<el-option label="否" :value="1" />
<el-option label="是" :value="0" />
</el-select>
</el-form-item>
<el-form-item label="路由路径">
<el-input v-model="formData.path" placeholder="请输入路由路径" />
</el-form-item>
<el-form-item v-if="formData.menuType === 'C'" label="组件路径">
<el-input v-model="formData.component" placeholder="请输入组件路径" />
</el-form-item>
<el-form-item v-if="formData.menuType === 'F'" label="权限标识">
<el-input v-model="formData.perms" placeholder="如 system:menu:list" />
</el-form-item>
<el-form-item label="显示状态">
<el-select v-model="formData.visible" placeholder="请选择">
<el-option label="显示" value="1" />
<el-option label="隐藏" value="0" />
</el-select>
</el-form-item>
<el-form-item label="状态">
<el-select v-model="formData.status" placeholder="请选择状态">
<el-option label="正常" value="1" />
<el-option label="停用" value="0" />
</el-select>
</el-form-item>
<el-form-item label="排序">
<el-input-number
v-model="formData.orderNum"
:min="0"
:max="9999"
controls-position="right"
/>
</el-form-item>
<el-form-item label="备注" style="grid-column: 1 / -1">
<el-input
v-model="formData.remark"
type="textarea"
:rows="2"
placeholder="可选"
/>
</el-form-item>
</div>
</el-form>
<template #footer>
<el-button class="btn-ghost" @click="dialogVisible = false">
<el-icon><Close /></el-icon>
取消
</el-button>
<el-button
class="btn-main"
type="primary"
@click="handleSubmit"
:loading="submitLoading"
>
<el-icon><Check /></el-icon>
确定
</el-button>
</template>
</el-dialog>
</section>
</div>
</template>
<script setup lang="ts">
import { ref, reactive, computed, onMounted } from 'vue'
import { ElMessage, ElMessageBox } from 'element-plus'
import { Plus, Close, Check } from '@element-plus/icons-vue'
import {
fetchMenuTree,
fetchCreateMenu,
fetchUpdateMenu,
fetchDeleteMenu
} from '@/api/admin'
defineOptions({ name: 'SystemMenu' })
const menuTypeTagMap: Record<string, { label: string; type: string }> = {
M: { label: '目录', type: '' },
C: { label: '菜单', type: 'success' },
F: { label: '按钮', type: 'warning' }
}
const searchForm = reactive<{ keyword: string }>({ keyword: '' })
const tableData = ref<Api.Menu.MenuItem[]>([])
const selectedRows = ref<Api.Menu.MenuItem[]>([])
const loading = ref(false)
const isExpandAll = ref(true)
const tableRef = ref()
const dialogVisible = ref(false)
const dialogTitle = ref('新增菜单')
const isEdit = ref(false)
const submitLoading = ref(false)
const formRef = ref()
const editingId = ref<string | null>(null)
const formData = reactive({
parentId: '0',
menuName: '',
menuType: 'M',
path: '',
component: '',
perms: '',
isFrame: 1,
visible: '1',
status: '1',
orderNum: 0,
remark: ''
})
const formRules = {
menuName: [{ required: true, message: '请输入菜单名称', trigger: 'blur' }],
menuType: [{ required: true, message: '请选择菜单类型', trigger: 'change' }]
}
const parentMenuName = computed(() => {
if (!formData.parentId || formData.parentId === '0') return ''
const findName = (items: Api.Menu.MenuItem[]): string => {
for (const item of items) {
if (item.id === formData.parentId) return item.menuName
if (item.children?.length) {
const found = findName(item.children)
if (found) return found
}
}
return ''
}
return findName(tableData.value)
})
const handleSelectionChange = (rows: Api.Menu.MenuItem[]) => {
selectedRows.value = rows
}
async function loadData() {
loading.value = true
try {
const res = await fetchMenuTree({
keyword: searchForm.keyword || undefined
})
tableData.value = Array.isArray(res) ? res : []
} catch (error) {
console.error('加载菜单数据失败:', error)
} finally {
loading.value = false
}
}
function handleSearch() {
loadData()
}
function handleReset() {
searchForm.keyword = ''
loadData()
}
function toggleExpand() {
isExpandAll.value = !isExpandAll.value
tableData.value = [...tableData.value]
}
function resetForm() {
formData.parentId = '0'
formData.menuName = ''
formData.menuType = 'M'
formData.path = ''
formData.component = ''
formData.perms = ''
formData.isFrame = 1
formData.visible = '1'
formData.status = '1'
formData.orderNum = 0
formData.remark = ''
editingId.value = null
}
function handleAdd() {
isEdit.value = false
dialogTitle.value = '新增菜单'
resetForm()
formData.parentId = '0'
dialogVisible.value = true
formRef.value?.clearValidate?.()
}
function handleAddChild(row: Api.Menu.MenuItem) {
isEdit.value = false
dialogTitle.value = '新增子菜单'
resetForm()
formData.parentId = row.id
dialogVisible.value = true
formRef.value?.clearValidate?.()
}
function handleEdit(row: Api.Menu.MenuItem) {
isEdit.value = true
dialogTitle.value = '编辑菜单'
editingId.value = row.id
formData.parentId = row.parentId || '0'
formData.menuName = row.menuName || ''
formData.menuType = row.menuType || 'M'
formData.path = row.path || ''
formData.component = row.component || ''
formData.perms = row.perms || ''
formData.isFrame = row.isFrame ?? 1
formData.visible = row.visible || '1'
formData.status = row.status || '1'
formData.orderNum = row.orderNum ?? 0
formData.remark = row.remark || ''
dialogVisible.value = true
formRef.value?.clearValidate?.()
}
async function handleSubmit() {
await formRef.value?.validate?.()
submitLoading.value = true
try {
const payload = {
parentId: formData.parentId || undefined,
menuName: formData.menuName.trim(),
menuType: formData.menuType,
path: formData.path?.trim() || undefined,
component: formData.menuType === 'C' ? formData.component?.trim() || undefined : undefined,
perms: formData.menuType === 'F' ? formData.perms?.trim() || undefined : undefined,
isFrame: formData.isFrame,
visible: formData.visible,
status: formData.status,
orderNum: formData.orderNum,
remark: formData.remark?.trim() || undefined
}
if (isEdit.value && editingId.value) {
await fetchUpdateMenu(editingId.value, payload)
} else {
await fetchCreateMenu(payload)
}
ElMessage.success(isEdit.value ? '更新成功' : '创建成功')
dialogVisible.value = false
await loadData()
} catch {
/* 校验或接口错误已由全局处理 */
} finally {
submitLoading.value = false
}
}
async function handleDelete(row: Api.Menu.MenuItem) {
try {
const childCount = row.children?.length || 0
const confirmText = childCount
? `该菜单下有 ${childCount} 个子菜单,删除将一并删除全部子菜单。确定继续吗?`
: '确定要删除该菜单吗?'
await ElMessageBox.confirm(confirmText, '提示', { type: 'warning' })
await fetchDeleteMenu(row.id)
ElMessage.success('删除成功')
await loadData()
} catch (error: any) {
if (error !== 'cancel') console.error('删除失败:', error)
}
}
function handleDialogClose() {
resetForm()
formRef.value?.clearValidate()
}
onMounted(() => {
loadData()
})
</script>
<style scoped lang="scss">
.menu-dialog-form {
:deep(.el-form-item) {
margin-bottom: 0;
}
:deep(.el-form-item__label) {
font-size: 11px;
font-weight: 500;
color: var(--mint-text-muted);
padding: 0 0 4px;
line-height: 1.2;
}
}
</style>