minitest2.0 0.0.4 → 0.0.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minitest2.0",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "private": false,
   "type": "module",
   "repository": {

package/src/App.vue

@@ -22,7 +22,7 @@ const tabItems = computed(() =>
   }),
 )
 
-const showTabbar = computed(() => route.meta.hideTabbar !== true)
+const showTabbar = computed(() => route.meta.showTabbar === true)
 const noBackRouteNames = new Set(['Home', 'Login', 'Dashboard', 'Articles', 'Mine'])
 const headerTitle = computed(() => String(route.meta.title || ''))
 const showHeaderBack = computed(() => !noBackRouteNames.has(String(route.name || '')))

package/src/api/clearing-detail.ts

@@ -0,0 +1,66 @@
+import {
+  buildTamRequestPayload,
+  tamRequest,
+  type TamRequestPayload,
+  type TamResponse,
+} from '@/api/tam'
+
+export type ClearingDetailQueryForm = {
+  /** 清算日期，页面日期控件为 YYYY-MM-DD，接口入参为 YYYYMMDD。 */
+  queryDate: string
+}
+
+export type ClearingDetailPayload = TamRequestPayload<ClearingDetailQueryBody>
+
+export type ClearingDetailResult = TamResponse<ClearingDetailResponseBody>
+
+export type ClearingDetailRecord = {
+  /** 时间 */
+  msgSendDt?: string
+  /** 进款 */
+  secreditLineAmt?: string
+  /** 出款 */
+  sedebtLineAmt?: string
+  /** 轧差 */
+  txnetgBalance?: string
+  /** 轧差方向 */
+  txnetgBalanceDirection?: string
+  /** 轧差日期 */
+  txnetgDt?: string
+  /** 场次 */
+  txnetgRnd?: string
+  /** 清算报文编号 */
+  txnetgType?: string
+}
+
+type ClearingDetailQueryBody = {
+  /** 清算日期，格式 YYYYMMDD。 */
+  queryDate: string
+}
+
+type ClearingDetailResponseBody = {
+  result?: ClearingDetailRecord[]
+}
+
+const QUERY_TRAN_CODE = '/TAM/0001/140110006'
+
+export function buildClearingDetailPayload(form: ClearingDetailQueryForm): ClearingDetailPayload {
+  return buildTamRequestPayload({
+    tranCode: QUERY_TRAN_CODE,
+    body: {
+      queryDate: normalizeDate(form.queryDate),
+    },
+  })
+}
+
+export async function queryClearingDetail(
+  payload: ClearingDetailPayload,
+): Promise<ClearingDetailResult> {
+  return tamRequest<ClearingDetailQueryBody, ClearingDetailResponseBody>(payload)
+}
+
+function normalizeDate(value: string) {
+  if (/^\d{8}$/.test(value)) return value
+
+  return value.replaceAll('-', '')
+}

package/src/api/net-debit.ts

