vue3-element-plus-app-chu 0.0.13 → 0.0.14

package/src/view/dcps/estimation/utils.ts

@@ -0,0 +1,113 @@
+import type { ApiResponse } from '@/utils/request'
+
+/** 校验公共响应头；retCode 不是 00000 时按服务端提示或 fallback 抛错。 */
+export function 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
+}
+
+/** 提取可展示的错误信息；无法识别时给出统一提示。 */
+export function getErrorMessage(error: unknown): string {
+  if (error instanceof Error && error.message.trim()) return error.message
+  if (typeof error === 'string' && error.trim()) return error
+  return '操作失败，请稍后重试'
+}
+
+/** 业务日期始终按上海时区生成，不依赖浏览器所在时区，格式为 YYYYMMDD。 */
+export function getToday(): string {
+  const parts = new Intl.DateTimeFormat('en-CA', {
+    timeZone: 'Asia/Shanghai', year: 'numeric', month: '2-digit', day: '2-digit',
+  }).formatToParts(new Date())
+  const read = (type: Intl.DateTimeFormatPartTypes) => parts.find((part) => part.type === type)?.value || ''
+  return read('year') + read('month') + read('day')
+}
+
+/** 判断是否为合法的 YYYYMMDD 日期。 */
+export function isValidDate(value: string): boolean {
+  if (!/^\d{8}$/.test(value)) return false
+  const year = Number(value.slice(0, 4))
+  const month = Number(value.slice(4, 6))
+  const day = Number(value.slice(6, 8))
+  if (year < 1 || month < 1 || month > 12 || day < 1) return false
+  const leap = year % 400 === 0 || (year % 4 === 0 && year % 100 !== 0)
+  const monthDays = [31, leap ? 29 : 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31]
+  return day <= (monthDays[month - 1] || 0)
+}
+
+/** 只接受十进制文本和合法千分位；保留全部小数位，避免改变输入精度。 */
+export function normalizeAmount(value: string): string {
+  let text = value.trim()
+  if (text.includes(',')) {
+    if (!/^[+-]?\d{1,3}(?:,\d{3})+(?:\.\d*)?$/.test(text)) return ''
+    text = text.replace(/,/g, '')
+  }
+  const match = /^([+-]?)(\d*)(?:\.(\d*))?$/.exec(text)
+  if (!match || (!match[2] && !match[3])) return ''
+  const integer = (match[2] || '0').replace(/^0+(?=\d)/, '')
+  const fraction = match[3] || ''
+  const negative = match[1] === '-' && /[1-9]/.test(integer + fraction)
+  return `${negative ? '-' : ''}${integer}${fraction ? `.${fraction}` : ''}`
+}
+
+/** 千分位展示至少两位小数，超过两位的小数原样保留，不做浮点数转换或舍入。 */
+export function formatAmount(value?: string): string {
+  const original = value?.trim() || ''
+  if (!original) return '—'
+  const normalized = normalizeAmount(original)
+  if (!normalized) return original
+  const negative = normalized.startsWith('-')
+  const [integer = '0', fraction = ''] = (negative ? normalized.slice(1) : normalized).split('.')
+  const grouped = integer.replace(/\B(?=(\d{3})+(?!\d))/g, ',')
+  return `${negative ? '-' : ''}${grouped}.${fraction.padEnd(2, '0')}`
+}
+
+/**
+ * 计算轧差（收入减支出）；任一金额无法解析时返回空字符串。
+ * emptyAsZero 为 true 时空文本按 0 参与计算（用于输入框的实时轧差）。
+ */
+export function calcGapAmount(inAmt: string, outAmt: string, emptyAsZero = false): string {
+  const parse = (value: string) => {
+    if (!value?.trim() && emptyAsZero) value = '0'
+    const normalized = normalizeAmount(value)
+    if (!normalized) return null
+    const negative = normalized.startsWith('-')
+    const [integer = '0', fraction = ''] = (negative ? normalized.slice(1) : normalized).split('.')
+    return { negative, integer, fraction }
+  }
+  const inPart = parse(inAmt)
+  const outPart = parse(outAmt)
+  if (!inPart || !outPart) return ''
+  const scale = Math.max(inPart.fraction.length, outPart.fraction.length)
+  const toScaled = (part: { negative: boolean; integer: string; fraction: string }): bigint => {
+    const digits = `${part.integer}${part.fraction.padEnd(scale, '0')}`
+    return BigInt(digits) * (part.negative ? -1n : 1n)
+  }
+  const diff = toScaled(inPart) - toScaled(outPart)
+  const negative = diff < 0n
+  const digits = (negative ? -diff : diff).toString().padStart(scale + 1, '0')
+  const integer = digits.slice(0, digits.length - scale)
+  const fraction = scale ? digits.slice(digits.length - scale) : ''
+  return formatAmount(`${negative ? '-' : ''}${integer}${fraction ? `.${fraction}` : ''}`)
+}
+
+/** 收支方向字典：I 来账、O 往账。 */
+export const payDirecLabels: Record<string, string> = { I: '来账', O: '往账' }
+/** 支付渠道：预报与流水的数字人民币分别为 8、5；其余渠道保留原文。 */
+export const payChannelLabels: Record<string, string> = { '5': '数字人民币', '8': '数字人民币' }
+/** 核销状态字典：1 未核销、2 已核销。 */
+export const verifyStatusLabels: Record<string, string> = { '1': '未核销', '2': '已核销' }
+/** 业务类型字典：201 兑回、202 兑出、203 付现；与核销预报使用同一套枚举。 */
+export const busiTypeLabels: Record<string, string> = { '201': '兑回', '202': '兑出', '203': '付现' }
+
+/** 读取字典文案；空值显示横线，未登记的代码保留原文展示。 */
+export function dictLabel(labels: Record<string, string>, value?: string): string {
+  const text = value?.trim() || ''
+  return text ? labels[text] ?? text : '—'
+}
+
+/** 详情明细展示的统一空值处理；空值显示横线。 */
+export function displayText(value?: string): string {
+  return value?.trim() || '—'
+}

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

