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

package/README.md

@@ -25,7 +25,7 @@ pnpm dev:backend  # 只启动后端（backend/ 目录，tsx watch）
 - 支持交易日期、客户、交易对手、机构、金额范围及业务代码筛选，分页、详情、新增、修改和批量删除。
 - 金额、账号及流水号使用字符串处理。业务状态与类型代码保留接口原值，待服务端提供字典后再接入中文选项。
 - 导入、导出按钮保留在列表工具栏，文件由后端接口生成和解析，页面不再在前端拼装 CSV。
-- 模块目录与授权页面保持一致：`api.ts` 接口与日期、金额、表单校验等共用工具，`typs.ts` 类型，`runtime.ts` 默认交易日期，`index.vue` 为入口，`components/` 放页面外壳和列表、新增修改、详情页面。
+- 模块目录与授权页面保持一致：`api.ts` 接口与日期、金额、表单校验等共用工具，`typs.ts` 类型，`runtime.ts` 默认交易日期，`index.vue` 为入口，`components/` 放页面外壳和列表、新增修改、详情页面。接口定义只维护在各自模块下，不再集中到 `src/api`。
 - 新增、修改、详情页面每行四列展示，窗口变窄后依次降为三列、两列、一列。
 
 本地后端的预报接口当前使用通用模拟响应，写入成功响应不代表真实持久化。

package/package.json

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

package/src/layout/index.vue

@@ -1,11 +1,11 @@
 <script setup lang="ts">
 import { computed, onMounted, ref, type Component } from 'vue'