@@ -0,0 +1,90 @@
+import {
+  buildTamRequestPayload,
+  tamRequest,
+  type TamRequestPayload,
+  type TamResponse,
+} from '@/api/tam'
+
+type NetDebitEmptyBody = Record<string, never>
+
+export type NetDebitSendPayload = TamRequestPayload<NetDebitEmptyBody>
+
+export type NetDebitQueryPayload = TamRequestPayload<NetDebitQueryBody>
+
+export type NetDebitSendResult = TamResponse<NetDebitSendBody>
+
+export type NetDebitQueryResult = TamResponse<NetDebitQuotaDetail>
+
+export type NetDebitQuotaDetail = {
+  /** 净借记限额 */
+  availableDrAmt?: string
+  /** 查询处理状态 */
+  busiStatus?: string
+  /** 委托日期 */
+  consignDate?: string
+  /** 授信额度 */
+  creditAmt?: string
+  /** 可用净借记限额 */
+  currentAvailableDrAmt?: string
+  /** 圈存资金 */
+  encloseAmt?: string
+  /** 质押额度 */
+  impawnLimit?: string
+  /** 报文标识号 */
+  msgRefNo?: string
+  /** 被查询行行号 */
+  rcvBankCode?: string
+  /** 平台流水号 */
+  refNo?: string
+  /** 应答委托日期 */
+  responseDate?: string
+  /** 应答报文序号 */
+  responseNo?: string
+  /** 被查询清算行行号 */
+  settleBankCode?: string
+  /** 业务处理状态 */
+  status?: string
+  /** 发送交易返回的平台流水号，页面状态流转使用。 */
+  requestRefNo?: string
+}
+
+type NetDebitSendBody = {
+  /** 平台流水号，后续查询交易 body.msgId 使用该值。 */
+  refNo?: string
+}
+
+type NetDebitQueryBody = {
+  /** 发送交易返回的平台流水号。 */
+  msgId: string
+}
+
+const SEND_TRAN_CODE = '/TAM/0001/140110003'
+const QUERY_TRAN_CODE = '/TAM/0001/140110004'
+
+export function buildNetDebitSendPayload(): NetDebitSendPayload {
+  return buildTamRequestPayload({
+    tranCode: SEND_TRAN_CODE,
+    body: {},
+  })
+}
+
+export async function sendNetDebitRequest(
+  payload: NetDebitSendPayload,
+): Promise<NetDebitSendResult> {
+  return tamRequest<NetDebitEmptyBody, NetDebitSendBody>(payload)
+}
+
+export function buildNetDebitQueryPayload(msgId: string): NetDebitQueryPayload {
+  return buildTamRequestPayload({
+    tranCode: QUERY_TRAN_CODE,
+    body: {
+      msgId,
+    },
+  })
+}
+
+export async function queryNetDebitQuota(
+  payload: NetDebitQueryPayload,
+): Promise<NetDebitQueryResult> {
+  return tamRequest<NetDebitQueryBody, NetDebitQuotaDetail>(payload)
+}

package/src/api/opening-reserve-estimate.ts

@@ -0,0 +1,42 @@
+import {
+  buildTamRequestPayload,
+  tamRequest,
+  type TamRequestPayload,
+  type TamResponse,
+} from '@/api/tam'
+
+type OpeningReserveEstimateEmptyBody = Record<string, never>
+
+export type OpeningReserveEstimateBody = {
+  /** 法定准备金 */
+  fzAmt?: string
+  /** 总分行铺底资金之和 */
+  pdAmt?: string
+  /** 日初备款 */
+  preAmt?: string
+  /** 人行时点头寸 */
+  rhAmt?: string
+  /** 预报未核销收入金额 */
+  unverifyAmtIn?: string
+  /** 预报未核销支出金额 */
+  unverifyAmtOut?: string
+}
+
+export type OpeningReserveEstimatePayload = TamRequestPayload<OpeningReserveEstimateEmptyBody>
+
+export type OpeningReserveEstimateResult = TamResponse<OpeningReserveEstimateBody>
+
+const QUERY_TRAN_CODE = '/TAM/0001/140103004'
+
+export function buildOpeningReserveEstimatePayload(): OpeningReserveEstimatePayload {
+  return buildTamRequestPayload({
+    tranCode: QUERY_TRAN_CODE,
+    body: {},
+  })
+}
+
+export async function queryOpeningReserveEstimate(
+  payload: OpeningReserveEstimatePayload,
+): Promise<OpeningReserveEstimateResult> {
+  return tamRequest<OpeningReserveEstimateEmptyBody, OpeningReserveEstimateBody>(payload)
+}

package/src/api/pbc-position.ts

@@ -5,43 +5,65 @@ import {
   type TamResponse,
 } from '@/api/tam'
 
