vue3-element-plus-app-chu 0.0.20 → 0.0.21

package/README.md

@@ -31,3 +31,7 @@ pnpm dev:backend  # 只启动后端（backend/ 目录，tsx watch）
 - 新增、修改、详情页面每行四列展示，窗口变窄后依次降为三列、两列、一列。
 
 本地后端的预报接口当前使用通用模拟响应，写入成功响应不代表真实持久化。
+
+## 城银清头寸参数接口
+
+新增、修改、删除、查询、详情五个接口的封装及类型位于 `src/view/dcps/city-clearing/parameters/`，本次仅提供接口层。城银清查询与详情使用 `moduleCode: '3'`。本地后端提供符合字段契约的模拟响应及参数校验，写操作不持久化；接口字段和示例见 [城银清头寸参数接口说明](docs/city-clearing-parameters-apis.md)，Scalar 文档入口为后端 `/docs`。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vue3-element-plus-app-chu",
-  "version": "0.0.20",
+  "version": "0.0.21",
   "private": false,
   "type": "module",
   "files": [

package/src/router/index.ts

@@ -6,6 +6,7 @@ import DigitalRmbForecast from '@/view/dcps/forecast/index.vue'
 import DigitalRmbInjection from '@/view/dcps/funding/injection/index.vue'
 import DigitalRmbWriteOff from '@/view/dcps/write-off/index.vue'
 import DigitalRmbPositionEstimation from '@/view/dcps/estimation/index.vue'
+import DigitalRmbParameters from '@/view/dcps/parameters/index.vue'
 
 declare module 'vue-router' {
   interface RouteMeta {
@@ -98,6 +99,12 @@ const routes: RouteRecordRaw[] = [
         component: DigitalRmbWriteOff,
         meta: { menu: 'write-off', title: '数字人民币核销' },
       },
+      {
+        path: 'parameters',
+        name: 'parameters',
+        component: DigitalRmbParameters,
+        meta: { menu: 'parameters', title: '数字人民币参数管理' },
+      },
     ],
   },
   { path: '/:pathMatch(.*)*', redirect: { name: 'forecast' } },

package/src/router/menus.ts

@@ -25,4 +25,5 @@ export const layoutMenus: LayoutMenu[] = [
   },
   { name: 'auth', title: '数字人民币授权', compactTitle: '授权' },
   { name: 'write-off', title: '数字人民币核销', compactTitle: '核销' },
+  { name: 'parameters', title: '数字人民币参数管理', compactTitle: '参数管理' },
 ]

package/src/view/dcps/README.md

@@ -37,6 +37,7 @@
 | `/funding/balance` | `balance` | `funding/balance/index.vue` | 页面 | 数字人民币账户行余额查询申请 |
 | `/auth` | `auth` | `auth/index.vue` | 页面 | 数字人民币授权 |
 | `/write-off` | `write-off` | `write-off/index.vue` | 页面 | 数字人民币核销 |
+| `/parameters` | `parameters` | `parameters/index.vue` | 列表、详情、新增和修改弹窗 | 数字人民币参数管理 |
 | `/` | — | 重定向到 `forecast` | — | — |
 | `/:pathMatch(.*)*` | — | 重定向到 `forecast`（404 兜底） | — | — |
 
@@ -46,6 +47,7 @@
 - `forecast/index.vue` 顶部使用一个普通 `<script>` 块保存列表记录缓存，跳转修改或详情前暂存列表行，用于补齐详情接口未返回的字段。
 - 侧边菜单配置在 `src/router/menus.ts`，其中 `name` 必须与对应路由的 `name` 保持一致；分组菜单通过 `children` 配置二级页面，页面的 `meta.menu` 指向自己的菜单项。
 - “注资/预注资管理”对应 `funding` 分组，包含注资明细查询和账户行余额查询申请两个页面；访问子页面时自动展开父菜单。旧地址 `/injection`、`/balance` 保留为对应页面的别名。
+- 数字人民币参数管理为末尾的独立菜单，页面文件为 `parameters/index.vue`、`parameters/api.ts`、`parameters/typs.ts`。页面复用“城银清算头寸管理－头寸参数”的五个接口，查询、详情及新增固定传 `moduleCode: '5'`。本次用户确认以 `paraName` 定位修改和删除：修改时锁定原参数名称、参数标志只读；删除使用由参数名称组成的 `sysParaList` 数组。当前本地后端仍返回模拟结果，不保存参数。
 - `src/layout/index.vue` 使用 `<KeepAlive include="DcpsForecastPage">` 缓存头寸预报页面；新增、修改、详情按路由 `key` 分别缓存，返回列表时自动重新查询。
 
 ## 新增页面检查清单

package/src/view/dcps/auth/index.vue

@@ -3,7 +3,7 @@ import { computed, onBeforeUnmount, onMounted, reactive, ref } from 'vue'
 import { ElConfigProvider, ElMessage } from 'element-plus'
 import { ArtDataTable, type ColumnOption, type PaginationOptions, type TableSettings } from '@/components/table'
 import API from './api'
