minitest2.0 0.0.4 → 0.0.6

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',
@@ -87,49 +87,49 @@ const router = createRouter({
       path: '/warning',
       name: 'Warning',
       component: () => import('@/views/warning/index.vue'),
-      meta: { requiresAuth: true, title: '预警信息' },
+      meta: { requiresAuth: true, title: '头寸管理平台' },
     },
     {
       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/stores/user.ts

@@ -20,7 +20,7 @@ export const useUserStore = defineStore(
     // -------------------------------- State --------------------------------
 
     /** 登录凭证，登录成功后由后端返回，后续请求通过请求头携带 */
-    const token = ref('1s')
+    const token = ref('')
     const refreshToken = ref('')
     const username = ref('')
     const realName = ref('')

package/src/utils/foreign-forecast.ts

@@ -0,0 +1,102 @@
+export type ForeignCurrencyOption = {
+  label: string
+  shortLabel: string
+  value: string
+  unit: string
+}
+
+export type ForeignOption = {
+  label: string
+  value: string
+}
+
+export type ForeignStatusOption = ForeignOption & {
+  className: string
+}
+
+export const foreignCurrencyOptions: ForeignCurrencyOption[] = [
+  { label: '全部币种', shortLabel: '全部币种', value: '', unit: '万元' },
+  { label: '美元', shortLabel: '美元', value: 'USD', unit: '万美元' },
+  { label: '欧元', shortLabel: '欧元', value: 'EUR', unit: '万欧元' },
+  { label: '港币', shortLabel: '港币', value: 'HKD', unit: '万港币' },
+  { label: '日元', shortLabel: '日元', value: 'JPY', unit: '万日元' },
+  { label: '英镑', shortLabel: '英镑', value: 'GBP', unit: '万英镑' },
+  { label: '加拿大元', shortLabel: '加元', value: 'CAD', unit: '万加元' },
+  { label: '澳大利亚元', shortLabel: '澳元', value: 'AUD', unit: '万澳元' },
+  { label: '新加坡元', shortLabel: '新元', value: 'SGD', unit: '万新元' },
+  { label: '瑞士法郎', shortLabel: '瑞郎', value: 'CHF', unit: '万瑞郎' },
+]
+
+export const foreignBusinessOptions: ForeignOption[] = [
+  { label: '全部业务类型', value: '' },
+  { label: '普通汇款', value: '1' },
+  { label: '外汇买卖', value: '2' },
+  { label: '结售汇', value: '3' },
+  { label: '资金调拨', value: '4' },
+  { label: '同业业务', value: '5' },
+  { label: '贸易融资', value: '6' },
+]
+
+export const foreignStatusOptions: ForeignStatusOption[] = [
+  { label: '全部预报状态', value: '', className: 'status-tag-unknown' },
+  { label: '已确认', value: '1', className: 'status-tag-confirmed' },
+  { label: '待确认', value: '2', className: 'status-tag-pending' },
+  { label: '已撤销', value: '3', className: 'status-tag-cancelled' },
+  { label: '已核销', value: '4', className: 'status-tag-verified' },
+  { label: '已驳回', value: '5', className: 'status-tag-rejected' },
+]
+
+export const unknownForeignStatus: ForeignStatusOption = {
+  label: '未知状态',
+  value: '',
+  className: 'status-tag-unknown',
+}
+
+export function resolveForeignCurrency(value?: string) {
+  const normalizedValue = value?.trim().toUpperCase()
+
+  if (!normalizedValue) {
+    return foreignCurrencyOptions[0]
+  }
+
+  return (
+    foreignCurrencyOptions.find((item) => item.value === normalizedValue) || {
+      label: normalizedValue,
+      shortLabel: normalizedValue,
+      value: normalizedValue,
+      unit: `万${normalizedValue}`,
+    }
+  )
+}
+
+export function resolveForeignBusinessType(value?: string) {
+  if (!value?.trim()) return '普通汇款'
+
+  return foreignBusinessOptions.find((item) => item.value === value)?.label || value
+}
+
+export function resolveForeignStatus(value?: string) {
+  if (!value?.trim()) {
+    return unknownForeignStatus
+  }
+
+  return foreignStatusOptions.find((item) => item.value === value) || unknownForeignStatus
+}
+
+export function formatForeignForecastDate(value?: string) {
+  if (value && /^\d{8}$/.test(value)) {
+    return `${value.slice(0, 4)}-${value.slice(4, 6)}-${value.slice(6, 8)}`
+  }
+
+  return value || '-'
+}
+
+export function toTenThousandAmount(value?: string) {
+  const amount = Number(value?.replaceAll(',', '') || 0)
+  return Number.isFinite(amount) ? amount / 10000 : 0
+}
+
+export function formatForeignForecastAmount(value: number) {
+  const sign = value >= 0 ? '+' : '-'
+  return `${sign}${Math.abs(value).toFixed(2)}`
+}

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} 元`
+}

package/src/views/article-detail/index.vue

@@ -219,6 +219,15 @@ function articleContentToText(html: string) {
   text-decoration: none;
 }
 
+.article-content :deep(img) {
+  display: block;
+  max-width: 100%;
+  height: auto;
+  margin: 8px auto 14px;
+  border-radius: 6px;
+  object-fit: contain;
+}
+
 .article-content :deep(pre) {
   position: relative;
   overflow-x: auto;

package/src/views/article-edit/index.vue

@@ -514,6 +514,15 @@ function normalizeCodeLanguage(value: string) {
   background: #f6f7f9;
 }
 
+.rich-editor :deep(img) {
+  display: block;
+  max-width: 100%;
+  height: auto;
+  margin: 8px auto 12px;
+  border-radius: 6px;
+  object-fit: contain;
+}
+
 .rich-editor :deep(pre) {
   overflow-x: auto;
   margin: 0 0 12px;