+/**
+ * 人行头寸余额“发送”交易请求报文。
+ *
+ * 该交易不携带业务 body，仅用于向后端发起一次余额查询申请，
+ * 后端返回的申请平台流水号会作为后续“查询”动作的匹配条件。
+ */
 export type PbcPositionSendPayload = {
   appHead: TamRequestPayload<PbcPositionEmptyBody>['appHead']
   body: PbcPositionEmptyBody
   head: TamRequestPayload<PbcPositionEmptyBody>['head']
 }
 
+/**
+ * 人行头寸余额列表查询请求报文。
+ *
+ * 列表查询同样为空 body，后端按当前登录用户、机构、工作日等报文头信息
+ * 返回可继续查询明细的记录集合。
+ */
 export type PbcPositionQueryPayload = {
   appHead: TamRequestPayload<PbcPositionEmptyBody>['appHead']
   body: PbcPositionEmptyBody
   head: TamRequestPayload<PbcPositionEmptyBody>['head']
 }
 
+/**
+ * 人行头寸余额明细查询请求报文。
+ *
+ * 明细交易需要列表记录中的应答平台流水号和清算账户行号，
+ * 查询结果再与发送交易返回的申请平台流水号进行匹配。
+ */
 export type PbcPositionDetailPayload = {
   appHead: TamRequestPayload<PbcPositionDetailRequestBody>['appHead']
   body: PbcPositionDetailRequestBody
   head: TamRequestPayload<PbcPositionDetailRequestBody>['head']
 }
 
+/** “发送”交易响应，body 中主要使用后端返回的申请平台流水号。 */
 export type PbcPositionSendResult = {
   body: PbcPositionSendBody
   head: TamResponse<PbcPositionSendBody>['head']
 }
 
+/** “列表查询”交易响应，body 可能是数组，也可能被 resultList 包裹。 */
 export type PbcPositionQueryResult = {
   body: PbcPositionQueryBody
   head: TamResponse<PbcPositionQueryBody>['head']
 }
 
+/** “明细查询”交易响应，body 为页面最终展示的扩展余额信息。 */
 export type PbcPositionDetailResult = {
   body: PbcPositionDetailBody
   head: TamResponse<PbcPositionDetailBody>['head']
 }
 