-import dcpsRuntime from '../runtime'
+import { dcpsRuntime } from '../runtime'
 import type { AuthorizationFilters, AuthorizationQueryParams, AuthorizationTask } from './typs'
 
 defineOptions({ name: 'DcpsAuthPage' })

package/src/view/dcps/city-clearing/parameters/api.ts

@@ -0,0 +1,36 @@
+import baseHttpClient, { type ApiResponse } from '@chic/http'
+import type {
+  CityClearingParameterParams,
+  Tam120305001InBody,
+  Tam120305001OutBody,
+  Tam120305002InBody,
+  Tam120305002OutBody,
+  Tam120305003InBody,
+  Tam120305003OutBody,
+  Tam140305001InBody,
+  Tam140305001OutBody,
+  Tam140305002InBody,
+  Tam140305002OutBody,
+} from './typs'
+
+export default {
+  /** 查询头寸参数；城银清 moduleCode 为 3，分页放在公共 head 中。 */
+  queryListApi: (params: CityClearingParameterParams<Tam140305001InBody>) =>
+    baseHttpClient.post<ApiResponse<Tam140305001OutBody>>('/TAM/0001/140305001', params),
+
+  /** 查询参数详情；附件未声明 paraName 的唯一性或必填规则。 */
+  getDetailApi: (params: CityClearingParameterParams<Tam140305002InBody>) =>
+    baseHttpClient.post<ApiResponse<Tam140305002OutBody>>('/TAM/0001/140305002', params),
+
+  /** 新增头寸参数；当前本地接口仅返回模拟响应，不保存参数。 */
+  addApi: (params: CityClearingParameterParams<Tam120305002InBody>) =>
+    baseHttpClient.post<ApiResponse<Tam120305002OutBody>>('/TAM/0001/120305002', params),
+
+  /** 修改头寸参数；附件未提供明确的记录定位规则。 */
+  editApi: (params: CityClearingParameterParams<Tam120305003InBody>) =>
+    baseHttpClient.post<ApiResponse<Tam120305003OutBody>>('/TAM/0001/120305003', params),
+
+  /** 删除头寸参数；sysParaList 数组项的标识含义尚未定义。 */
+  deleteApi: (params: CityClearingParameterParams<Tam120305001InBody>) =>
+    baseHttpClient.post<ApiResponse<Tam120305001OutBody>>('/TAM/0001/120305001', params),
+}

package/src/view/dcps/city-clearing/parameters/typs.ts

@@ -0,0 +1,82 @@
+import type { DigitalRmbHead } from '@/utils/digital-rmb-request'
+
+/** 城银清算头寸参数接口类型，字段及可选性对应附件原始 schema。 */
+export interface CityClearingParameter {
+  /** 参数描述 */
+  paraDesc?: string
+  /** 参数标志；附件未声明取值或枚举。 */
+  paraMark?: string
+  /** 参数名称；附件未声明唯一性。 */
+  paraName?: string
+  /** 参数类型；附件未声明取值或枚举。 */
+  paraType?: string
+  /** 参数值，保留原始字符串。 */
+  paraValue?: string
+  /** 备注 */
+  remark?: string
+}
+
+/** Tam120305001In.Body：删除；数组项对应的标识含义尚未声明。 */
+export interface Tam120305001InBody {
+  sysParaList?: string[]
+}
+
+/** Tam120305002In.Body：新增；原始 schema 未声明必填字段。 */
+export interface Tam120305002InBody extends CityClearingParameter {
+  /** 模块代码：1 人民币、2 外币、3 城银清、4 跨境、5 数币。 */
+  moduleCode?: string
+}
+
+/** Tam120305003In.Body：修改；附件没有模块代码、原始参数名称或独立标识字段。 */
+export interface Tam120305003InBody {
+  /** 参数说明 */
+  paraDesc?: string
+  /** 参数名称，不能据此推断唯一定位规则。 */
+  paraName?: string
+  /** 原始字段说明为“备注”，字段名仍为 paraType。 */
+  paraType?: string
+  /** 参数值 */
+  paraValue?: string
+  /** 备注 */
+  remark?: string
+}
+
+/** Tam140305001In.Body：列表查询，仅 moduleCode 在原始 schema 中必填。 */
+export interface Tam140305001InBody {
+  /** 查询关键字 */
+  keywords?: string
+  /** 模块代码；城银清使用 3。 */
+  moduleCode: string
+}
+
+/** Tam140305002In.Body：详情查询，仅 moduleCode 在原始 schema 中必填。 */
+export interface Tam140305002InBody {
+  /** 模块代码；城银清使用 3。 */
+  moduleCode: string
+  /** 参数名称；原始 schema 未声明必填或唯一性。 */
+  paraName?: string
+}
+
+/** 三个写接口的原始响应 body 均未声明业务字段。 */
+export type Tam120305001OutBody = Record<string, never>
+export type Tam120305002OutBody = Record<string, never>
+export type Tam120305003OutBody = Record<string, never>
+
+/** Tam140305001Out.Body */
+export interface Tam140305001OutBody {
+  resultList?: CityClearingParameter[]
+  /** 总条数，按契约保留字符串。 */
+  totalCount?: string
+}
+
+/** 与列表行使用相同的六个参数字段，原始 schema 均未声明必填。 */
+export type Tam140305002OutBody = CityClearingParameter
+
+/** 复用现有公共头类型，支持显式 TAM 信封或业务字段平铺。 */
+export type CityClearingParameterParams<T> =
+  | {
+      body: T
+      head?: DigitalRmbHead
+      appHead?: { ip?: string; opType?: string }
+    }
+  | (T & Omit<DigitalRmbHead, 'tranDate'> & { ip?: string; opType?: string })

