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

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

@@ -1,232 +1,35 @@
-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,
-  Tam140501001InBody,
-  Tam140501001OutBody,
-  Tam140501002InBody,
-  Tam140501002OutBody,
-} from './typs'
+import baseHttpClient from "@chic/http"
 
-/**
- * 数字人民币头寸预报页面接口与共用工具。
- * 接口地址：新增 120501001、修改 120501002、删除 120501003、查询 140501001、详情 140501002；
- * 请求报文和接口类型均在本模块内维护。
- */
-const API = {
+export default {
   /**
-   * 分页查询头寸预报。
-   * @param params 查询参数：opType 固定为 query；tranDate 为必查交易日期，格式为 YYYYMMDD。
-   * 其余筛选条件为空字符串表示不限制；金额范围使用 startTransAmt、endTransAmt。
+   * 分页查询数字人民币头寸预报。
+   * @param params 查询参数：opType 固定为 query；pageIndex、pageSize 为页码和每页条数。
+   * 业务筛选：tranDate 为交易日期（必填，YYYYMMDD），busiType 为业务类型，
+   * clientName 为客户名称，competName 为交易对手名称，groundBranch 为落地机构，
+   * payChannel 为支付渠道，payDirec 为收支方向，predStatus 为预报状态，
+   * verifyStatus 为核销状态，startTransAmt、endTransAmt 为金额范围，sortRule 为排序规则。
    */
-  queryListApi: (params: ForecastQueryParams) =>
-    postDigitalRmb<Tam140501001InBody, Tam140501001OutBody>('/TAM/0001/140501001', params),
-
+  queryListApi: (params: unknown) => baseHttpClient.post<any>("/TAM/0001/140501001", params),
   /**
-   * 新增一条头寸预报。
-   * @param body 新增业务字段；金额字段由调用方标准化为十进制文本。
+   * 新增一条数字人民币头寸预报。
+   * @param params 新增参数：tranDate 为交易日期，predDate 为预报日期，predAmt 为预报金额；
+   * 其余为客户、机构、渠道、用途、备注等业务字段，未填写的字段可不传。
    */
-  addApi: (body: ForecastCreateBody) =>
-    postDigitalRmb<Tam120501001InBody, Record<string, unknown>>('/TAM/0001/120501001', { body }),
-
+  addApi: (params: unknown) => baseHttpClient.post<any>("/TAM/0001/120501001", params),
   /**
-   * 修改一条头寸预报。
-   * @param body 修改业务字段；predRefSeq 为待修改记录的预报流水号。
+   * 修改一条数字人民币头寸预报。
+   * @param params 修改参数：predRefSeq 为待修改记录的预报流水号；其余业务字段按修改后的值整条提交。
    */
-  editApi: (body: ForecastEditBody) =>
-    postDigitalRmb<Tam120501002InBody, Record<string, unknown>>('/TAM/0001/120501002', { body }),
-
+  editApi: (params: unknown) => baseHttpClient.post<any>("/TAM/0001/120501002", params),
   /**
-   * 按预报流水号删除头寸预报。
+   * 批量删除数字人民币头寸预报。
    * @param predRefSeqs 待删除记录的预报流水号列表。
    */
   deleteApi: (predRefSeqs: string[]) =>
-    postDigitalRmb<Tam120501003InBody, Record<string, unknown>>('/TAM/0001/120501003', { predRefSeqs }),
-
+    baseHttpClient.post<any>("/TAM/0001/120501003", { predRefSeqs }),
   /**
-   * 读取单条预报详情。
-   * @param params 详情参数：predRefNo 为预报流水号。
+   * 查询单条数字人民币头寸预报详情。
+   * @param params 查询参数：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 '操作失败，请稍后重试'
+  getDetailApi: (params: unknown) => baseHttpClient.post<any>("/TAM/0001/140501002", params)
 }
-
-/** 业务日期始终按上海时区生成，不依赖浏览器所在时区，格式为 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
-}
-
-/** 只接受十进制文本和合法千分位；保留全部小数位，避免改变输入精度。 */
-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