-import DigitalRmbAuthorization from '@/view/dcps/digital-rmb-authorization/index.vue'
-import DigitalRmbAccountBalance from '@/view/dcps/digital-rmb-account-balance/index.vue'
-import DigitalRmbForecast from '@/view/dcps/digital-rmb-forecast/index.vue'
-import DigitalRmbInjection from '@/view/dcps/digital-rmb-injection/index.vue'
-import DigitalRmbWriteOff from '@/view/dcps/digital-rmb-write-off/index.vue'
-import DigitalRmbPositionEstimation from '@/view/dcps/digital-rmb-position-estimation/index.vue'
+import DigitalRmbAuthorization from '@/view/dcps/auth/index.vue'
+import DigitalRmbAccountBalance from '@/view/dcps/balance/index.vue'
+import DigitalRmbForecast from '@/view/dcps/forecast/index.vue'
+import DigitalRmbInjection from '@/view/dcps/injection/index.vue'
+import DigitalRmbWriteOff from '@/view/dcps/write-off/index.vue'
+import DigitalRmbPositionEstimation from '@/view/dcps/estimation/index.vue'
 
 interface LayoutMenu {
   /** 菜单唯一标识，同时作为 KeepAlive 内的页面缓存键。 */
@@ -17,12 +17,12 @@ interface LayoutMenu {
 
 // 全局布局的菜单配置：新增业务页面时只需在这里追加一项。
 const menus: LayoutMenu[] = [
-  { key: 'digital-rmb-forecast', title: '数字人民币头寸预报', compactTitle: '头寸预报', component: DigitalRmbForecast },
-  { key: 'digital-rmb-position-estimation', title: '数字人民币头寸匡算', compactTitle: '匡算', component: DigitalRmbPositionEstimation },
-  { key: 'digital-rmb-injection', title: '数字人民币注资明细查询', compactTitle: '注资明细', component: DigitalRmbInjection },
-  { key: 'digital-rmb-account-balance', title: '数字人民币账户行余额查询申请', compactTitle: '余额查询', component: DigitalRmbAccountBalance },
-  { key: 'digital-rmb-authorization', title: '数字人民币授权', compactTitle: '授权', component: DigitalRmbAuthorization },
-  { key: 'digital-rmb-write-off', title: '数字人民币核销', compactTitle: '核销', component: DigitalRmbWriteOff },
+  { key: 'forecast', title: '数字人民币头寸预报', compactTitle: '头寸预报', component: DigitalRmbForecast },
+  { key: 'estimation', title: '数字人民币头寸匡算', compactTitle: '匡算', component: DigitalRmbPositionEstimation },
+  { key: 'injection', title: '数字人民币注资明细查询', compactTitle: '注资明细', component: DigitalRmbInjection },
+  { key: 'balance', title: '数字人民币账户行余额查询申请', compactTitle: '余额查询', component: DigitalRmbAccountBalance },
+  { key: 'auth', title: '数字人民币授权', compactTitle: '授权', component: DigitalRmbAuthorization },
+  { key: 'write-off', title: '数字人民币核销', compactTitle: '核销', component: DigitalRmbWriteOff },
 ]
 
 const firstMenu = menus[0]!

package/src/utils/digital-rmb-request.ts

@@ -0,0 +1,78 @@
+import { post, type ApiResponse } from './request'
+
+/** TAM 公共请求头中允许出现在数币请求里的字段；未列出的字段按业务字段处理。 */
+export interface DigitalRmbHead {
+  adminUserId?: string
+  agentBranchId?: string
+  apprUserId?: string
+  areaCode?: string
+  batch?: boolean
+  branchId?: string
+  consumerId?: string
+  consumerSeqNo?: string
+  ctrlBits?: string
+  digitalSign?: string
+  extra?: Record<string, unknown>
+  fileFlag?: string
+  filePath?: string
+  isBatch?: boolean
+  msgId?: string
+  origSender?: string
+  pageIndex?: number | string
+  pageSize?: number | string
+  spanId?: string
+  traceId?: string
+  tranCode?: string
+  tranDate?: string
+  tranTimestamp?: string
+  userId?: string
+  verifyUserId?: string
+  versionId?: string
+}
+
+/** 已分组的数币请求报文。 */
+export interface DigitalRmbEnvelope<T> {
+  body: T
+  head?: DigitalRmbHead & Record<string, unknown>
+  appHead?: { opType?: string; ip?: string }
+}
+
+/** 平铺入参中的 tranDate 保留在业务体；公共交易日期请显式传入 head。 */
+export type DigitalRmbParams<T> = DigitalRmbEnvelope<T> | (T & Omit<DigitalRmbHead, 'tranDate'> & {
+  opType?: string
+  ip?: string
+})
+
+const publicFields = new Set([
+  'adminUserId', 'agentBranchId', 'apprUserId', 'areaCode', 'batch',
+  'branchId', 'consumerId', 'consumerSeqNo', 'ctrlBits', 'digitalSign',
+  'extra', 'fileFlag', 'filePath', 'isBatch', 'msgId', 'origSender',
+  'pageIndex', 'pageSize', 'spanId', 'traceId', 'tranCode',
+  'tranTimestamp', 'userId', 'verifyUserId', 'versionId',
+])
+
+/**
+ * 发送数币接口请求。
+ * 支持平铺参数和 { appHead, head, body } 报文；业务 tranDate 始终保留在 body。
+ * 分页参数统一转为字符串，响应保留 TAM 的 head、body 结构。
+ */
+export function postDigitalRmb<TInput, TOutput>(url: string, params: DigitalRmbParams<TInput>) {
+  if (Object.hasOwn(params as object, 'body')) {
+    const envelope = params as DigitalRmbEnvelope<TInput>
+    const head = { ...envelope.head }
+    if (head.pageIndex !== undefined) head.pageIndex = String(head.pageIndex)
+    if (head.pageSize !== undefined) head.pageSize = String(head.pageSize)
+    return post<ApiResponse<TOutput>>(url, { ...envelope, head })
+  }
+
+  const body: Record<string, unknown> = {}
+  const head: Record<string, unknown> = {}
+  const appHead: Record<string, unknown> = {}
+  for (const [key, value] of Object.entries(params as Record<string, unknown>)) {
+    if (value === undefined) continue
+    if (key === 'opType' || key === 'ip') appHead[key] = value
+    else if (publicFields.has(key)) head[key] = key === 'pageIndex' || key === 'pageSize' ? String(value) : value
+    else body[key] = value
+  }
+  return post<ApiResponse<TOutput>>(url, { head, appHead, body })
+}

package/src/view/dcps/{digital-rmb-position-estimation → estimation}/api.ts

@@ -1,13 +1,15 @@
-import sharedEstimationApi from '@/api/modules/digital-rmb/position-estimation'
+import { postDigitalRmb } from '@/utils/digital-rmb-request'
 import type { ApiResponse } from '@/utils/request'
 import type {
   EstimationAmounts, EstimationHistory, EstimationPredRow, EstimationQueryParams, EstimationTranRow,
+  Tam140503001InBody, Tam140503001OutBody, Tam140503002InBody, Tam140503002OutBody,
+  Tam140503003InBody, Tam140503003OutBody, Tam140503004InBody, Tam140503004OutBody,
 } from './typs'
 
 /**
  * 数字人民币头寸匡算页面接口与共用工具。
  * 接口地址：查询 140503001、导出 140503002、详情 140503003、历史预计调拨金额 140503004；
- * 请求报文沿用 @/api 中的数币接口定义。
+ * 请求报文和接口类型均在本模块内维护。
  */
 const API = {
   /**
@@ -15,27 +17,30 @@ const API = {
    * @param params tranDate 为交易日期；predictAllotInAmt、predictAllotOutAmt
    * 为今日预计调拨收入、支付金额。返回十个单元格金额，C11、D11 回显本次输入。
    */
-  queryListApi: (params: EstimationQueryParams) => sharedEstimationApi.queryListApi(params),
+  queryListApi: (params: EstimationQueryParams) =>
+    postDigitalRmb<Tam140503001InBody, Tam140503001OutBody>('/TAM/0001/140503001', params),
 
   /**
    * 匡算导出（140503002）：入参与查询完全一致，响应只有 fileName。
    * 下载协议待文件服务确认，页面导出按钮暂未接线。
    */
-  exportApi: (params: EstimationQueryParams) => sharedEstimationApi.exportApi(params),
+  exportApi: (params: EstimationQueryParams) =>
+    postDigitalRmb<Tam140503002InBody, Tam140503002OutBody>('/TAM/0001/140503002', params),
 
   /**
    * 匡算详情（140503003）。
    * @param params position 为报表单元格位置编码，tranDate 为交易日期；
    * 返回该单元格对应的预报列表、流水列表和总条数。
    */
-  getDetailApi: (params: { position: string; tranDate: string }) =>
-    sharedEstimationApi.getDetailApi(params),
+  getDetailApi: (params: Tam140503003InBody) =>
+    postDigitalRmb<Tam140503003InBody, Tam140503003OutBody>('/TAM/0001/140503003', params),
 
   /**
    * 历史预计调拨金额查询（140503004）。
    * @param tranDate 交易日期。返回该日期的预计调拨收支金额，用于预填查询条件。
    */
-  queryHistoryApi: (tranDate: string) => sharedEstimationApi.queryHistoryApi({ tranDate }),
+  queryHistoryApi: (tranDate: string) =>
+    postDigitalRmb<Tam140503004InBody, Tam140503004OutBody>('/TAM/0001/140503004', { tranDate }),
 }
 
 /** 校验公共响应头；retCode 不是 00000 时按服务端提示或 fallback 抛错。 */

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

@@ -0,0 +1,158 @@
+/**
+ * 数字人民币头寸匡算接口类型，摘自 docs/digital-rmb.openapi.json。
+ * 金额、日期、流水号保留协议原始 string；只有 schema.required 中的字段必填。
+ */
+
+/** Tam140503001In.Body */
+export interface Tam140503001InBody {
+  /** 今日预计调拨收入金额 */
+  predictAllotInAmt: string
+  /** 今日预计调拨支付金额 */
+  predictAllotOutAmt: string
+  /** 交易日期 */
+  tranDate: string
+}
+
+/** Tam140503001Out.Body */
+export interface Tam140503001OutBody {
+  /** 当日可用余额 */
+  B15?: string
+  /** 预计调拨收入金额 */
+  C11?: string
+  /** 昨日可用余额 */
+  C3?: string
+  /** 预报收入金额 */
+  C6?: string
+  /** 未核销收入金额 */
+  C7?: string
+  /** 未核销流水收入金额 */
+  C8?: string
+  /** 预计调拨支出金额 */
+  D11?: string
+  /** 预报支出金额 */
+  D6?: string
+  /** 未核销支出金额 */
+  D7?: string
+  /** 未核销流水支出金额 */
+  D8?: string
+}
+
+/** Tam140503002In.Body */
+export interface Tam140503002InBody {
+  /** 今日预计调拨收入金额 */
+  predictAllotInAmt: string
+  /** 今日预计调拨支付金额 */
+  predictAllotOutAmt: string
+  /** 交易日期 */
+  tranDate: string
+}
+
+/** Tam140503002Out.Body */
+export interface Tam140503002OutBody {
+  /** 返回文件名 */
+  fileName?: string
+}
+
+/** Tam140503003In.Body */
+export interface Tam140503003InBody {
+  /** 位置信息 */
+  position: string
+  /** 交易时间 */
+  tranDate: string
+}
+
+/** Tam140503003Out.Body */
+export interface Tam140503003OutBody {
+  /** 返回预报列表 */
+  predList?: Array<Tam140503003OutBodyPredList>
+  /** 总条数 */
+  totalCount?: string
+  /** 返回流水列表 */
+  tranList?: Array<Tam140503003OutBodyTranList>
+}
+
+/** Tam140503003Out.Body.predList */
+export interface Tam140503003OutBodyPredList {
+  /** 业务类型 */
+  busiType?: string
+  /** 客户名称 */
+  clientName?: string
+  /** 交易对手名称 */
+  competName?: string
+  /** 落地支行 */
+  groundBranch?: string
+  /** 支付渠道 */
+  payChannel?: string
+  /** 收支方向 */
+  payDirec?: string
+  /** 预报金额 */
+  predAmt?: string
+  /** 预报流水号 */
+  predRefNo?: string
+  /** 上级单位 */
+  upOrg?: string
+  /** 已核销金额 */
+  verifyAmt?: string
+  /** 核销状态 */
+  verifyStatus?: string
+}
+
+/** Tam140503003Out.Body.tranList */
+export interface Tam140503003OutBodyTranList {
+  /** 金额 */
+  amt?: string
+  /** 支付系统业务类型 */
+  busiType?: string
+  /** 落地支行 */
+  groundBranch?: string
+  /** 支付渠道 */
+  payChannel?: string
+  /** 收支方向 */
+  payDirec?: string
+  /** 收款人名称 */
+  payeeName?: string
+  /** 付款人名称 */
+  payerName?: string
+  /** 交易参考号 */
+  refNo?: string
+  /** 上级单位 */
+  upOrg?: string
+  /** 核销状态 */
+  verifyStatus?: string
+}
+
+/** Tam140503004In.Body */
+export interface Tam140503004InBody {
+  /** 交易时间 */
+  tranDate: string
+}
+
+/** Tam140503004Out.Body */
+export interface Tam140503004OutBody {
+  /** 今日预计调拨收入金额 */
+  predictAllotInAmt: string
+  /** 今日预计调拨支付金额 */
+  predictAllotOutAmt: string
+}
+
+/** 匡算查询与导出（140503001、140503002）的业务参数：交易日期与预计调拨收支金额均为必填。 */
+export type EstimationQueryParams = Required<Tam140503001InBody>
+
+/** 匡算查询（140503001）返回的十个报表单元格金额；字段名即单元格位置编码。 */
+export type EstimationAmounts = Tam140503001OutBody
+
+/** 历史预计调拨金额查询（140503004）返回，用于预填查询条件。 */
+export type EstimationHistory = Required<Tam140503004OutBody>
+
+/** 匡算详情（140503003）返回的单条预报明细。 */
+export type EstimationPredRow = Tam140503003OutBodyPredList
+
+/** 匡算详情（140503003）返回的单条流水明细。 */
+export type EstimationTranRow = Tam140503003OutBodyTranList
+
+/** 匡算报表单元格：位置为接口字段编码，label 为中文展示名称，amount 为接口金额文本。 */
+export interface EstimationCell {
+  position: string // 单元格位置编码，同接口字段名；详情接口按此提交 position。
+  label: string // 单元格展示名称，如 报备金额（收入）。
+  amount?: string // 接口返回的原始金额文本；未查询时可为空。
+}

package/src/view/dcps/{digital-rmb-forecast → forecast}/api.ts

@@ -1,4 +1,4 @@
-import sharedForecastApi from '@/api/modules/digital-rmb/forecast-management'
+import { postDigitalRmb } from '@/utils/digital-rmb-request'
 import type { ApiResponse } from '@/utils/request'
 import type {
   ForecastCreateBody,
@@ -9,12 +9,19 @@ import type {
   ForecastListBody,
   ForecastQueryParams,
   ForecastRow,
+  Tam120501001InBody,
+  Tam120501002InBody,
+  Tam120501003InBody,
+  Tam140501001InBody,
+  Tam140501001OutBody,
+  Tam140501002InBody,
+  Tam140501002OutBody,
 } from './typs'
 
 /**
  * 数字人民币头寸预报页面接口与共用工具。
  * 接口地址：新增 120501001、修改 120501002、删除 120501003、查询 140501001、详情 140501002；
- * 请求报文沿用 @/api 中的数币接口定义。
+ * 请求报文和接口类型均在本模块内维护。
  */
 const API = {
   /**
@@ -22,31 +29,36 @@ const API = {
    * @param params 查询参数：opType 固定为 query；tranDate 为必查交易日期，格式为 YYYYMMDD。
    * 其余筛选条件为空字符串表示不限制；金额范围使用 startTransAmt、endTransAmt。
    */
-  queryListApi: (params: ForecastQueryParams) => sharedForecastApi.queryListApi(params),
+  queryListApi: (params: ForecastQueryParams) =>
+    postDigitalRmb<Tam140501001InBody, Tam140501001OutBody>('/TAM/0001/140501001', params),
 
   /**
    * 新增一条头寸预报。
    * @param body 新增业务字段；金额字段由调用方标准化为十进制文本。
    */
-  addApi: (body: ForecastCreateBody) => sharedForecastApi.addApi({ body }),
+  addApi: (body: ForecastCreateBody) =>
+    postDigitalRmb<Tam120501001InBody, Record<string, unknown>>('/TAM/0001/120501001', { body }),
 
   /**
    * 修改一条头寸预报。
    * @param body 修改业务字段；predRefSeq 为待修改记录的预报流水号。
    */
-  editApi: (body: ForecastEditBody) => sharedForecastApi.editApi({ body }),
+  editApi: (body: ForecastEditBody) =>
+    postDigitalRmb<Tam120501002InBody, Record<string, unknown>>('/TAM/0001/120501002', { body }),
 
   /**
    * 按预报流水号删除头寸预报。
    * @param predRefSeqs 待删除记录的预报流水号列表。
    */
-  deleteApi: (predRefSeqs: string[]) => sharedForecastApi.deleteApi({ predRefSeqs }),
+  deleteApi: (predRefSeqs: string[]) =>
+    postDigitalRmb<Tam120501003InBody, Record<string, unknown>>('/TAM/0001/120501003', { predRefSeqs }),
 
   /**
    * 读取单条预报详情。
    * @param params 详情参数：predRefNo 为预报流水号。
    */
-  getDetailApi: (params: ForecastDetailParams) => sharedForecastApi.getDetailApi(params),
+  getDetailApi: (params: ForecastDetailParams) =>
+    postDigitalRmb<Tam140501002InBody, Tam140501002OutBody>('/TAM/0001/140501002', params),
 
   /**
    * 读取详情并与列表记录合并：详情没有的字段由同一条列表记录补充，

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

@@ -0,0 +1,262 @@
+/**
+ * 数字人民币头寸预报接口类型，摘自 docs/digital-rmb.openapi.json。
+ * 金额、日期、流水号保留协议原始 string；只有 schema.required 中的字段必填。
+ */
+
+/** Tam120501001In.Body */
+export interface Tam120501001InBody {
+  /** 出票日 */
+  billDate?: string
+  /** 票号 */
+  billNo?: string
+  /** 业务类型 */
+  busiType?: string
+  /** 客户名称 */
+  clientName?: string
+  /** 客户类型 */
+  clientType?: string
+  /** 交易对手账号 */
+  competAcct?: string
+  /** 交易对手名称 */
+  competName?: string
+  /** 客户信息流水号 */
+  custInfoSeq?: string
+  /** 落地机构 */
+  groundBranch?: string
+  /** 落地机构名称 */
+  groundBranchName?: string
+  /** 联系人 */
+  linkMan?: string
+  /** 支付渠道 */
+  payChannel?: string
+  /** 收支方向 */
+  payDirec?: string
+  /** 联系电话 */
+  phoneNo?: string
+  /** 预报金额 */
+  predAmt?: string
+  /** 预报日期 */
+  predDate?: string
+  /** 预报人员姓名 */
+  predName?: string
+  /** 预报机构名称 */
+  predOrgName?: string
+  /** 用途 */
+  purpose?: string
+  /** 备注 */
+  remark?: string
+  /** 交易日期 */
+  tranDate?: string
+}
+
+/** Tam120501002In.Body */
+export interface Tam120501002InBody {
+  /** 出票日 */
+  billDate?: string
+  /** 票号 */
+  billNo?: string
+  /** 业务类型 */
+  busiType?: string
+  /** 客户名称 */
+  clientName?: string
+  /** 客户类型 */
+  clientType?: string
+  /** 交易对手账号 */
+  competAcct?: string
+  /** 交易对手名称 */
+  competName?: string
+  /** 客户信息流水号 */
+  custRefSeq?: string
+  /** 落地机构 */
+  groundBranch?: string
+  /** 落地机构名称 */
+  groundBranchName?: string
+  /** 联系人 */
+  linkMan?: string
+  /** 支付渠道 */
+  payChannel?: string
+  /** 收支方向 */
+  payDirec?: string
+  /** 联系电话 */
+  phoneNo?: string
+  /** 预报金额 */
+  predAmt?: string
+  /** 预报日期 */
+  predDate?: string
+  /** 预报流水号 */
+  predRefSeq?: string
+  /** 用途 */
+  purpose?: string
+  /** 备注 */
+  remark?: string
+  /** 交易日期 */
+  tranDate?: string
+}
+
+/** Tam120501003In.Body */
+export interface Tam120501003InBody {
+  /** 预报流水号 */
+  predRefSeqs?: Array<string>
+}
+
+/** Tam140501001In.Body */
+export interface Tam140501001InBody {
+  /** 业务类型 */
+  busiType?: string
+  /** 客户名称 */
+  clientName?: string
+  /** 交易对手名称 */
+  competName?: string
+  /** 截止金额 */
+  endTransAmt?: string
+  /** 落地机构 */
+  groundBranch?: string
+  /** 支付渠道 */
+  payChannel?: string
+  /** 收支方向 */
+  payDirec?: string
+  /** 预报状态 */
+  predStatus?: string
+  /** 排序 */
+  sortRule?: string
+  /** 起始金额 */
+  startTransAmt?: string
+  /** 交易时间 */
+  tranDate: string
+  /** 核销状态 */
+  verifyStatus?: string
+}
+
+/** Tam140501001Out.Body */
+export interface Tam140501001OutBody {
+  /** 文件名称 */
+  fileName?: string
+  /** 信息列表 */
+  resultList?: Array<Tam140501001OutBodyResultList>
+  /** 总条数 */
+  totalCount?: string
+}
+
+/** Tam140501001Out.Body.resultList */
+export interface Tam140501001OutBodyResultList {
+  /** 业务类型 */
+  busiType?: string
+  /** 客户名称 */
+  clientName?: string
+  /** 客户类型 */
+  clientType?: string
+  /** 交易对手账号 */
+  competAcct?: string
+  /** 交易对手名称 */
+  competName?: string
+  /** 落地机构 */
+  groundBranch?: string
+  /** 机构代码 */
+  groundBranchCode?: string
+  /** 支付渠道 */
+  payChannel?: string
+  /** 收支方向 */
+  payDirec?: string
+  /** 预报金额 */
+  predAmt?: string
+  /** 预报人员编号 */
+  predCode?: string
+  /** 预报日期 */
+  predDate?: string
+  /** 预报流水号 */
+  predRefNo?: string
+  /** 预报状态 */
+  predStatus?: string
+  /** 标准名称 */
+  standardName?: string
+  /** 交易日期 */
+  tranDate?: string
+  /** 已核销金额 */
+  verifyAmt?: string
+  /** 核销状态 */
+  verifyStatus?: string
+}
+
+/** Tam140501002In.Body */
+export interface Tam140501002InBody {
+  /** 预报流水号 */
+  predRefNo: string
+}
+
+/** Tam140501002Out.Body */
+export interface Tam140501002OutBody {
+  /** 票号 */
+  billNo?: string
+  /** 出票日 */
+  billSignDate?: string
+  /** 业务类型 */
+  busiType?: string
+  /** 客户名称 */
+  clientName?: string
+  /** 交易对手账号 */
+  competAcct?: string
+  /** 交易对手名称 */
+  competName?: string
+  /** 释放状态 */
+  edusFlag?: string
+  /** 落地机构名称 */
+  groundBranchName?: string
+  /** 支付渠道 */
+  payChannel?: string
+  /** 收支方向 */
+  payDirec?: string
+  /** 预报金额 */
+  predAmt?: string
+  /** 预报流水号 */
+  predRefNo?: string
+  /** 预报状态 */
+  predStatus?: string
+  /** 标准名称 */
+  standardName?: string
+  /** 交易时间 */
+  tranDate?: string
+  /** 已核销金额 */
+  verifyAmt?: string
+  /** 核销状态 */
+  verifyStatus?: string
+}
+
+/** 页面查询条件；空字符串表示不限制该条件。 */
+export type ForecastFilters = Required<Tam140501001InBody>
+
+/** 列表查询参数；日期格式为 YYYYMMDD，分页从第 1 页开始。 */
+export type ForecastQueryParams = ForecastFilters & {
+  opType: 'query' // 查询操作标识。
+  pageIndex: number // 当前页码。
+  pageSize: number // 每页条数。
+}
+
+/** 新增预报的入参；仅提交填写了内容的业务字段。 */
+export type ForecastCreateBody = Tam120501001InBody
+
+/** 修改预报的入参；predRefSeq 必传，其余字段按接口原值覆盖。 */
+export type ForecastEditBody = Tam120501002InBody
+
+/** 删除预报的入参；一次可提交多个预报流水号。 */
+export type ForecastDeleteBody = Tam120501003InBody
+
+/** 预报详情入参；predRefNo 为要查看的预报流水号。 */
+export type ForecastDetailParams = Tam140501002InBody
+
+/** 接口返回的预报记录，列表和详情共用同一组基础字段。 */
+export type ForecastRow = Tam140501001OutBodyResultList
+
+/** 预报详情；详情接口未返回的字段由同一条列表记录补充。 */
+export type ForecastDetail = ForecastRow & Tam140501002OutBody
+
+/** 详情可能附带客户信息流水号，协议类型未声明，按可选字段处理。 */
+export type ForecastDetailFields = ForecastDetail & Partial<Pick<ForecastFormValues, 'custInfoSeq' | 'custRefSeq'>>
+
+/** 列表查询返回的业务数据。 */
+export type ForecastListBody = Tam140501001OutBody
+
+/** 新增、修改、详情共用的表单值；custRefSeq 为修改接口的字段别名。 */
+export type ForecastFormValues = Required<Tam120501001InBody> & { custRefSeq?: string }
+
+/** 表单模式：create 为新增，edit 为修改。 */
+export type ForecastEditorMode = 'create' | 'edit'

package/src/view/dcps/{digital-rmb-write-off → write-off}/api.ts

@@ -1,16 +1,17 @@
-import sharedWriteOffApi from '@/api/modules/digital-rmb/manual-write-off'
+import { postDigitalRmb, type DigitalRmbParams } from '@/utils/digital-rmb-request'
 import type { ApiResponse } from '@/utils/request'
-import type { DigitalRmbParams } from '@/api/modules/digital-rmb/request'
 import type {
   Tam120502001InBody,
   Tam120502002InBody,
   Tam120502003InBody,
   Tam140502001InBody,
+  Tam140502001OutBody,
   Tam140502002InBody,
-} from '@/api/modules/digital-rmb/types'
+  Tam140502002OutBody,
+} from './typs'
 
 /**
- * 数字人民币头寸核销的五个接口，复用公共封装及 Swagger 类型。
+ * 数字人民币头寸核销的五个接口，复用本模块的类型定义。
  * 支持平铺参数和 { appHead, head, body } 报文；业务 tranDate 始终保留在 body。
  * 金额、日期、账号及流水号使用字符串，响应保留 TAM 的 head、body 结构。
  */
@@ -20,21 +21,24 @@ const API = {
    * @param params predRefNo 为预报流水号，predAmt 为预报金额，
    * beforeVerifyAmt 为修改前核销金额，verifyAmt 为已核销金额。
    */
-  editApi: (params: DigitalRmbParams<Tam120502001InBody>) => sharedWriteOffApi.editApi(params),
+  editApi: (params: DigitalRmbParams<Tam120502001InBody>) =>
+    postDigitalRmb<Tam120502001InBody, Record<string, unknown>>('/TAM/0001/120502001', params),
 
   /**
    * 头寸核销-核销（120502002）。
    * @param params predList 为必填预报集合，每项包含 predRefNo、predAmt、verifyAmt、verifyStatus；
    * tranList 为可选流水集合，传入时每项必须包含 refNo、tranAmt、verifyStatus。
    */
-  writeOffApi: (params: DigitalRmbParams<Tam120502002InBody>) => sharedWriteOffApi.writeOffApi(params),
+  writeOffApi: (params: DigitalRmbParams<Tam120502002InBody>) =>
+    postDigitalRmb<Tam120502002InBody, Record<string, unknown>>('/TAM/0001/120502002', params),
 
   /**
    * 头寸核销-撤销核销（120502003）。
    * @param params predList 为预报集合，tranList 为流水集合；Swagger 未声明集合必填。
    * 流水项必须包含 refNo、tranAmt、verifyStatus；预报项字段的必填约束与核销接口不同。
    */
-  cancelWriteOffApi: (params: DigitalRmbParams<Tam120502003InBody>) => sharedWriteOffApi.cancelWriteOffApi(params),
+  cancelWriteOffApi: (params: DigitalRmbParams<Tam120502003InBody>) =>
+    postDigitalRmb<Tam120502003InBody, Record<string, unknown>>('/TAM/0001/120502003', params),
 
   /**
    * 头寸核销-预报查询（140502001）。
@@ -42,7 +46,8 @@ const API = {
    * busiType：201 兑回、202 兑出、203 付现；payChannel：8 数字人民币；payDirec：I 来账、O 往账。
    * 分页使用公共头 pageIndex、pageSize；返回 body.resultList、body.totalCount（字符串）。
    */
-  queryForecastApi: (params: DigitalRmbParams<Tam140502001InBody>) => sharedWriteOffApi.queryForecastApi(params),
+  queryForecastApi: (params: DigitalRmbParams<Tam140502001InBody>) =>
+    postDigitalRmb<Tam140502001InBody, Tam140502001OutBody>('/TAM/0001/140502001', params),
 
   /**
    * 头寸核销-流水查询（140502002）。
@@ -50,7 +55,8 @@ const API = {
    * startTransAmt、endTransAmt、verifyStatus（1 未核销、2 已核销）筛选。
    * 返回 body.resultList、body.totalCount 和可选 fileName；流水的渠道说明为 5 数字人民币。
    */
-  queryFlowApi: (params: DigitalRmbParams<Tam140502002InBody>) => sharedWriteOffApi.queryFlowApi(params),
+  queryFlowApi: (params: DigitalRmbParams<Tam140502002InBody>) =>
+    postDigitalRmb<Tam140502002InBody, Tam140502002OutBody>('/TAM/0001/140502002', params),
 }
 
 /** 列表查询结果：当前页记录和符合条件的总条数。 */

package/src/view/dcps/write-off/typs.ts

@@ -0,0 +1,263 @@
+/**
+ * 数字人民币头寸核销接口类型，摘自 docs/digital-rmb.openapi.json。
+ * 金额、日期、流水号保留协议原始 string；只有 schema.required 中的字段必填。
+ */
+
+/** Tam120502001In.Body */
+export interface Tam120502001InBody {
+  /** 修改前核销金额 */
+  beforeVerifyAmt?: string
+  /** 预报金额 */
+  predAmt?: string
+  /** 预报流水号 */
+  predRefNo?: string
+  /** 已核销金额 */
+  verifyAmt?: string
+}
+
+/** Tam120502002In.Body */
+export interface Tam120502002InBody {
+  /** 预报集合 */
+  predList: Array<Tam120502002InBodyPredList>
+  /** 流水集合 */
+  tranList?: Array<Tam120502002InBodyTranList>
+}
+
+/** Tam120502002In.Body.predList */
+export interface Tam120502002InBodyPredList {
+  /** 预报金额 */
+  predAmt: string
+  /** 预报流水 */
+  predRefNo: string
+  /** 核销金额 */
+  verifyAmt: string
+  /** 核销状态 */
+  verifyStatus: string
+}
+
+/** Tam120502002In.Body.tranList */
+export interface Tam120502002InBodyTranList {
+  /** 流水号 */
+  refNo: string
+  /** 交易金额 */
+  tranAmt: string
+  /** 核销状态 */
+  verifyStatus: string
+}
+
+/** Tam120502003In.Body */
+export interface Tam120502003InBody {
+  /** 预报集合 */
+  predList?: Array<Tam120502003InBodyPredList>
+  /** 流水集合 */
+  tranList?: Array<Tam120502003InBodyTranList>
+}
+
+/** Tam120502003In.Body.predList */
+export interface Tam120502003InBodyPredList {
+  /** 预报金额 */
+  predAmt?: string
+  /** 预报流水 */
+  predRefNo?: string
+  /** 核销金额 */
+  verifyAmt?: string
+  /** 核销状态 */
+  verifyStatus?: string
+}
+
+/** Tam120502003In.Body.tranList */
+export interface Tam120502003InBodyTranList {
+  /** 流水号 */
+  refNo: string
+  /** 交易金额 */
+  tranAmt: string
+  /** 核销状态 */
+  verifyStatus: string
+}
+
+/** Tam140502001In.Body */
+export interface Tam140502001InBody {
+  /** 我方账号 */
+  acctNo?: string
+  /** 机构关键字 */
+  banchPre?: string
+  /** 机构号列表 */
+  branchCodeList?: Array<string>
+  /** 业务类型,兑回：201 ，兑出：202，付现：203 */
+  busiType?: string
+  /** 客户名称 */
+  clientName?: string
+  /** 交易对手名称 */
+  competName?: string
+  /** 截止金额 */
+  endTransAmt?: string
+  /** 支付渠道,8:数字人民币 */
+  payChannel?: string
+  /** 收支方向,I=来账 O=往账 */
+  payDirec?: string
+  /** 起始金额 */
+  startTransAmt?: string
+  /** 交易日期 */
+  tranDate: string
+  /** 核销状态列表 */
+  verifyStatusList?: Array<string>
+}
+
+/** Tam140502001Out.Body */
+export interface Tam140502001OutBody {
+  /** 返回信息列表 */
+  resultList?: Array<Tam140502001OutBodyResultList>
+  /** 总条数 */
+  totalCount?: string
+}
+
+/** Tam140502001Out.Body.ResultList */
+export interface Tam140502001OutBodyResultList {
+  /** 业务类型,兑回：201 ，兑出：202，付现：203 */
+  busiType?: string
+  /** 客户名称 */
+  clientName?: string
+  /** 交易对手名称 */
+  competName?: string
+  /** 释放状态 */
+  edusFlag?: string
+  /** 落地机构名称 */
+  groundBranchName?: string
+  /** 支付渠道,8:数字人民币 */
+  payChannel?: string
+  /** 收支方向 */
+  payDirec?: string
+  /** 预报金额 */
+  predAmt?: string
+  /** 预报流水号 */
+  predRefNo?: string
+  /** 预报状态 */
+  predStatus?: string
+  /** 交易时间 */
+  tranDate?: string
+  /** 已核销金额 */
+  verifyAmt?: string
+  /** 核销状态 */
+  verifyStatus?: string
+}
+
+/** Tam140502002In.Body */
+export interface Tam140502002InBody {
+  /** 截止金额 */
+  endTransAmt?: string
+  /** 我方机构 */
+  orgName?: string
+  /** 收支方向 */
+  payDirec?: string
+  /** 收款人名称 */
+  payeeName?: string
+  /** 付款人名称 */
+  payerName?: string
+  /** 起始金额 */
+  startTransAmt?: string
+  /** 交易日期 */
+  tranDate: string
+  /** 核销状态，1-未核销 2-已核销 */
+  verifyStatus?: string
+}
+
+/** Tam140502002Out.Body */
+export interface Tam140502002OutBody {
+  /** 导出文件名 */
+  fileName?: string
+  /** 返回信息列表 */
+  resultList?: Array<Tam140502002OutBodyResultList>
+  /** 总条数 */
+  totalCount?: string
+}
+
+/** Tam140502002Out.Body.ResultList */
+export interface Tam140502002OutBodyResultList {
+  /** 机构行号 */
+  branchCode?: string
+  /** 机构名称 */
+  branchName?: string
+  /** 业务状态 */
+  busiStatus?: string
+  /** 业务类型,201：兑回 ，202：兑出，203：付现 */
+  busiType?: string
+  /** 收款行行名称 */
+  collBankName?: string
+  /** 收款行行号 */
+  collBankNo?: string
+  /** 收款钱包ID */
+  collWltId?: string
+  /** 付款行行名称 */
+  payBankName?: string
+  /** 付款行行号 */
+  payBankNo?: string
+  /** 支付渠道,5：数字人民币 */
+  payChannel?: string
+  /** 收支方向,I=来账 O=往账 */
+  payDirec?: string
+  /** 付款钱包ID */
+  payWltId?: string
+  /** 收款人名称 */
+  payeeName?: string
+  /** 付款人名称 */
+  payerName?: string
+  refNo?: string
+  /** 备注 */
+  remark?: string
+  /** 交易金额 */
+  tranAmt?: string
+  /** 交易日期 */
+  tranDate?: string
+  /** 交易时间 */
+  tranTime?: string
+  /** 核销状态 */
+  verifyStatus?: string
+}
+
+/** 预报查询条件；空字符串和空数组表示不限制该条件，重置时恢复默认配置。 */
+export type ForecastFilters = Required<Tam140502001InBody>
+
+/** 预报查询参数：必填 tranDate，分页从第 1 页开始； pageIndex、pageSize 由公共请求头承载。 */
+export type ForecastQueryParams = Tam140502001InBody & { pageIndex: number; pageSize: number }
+
+/** 流水查询条件；空字符串表示不限制该条件。 */
+export type FlowFilters = Required<Tam140502002InBody>
+
+/** 流水查询参数：必填 tranDate，分页从第 1 页开始。 */
+export type FlowQueryParams = Tam140502002InBody & { pageIndex: number; pageSize: number }
+
+/** 预报查询（140502001）返回的单条预报记录。 */
+export type ForecastRow = Tam140502001OutBodyResultList
+
+/** 流水查询（140502002）返回的单条流水记录。 */
+export type FlowRow = Tam140502002OutBodyResultList
+
+/** 核销（120502002）提交的预报集合项：predRefNo、predAmt、verifyAmt、verifyStatus 均必填。 */
+export type WriteOffForecastItem = Tam120502002InBodyPredList
+
+/** 核销（120502002）提交的流水集合项：refNo、tranAmt、verifyStatus 均必填。 */
+export type WriteOffFlowItem = Tam120502002InBodyTranList
+
+/** 撤销核销（120502003）提交的预报集合项；字段可选，按行原值提交。 */
+export type CancelWriteOffPredItem = Tam120502003InBodyPredList
+
+/** 撤销核销（120502003）提交的流水集合项：refNo、tranAmt、verifyStatus 均必填。 */
+export type CancelWriteOffFlowItem = Tam120502003InBodyTranList
+
+/** 修改核销金额（120502001）的表单值；predRefNo、predAmt、beforeVerifyAmt 从行数据带入。 */
+export type EditVerifyFormValues = Required<Tam120502001InBody>
+
+/** 核销弹窗的预报编辑行：amount 为待输入的核销金额，key 用于表格渲染。 */
+export type WriteOffItemInput = {
+  key: string // 弹窗表格行的渲染键，取预报流水号。
+  predRefNo: string // 预报流水号，提交时原样带回。
+  predAmt: string // 预报金额，仅展示。
+  amount: string // 用户输入的核销金额，默认取预报金额。
+}
+
+/** 核销弹窗的流水行：已在预报表格勾选的流水，提交时按行原值组装。 */
+export type WriteOffFlowInput = {
+  key: string // 弹窗表格行的渲染键，取流水号。
+  refNo: string // 流水号，提交时原样带回。
+  tranAmt: string // 交易金额，仅展示。
+}

package/src/view/dcps/digital-rmb-forecast/typs.ts

@@ -1,50 +0,0 @@
-import type {
-  Tam120501001InBody,
-  Tam120501002InBody,
-  Tam120501003InBody,
-  Tam140501001InBody,
-  Tam140501001OutBody,
-  Tam140501001OutBodyResultList,
-  Tam140501002InBody,
-  Tam140501002OutBody,
-} from '@/api'
-
-/** 页面查询条件；空字符串表示不限制该条件。 */
-export type ForecastFilters = Required<Tam140501001InBody>
-
-/** 列表查询参数；日期格式为 YYYYMMDD，分页从第 1 页开始。 */
-export type ForecastQueryParams = ForecastFilters & {
-  opType: 'query' // 查询操作标识。
-  pageIndex: number // 当前页码。
-  pageSize: number // 每页条数。
-}
-
-/** 新增预报的入参；仅提交填写了内容的业务字段。 */
-export type ForecastCreateBody = Tam120501001InBody
-
-/** 修改预报的入参；predRefSeq 必传，其余字段按接口原值覆盖。 */
-export type ForecastEditBody = Tam120501002InBody
-
-/** 删除预报的入参；一次可提交多个预报流水号。 */
-export type ForecastDeleteBody = Tam120501003InBody
-
-/** 预报详情入参；predRefNo 为要查看的预报流水号。 */
-export type ForecastDetailParams = Tam140501002InBody
-
-/** 接口返回的预报记录，列表和详情共用同一组基础字段。 */
-export type ForecastRow = Tam140501001OutBodyResultList
-
-/** 预报详情；详情接口未返回的字段由同一条列表记录补充。 */
-export type ForecastDetail = ForecastRow & Tam140501002OutBody
-
-/** 详情可能附带客户信息流水号，协议类型未声明，按可选字段处理。 */
-export type ForecastDetailFields = ForecastDetail & Partial<Pick<ForecastFormValues, 'custInfoSeq' | 'custRefSeq'>>
-
-/** 列表查询返回的业务数据。 */
-export type ForecastListBody = Tam140501001OutBody
-
-/** 新增、修改、详情共用的表单值；custRefSeq 为修改接口的字段别名。 */
-export type ForecastFormValues = Required<Tam120501001InBody> & { custRefSeq?: string }
-
-/** 表单模式：create 为新增，edit 为修改。 */
-export type ForecastEditorMode = 'create' | 'edit'

package/src/view/dcps/digital-rmb-position-estimation/typs.ts

@@ -1,29 +0,0 @@
-import type {
-  Tam140503001InBody,
-  Tam140503001OutBody,
-  Tam140503003OutBodyPredList,
-  Tam140503003OutBodyTranList,
-  Tam140503004OutBody,
-} from '@/api'
-
-/** 匡算查询与导出（140503001、140503002）的业务参数：交易日期与预计调拨收支金额均为必填。 */
-export type EstimationQueryParams = Required<Tam140503001InBody>
-
-/** 匡算查询（140503001）返回的十个报表单元格金额；字段名即单元格位置编码。 */
-export type EstimationAmounts = Tam140503001OutBody
-
-/** 历史预计调拨金额查询（140503004）返回，用于预填查询条件。 */
-export type EstimationHistory = Required<Tam140503004OutBody>
-
-/** 匡算详情（140503003）返回的单条预报明细。 */
-export type EstimationPredRow = Tam140503003OutBodyPredList
-
-/** 匡算详情（140503003）返回的单条流水明细。 */
-export type EstimationTranRow = Tam140503003OutBodyTranList
-
-/** 匡算报表单元格：位置为接口字段编码，label 为中文展示名称，amount 为接口金额文本。 */
-export interface EstimationCell {
-  position: string // 单元格位置编码，同接口字段名；详情接口按此提交 position。
-  label: string // 单元格展示名称，如 报备金额（收入）。
-  amount?: string // 接口返回的原始金额文本；未查询时可为空。
-}

package/src/view/dcps/digital-rmb-write-off/typs.ts

@@ -1,59 +0,0 @@
-import type {
-  Tam120502001InBody,
-  Tam120502002InBodyPredList,
-  Tam120502002InBodyTranList,
-  Tam120502003InBodyPredList,
-  Tam120502003InBodyTranList,
-  Tam140502001InBody,
-  Tam140502001OutBodyResultList,
-  Tam140502002InBody,
-  Tam140502002OutBodyResultList,
-} from '@/api'
-
-/** 预报查询条件；空字符串和空数组表示不限制该条件，重置时恢复默认配置。 */
-export type ForecastFilters = Required<Tam140502001InBody>
-
-/** 预报查询参数：必填 tranDate，分页从第 1 页开始； pageIndex、pageSize 由公共请求头承载。 */
-export type ForecastQueryParams = Tam140502001InBody & { pageIndex: number; pageSize: number }
-
-/** 流水查询条件；空字符串表示不限制该条件。 */
-export type FlowFilters = Required<Tam140502002InBody>
-
-/** 流水查询参数：必填 tranDate，分页从第 1 页开始。 */
-export type FlowQueryParams = Tam140502002InBody & { pageIndex: number; pageSize: number }
-
-/** 预报查询（140502001）返回的单条预报记录。 */
-export type ForecastRow = Tam140502001OutBodyResultList
-
-/** 流水查询（140502002）返回的单条流水记录。 */
-export type FlowRow = Tam140502002OutBodyResultList
-
-/** 核销（120502002）提交的预报集合项：predRefNo、predAmt、verifyAmt、verifyStatus 均必填。 */
-export type WriteOffForecastItem = Tam120502002InBodyPredList
-
-/** 核销（120502002）提交的流水集合项：refNo、tranAmt、verifyStatus 均必填。 */
-export type WriteOffFlowItem = Tam120502002InBodyTranList
-
-/** 撤销核销（120502003）提交的预报集合项；字段可选，按行原值提交。 */
-export type CancelWriteOffPredItem = Tam120502003InBodyPredList
-
-/** 撤销核销（120502003）提交的流水集合项：refNo、tranAmt、verifyStatus 均必填。 */
-export type CancelWriteOffFlowItem = Tam120502003InBodyTranList
-
-/** 修改核销金额（120502001）的表单值；predRefNo、predAmt、beforeVerifyAmt 从行数据带入。 */
-export type EditVerifyFormValues = Required<Tam120502001InBody>
-
-/** 核销弹窗的预报编辑行：amount 为待输入的核销金额，key 用于表格渲染。 */
-export type WriteOffItemInput = {
-  key: string // 弹窗表格行的渲染键，取预报流水号。
-  predRefNo: string // 预报流水号，提交时原样带回。
-  predAmt: string // 预报金额，仅展示。
-  amount: string // 用户输入的核销金额，默认取预报金额。
-}
-
-/** 核销弹窗的流水行：已在预报表格勾选的流水，提交时按行原值组装。 */
-export type WriteOffFlowInput = {
-  key: string // 弹窗表格行的渲染键，取流水号。
-  refNo: string // 流水号，提交时原样带回。
-  tranAmt: string // 交易金额，仅展示。
-}