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

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

@@ -0,0 +1,131 @@
+import type { ApiResponse } from '@/utils/request'
+
+/** 列表查询结果：当前页记录和符合条件的总条数。 */
+export interface WriteOffPage<T> {
+  data: T[] // 当前页的记录列表。
+  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
+}
+
+/**
+ * 校验查询响应并取出当前页数据；两个查询接口共享同一种 body 结构。
+ * @param body 查询接口返回的业务数据。
+ * @param fallback body 缺少 resultList 时的错误提示文本。
+ */
+export function readPage<R extends { resultList?: unknown[]; totalCount?: unknown }>(
+  body: R | null,
+  fallback: string,
+): WriteOffPage<NonNullable<R['resultList']>[number]> {
+  if (!body || !Array.isArray(body.resultList)) throw new Error(fallback)
+  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 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
+}
+
+/** 只接受十进制文本和合法千分位；保留全部小数位，避免改变输入精度。 */
+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
+}
+
+/** 业务类型字典：201 兑回、202 兑出、203 付现；超出字典的值保留原文。 */
+export const busiTypeLabels: Record<string, string> = { '201': '兑回', '202': '兑出', '203': '付现' }
+/** 收支方向字典：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': '已核销' }
+
+/** 读取字典文案；空值显示横线，未登记的代码保留原文展示。 */
+export function dictLabel(labels: Record<string, string>, value?: string): string {
+  const text = value?.trim() || ''
+  return text ? labels[text] ?? text : '—'
+}