@@ -1,14 +1,9 @@
 import { postDigitalRmb } from '@/utils/digital-rmb-request'
-import type { ApiResponse } from '@/utils/request'
 import type {
   ForecastCreateBody,
-  ForecastDetail,
   ForecastDetailParams,
   ForecastEditBody,
-  ForecastFormValues,
-  ForecastListBody,
   ForecastQueryParams,
-  ForecastRow,
   Tam120501001InBody,
   Tam120501002InBody,
   Tam120501003InBody,
@@ -19,214 +14,27 @@ import type {
 } from './typs'
 
 /**
- * 数字人民币头寸预报页面接口与共用工具。
- * 接口地址：新增 120501001、修改 120501002、删除 120501003、查询 140501001、详情 140501002；
- * 请求报文和接口类型均在本模块内维护。
+ * 数字人民币头寸预报接口。
+ * 新增 120501001、修改 120501002、删除 120501003、查询 140501001、详情 140501002。
  */
-const API = {
-  /**
-   * 分页查询头寸预报。
-   * @param params 查询参数：opType 固定为 query；tranDate 为必查交易日期，格式为 YYYYMMDD。
-   * 其余筛选条件为空字符串表示不限制；金额范围使用 startTransAmt、endTransAmt。
-   */
+export default {
+  /** 分页查询头寸预报；tranDate 必填，其余条件为空表示不限制。 */
   queryListApi: (params: ForecastQueryParams) =>
     postDigitalRmb<Tam140501001InBody, Tam140501001OutBody>('/TAM/0001/140501001', params),
 
-  /**
-   * 新增一条头寸预报。
-   * @param body 新增业务字段；金额字段由调用方标准化为十进制文本。
-   */
+  /** 新增一条头寸预报。 */
   addApi: (body: ForecastCreateBody) =>
     postDigitalRmb<Tam120501001InBody, Record<string, unknown>>('/TAM/0001/120501001', { body }),
 
-  /**
-   * 修改一条头寸预报。
-   * @param body 修改业务字段；predRefSeq 为待修改记录的预报流水号。
-   */
+  /** 修改一条头寸预报；predRefSeq 为待修改记录的预报流水号。 */
   editApi: (body: ForecastEditBody) =>
     postDigitalRmb<Tam120501002InBody, Record<string, unknown>>('/TAM/0001/120501002', { body }),
 
-  /**
-   * 按预报流水号删除头寸预报。
-   * @param predRefSeqs 待删除记录的预报流水号列表。
-   */
+  /** 按预报流水号批量删除头寸预报。 */
   deleteApi: (predRefSeqs: string[]) =>
     postDigitalRmb<Tam120501003InBody, Record<string, unknown>>('/TAM/0001/120501003', { predRefSeqs }),
 
-  /**
-   * 读取单条预报详情。
-   * @param params 详情参数：predRefNo 为预报流水号。
-   */
+  /** 读取单条预报详情；predRefNo 为预报流水号。 */
   getDetailApi: (params: ForecastDetailParams) =>
-    postDigitalRmb<Tam140501002InBody, Tam140501002OutBody>('/TAM/0001/140501002', params),
-
-  /**
-   * 读取详情并与列表记录合并：详情没有的字段由同一条列表记录补充，
-   * 不为接口未返回的字段填入空值。
-   * @param row 列表中的预报记录。
-   */
-  async fetchDetail(row: ForecastRow): Promise<ForecastDetail> {
-    if (!row.predRefNo?.trim()) throw new Error('预报流水号缺失，无法读取详情')
-    const body = ensureSuccess(await API.getDetailApi({ predRefNo: row.predRefNo }), '读取预报详情失败')
-    if (!body || !Object.keys(body).length) throw new Error('服务端未返回预报详情')
-    if (body.predRefNo && body.predRefNo !== row.predRefNo) throw new Error('返回的预报流水号与当前记录不一致')
-    const definedBody = Object.fromEntries(Object.entries(body).filter(([, value]) => value !== undefined && value !== null))
-    return { ...row, ...definedBody } as ForecastDetail
-  },
-
-  /**
-   * 校验列表响应并取出当前页数据；列表缺失或总条数无效时抛出可提示的错误。
-   * @param body 列表接口返回的业务数据。
-   */
-  readPage(body: ForecastListBody | null): ForecastPage {
-    if (!body || !Array.isArray(body.resultList)) throw new Error('查询结果缺少预报列表，请联系服务端确认返回数据')
-    const totalText = String(body.totalCount ?? body.resultList.length)
-    const total = Number(totalText)
-    if (!/^\d+$/.test(totalText) || !Number.isSafeInteger(total)) throw new Error('查询返回的总条数无效')
-    return { data: body.resultList, total }
-  },
-}
-
-/** 列表查询结果：当前页记录和符合条件的总条数。 */
-export interface ForecastPage {
-  data: ForecastRow[] // 当前页的预报记录。
-  total: number // 符合查询条件的总记录数。
-}
-
-/** 校验公共响应头；retCode 不是 00000 时按服务端提示或 fallback 抛错。 */
-export function 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
-}
-
-/** 提取可展示的错误信息；无法识别时给出统一提示。 */
-export function getErrorMessage(error: unknown): string {
-  if (error instanceof Error && error.message.trim()) return error.message
-  if (typeof error === 'string' && error.trim()) return error
-  return '操作失败，请稍后重试'
-}
-
-/** 业务日期始终按上海时区生成，不依赖浏览器所在时区，格式为 YYYYMMDD。 */
-export function getToday(): string {
-  const parts = new Intl.DateTimeFormat('en-CA', {
-    timeZone: 'Asia/Shanghai', year: 'numeric', month: '2-digit', day: '2-digit',
-  }).formatToParts(new Date())
-  const read = (type: Intl.DateTimeFormatPartTypes) => parts.find((part) => part.type === type)?.value || ''
-  return read('year') + read('month') + read('day')
-}
-
-/** 判断是否为合法的 YYYYMMDD 日期。 */
-export function isValidDate(value: string): boolean {
-  if (!/^\d{8}$/.test(value)) return false
-  const year = Number(value.slice(0, 4))
-  const month = Number(value.slice(4, 6))
-  const day = Number(value.slice(6, 8))
-  if (year < 1 || month < 1 || month > 12 || day < 1) return false
-  const leap = year % 400 === 0 || (year % 4 === 0 && year % 100 !== 0)
-  const monthDays = [31, leap ? 29 : 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31]
-  return day <= (monthDays[month - 1] || 0)
-}
-
-/** 把 YYYYMMDD 格式化为 YYYY-MM-DD 展示；空值显示横线，其他格式保留原文。 */
-export function formatDate(value?: string): string {
-  const text = value?.trim() || ''
-  if (!text) return '—'
-  return isValidDate(text) ? `${text.slice(0, 4)}-${text.slice(4, 6)}-${text.slice(6, 8)}` : text
+    postDigitalRmb<Tam140501002InBody, Tam140501002OutBody>('/TAM/0001/140501002', params)
 }
-
-/** 只接受十进制文本和合法千分位；保留全部小数位，避免改变输入精度。 */
-export function normalizeAmount(value: string): string {
-  let text = value.trim()
-  if (text.includes(',')) {
-    if (!/^[+-]?\d{1,3}(?:,\d{3})+(?:\.\d*)?$/.test(text)) return ''
-    text = text.replace(/,/g, '')
-  }
-  const match = /^([+-]?)(\d*)(?:\.(\d*))?$/.exec(text)
-  if (!match || (!match[2] && !match[3])) return ''
-  const integer = (match[2] || '0').replace(/^0+(?=\d)/, '')
-  const fraction = match[3] || ''
-  const negative = match[1] === '-' && /[1-9]/.test(integer + fraction)
-  return `${negative ? '-' : ''}${integer}${fraction ? `.${fraction}` : ''}`
-}
-
-/** 千分位展示至少两位小数，超过两位的小数原样保留，不做浮点数转换或舍入。 */
-export function formatAmount(value?: string): string {
-  const original = value?.trim() || ''
-  if (!original) return '—'
-  const normalized = normalizeAmount(original)
-  if (!normalized) return original
-  const negative = normalized.startsWith('-')
-  const [integer = '0', fraction = ''] = (negative ? normalized.slice(1) : normalized).split('.')
-  const grouped = integer.replace(/\B(?=(\d{3})+(?!\d))/g, ',')
-  return `${negative ? '-' : ''}${grouped}.${fraction.padEnd(2, '0')}`
-}
-
-/** 按统一小数位数转为 BigInt，任意长度的十进制金额都可精确比较。 */
-export function compareAmounts(left: string, right: string): number {
-  const leftText = normalizeAmount(left)
-  const rightText = normalizeAmount(right)
-  if (!leftText || !rightText) {
-    if (!leftText && !rightText) return 0
-    return leftText ? -1 : 1
-  }
-  const parts = (text: string) => {
-    const negative = text.startsWith('-')
-    const [integer = '0', fraction = ''] = (negative ? text.slice(1) : text).split('.')
-    return { negative, integer, fraction }
-  }
-  const a = parts(leftText)
-  const b = parts(rightText)
-  const precision = Math.max(a.fraction.length, b.fraction.length)
-  const toInteger = (amount: ReturnType<typeof parts>) =>
-    BigInt(amount.integer + amount.fraction.padEnd(precision, '0')) * (amount.negative ? -1n : 1n)
-  const aValue = toInteger(a)
-  const bValue = toInteger(b)
-  return aValue < bValue ? -1 : aValue > bValue ? 1 : 0
-}
-
-/** 新增和导入使用的表单初始值；日期默认取当天。 */
-export function createFormValues(): ForecastFormValues {
-  const today = getToday()
-  return {
-    billDate: '', billNo: '', busiType: '', clientName: '', clientType: '',
-    competAcct: '', competName: '', custInfoSeq: '', groundBranch: '', groundBranchName: '',
-    linkMan: '', payChannel: '', payDirec: '', phoneNo: '', predAmt: '', predDate: today,
-    predName: '', predOrgName: '', purpose: '', remark: '', tranDate: today,
-  }
-}
-
-/**
- * 校验表单；新增校验全部必填项，修改只校验已填写的字段。
- * @param values 表单值。
- * @param mode create 为新增，edit 为修改。
- * @returns 错误提示文本，空字符串表示校验通过。
- */
-export function validateForm(values: ForecastFormValues, mode: 'create' | 'edit' = 'create'): string {
-  const requiredFields = [
-    ['clientName', '客户名称'], ['payDirec', '收支方向'], ['busiType', '业务类型'],
-    ['payChannel', '支付渠道'], ['groundBranch', '落地机构'],
-  ] as const
-  if (mode === 'create') {
-    for (const [key, label] of requiredFields) {
-      if (!values[key].trim()) return `请填写${label}`
-    }
-  }
-  for (const [key, label] of [['tranDate', '交易日期'], ['predDate', '预报日期']] as const) {
-    const date = values[key].trim()
-    if ((date || mode === 'create') && !isValidDate(date)) return `${label}须为有效日期，格式为 YYYYMMDD`
-  }
-  if (values.billDate.trim() && !isValidDate(values.billDate.trim())) {
-    return '出票日须为有效日期，格式为 YYYYMMDD'
-  }
-  if (values.predAmt.trim() || mode === 'create') {
-    const amount = normalizeAmount(values.predAmt)
-    if (!amount || amount.startsWith('-') || (amount.split('.')[1]?.length || 0) > 2) {
-      return '预报金额须为非负金额，最多保留两位小数'
-    }
-  }
-  return ''
-}
-
-export default API

package/src/view/dcps/forecast/components/ForecastDetailView.vue

@@ -1,15 +1,20 @@
 <script setup lang="ts">
 import { computed, onBeforeUnmount, onMounted, ref } from 'vue'
+import { useRouter } from 'vue-router'
 import ForecastPageShell from './ForecastPageShell.vue'
-import API, { formatAmount, formatDate, getErrorMessage } from '../api'
+import { fetchDetail, formatAmount, formatDate, getErrorMessage } from '../utils'
 import type { ForecastDetail, ForecastRow } from '../typs'
 
-defineOptions({ name: 'ForecastDetailView' })
+defineOptions({ name: 'DcpsForecastDetail' })
 
-/** 预报详情页；按预报流水号读取，接口未返回的字段由列表记录补充。 */
-const props = defineProps<{ row: ForecastRow }>()
+/** 预报详情页；按路由中的预报流水号读取，列表记录仅用于补充接口未返回的字段。 */
+const props = defineProps<{
+  predRefNo: string // 预报流水号，来自路由参数。
+  row?: ForecastRow | null // 可选：从列表进入详情时携带的完整记录。
+}>()
 
-const emit = defineEmits<{ back: []; edit: [row: ForecastRow] }>()
+const router = useRouter()
+const backToList = () => void router.replace({ name: 'forecast' })
 
 type DetailField = { key: keyof ForecastDetail; label: string; kind?: 'date' | 'amount' | 'status' }
 
@@ -56,9 +61,14 @@ const detailGroups: { title: string; fields: DetailField[] }[] = [
 const detail = ref<ForecastDetail | null>(null)
 const loading = ref(false)
 const error = ref('')
-const predRefNo = computed(() => props.row.predRefNo?.trim() || '')
+const predRefNo = computed(() => props.predRefNo?.trim() || props.row?.predRefNo?.trim() || '')
+const detailRow = computed<ForecastRow>(() => ({ ...props.row, predRefNo: predRefNo.value }))
 const title = computed(() => predRefNo.value ? `预报详情 · ${predRefNo.value}` : '数字人民币头寸预报详情')
 
+const openEdit = () => {
+  if (predRefNo.value) void router.push({ name: 'forecast-edit', params: { predRefNo: predRefNo.value } })
+}
+
 const displayValue = (field: DetailField) => {
   const value = detail.value?.[field.key]
   if (value === undefined || value === null || value === '') return '—'
@@ -74,7 +84,7 @@ const loadDetail = async () => {
   detail.value = null
   error.value = ''
   try {
-    const result = await API.fetchDetail(props.row)
+    const result = await fetchDetail(detailRow.value)
     if (!disposed) detail.value = result
   } catch (requestError) {
     if (!disposed) error.value = getErrorMessage(requestError)
@@ -88,9 +98,9 @@ onBeforeUnmount(() => { disposed = true })
 </script>
 
 <template>
-  <ForecastPageShell :title="title" :back-disabled="loading" @back="emit('back')">
+  <ForecastPageShell :title="title" :back-disabled="loading" @back="backToList">
     <template #heading-extra>
-      <el-button v-if="detail" type="primary" :disabled="loading" @click="emit('edit', row)">修改预报</el-button>
+      <el-button v-if="detail" type="primary" :disabled="loading" @click="openEdit">修改预报</el-button>
     </template>
     <el-card class="detail-card" shadow="never" :body-style="{ padding: '12px 16px' }">
       <div v-loading="loading" class="detail-scroll">

package/src/view/dcps/forecast/components/ForecastEditorView.vue

@@ -1,10 +1,13 @@
 <script setup lang="ts">
 import { computed, onBeforeUnmount, onMounted, reactive, ref, watch } from 'vue'
+import { useRouter } from 'vue-router'
 import { ElMessage } from 'element-plus'
 import ForecastPageShell from './ForecastPageShell.vue'
-import API, {
-  createFormValues, ensureSuccess, getErrorMessage, getToday, normalizeAmount, validateForm,
-} from '../api'
+import API from '../api'
+import { requestForecastListRefresh } from '../list-refresh'
+import {
+  createFormValues, ensureSuccess, fetchDetail, getErrorMessage, getToday, normalizeAmount, validateForm,
+} from '../utils'
 import { forecastRuntime } from '../../runtime'
 import type {
   ForecastCreateBody,
@@ -16,16 +19,18 @@ import type {
   ForecastRow,
 } from '../typs'
 
-defineOptions({ name: 'ForecastEditorView' })
+defineOptions({ name: 'DcpsForecastEditor' })
 
-/** 新增和修改共用同一张表单页；row 为修改时选中的列表记录，用于补齐详情没有返回的字段。 */
+/** 新增和修改共用同一张表单页；predRefNo 来自路由，row 为可选的列表记录，用于补齐详情没有返回的字段。 */
 const props = defineProps<{
   mode: ForecastEditorMode // create 为新增，edit 为修改。
-  row?: ForecastRow | null // 修改模式的预报记录。
+  predRefNo?: string // 修改模式的预报流水号，来自路由参数。
+  row?: ForecastRow | null // 可选：从列表进入修改时携带的完整记录。
   tranDate?: string // 新增模式的默认交易日期，格式为 YYYYMMDD。
 }>()
 
-const emit = defineEmits<{ back: []; saved: [] }>()
+const router = useRouter()
+const backToList = () => void router.replace({ name: 'forecast' })
 
 type FieldKey = Exclude<keyof ForecastFormValues, 'custRefSeq'>
 type EditorField = {
@@ -90,7 +95,7 @@ const loadError = ref('')
 const initialValues = ref<Partial<ForecastFormValues>>({})
 const requiredFields = new Set<FieldKey>(['clientName', 'payDirec', 'busiType', 'payChannel', 'groundBranch', 'tranDate', 'predDate', 'predAmt'])
 const disabled = computed(() => loading.value || submitting.value)
-const predRefNo = computed(() => props.row?.predRefNo?.trim() || '')
+const predRefNo = computed(() => props.predRefNo?.trim() || props.row?.predRefNo?.trim() || '')
 const title = computed(() => props.mode === 'create' ? '新增数字人民币头寸预报' : '修改数字人民币头寸预报')
 const visibleGroups = computed(() => fieldGroups.map(group => ({
   ...group,
@@ -146,11 +151,16 @@ const buildInitialValues = (detail: ForecastDetail): Partial<ForecastFormValues>
 let disposed = false
 // 修改模式先读取原始数据，再回填表单；读取失败时停留在页面提示原因。
 const loadDetail = async () => {
-  if (props.mode !== 'edit' || !props.row) return
+  if (props.mode !== 'edit') return
+  if (!predRefNo.value) {
+    loadError.value = '预报流水号缺失，无法修改'
+    return
+  }
   loading.value = true
   loadError.value = ''
   try {
-    initialValues.value = buildInitialValues(await API.fetchDetail(props.row))
+    const detailRow: ForecastRow = { ...props.row, predRefNo: predRefNo.value }
+    initialValues.value = buildInitialValues(await fetchDetail(detailRow))
     if (disposed) return
     initializeForm()
   } catch (error) {
@@ -206,7 +216,8 @@ const submit = async () => {
     }
     if (disposed) return
     ElMessage.success(props.mode === 'create' ? '新增请求已处理' : '修改请求已处理')
-    emit('saved')
+    requestForecastListRefresh()
+    await router.replace({ name: 'forecast' })
   } catch (error) {
     if (!disposed) ElMessage.error(getErrorMessage(error))
   } finally {
@@ -216,13 +227,13 @@ const submit = async () => {
 </script>
 
 <template>
-  <ForecastPageShell :title="title" :back-disabled="submitting" @back="emit('back')">
+  <ForecastPageShell :title="title" :back-disabled="submitting" @back="backToList">
     <el-card class="editor-card" shadow="never" :body-style="{ padding: '12px 16px' }">
       <div class="editor-body">
         <div v-loading="loading" class="editor-scroll">
           <el-alert v-if="loadError" class="editor-load-error" :title="loadError" type="error" show-icon :closable="false">
             <el-button link type="primary" :disabled="disabled" @click="loadDetail">重新加载</el-button>
-            <el-button link type="primary" :disabled="disabled" @click="emit('back')">返回列表</el-button>
+            <el-button link type="primary" :disabled="disabled" @click="backToList">返回列表</el-button>
           </el-alert>
           <template v-else>
             <p class="editor-note">金额单位为元，方向、业务类型、支付渠道和客户类型按业务代码填写。</p>
@@ -278,7 +289,7 @@ const submit = async () => {
           <p v-if="formError" class="editor-error" role="alert" aria-live="polite">{{ formError }}</p>
           <span v-else class="editor-tip">{{ mode === 'create' ? '带 * 的字段为新增必填项。' : '留空的字段表示不修改该字段的原值。' }}</span>
           <el-space :size="8">
-            <el-button :disabled="submitting" @click="emit('back')">返回列表</el-button>
+            <el-button :disabled="submitting" @click="backToList">返回列表</el-button>
             <el-button type="primary" :disabled="disabled || !!loadError" :loading="submitting" @click="submit">
               {{ mode === 'create' ? '新增预报' : '保存修改' }}
             </el-button>

package/src/view/dcps/forecast/components/ForecastListView.vue

@@ -1,14 +1,15 @@
 <script setup lang="ts">
 import { computed, onBeforeUnmount, onMounted, reactive, ref } from 'vue'
 import { ElMessage, ElMessageBox } from 'element-plus'
-import API, {
-  compareAmounts, ensureSuccess, formatAmount, formatDate, getErrorMessage, normalizeAmount,
-} from '../api'
+import API from '../api'
+import {
+  compareAmounts, ensureSuccess, formatAmount, formatDate, getErrorMessage, normalizeAmount, readPage,
+} from '../utils'
 import { forecastRuntime } from '../../runtime'
 import { ArtDataTable, type ColumnOption, type PaginationOptions, type TableSettings } from '@/components/table'
 import type { ForecastFilters, ForecastRow } from '../typs'
 
-defineOptions({ name: 'ForecastListView' })
+defineOptions({ name: 'DcpsForecastList' })
 
 /** 列表页只负责查询和展示；新建、修改、详情由外层页面切换。 */
 const emit = defineEmits<{
@@ -98,7 +99,7 @@ const loadList = async () => {
     for (let attempt = 0; attempt < 2; attempt += 1) {
       const response = await API.queryListApi({ ...query, opType: 'query', pageIndex, pageSize })
       if (disposed || currentId !== requestId) return
-      const page = API.readPage(ensureSuccess(response, '预报查询失败'))
+      const page = readPage(ensureSuccess(response, '预报查询失败'))
       const lastPage = Math.max(1, Math.ceil(page.total / pageSize))
       if (pageIndex > lastPage && attempt === 0) {
         pageIndex = lastPage
@@ -279,16 +280,12 @@ defineExpose({ refresh: loadList, getQueryDate: () => appliedQuery.tranDate })
 <style scoped>
 /* 页面先扣除宿主占用高度，再使用 flex 分配剩余高度，让列表内部滚动并保留分页。 */
 .dcps-page {
-  /* 手动修改这里：顶部导航/页签 + 底部状态栏 + 宿主上下留白的合计高度。
-     独立页面保持 0px；例如顶部 90px、底部 24px、上下留白 6px，填写 120px。
-     不包含浏览器标签栏、地址栏，也不包含本页面自身的 padding。 */
-  --host-layout-height: 0px;
   box-sizing: border-box;
   display: flex;
   flex-direction: column;
   gap: 5px;
-  height: calc(100vh - var(--host-layout-height));
-  height: calc(100dvh - var(--host-layout-height));
+  height: calc(100vh - var(--dpcs-host-layout-height));
+  height: calc(100dvh - var(--dpcs-host-layout-height));
   min-width: 0;
   min-height: 0;
   padding: 5px;

package/src/view/dcps/forecast/components/ForecastPageShell.vue

@@ -1,5 +1,5 @@
 <script setup lang="ts">
-defineOptions({ name: 'ForecastPageShell' })
+defineOptions({ name: 'DcpsForecastPageShell' })
 
 /** 页面外壳：固定提供返回按钮和页面标题，内容区由各页面自行填充。 */
 defineProps<{
@@ -32,16 +32,12 @@ const emit = defineEmits<{ back: [] }>()
 <style scoped>
 /* 与列表页面一致：扣除宿主占用高度后，把剩余空间分给内容区，内容区内部滚动。 */
 .page-shell {
-  /* 手动修改这里：顶部导航/页签 + 底部状态栏 + 宿主上下留白的合计高度。
-     独立页面保持 0px；例如顶部 90px、底部 24px、上下留白 6px，填写 120px。
-     不包含浏览器标签栏、地址栏，也不包含本页面自身的 padding。 */
-  --host-layout-height: 0px;
   box-sizing: border-box;
   display: flex;
   flex-direction: column;
   gap: 5px;
-  height: calc(100vh - var(--host-layout-height));
-  height: calc(100dvh - var(--host-layout-height));
+  height: calc(100vh - var(--dpcs-host-layout-height));
+  height: calc(100dvh - var(--dpcs-host-layout-height));
   min-width: 0;
   min-height: 0;
   padding: 5px;