415 lines
19 KiB
Vue
415 lines
19 KiB
Vue
<script setup lang="ts">
|
||
import '@/styles/adminWorkbench.css'
|
||
import InlineHelp from '@/shared/components/InlineHelp.vue'
|
||
import '@/styles/adminDensity.css'
|
||
import { computed, onMounted, reactive, ref, watch } from 'vue'
|
||
import { ElMessage, ElMessageBox, type FormInstance, type FormRules } from 'element-plus'
|
||
import { ExternalLink, FileUp, Plus, Save, Truck } from '@lucide/vue'
|
||
import ApiErrorMeta from '@/shared/components/ApiErrorMeta.vue'
|
||
import AdminPage from '@/shared/components/AdminPage.vue'
|
||
import BatchImportDialog from '@/shared/components/BatchImportDialog.vue'
|
||
import DataTable, { type DataTableColumn } from '@/shared/components/DataTable.vue'
|
||
import FormSection from '@/shared/components/FormSection.vue'
|
||
import ListPageLayout from '@/shared/components/ListPageLayout.vue'
|
||
import QueryToolbar, { type QueryField, type QueryModel } from '@/shared/components/QueryToolbar.vue'
|
||
import { useUnsavedWorkRegistration } from '@/core/unsaved-work/useUnsavedWorkRegistration'
|
||
import { getApiErrorDetails, type ApiErrorDetails } from '@/shared/api/http'
|
||
import {
|
||
changePlatformExpressCompanyStatus,
|
||
createPlatformExpressCompany,
|
||
downloadPlatformExpressCompanyImportTemplate,
|
||
getPlatformExpressCompany,
|
||
importPlatformExpressCompanies,
|
||
listPlatformExpressCompanies,
|
||
updatePlatformExpressCompany,
|
||
type PlatformExpressCompanyResource,
|
||
type PlatformExpressCompanyStatus,
|
||
type SavePlatformExpressCompanyRequest,
|
||
} from '@/modules/master-data/express-companies/api/platformExpressCompanies'
|
||
import { useAccessPreviewStore } from '@/core/access/accessPreview'
|
||
|
||
const access = useAccessPreviewStore()
|
||
const loading = ref(false)
|
||
const saving = ref(false)
|
||
const editorOpen = ref(false)
|
||
const importOpen = ref(false)
|
||
const formRef = ref<FormInstance>()
|
||
const rows = ref<PlatformExpressCompanyResource[]>([])
|
||
const page = ref(1)
|
||
const pageSize = ref(20)
|
||
const total = ref(0)
|
||
const loadError = ref<ApiErrorDetails | null>(null)
|
||
const statusLoadingIds = ref(new Set<string>())
|
||
const editLoadingIds = ref(new Set<string>())
|
||
type ExpressCompanyFilters = QueryModel & {
|
||
keyword: string
|
||
status: PlatformExpressCompanyStatus | ''
|
||
}
|
||
const filters = ref<ExpressCompanyFilters>({ keyword: '', status: '' })
|
||
const appliedFilters = ref<ExpressCompanyFilters>({ ...filters.value })
|
||
const queryFields = computed<QueryField[]>(() => [
|
||
{ key: 'keyword', type: 'input', label: '快递公司名称', placeholder: '请输入快递公司名称', props: { maxlength: 128, 'aria-label': '快递公司名称' } },
|
||
{
|
||
key: 'status',
|
||
type: 'select',
|
||
label: '状态',
|
||
placeholder: '全部状态',
|
||
props: { 'aria-label': '快递公司状态' },
|
||
options: [
|
||
{ label: '启用', value: 'ACTIVE' },
|
||
{ label: '停用', value: 'INACTIVE' },
|
||
],
|
||
},
|
||
])
|
||
let loadSequence = 0
|
||
let editorLoadSequence = 0
|
||
|
||
const emptyForm = (): SavePlatformExpressCompanyRequest & { id: string } => ({
|
||
id: '',
|
||
companyCode: '',
|
||
companyName: '',
|
||
servicePhone: null,
|
||
website: null,
|
||
trackingUrlTemplate: null,
|
||
status: 'ACTIVE',
|
||
remark: null,
|
||
})
|
||
const form = reactive(emptyForm())
|
||
const rules: FormRules<typeof form> = {
|
||
companyCode: [{ required: true, message: '请输入快递公司编码', trigger: 'blur' }],
|
||
companyName: [{ required: true, message: '请输入快递公司名称', trigger: 'blur' }],
|
||
website: [{ type: 'url', message: '请输入以 http:// 或 https:// 开头的完整网址', trigger: 'blur' }],
|
||
status: [{ required: true, message: '请选择状态', trigger: 'change' }],
|
||
}
|
||
const editorTitle = computed(() => form.id ? '编辑快递公司' : '新增快递公司')
|
||
const editorPermission = computed(() => form.id ? 'platform:express:edit' : 'platform:express:create')
|
||
const { captureBaseline } = useUnsavedWorkRegistration({
|
||
key: 'express-company-editor',
|
||
label: editorTitle,
|
||
isOpen: editorOpen,
|
||
model: form,
|
||
requiredPermission: editorPermission,
|
||
})
|
||
|
||
watch(
|
||
() => access.can(editorPermission.value),
|
||
(canWrite) => {
|
||
if (canWrite || !editorOpen.value) return
|
||
editorOpen.value = false
|
||
Object.assign(form, emptyForm())
|
||
},
|
||
{ flush: 'sync' },
|
||
)
|
||
|
||
function optionalText(value: string | null) {
|
||
const trimmed = value?.trim()
|
||
return trimmed || null
|
||
}
|
||
|
||
function safeHttpUrl(value: string | null) {
|
||
if (!value) return null
|
||
try {
|
||
const url = new URL(value)
|
||
return ['http:', 'https:'].includes(url.protocol) ? url.toString() : null
|
||
} catch {
|
||
return null
|
||
}
|
||
}
|
||
|
||
function formatUpdatedAt(value?: string | null) {
|
||
return value?.replace('T', ' ').slice(0, 16) || '—'
|
||
}
|
||
|
||
const expressCompanyColumns: DataTableColumn[] = [
|
||
{ key: 'actions', label: '操作', width: 170, fixed: 'left', slotName: 'actions' },
|
||
{ key: 'company', label: '公司名称', minWidth: 210, slotName: 'company' },
|
||
{ key: 'companyCode', prop: 'companyCode', label: '编码', minWidth: 120 },
|
||
{ key: 'status', label: '状态', width: 100, slotName: 'status', afterColumn: 'companyCode' },
|
||
{ key: 'website', label: '官方网站', minWidth: 210, slotName: 'website' },
|
||
{ key: 'servicePhone', prop: 'servicePhone', label: '客服电话', minWidth: 130, formatter: (row: PlatformExpressCompanyResource) => row.servicePhone || '—' },
|
||
{ key: 'updatedAt', prop: 'updatedAt', label: '更新时间', minWidth: 150, defaultVisible: false, formatter: (row: PlatformExpressCompanyResource) => formatUpdatedAt(row.updatedAt) },
|
||
]
|
||
|
||
async function loadExpressCompanies() {
|
||
const sequence = ++loadSequence
|
||
loading.value = true
|
||
loadError.value = null
|
||
try {
|
||
const result = await listPlatformExpressCompanies(
|
||
page.value,
|
||
pageSize.value,
|
||
appliedFilters.value.keyword,
|
||
appliedFilters.value.status,
|
||
)
|
||
if (sequence !== loadSequence) return
|
||
rows.value = result.records
|
||
total.value = result.total
|
||
} catch (error) {
|
||
if (sequence !== loadSequence) return
|
||
rows.value = []
|
||
total.value = 0
|
||
loadError.value = getApiErrorDetails(error, '快递公司加载失败，请稍后重试')
|
||
} finally {
|
||
if (sequence === loadSequence) loading.value = false
|
||
}
|
||
}
|
||
|
||
function applyFilters(model: QueryModel) {
|
||
appliedFilters.value = {
|
||
keyword: String(model.keyword || ''),
|
||
status: (model.status || '') as PlatformExpressCompanyStatus | '',
|
||
}
|
||
if (page.value === 1) {
|
||
void loadExpressCompanies()
|
||
return
|
||
}
|
||
page.value = 1
|
||
}
|
||
|
||
function openCreate() {
|
||
editorLoadSequence += 1
|
||
Object.assign(form, emptyForm())
|
||
captureBaseline()
|
||
editorOpen.value = true
|
||
void formRef.value?.clearValidate()
|
||
}
|
||
|
||
function assignEditor(row: PlatformExpressCompanyResource) {
|
||
Object.assign(form, {
|
||
id: String(row.id),
|
||
companyCode: row.companyCode,
|
||
companyName: row.companyName,
|
||
servicePhone: row.servicePhone,
|
||
website: row.website,
|
||
trackingUrlTemplate: row.trackingUrlTemplate,
|
||
status: row.status,
|
||
remark: row.remark,
|
||
})
|
||
captureBaseline()
|
||
editorOpen.value = true
|
||
void formRef.value?.clearValidate()
|
||
}
|
||
|
||
async function openEdit(row: PlatformExpressCompanyResource) {
|
||
const sequence = ++editorLoadSequence
|
||
const id = String(row.id)
|
||
const pending = new Set(editLoadingIds.value)
|
||
pending.add(id)
|
||
editLoadingIds.value = pending
|
||
try {
|
||
const result = await getPlatformExpressCompany(row.id)
|
||
if (sequence !== editorLoadSequence) return
|
||
assignEditor(result)
|
||
} catch (error) {
|
||
if (sequence !== editorLoadSequence) return
|
||
const details = getApiErrorDetails(error, '快递公司详情加载失败，请稍后重试')
|
||
ElMessage.error(details.requestId ? `${details.message}（requestId: ${details.requestId}）` : details.message)
|
||
} finally {
|
||
const next = new Set(editLoadingIds.value)
|
||
next.delete(id)
|
||
editLoadingIds.value = next
|
||
}
|
||
}
|
||
|
||
function openImport() {
|
||
importOpen.value = true
|
||
}
|
||
|
||
function buildPayload(): SavePlatformExpressCompanyRequest {
|
||
return {
|
||
companyCode: form.companyCode.trim(),
|
||
companyName: form.companyName.trim(),
|
||
servicePhone: optionalText(form.servicePhone),
|
||
website: optionalText(form.website),
|
||
trackingUrlTemplate: optionalText(form.trackingUrlTemplate),
|
||
status: form.status,
|
||
remark: optionalText(form.remark),
|
||
}
|
||
}
|
||
|
||
async function saveExpressCompany() {
|
||
const valid = await formRef.value?.validate().catch(() => false)
|
||
if (!valid) return
|
||
saving.value = true
|
||
try {
|
||
const payload = buildPayload()
|
||
if (form.id) await updatePlatformExpressCompany(form.id, payload)
|
||
else await createPlatformExpressCompany(payload)
|
||
editorOpen.value = false
|
||
ElMessage.success(form.id ? '快递公司资料已更新' : '快递公司已创建')
|
||
await loadExpressCompanies()
|
||
} catch (error) {
|
||
const details = getApiErrorDetails(error, '快递公司保存失败，请检查后重试')
|
||
ElMessage.error(details.requestId ? `${details.message}（requestId: ${details.requestId}）` : details.message)
|
||
} finally {
|
||
saving.value = false
|
||
}
|
||
}
|
||
|
||
async function toggleStatus(row: PlatformExpressCompanyResource) {
|
||
const nextStatus: PlatformExpressCompanyStatus = row.status === 'ACTIVE' ? 'INACTIVE' : 'ACTIVE'
|
||
const action = nextStatus === 'ACTIVE' ? '启用' : '停用'
|
||
try {
|
||
await ElMessageBox.confirm(
|
||
`确定${action}“${row.companyName}”吗？${nextStatus === 'INACTIVE' ? '停用后不会再作为可用快递公司。' : ''}`,
|
||
`${action}快递公司`,
|
||
{ customClass: 'admin-density-confirm admin-workbench', type: nextStatus === 'ACTIVE' ? 'success' : 'warning', confirmButtonText: `确认${action}`, cancelButtonText: '取消' },
|
||
)
|
||
} catch {
|
||
return
|
||
}
|
||
const id = String(row.id)
|
||
const pending = new Set(statusLoadingIds.value)
|
||
pending.add(id)
|
||
statusLoadingIds.value = pending
|
||
try {
|
||
await changePlatformExpressCompanyStatus(row.id, nextStatus)
|
||
ElMessage.success(`已${action}${row.companyName}`)
|
||
await loadExpressCompanies()
|
||
} catch (error) {
|
||
const details = getApiErrorDetails(error, `${action}快递公司失败`)
|
||
ElMessage.error(details.requestId ? `${details.message}（requestId: ${details.requestId}）` : details.message)
|
||
} finally {
|
||
const next = new Set(statusLoadingIds.value)
|
||
next.delete(id)
|
||
statusLoadingIds.value = next
|
||
}
|
||
}
|
||
|
||
watch([page, pageSize], () => { void loadExpressCompanies() })
|
||
onMounted(() => {
|
||
void loadExpressCompanies()
|
||
})
|
||
</script>
|
||
|
||
<template>
|
||
<AdminPage class="admin-density admin-workbench">
|
||
<div class="business-page express-company-page">
|
||
<ListPageLayout ariaLabel="快递公司列表">
|
||
|
||
|
||
|
||
<section class="workbench-table is-page-surface"><DataTable appearance="integrated" column-settings-mode="show" :results-visible="!loadError"
|
||
v-model:page="page"
|
||
v-model:page-size="pageSize"
|
||
:data="rows"
|
||
:columns="expressCompanyColumns"
|
||
preference-key="express-companies-table"
|
||
:loading="loading"
|
||
:total="total"
|
||
:page-sizes="[20, 50, 100]"
|
||
aria-label="快递公司列表"
|
||
row-key="id"
|
||
:empty-text="appliedFilters.keyword.trim() || appliedFilters.status ? '暂无符合筛选条件的快递公司' : '暂无快递公司档案'"
|
||
>
|
||
<template #toolbar-start><h1>快递公司</h1></template>
|
||
<template #filters>
|
||
<QueryToolbar v-model="filters" ariaLabel="快递公司筛选" :fields="queryFields" preference-key="express-companies-query" @search="applyFilters" />
|
||
</template>
|
||
<template #notices><template v-if="loadError">
|
||
<el-alert type="error" :closable="false" show-icon class="state-alert">
|
||
<template #title>快递公司加载失败</template>
|
||
<p>{{ loadError.message }}</p>
|
||
<ApiErrorMeta :details="loadError" />
|
||
<el-button size="small" @click="loadExpressCompanies()">重新查询</el-button>
|
||
</el-alert>
|
||
</template></template>
|
||
|
||
|
||
<template #toolbar-actions><div class="table-actions"><el-button v-if="access.can('platform:express:import')" :disabled="loading" @click="openImport"><FileUp :size="16" />批量导入</el-button><el-button v-if="access.can('platform:express:create')" type="primary" :disabled="loading" @click="openCreate"><Plus :size="16" />新增快递公司</el-button></div></template>
|
||
<template #actions="{ row }"><div class="row-actions density-actions admin-text-actions">
|
||
<div v-if="access.can('platform:express:edit') || access.can('platform:express:status')" class="table-actions density-actions">
|
||
<el-button data-tone="neutral" class="density-action"
|
||
v-if="access.can('platform:express:edit')"
|
||
size="small"
|
||
|
||
|
||
:disabled="loading"
|
||
:loading="editLoadingIds.has(String((row as PlatformExpressCompanyResource).id))"
|
||
@click="openEdit(row as PlatformExpressCompanyResource)"
|
||
>编辑</el-button>
|
||
<el-button class="density-action"
|
||
v-if="access.can('platform:express:status')"
|
||
size="small"
|
||
|
||
:disabled="loading"
|
||
:data-tone="(row as PlatformExpressCompanyResource).status === 'ACTIVE' ? 'danger' : 'success'"
|
||
:loading="statusLoadingIds.has(String((row as PlatformExpressCompanyResource).id))"
|
||
@click="toggleStatus(row as PlatformExpressCompanyResource)"
|
||
>{{ (row as PlatformExpressCompanyResource).status === 'ACTIVE' ? '停用' : '启用' }}</el-button>
|
||
</div>
|
||
<span v-else class="muted-value">仅查看</span>
|
||
</div></template>
|
||
<template #company="{ row }"><div class="express-company-cell"><span><Truck :size="17" /></span><div><strong>{{ (row as PlatformExpressCompanyResource).companyName }}</strong></div></div></template>
|
||
<template #website="{ row }">
|
||
<a v-if="safeHttpUrl((row as PlatformExpressCompanyResource).website)" class="external-link" :href="safeHttpUrl((row as PlatformExpressCompanyResource).website)!" target="_blank" rel="noopener noreferrer">访问官网<ExternalLink :size="13" /></a>
|
||
<span v-else class="muted-value">{{ (row as PlatformExpressCompanyResource).website || '—' }}</span>
|
||
</template>
|
||
<template #status="{ row }"><el-tag :type="(row as PlatformExpressCompanyResource).status === 'ACTIVE' ? 'success' : 'info'" effect="light">{{ (row as PlatformExpressCompanyResource).status === 'ACTIVE' ? '启用' : '停用' }}</el-tag></template>
|
||
<template #empty>
|
||
<el-empty v-if="!loading" :description="appliedFilters.keyword.trim() || appliedFilters.status ? '暂无符合筛选条件的快递公司' : '暂无快递公司档案'">
|
||
<el-button v-if="!appliedFilters.keyword.trim() && !appliedFilters.status && access.can('platform:express:create')" type="primary" @click="openCreate"><Plus :size="16" />新增第一家快递公司</el-button>
|
||
</el-empty>
|
||
</template>
|
||
<template #pagination-left="{ total: tableTotal }"><span>平台公共数据 · 共 {{ tableTotal }} 家快递公司</span></template>
|
||
</DataTable></section>
|
||
</ListPageLayout>
|
||
|
||
<BatchImportDialog class="admin-density-dialog admin-workbench is-dialog"
|
||
v-model="importOpen"
|
||
title="批量导入快递公司"
|
||
entity-label="快递公司"
|
||
success-unit="家"
|
||
template-file-name="快递公司批量导入模板-v1.xlsx"
|
||
error-report-file-name="快递公司导入错误报告.csv"
|
||
:download-template="downloadPlatformExpressCompanyImportTemplate"
|
||
:import-file="importPlatformExpressCompanies"
|
||
@success="loadExpressCompanies"
|
||
/>
|
||
|
||
<el-drawer v-model="editorOpen" :title="editorTitle" size="580px" class="editor-drawer admin-density admin-density-drawer admin-workbench is-drawer" :close-on-click-modal="false">
|
||
<el-form ref="formRef" :model="form" :rules="rules" label-position="top" class="density-form" :disabled="saving">
|
||
<FormSection class="density-form-section" title="基础信息">
|
||
<div class="form-grid two-cols">
|
||
<el-form-item label="快递公司编码" prop="companyCode" required><el-input v-model.trim="form.companyCode" maxlength="50" placeholder="例如 SF" /></el-form-item>
|
||
<el-form-item label="快递公司名称" prop="companyName" required><el-input v-model.trim="form.companyName" maxlength="128" placeholder="例如 顺丰速运" /></el-form-item>
|
||
</div>
|
||
<el-form-item label="状态" prop="status" required><el-radio-group v-model="form.status"><el-radio-button value="ACTIVE">启用</el-radio-button><el-radio-button value="INACTIVE">停用</el-radio-button></el-radio-group></el-form-item>
|
||
</FormSection>
|
||
<FormSection class="density-form-section" title="服务配置">
|
||
<div class="form-grid two-cols">
|
||
<el-form-item label="客服电话"><el-input v-model.trim="form.servicePhone" maxlength="32" placeholder="例如 95338" /></el-form-item>
|
||
<el-form-item label="官方网站" prop="website"><el-input v-model.trim="form.website" maxlength="255" placeholder="https://www.example.com" /></el-form-item>
|
||
</div>
|
||
<el-form-item label="轨迹查询地址模板"><template #label><span>轨迹查询地址模板<InlineHelp title="轨迹地址模板说明"><p>可使用 <code>{trackingNo}</code> 作为快递单号占位符。</p></InlineHelp></span></template><el-input v-model.trim="form.trackingUrlTemplate" maxlength="500" placeholder="https://example.com/track/{trackingNo}" /></el-form-item>
|
||
|
||
</FormSection>
|
||
<FormSection class="density-form-section" title="备注"><el-form-item label="内部说明"><el-input v-model.trim="form.remark" type="textarea" :rows="4" maxlength="500" show-word-limit placeholder="请输入适用范围、服务限制或其他说明" /></el-form-item></FormSection>
|
||
</el-form>
|
||
<template #footer><div class="drawer-footer"><el-button :disabled="saving" @click="editorOpen = false">取消</el-button><el-button type="primary" :loading="saving" @click="saveExpressCompany"><Save :size="16" />保存快递公司</el-button></div></template>
|
||
</el-drawer>
|
||
</div>
|
||
</AdminPage>
|
||
</template>
|
||
|
||
<style scoped>
|
||
.express-company-page { gap: var(--admin-space-6); }
|
||
.state-alert p { margin: var(--admin-space-2) 0 0; line-height: 1.55; }
|
||
.state-alert .el-button { margin-top: var(--admin-space-4); }
|
||
.express-company-cell { display: flex; min-width: 0; align-items: center; gap: var(--admin-space-4); }
|
||
.express-company-cell > span { display: grid; width: 34px; height: 34px; flex: 0 0 34px; place-items: center; border: 1px solid var(--workbench-border); border-radius: var(--admin-radius); background: var(--workbench-surface-soft); color: var(--workbench-primary); }
|
||
.express-company-cell > div { display: flex; min-width: 0; flex-direction: column; gap: 3px; }
|
||
.express-company-cell strong { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
|
||
.external-link { display: inline-flex; align-items: center; gap: 5px; color: var(--workbench-primary); font-size: var(--admin-font-caption); text-decoration: none; }
|
||
.external-link:hover { text-decoration: underline; }
|
||
.tracking-template { display: block; max-width: 100%; color: var(--workbench-text); font-family: "Cascadia Code", Consolas, monospace; font-size: var(--admin-font-caption); overflow-wrap: anywhere; }
|
||
.remark-cell { display: -webkit-box; overflow: hidden; line-height: 1.5; -webkit-box-orient: vertical; -webkit-line-clamp: 2; }
|
||
.form-help code { color: var(--workbench-text); font-family: "Cascadia Code", Consolas, monospace; }
|
||
.panel-actions { display: flex; flex-wrap: wrap; justify-content: flex-end; gap: var(--admin-space-3); }
|
||
.panel-actions .el-button { margin-left: 0; }
|
||
@media (max-width: 720px) {
|
||
.panel-actions, .panel-actions .el-button { width: 100%; }
|
||
.express-company-page :deep(.query-toolbar__actions) { width: 100%; }
|
||
}
|
||
</style>
|