+/** 列表交易返回的基础记录，也是明细查询的入参来源。 */
 export type PbcPositionRecord = {
-  /** 应答平台流水号，查询明细入参。 */
+  /** 应答平台流水号，作为明细查询 body.refNo。 */
   refNo?: string
-  /** 清算账户行号。 */
+  /** 清算账户行号，作为明细查询 body.settleBankNo。 */
   settleBankNo?: string
   /** 清算账户余额，接口按元返回。 */
   settleBal?: string
@@ -49,14 +71,15 @@ export type PbcPositionRecord = {
   avaAmt?: string
   /** 预期头寸，接口按元返回。 */
   expectAmt?: string
-  /** 更新时间。 */
+  /** 余额数据更新时间，页面原样展示。 */
   updateTime?: string
 }
 
+/** 明细交易返回的完整余额记录，补充排队金额和辖内非清算账户信息。 */
 export type PbcPositionDetailBody = PbcPositionRecord & {
-  /** 申请平台流水号。 */
+  /** 申请平台流水号，用于与发送交易返回的流水号匹配。 */
   refNo?: string
-  /** 应答平台流水号。 */
+  /** 明细返回的应答平台流水号，页面展示使用。 */
   resRefNo?: string
   /** 排队借记总金额，接口按元返回。 */
   lineDrAmt?: string
@@ -68,33 +91,50 @@ export type PbcPositionDetailBody = PbcPositionRecord & {
   subAcctAmt?: string
 }
 
+/**
+ * 页面使用的归一化余额模型。
+ *
+ * 列表记录和明细记录会合并到同一个对象中，额外保留发送交易返回的
+ * requestRefNo，便于页面判断是否允许继续查询并展示当前申请编号。
+ */
 export type PbcPositionBalance = PbcPositionRecord &
   PbcPositionDetailBody & {
     /** 发送交易返回的申请平台流水号。 */
     requestRefNo?: string
   }
 
+/** 人行头寸余额相关交易均没有业务入参，body 按接口约定传空对象。 */
 type PbcPositionEmptyBody = Record<string, never>
 
+/** 发送交易响应体，仅返回本次申请的平台流水号。 */
 type PbcPositionSendBody = {
+  /** 申请平台流水号，后续查询用它匹配最终明细。 */
   refNo?: string
 }
 
+/** 列表查询响应体，兼容后端返回数组或 { resultList } 两种结构。 */
 type PbcPositionQueryBody =
   | PbcPositionRecord[]
   | {
       resultList?: PbcPositionRecord[]
     }
 
+/** 明细查询请求体，两个字段均来自列表记录。 */
 type PbcPositionDetailRequestBody = {
+  /** 列表记录中的应答平台流水号。 */
   refNo: string
+  /** 列表记录中的清算账户行号。 */
   settleBankNo: string
 }
 
+/** 140104009：发起人行头寸余额查询申请。 */
 const SEND_TRAN_CODE = '/TAM/0001/140104009'
+/** 140104010：查询可用于继续取明细的人行头寸余额记录列表。 */
 const QUERY_TRAN_CODE = '/TAM/0001/140104010'
+/** 140104011：按列表记录查询人行头寸余额明细。 */
 const DETAIL_TRAN_CODE = '/TAM/0001/140104011'
 
+/** 构造“发送”交易报文，填充 TAM 公共报文头并传空业务 body。 */
 export function buildPbcPositionSendPayload(): PbcPositionSendPayload {
   return buildTamRequestPayload({
     tranCode: SEND_TRAN_CODE,
@@ -102,12 +142,14 @@ export function buildPbcPositionSendPayload(): PbcPositionSendPayload {
   })
 }
 
+/** 调用“发送”交易，成功后返回申请平台流水号。 */
 export async function sendPbcPositionRequest(
   payload: PbcPositionSendPayload,
 ): Promise<PbcPositionSendResult> {
   return tamRequest<PbcPositionEmptyBody, PbcPositionSendBody>(payload)
 }
 
+/** 构造“列表查询”交易报文，按登录上下文查询当前可见的人行头寸记录。 */
 export function buildPbcPositionQueryPayload(): PbcPositionQueryPayload {
   return buildTamRequestPayload({
     tranCode: QUERY_TRAN_CODE,
@@ -115,12 +157,14 @@ export function buildPbcPositionQueryPayload(): PbcPositionQueryPayload {
   })
 }
 
+/** 调用“列表查询”交易，返回可进一步查询明细的记录集合。 */
 export async function queryPbcPositionList(
   payload: PbcPositionQueryPayload,
 ): Promise<PbcPositionQueryResult> {
   return tamRequest<PbcPositionEmptyBody, PbcPositionQueryBody>(payload)
 }
 
+/** 根据列表记录构造“明细查询”交易报文。 */
 export function buildPbcPositionDetailPayload(
   record: Pick<PbcPositionRecord, 'refNo' | 'settleBankNo'>,
 ): PbcPositionDetailPayload {
@@ -133,13 +177,22 @@ export function buildPbcPositionDetailPayload(
   })
 }
 
+/** 调用“明细查询”交易，返回单条人行头寸余额的完整字段。 */
 export async function queryPbcPositionDetail(
   payload: PbcPositionDetailPayload,
 ): Promise<PbcPositionDetailResult> {
   return tamRequest<PbcPositionDetailRequestBody, PbcPositionDetailBody>(payload)
 }
 
+/**
+ * 按发送交易返回的申请平台流水号查询最终余额明细。
+ *
+ * 后端流程拆成“列表查询”和“逐条明细查询”两步：先取到候选记录列表，
+ * 再使用每条记录的应答流水号和清算账户行号查询明细；只有明细中的
+ * refNo 与发送返回的 requestRefNo 一致时，才认为命中了本次申请结果。
+ */
 export async function queryPbcPositionBalance(requestRefNo: string): Promise<PbcPositionBalance> {
+  // 第一步：获取当前登录上下文下可查询的候选人行头寸记录。
   const queryPayload = buildPbcPositionQueryPayload()
   console.log('[人行头寸余额查询1入参]', queryPayload)
 
@@ -151,15 +204,19 @@ export async function queryPbcPositionBalance(requestRefNo: string): Promise<Pbc
   }
 
   for (const record of records) {
+    // 明细交易必须同时传入应答流水号和清算账户行号，缺任一字段时跳过。
     if (!record.refNo || !record.settleBankNo) continue
 
+    // 第二步：逐条查询明细，因为列表交易不直接返回全部展示字段。
     const detailPayload = buildPbcPositionDetailPayload(record)
     console.log('[人行头寸余额查询2入参]', detailPayload)
 
     const detailResponse = await queryPbcPositionDetail(detailPayload)
 
+    // 明细 refNo 表示申请平台流水号，用它与发送交易返回值做最终匹配。
     if (detailResponse.body.refNo !== requestRefNo) continue
 
+    // 保留列表字段，使用明细字段覆盖同名字段，并补齐页面需要的流水号别名。
     return {
       ...record,
       ...detailResponse.body,
@@ -171,6 +228,7 @@ export async function queryPbcPositionBalance(requestRefNo: string): Promise<Pbc
   throw new Error(`未查询到编号 ${requestRefNo} 对应的余额结果`)
 }
 
+/** 统一提取列表记录，屏蔽后端数组和 resultList 包裹结构的差异。 */
 function getPbcPositionRecords(body: PbcPositionQueryBody) {
   if (Array.isArray(body)) return body
 

package/src/router/index.ts

@@ -15,31 +15,31 @@ const router = createRouter({
       path: '/',
       name: 'Home',
       component: () => import('@/views/home/index.vue'),
-      meta: { requiresAuth: true, title: '头寸管理平台' },
+      meta: { requiresAuth: true, showTabbar: true, title: '头寸管理平台' },
     },
     {
       path: '/login',
       name: 'Login',
       component: () => import('@/views/login/index.vue'),
-      meta: { hideTabbar: true, title: '账号登录' },
+      meta: { title: '账号登录' },
     },
     {
       path: '/rmb-position',
       name: 'RmbPosition',
       component: () => import('@/views/rmb-position/index.vue'),
-      meta: { requiresAuth: true, hideTabbar: true, title: '本币预报信息查询' },
+      meta: { requiresAuth: true, title: '本币预报信息查询' },
     },
     {
       path: '/rmb-position/new',
       name: 'RmbPositionCreate',
       component: () => import('@/views/rmb-position-create/index.vue'),
-      meta: { requiresAuth: true, hideTabbar: true, title: '新增本币预报' },
+      meta: { requiresAuth: true, title: '新增本币预报' },
     },
     {
       path: '/rmb-position/:predRefNo',
       name: 'RmbPositionDetail',
       component: () => import('@/views/rmb-position-detail/index.vue'),
-      meta: { requiresAuth: true, hideTabbar: true, title: '预报详情' },
+      meta: { requiresAuth: true, title: '预报详情' },
     },
     {
       path: '/foreign-position',
@@ -51,7 +51,7 @@ const router = createRouter({
       path: '/pbc-position',
       name: 'PbcPosition',
       component: () => import('@/views/pbc-position/index.vue'),
-      meta: { requiresAuth: true, hideTabbar: true, title: '人行头寸余额查询' },
+      meta: { requiresAuth: true, title: '人行头寸余额查询' },
     },
     {
       path: '/position-estimate',
@@ -63,13 +63,13 @@ const router = createRouter({
       path: '/position-estimate/report',
       name: 'PositionEstimateReport',
       component: () => import('@/views/position-estimate-report/index.vue'),
-      meta: { requiresAuth: true, hideTabbar: true, title: '头寸匡算报表' },
+      meta: { requiresAuth: true, title: '头寸匡算报表' },
     },
     {
       path: '/position-estimate/opening-reserve',
       name: 'OpeningReserveEstimate',
       component: () => import('@/views/opening-reserve-estimate/index.vue'),
-      meta: { requiresAuth: true, hideTabbar: true, title: '日初备款数匡算' },
+      meta: { requiresAuth: true, title: '日初备款数匡算' },
     },
     {
       path: '/net-debit',
@@ -93,43 +93,43 @@ const router = createRouter({
       path: '/dashboard',
       name: 'Dashboard',
       component: () => import('@/views/dashboard/index.vue'),
-      meta: { requiresAuth: true, title: '看板' },
+      meta: { requiresAuth: true, showTabbar: true, title: '看板' },
     },
     {
       path: '/articles',
       name: 'Articles',
       component: () => import('@/views/articles/index.vue'),
-      meta: { requiresAuth: true, title: '公告' },
+      meta: { requiresAuth: true, showTabbar: true, title: '公告' },
     },
     {
       path: '/articles/new',
       name: 'ArticlePublish',
       component: () => import('@/views/article-edit/index.vue'),
-      meta: { requiresAuth: true, hideTabbar: true, title: '发布公告' },
+      meta: { requiresAuth: true, title: '发布公告' },
     },
     {
       path: '/articles/:id',
       name: 'ArticleDetail',
       component: () => import('@/views/article-detail/index.vue'),
-      meta: { requiresAuth: true, hideTabbar: true, title: '公告详情' },
+      meta: { requiresAuth: true, title: '公告详情' },
     },
     {
       path: '/articles/:id/edit',
       name: 'ArticleEdit',
       component: () => import('@/views/article-edit/index.vue'),
-      meta: { requiresAuth: true, hideTabbar: true, title: '编辑公告' },
+      meta: { requiresAuth: true, title: '编辑公告' },
     },
     {
       path: '/mine',
       name: 'Mine',
       component: () => import('@/views/mine/index.vue'),
-      meta: { requiresAuth: true, title: '我的' },
+      meta: { requiresAuth: true, showTabbar: true, title: '我的' },
     },
     {
       path: '/settings',
       name: 'Settings',
       component: () => import('@/views/settings/index.vue'),
-      meta: { requiresAuth: true, hideTabbar: true, title: '设置' },
+      meta: { requiresAuth: true, title: '设置' },
     },
   ],
 })

package/src/utils/rmb-forecast.ts

@@ -68,7 +68,7 @@ export function formatRmbForecastDate(value?: string) {
 }
 
 export function toBillionYuan(value?: string) {
-  const amount = Number(value || 0)
+  const amount = Number(value?.replaceAll(',', '') || 0)
   return Number.isFinite(amount) ? amount / 100000000 : 0
 }
 
@@ -82,3 +82,27 @@ export function formatForecastAmountText(value?: string) {
 
   return `${formatForecastAmount(toBillionYuan(value))} 亿元`
 }
+
+export function formatForecastAmountYuanText(value?: string) {
+  const text = value?.trim()
+
+  if (!text) return '-'
+
+  const normalizedText = text.replaceAll(',', '')
+
+  if (!/^[-+]?\d+(\.\d+)?$/.test(normalizedText)) {
+    return `${text} 元`
+  }
+
+  const sign =
+    normalizedText.startsWith('-') || normalizedText.startsWith('+')
+      ? normalizedText.slice(0, 1)
+      : ''
+  const unsignedText = sign ? normalizedText.slice(1) : normalizedText
+  const [integerPart = '0', decimalPart] = unsignedText.split('.')
+  const normalizedInteger = integerPart.replace(/^0+(?=\d)/, '') || '0'
+  const groupedInteger = normalizedInteger.replace(/\B(?=(\d{3})+(?!\d))/g, ',')
+  const amountText = decimalPart === undefined ? groupedInteger : `${groupedInteger}.${decimalPart}`
+
+  return `${sign}${amountText} 元`
+}