package/src/view/dcps/estimation/index.vue

@@ -2,7 +2,7 @@
 import { computed, onBeforeUnmount, onMounted, reactive, ref } from 'vue'
 import { ElConfigProvider, ElMessage } from 'element-plus'
 import API from './api'
-import dcpsRuntime from '../runtime'
+import { dcpsRuntime } from '../runtime'
 import type {
   EstimationAmounts, EstimationCell, EstimationPredRow, EstimationQueryParams, EstimationTranRow,
 } from './typs'

package/src/view/dcps/forecast/index.vue

@@ -24,7 +24,7 @@ import { computed, onActivated, onBeforeUnmount, reactive, ref, watch } from 'vu
 import { useRouter } from 'vue-router'
 import { ElConfigProvider, ElMessage, ElMessageBox } from 'element-plus'
 import API from './api'
-import dcpsRuntime from '../runtime'
+import { dcpsRuntime } from '../runtime'
 import { ArtDataTable, type ColumnOption, type PaginationOptions, type TableSettings } from '@/components/table'
 import type {
   ForecastCreateBody,

package/src/view/dcps/funding/balance/api.ts

@@ -1,11 +1,11 @@
-import baseHttpClient, { type ApiResponse } from '@chic/http'
+import baseHttpClient from '@chic/http'
 import type { AccountBalanceInfo, InjectionCreateParams } from './typs'
 
 export default {
   /** 查询单条账户行余额，无筛选参数。 */
   queryBalanceApi: () =>
-    baseHttpClient.post<ApiResponse<AccountBalanceInfo>>('/TAM/0001/140506001', {}),
+    baseHttpClient.post<AccountBalanceInfo>('/TAM/0001/140506001', {}),
   /** 注资/预注资发起，响应未声明业务字段。 */
   createApi: (params: InjectionCreateParams) =>
-    baseHttpClient.post<ApiResponse>('/TAM/0001/120506001', params),
+    baseHttpClient.post('/TAM/0001/120506001', params),
 }

package/src/view/dcps/funding/balance/index.vue

@@ -72,7 +72,7 @@ const submitCreate = async () => {
 
   pendingCreate.value = true
   try {
-    const { head } = await API.createApi({ adjustType, tranAmt })
+    const { head } = await API.createApi({ adjustType, tranAmt }) as any
     if (disposed) return
     if (head?.retCode !== '00000') {
       throw new Error(head?.retMsg || '提交失败')
@@ -169,7 +169,7 @@ const query = async () => {
   const currentRequestId = ++requestId
   loading.value = true
   try {
-    const { head, body } = await API.queryBalanceApi()
+    const { head, body } = await API.queryBalanceApi() as any
     if (currentRequestId !== requestId) return
     if (head?.retCode !== '00000') {
       throw new Error(head?.retMsg || '查询失败')

package/src/view/dcps/parameters/api.ts

@@ -0,0 +1,26 @@
+import parameterApi from '../city-clearing/parameters/api'
+import type { ParameterEditBody, ParameterFormValues, ParameterQueryParams } from './typs'
+
+const moduleCode = '5'
+
+export default {
+  queryListApi: ({ keywords, pageIndex, pageSize }: ParameterQueryParams) =>
+    parameterApi.queryListApi({
+      head: { pageIndex: String(pageIndex), pageSize: String(pageSize) },
+      body: { moduleCode, keywords },
+    }),
+
+  getDetailApi: (paraName: string) =>
+    parameterApi.getDetailApi({ body: { moduleCode, paraName } }),
+
+  addApi: (values: ParameterFormValues) =>
+    parameterApi.addApi({ body: { ...values, moduleCode } }),
+
+  // 用户确认以原参数名称定位；原始修改契约不包含 moduleCode、paraMark。
+  editApi: (values: ParameterEditBody) =>
+    parameterApi.editApi({ body: values }),
+
+  // 用户确认 sysParaList 的元素为参数名称；删除契约没有模块字段。
+  deleteApi: (paraNames: string[]) =>
+    parameterApi.deleteApi({ body: { sysParaList: [...paraNames] } }),
+}

package/src/view/dcps/parameters/index.vue

@@ -0,0 +1,506 @@
+<script setup lang="ts">
+import { computed, onBeforeUnmount, onMounted, reactive, ref } from 'vue'
+import { ElConfigProvider, ElMessage } from 'element-plus'
+import { ArtDataTable, type ColumnOption, type PaginationOptions, type TableSettings } from '@/components/table'
+import type { ApiResponse } from '@/utils/request'
+import API from './api'
+import type { DigitalRmbParameter, ParameterFormValues, ParameterListBody } from './typs'
+
+defineOptions({ name: 'DcpsParametersPage' })
+
+type DialogMode = 'create' | 'edit' | 'detail'
+type Mutation = 'create' | 'edit' | 'delete' | null
+
+const parameterFields = [
+  { key: 'paraName', label: '参数名称', multiline: false },
+  { key: 'paraType', label: '参数类型', multiline: false },
+  { key: 'paraMark', label: '参数标志', multiline: false },
+  { key: 'paraValue', label: '参数值', multiline: true },
+  { key: 'paraDesc', label: '参数描述', multiline: true },
+  { key: 'remark', label: '备注', multiline: true },
+] as const
+
+const createFormValues = (parameter: DigitalRmbParameter = {}): ParameterFormValues => ({
+  paraName: parameter.paraName ?? '',
+  paraType: parameter.paraType ?? '',
+  paraMark: parameter.paraMark ?? '',
+  paraValue: parameter.paraValue ?? '',
+  paraDesc: parameter.paraDesc ?? '',
+  remark: parameter.remark ?? '',
+})
+
+const errorMessage = (error: unknown): string =>
+  error instanceof Error && error.message.trim() ? error.message : '请求失败，请稍后重试'
+
+const ensureSuccess = <T,>(response: ApiResponse<T>, fallback: string): T | null => {
+  if (response?.head?.retCode !== '00000') {
+    throw new Error(response?.head?.retMsg?.trim() || fallback)
+  }
+  return response.body
+}
+
+/** 只读取契约中的字符串字段，参数值不转换成数字，也不去掉首尾空格。 */
+const readParameter = (value: unknown): DigitalRmbParameter => {
+  if (!value || typeof value !== 'object' || Array.isArray(value)) {
+    throw new Error('服务端返回的参数格式异常')
+  }
+  const source = value as Record<string, unknown>
+  const result: DigitalRmbParameter = {}
+  for (const { key } of parameterFields) {
+    const field = source[key]
+    if (field === undefined) continue
+    if (typeof field !== 'string') throw new Error('服务端返回的参数字段格式异常')
+    result[key] = field
+  }
+  return result
+}
+
+const hasName = (parameter: DigitalRmbParameter): boolean => Boolean(parameter.paraName?.trim())
+const displayValue = (value?: string): string => value === undefined || value === '' ? '—' : value
+
+const keywords = ref('')
+let appliedKeywords = ''
+const rows = ref<DigitalRmbParameter[]>([])
+const selectedRows = ref<DigitalRmbParameter[]>([])
+const pagination = reactive({ current: 1, size: 15, total: 0 })
+const paginationOptions: PaginationOptions = { align: 'right', pageSizes: [15, 30, 50, 100], background: false }
+const tableSettings = ref<TableSettings>({ size: 'small', stripe: true, border: true, headerBackground: true })
+const tableRef = ref<InstanceType<typeof ArtDataTable> | null>(null)
+const showSearchBar = ref(true)
+const listLoading = ref(false)
+const listError = ref('')
+const pendingMutation = ref<Mutation>(null)
+const writing = computed(() => pendingMutation.value !== null)
+const listBusy = computed(() => listLoading.value || writing.value)
+let listRequestId = 0
+let detailRequestId = 0
+let disposed = false
+
+const textColumn = (prop: keyof DigitalRmbParameter, label: string, minWidth: number): ColumnOption<DigitalRmbParameter> => ({
+  prop, label, minWidth, showOverflowTooltip: true,
+  formatter: (row) => displayValue(row[prop]),
+})
+
+const tableColumns: ColumnOption<DigitalRmbParameter>[] = [
+  { type: 'selection', width: 42, fixed: 'left', selectable: hasName },
+  { type: 'globalIndex', label: '序号', width: 60, align: 'center' },
+  { ...textColumn('paraName', '参数名称', 180), useSlot: true, slotName: 'name' },
+  textColumn('paraType', '参数类型', 110),
+  textColumn('paraMark', '参数标志', 110),
+  { ...textColumn('paraValue', '参数值', 190), useSlot: true, slotName: 'value' },
+  textColumn('paraDesc', '参数描述', 220),
+  textColumn('remark', '备注', 180),
+  { key: 'actions', label: '操作', width: 170, fixed: 'right', align: 'center', useSlot: true },
+]
+
+const clearSelection = () => {
+  selectedRows.value = []
+  tableRef.value?.getElTable()?.clearSelection()
+}
+
+/** 查询和翻页使用已提交的关键字，旧请求返回时不覆盖新结果。 */
+const loadList = async () => {
+  if (disposed) return
+  const requestId = ++listRequestId
+  const params = { keywords: appliedKeywords || undefined, pageIndex: pagination.current, pageSize: pagination.size }
+  listLoading.value = true
+  listError.value = ''
+  clearSelection()
+  try {
+    for (let attempt = 0; attempt < 2; attempt += 1) {
+      const response = await API.queryListApi(params)
+      if (disposed || requestId !== listRequestId) return
+      const body: ParameterListBody | null = ensureSuccess(response, '参数查询失败')
+      if (!body || !Array.isArray(body.resultList)) throw new Error('查询结果缺少参数列表')
+      const totalText = body.totalCount ?? String(body.resultList.length)
+      const total = Number(totalText)
+      if (!/^\d+$/.test(totalText) || !Number.isSafeInteger(total) || total < 0) {
+        throw new Error('查询返回的总条数无效')
+      }
+      const lastPage = Math.max(1, Math.ceil(total / params.pageSize))
+      if (params.pageIndex > lastPage) {
+        pagination.current = lastPage
+        params.pageIndex = lastPage
+        if (attempt === 0) continue
+        throw new Error('参数列表已变化，请重新查询')
+      }
+      rows.value = body.resultList.map(readParameter)
+      pagination.total = total
+      return
+    }
+  } catch (error) {
+    if (disposed || requestId !== listRequestId) return
+    rows.value = []
+    Object.assign(pagination, { current: 1, total: 0 })
+    listError.value = errorMessage(error)
+    ElMessage.error(listError.value)
+  } finally {
+    if (!disposed && requestId === listRequestId) listLoading.value = false
+  }
+}
+
+const search = () => {
+  if (listBusy.value) return
+  appliedKeywords = keywords.value.trim()
+  pagination.current = 1
+  void loadList()
+}
+
+const resetFilters = () => {
+  if (listBusy.value) return
+  keywords.value = ''
+  search()
+}
+
+const refreshList = () => {
+  if (!listBusy.value) void loadList()
+}
+
+const changePage = (current: number, size = pagination.size) => {
+  if (listBusy.value || (current === pagination.current && size === pagination.size)) return
+  Object.assign(pagination, { current, size })
+  void loadList()
+}
+
+// 新增、修改和详情共用弹窗；详情失败时禁用保存，避免提交未完整加载的数据。
+const dialogVisible = ref(false)
+const dialogMode = ref<DialogMode>('create')
+const dialogLoading = ref(false)
+const dialogReady = ref(false)
+const dialogError = ref('')
+const dialogSource = ref<DigitalRmbParameter | null>(null)
+const form = ref(createFormValues())
+const formNameError = ref('')
+const dialogTitle = computed(() => ({ create: '新增参数', edit: '修改参数', detail: '参数详情' })[dialogMode.value])
+const dialogBusy = computed(() => dialogLoading.value || writing.value)
+
+const openCreateDialog = () => {
+  if (listBusy.value) return
+  detailRequestId += 1
+  dialogMode.value = 'create'
+  dialogSource.value = null
+  form.value = createFormValues()
+  formNameError.value = ''
+  dialogError.value = ''
+  dialogLoading.value = false
+  dialogReady.value = true
+  dialogVisible.value = true
+}
+
+const loadDetail = async () => {
+  const source = dialogSource.value
+  if (!source || !hasName(source) || disposed || writing.value) return
+  const paraName = source.paraName!
+  const requestId = ++detailRequestId
+  dialogLoading.value = true
+  dialogReady.value = false
+  dialogError.value = ''
+  try {
+    const response = await API.getDetailApi(paraName)
+    if (disposed || requestId !== detailRequestId) return
+    const detail = readParameter(ensureSuccess(response, '读取参数详情失败'))
+    if (!Object.keys(detail).length) throw new Error('服务端未返回参数详情')
+    if (detail.paraName !== undefined && detail.paraName !== paraName) {
+      throw new Error('返回的参数名称与当前记录不一致')
+    }
+    form.value = createFormValues({ ...source, ...detail, paraName })
+    dialogReady.value = true
+  } catch (error) {
+    if (!disposed && requestId === detailRequestId) dialogError.value = errorMessage(error)
+  } finally {
+    if (!disposed && requestId === detailRequestId) dialogLoading.value = false
+  }
+}
+
+const openParameterDialog = (parameter: DigitalRmbParameter, mode: 'edit' | 'detail' = 'detail') => {
+  if (listBusy.value || !hasName(parameter)) return
+  dialogMode.value = mode
+  dialogSource.value = { ...parameter }
+  form.value = createFormValues(parameter)
+  formNameError.value = ''
+  dialogError.value = ''
+  dialogVisible.value = true
+  void loadDetail()
+}
+
+const closeParameterDialog = () => {
+  // 关闭后即使请求继续返回，也不能更新下一次打开的弹窗。
+  detailRequestId += 1
+  dialogLoading.value = false
+  dialogReady.value = false
+}
+
+const submitParameter = async () => {
+  const mode = dialogMode.value
+  if (mode === 'detail' || dialogBusy.value || !dialogReady.value || !dialogVisible.value) return
+  const values = { ...form.value }
+  if (!values.paraName.trim()) {
+    formNameError.value = '请填写参数名称'
+    return
+  }
+  formNameError.value = ''
+  dialogError.value = ''
+  pendingMutation.value = mode
+  try {
+    const response = mode === 'create'
+      ? await API.addApi({ ...values, paraName: values.paraName.trim() })
+      : await API.editApi({
+          paraName: dialogSource.value!.paraName!,
+          paraType: values.paraType,
+          paraValue: values.paraValue,
+          paraDesc: values.paraDesc,
+          remark: values.remark,
+        })
+    if (disposed) return
+    ensureSuccess(response, mode === 'create' ? '新增参数失败' : '修改参数失败')
+    ElMessage.success(response.head.retMsg?.trim() || (mode === 'create' ? '新增请求成功' : '修改请求成功'))
+    dialogVisible.value = false
+    // 写接口不返回记录；重新查询服务端，不在前端伪造保存后的列表。
+    await loadList()
+  } catch (error) {
+    if (!disposed) dialogError.value = errorMessage(error)
+  } finally {
+    if (!disposed) pendingMutation.value = null
+  }
+}
+
+// 删除名单取操作时的快照，确认后提交参数名称数组，支持单条和批量删除。
+const deleteDialogVisible = ref(false)
+const deleteNames = ref<string[]>([])
+const deleteError = ref('')
+const openDeleteDialog = (parameters: DigitalRmbParameter[]) => {
+  if (listBusy.value) return
+  const names = parameters.filter(hasName).map((parameter) => parameter.paraName!)
+  if (!names.length) return
+  deleteNames.value = [...new Set(names)]
+  deleteError.value = ''
+  deleteDialogVisible.value = true
+}
+
+const submitDelete = async () => {
+  if (writing.value || !deleteDialogVisible.value || !deleteNames.value.length) return
+  pendingMutation.value = 'delete'
+  deleteError.value = ''
+  try {
+    const response = await API.deleteApi(deleteNames.value)
+    if (disposed) return
+    ensureSuccess(response, '删除参数失败')
+    ElMessage.success(response.head.retMsg?.trim() || '删除请求成功')
+    deleteDialogVisible.value = false
+    await loadList()
+  } catch (error) {
+    if (!disposed) deleteError.value = errorMessage(error)
+  } finally {
+    if (!disposed) pendingMutation.value = null
+  }
+}
+
+onMounted(loadList)
+onBeforeUnmount(() => {
+  disposed = true
+  listRequestId += 1
+  detailRequestId += 1
+})
+</script>
+
+<template>
+  <ElConfigProvider :size="tableSettings.size">
+    <main class="dcps-page">
+      <el-card class="parameter-header" shadow="never" :body-style="{ padding: '12px 14px' }">
+        <h1>数字人民币参数管理</h1>
+        <el-form
+          v-show="showSearchBar"
+          class="filter-form"
+          label-position="top"
+          :disabled="listBusy"
+          @submit.prevent="search()"
+        >
+          <el-form-item label="关键字">
+            <el-input v-model="keywords" placeholder="输入查询关键字" clearable />
+          </el-form-item>
+          <el-space class="filter-actions" :size="8">
+            <el-button @click="resetFilters">重置</el-button>
+            <el-button type="primary" native-type="submit" :loading="listLoading">查询</el-button>
+          </el-space>
+        </el-form>
+      </el-card>
+
+      <el-alert v-if="listError" :title="listError" type="error" show-icon :closable="false" />
+
+      <div class="parameter-table-region">
+        <ArtDataTable
+          ref="tableRef"
+          v-model:settings="tableSettings"
+          v-model:show-search-bar="showSearchBar"
+          style="padding: 10px"
+          fill
+          toolbar-layout="search,refresh,size,fullscreen,columns,settings"
+          :data="rows"
+          :columns="tableColumns"
+          :loading="listBusy"
+          :pagination="pagination"
+          :pagination-options="paginationOptions"
+          :empty-text="listError ? '查询失败，请重新查询' : '暂无符合条件的参数'"
+          @refresh="refreshList"
+          @pagination:current-change="changePage"
+          @pagination:size-change="(size: number) => changePage(1, size)"
+          @selection-change="(selection: DigitalRmbParameter[]) => selectedRows = selection"
+          @row-dblclick="(row: DigitalRmbParameter) => openParameterDialog(row)"
+        >
+          <template #toolbar-left>
+            <div class="table-actions">
+              <el-button type="primary" :disabled="listBusy" @click="openCreateDialog">新增参数</el-button>
+              <el-button type="danger" plain :disabled="listBusy || !selectedRows.length" @click="openDeleteDialog(selectedRows)">
+                批量删除
+              </el-button>
+              <span v-if="selectedRows.length" class="selection-count">已选 {{ selectedRows.length }} 项</span>
+            </div>
+          </template>
+          <template #name="{ row }">
+            <el-button v-if="hasName(row)" class="parameter-name" link type="primary" :disabled="listBusy" @click.stop="openParameterDialog(row)">
+              {{ row.paraName }}
+            </el-button>
+            <span v-else>—</span>
+          </template>
+          <template #value="{ row }">
+            <span class="parameter-value">{{ displayValue(row.paraValue) }}</span>
+          </template>
+          <template #actions="{ row }">
+            <el-button link type="primary" :disabled="listBusy || !hasName(row)" @click.stop="openParameterDialog(row)">详情</el-button>
+            <el-button link type="primary" :disabled="listBusy || !hasName(row)" @click.stop="openParameterDialog(row, 'edit')">修改</el-button>
+            <el-button link type="danger" :disabled="listBusy || !hasName(row)" @click.stop="openDeleteDialog([row])">删除</el-button>
+          </template>
+        </ArtDataTable>
+      </div>
+
+      <el-dialog
+        v-model="dialogVisible"
+        :title="dialogTitle"
+        width="min(660px, calc(100vw - 32px))"
+        append-to-body
+        destroy-on-close
+        :show-close="!writing"
+        :close-on-click-modal="false"
+        :close-on-press-escape="!writing"
+        @close="closeParameterDialog"
+      >
+        <el-alert v-if="dialogError" class="dialog-error" :title="dialogError" type="error" show-icon :closable="false" />
+        <el-scrollbar max-height="min(62vh, 620px)">
+          <div v-if="dialogLoading" class="detail-loading" role="status">正在读取参数详情…</div>
+          <dl v-else-if="dialogMode === 'detail' && dialogReady" class="detail-fields">
+            <div v-for="field in parameterFields" :key="field.key" class="detail-field" :class="{ 'detail-field--wide': field.multiline }">
+              <dt>{{ field.label }}</dt>
+              <dd :class="{ 'parameter-value': field.key === 'paraValue' }">{{ displayValue(form[field.key]) }}</dd>
+            </div>
+          </dl>
+          <el-form
+            v-else-if="dialogMode !== 'detail' && dialogReady"
+            id="parameter-editor-form"
+            class="parameter-form"
+            label-position="top"
+            :model="form"
+            :disabled="dialogBusy"
+            @submit.prevent="submitParameter()"
+          >
+            <el-form-item
+              v-for="field in parameterFields"
+              :key="field.key"
+              :label="field.label"
+              :required="field.key === 'paraName'"
+              :error="field.key === 'paraName' ? formNameError : undefined"
+              :class="{ 'form-item--wide': field.multiline }"
+            >
+              <el-input
+                v-model="form[field.key]"
+                :type="field.multiline ? 'textarea' : 'text'"
+                :autosize="field.multiline ? { minRows: 2, maxRows: 5 } : undefined"
+                :readonly="dialogMode === 'edit' && (field.key === 'paraName' || field.key === 'paraMark')"
+                :placeholder="`请输入${field.label}`"
+                @input="field.key === 'paraName' && (formNameError = '')"
+              />
+            </el-form-item>
+          </el-form>
+        </el-scrollbar>
+        <template #footer>
+          <el-button v-if="dialogError && !dialogReady && dialogSource" :loading="dialogLoading" @click="loadDetail">重新读取</el-button>
+          <el-button :disabled="writing" @click="dialogVisible = false">{{ dialogMode === 'detail' ? '关闭' : '取消' }}</el-button>
+          <el-button
+            v-if="dialogMode !== 'detail'"
+            type="primary"
+            :loading="pendingMutation === 'create' || pendingMutation === 'edit'"
+            :disabled="dialogLoading || !dialogReady || writing"
+            @click="submitParameter"
+          >
+            {{ dialogMode === 'create' ? '新增' : '保存' }}
+          </el-button>
+        </template>
+      </el-dialog>
+
+      <el-dialog
+        v-model="deleteDialogVisible"
+        title="删除参数"
+        width="min(460px, calc(100vw - 32px))"
+        append-to-body
+        destroy-on-close
+        :show-close="!writing"
+        :close-on-click-modal="false"
+        :close-on-press-escape="!writing"
+      >
+        <p class="delete-description">确认删除以下 {{ deleteNames.length }} 项参数？</p>
+        <el-scrollbar max-height="240px">
+          <ul class="delete-list"><li v-for="name in deleteNames" :key="name">{{ name }}</li></ul>
+        </el-scrollbar>
+        <el-alert v-if="deleteError" class="dialog-error" :title="deleteError" type="error" show-icon :closable="false" />
+        <template #footer>
+          <el-button :disabled="writing" @click="deleteDialogVisible = false">取消</el-button>
+          <el-button type="danger" :loading="pendingMutation === 'delete'" :disabled="writing" @click="submitDelete">确认删除</el-button>
+        </template>
+      </el-dialog>
+    </main>
+  </ElConfigProvider>
+</template>
+
+<style scoped>
+.dcps-page {
+  display: flex;
+  flex-direction: column;
+  gap: 5px;
+  height: calc(100vh - var(--dpcs-host-layout-height));
+  height: calc(100dvh - var(--dpcs-host-layout-height));
+  min-width: 0;
+  min-height: 0;
+  padding: 5px;
+  overflow: hidden;
+  background: var(--el-bg-color-page, #f7f8fa);
+}
+.parameter-header { flex: 0 0 auto; }
+.parameter-header h1 { margin: 0; font-size: 15px; font-weight: 600; line-height: 24px; }
+.filter-form { display: flex; flex-wrap: wrap; align-items: flex-end; gap: 10px 12px; margin-top: 12px; }
+.filter-form :deep(.el-form-item) { flex: 0 1 360px; min-width: 160px; margin: 0; }
+.filter-form :deep(.el-form-item__label) { margin-bottom: 4px; }
+.filter-actions { flex-shrink: 0; }
+.parameter-table-region { flex: 1; min-width: 0; min-height: 0; }
+.table-actions { display: flex; flex-wrap: wrap; align-items: center; gap: 8px; }
+.table-actions :deep(.el-button + .el-button) { margin-left: 0; }
+.selection-count { margin-left: 4px; color: var(--el-text-color-secondary); font-size: 12px; white-space: nowrap; }
+.parameter-name { display: inline; max-width: 100%; overflow: hidden; text-overflow: ellipsis; text-align: left; vertical-align: middle; }
+.parameter-value { font-family: 'SFMono-Regular', Consolas, 'Liberation Mono', monospace; font-variant-numeric: tabular-nums; white-space: pre-wrap; }
+.parameter-form { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 0 16px; padding: 2px 4px; }
+.form-item--wide { grid-column: 1 / -1; }
+.parameter-form :deep(.el-input__inner[readonly]) { color: var(--el-text-color-secondary); }
+.dialog-error { margin-bottom: 14px; }
+.detail-loading { padding: 40px 0; color: var(--el-text-color-secondary); text-align: center; }
+.detail-fields { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 1px; margin: 0; overflow: hidden; border: 1px solid var(--el-border-color-lighter); border-radius: 8px; background: var(--el-border-color-lighter); }
+.detail-field { min-width: 0; padding: 12px 14px; background: var(--el-bg-color); }
+.detail-field--wide { grid-column: 1 / -1; }
+.detail-field dt { margin-bottom: 6px; color: var(--el-text-color-secondary); font-size: 12px; }
+.detail-field dd { margin: 0; overflow-wrap: anywhere; white-space: pre-wrap; line-height: 1.6; }
+.delete-description { margin: 0 0 12px; line-height: 1.6; }
+.delete-list { margin: 0 0 14px; padding: 12px 14px 12px 32px; border-radius: 8px; background: var(--el-fill-color-light); }
+.delete-list li { padding: 3px 0; overflow-wrap: anywhere; }
+@media (max-width: 540px) {
+  .filter-form :deep(.el-form-item) { flex-basis: 100%; }
+  .parameter-form, .detail-fields { grid-template-columns: minmax(0, 1fr); }
+  .selection-count { width: 100%; margin-left: 0; }
+}
+</style>

package/src/view/dcps/parameters/typs.ts

@@ -0,0 +1,18 @@
+import type {
+  CityClearingParameter,
+  Tam120305003InBody,
+  Tam140305001OutBody,
+} from '../city-clearing/parameters/typs'
+
+/** 数字人民币复用头寸参数契约，所有参数字段保留字符串。 */
+export type DigitalRmbParameter = CityClearingParameter
+export type ParameterListBody = Tam140305001OutBody
+export type ParameterEditBody = Tam120305003InBody
+export type ParameterFormValues = Required<DigitalRmbParameter>
+
+/** 模块由页面接口固定为数币，调用处只提供关键字和公共分页。 */
+export interface ParameterQueryParams {
+  keywords?: string
+  pageIndex: number
+  pageSize: number
+}

package/src/view/dcps/runtime.ts

@@ -1,6 +1,6 @@
 /**
- * DCPS 各页面共用的运行时配置，仅默认导出一个对象。
- * 页面通过 `import dcpsRuntime from '../runtime'` 引入；分组子页面使用 `../../runtime`。
+ * DCPS 各页面共用的运行时配置，统一通过具名对象 dcpsRuntime 导出。
+ * 页面通过 `import { dcpsRuntime } from '../runtime'` 引入；分组子页面使用 `../../runtime`。
  */
 
 // 模块加载时按上海时区生成一次日期，所有页面共用，格式为 YYYYMMDD。
@@ -9,7 +9,7 @@ const dateParts = new Intl.DateTimeFormat('en-CA', {
 }).formatToParts(new Date())
 const readDatePart = (type: Intl.DateTimeFormatPartTypes) => dateParts.find((part) => part.type === type)?.value || ''
 
-export default {
+export const dcpsRuntime = {
   date: readDatePart('year') + readDatePart('month') + readDatePart('day'), // 共用业务日期。
   approverId: '10092', // 工号。
   approverName: '王干事', // 姓名。

package/src/view/dcps/write-off/index.vue

@@ -2,7 +2,7 @@
 import { computed, onBeforeUnmount, onMounted, reactive, ref } from 'vue'
 import { ElConfigProvider, ElMessage, ElMessageBox } from 'element-plus'
 import API from './api'
-import dcpsRuntime from '../runtime'
+import { dcpsRuntime } from '../runtime'
 import { ArtDataTable, type ColumnOption, type PaginationOptions, type TableSettings } from '@/components/table'
 import type {
   CancelWriteOffPredItem, EditVerifyFormValues, FlowRow, ForecastRow, WriteOffFlowInput, WriteOffForecastItem, WriteOffItemInput,