feat(后管): 密钥管理拆两列显示余额(LLM 人民币余额/代理余量),实时查不落库

按拍板:数据源=实时查上游不落库(⇒ 本窗零 Flyway、零 Schema);列形态=拆两列,不是一列两行——
两张货源字典本就互不相通(LLM 行为渠道 longtaitou/t8star,代理行为供应商 qingguo/jikip),合成一格
就是 11-02 那次"代理行贴出龙抬头"的串档形状重来一遍(铁律 25)。不加 v-if="isSuperAdmin":主管必须
能解释组员任务为什么挂欠费,鉴权维持 requireAdmin + DataReadScope。

- src/api/user-secrets.ts:fetchAdminSecretBalances(userIds, companyId?),POST /api/admin/user-secrets/balances,
  超时放宽到 30s(服务端整请求预算 10s,客户端必须比它长,否则拿到的是本地掐断而不是"上游未应答")。
- user-secret-model.ts:llmBalanceLines/proxyBalanceLine 纯函数——**两张字典各查各的**、跨域一律 —、
  未知渠道只出 — 不出钱;available=false 时把 message 挂进 title 而不是画成 0;同一账号两个模块归到
  同一个渠道名下只列一次钱。保持零 @/ 别名以便 node --test 直测。
- UserSecretsPage.vue:两个 <th>(LLM 余额 170px/代理余量 160px,放「更新时间」前),两个 <td> 首屏画 —/查询中,
  列表返回后异步填(不阻塞首屏);colspan 由 isSuperAdmin ? 10 : 9 改成 12 : 11(两处同改,892d88ed 的提交信息
  专门写过这句);表格 min-width 相应 +240px;「刷新余额」按钮按 BALANCE_BATCH=20 分批请求。
- 已核对 ops-cell-must-wrap.test.ts:它的 opsColDecl() 正则锚在表头文字「操作」上,新增 <th> 排在它之前不影响
  UserSecretsPage: 314 下限 ⇒ 那张表不改(实测绿)。
- mock-admin-server.mjs 补两列夹具(一条有数、一条全查不到)供 dev/e2e。

测试:tests/密钥余额列读数.test.ts 12 例(跨域不认、坏值不画 0)+
tests/mount/user-secret-balance-columns.mount.test.ts 9 例——按表头文字定位不靠列序数,并钉 <th> 数=<td> 数=
空行 colspan(超管与非超管两种形状各一遍),把"加列忘改 colspan"直接钉死。既有 status-band 挂载格的夹具 mock
补一个 fetchAdminSecretBalances 函数名(页面挂载即取余额,缺它整个模块 mock 会炸),不是判据改动。
刻意不新增 readSource 钉 ⇒ 不动 tests/baselines/source-pin-ledger.json。vue-tsc rc=0、node --test 1890 例、vitest 77 例。
This commit is contained in:
2026-11-05 12:03:43 +08:00
parent a10aa6bda3
commit cc22600a07
7 changed files with 695 additions and 3 deletions
@@ -0,0 +1,210 @@
/**
* 密钥管理列表页「余额两列」的界面侧判据(2026-11-05 B83)。
*
* 读数本身在 `user-secret-model.ts` 里被那颗纯函数尺子钉着;这一支管的是**接上去的形状**:
* ① 两列都在,且 `<th>` 数=每行 `<td>` 数=空态行的 colspan —— 加列忘改 colspan 是本仓常踩的残行,
* 历史上专门为此写过提交说明,所以这里把它钉成算术关系而不是逐个数字;
* ② 有数时 LLM 列给人民币、代理列给次数,两者不混;
* ③ 整轮没取到时两列都是 `—`,**不是 0**(一格 0 会被读成「这人欠费了」);
* ④ 非超管少一列「分组」时,上述三个数仍然彼此相等。
*
* 跑法:`npx vitest run tests/mount/user-secret-balance-columns.mount.test.ts`
*/
import { beforeEach, describe, expect, it, vi } from 'vitest'
import { flushPromises, mount, type VueWrapper } from '@vue/test-utils'
import { createPinia, setActivePinia, type Pinia } from 'pinia'
import UserSecretsPage from '@/pages/account/UserSecretsPage.vue'
import { useAdminSessionStore } from '@/stores/admin-session'
import { useCompanyTabStore } from '@/stores/company-tab'
const secretsApi = vi.hoisted(() => ({
fetchUserSecretList: vi.fn(),
fetchAdminSecretBalances: vi.fn(),
checkUserSecret: vi.fn(),
deleteUserSecret: vi.fn(),
saveUserSecretModule: vi.fn(),
clearUserSecretModule: vi.fn(),
}))
vi.mock('@/api/user-secrets', () => secretsApi)
function moduleCell(moduleKey: string, over: Record<string, unknown> = {}) {
return {
moduleKey, moduleLabel: moduleKey, channel: null,
masked: 'sk-f****9BgQ', full: '', exists: true, locked: false,
checkStatus: 'passed', checkCode: 'ok', checkMessage: '连通正常',
checkLatencyMs: 12, checkedAt: '2026-11-05T10:30:00', updatedAt: '2026-11-05T10:30:00',
...over,
}
}
function row(userId: number, over: Record<string, unknown> = {}) {
return {
userId,
username: `user${userId}`,
groups: [],
leaderUsername: '',
similarAsin: moduleCell('similar-asin', { moduleLabel: '货源查询密钥', channel: 'longtaitou' }),
appearancePatent: moduleCell('appearance-patent', { moduleLabel: '外观专利密钥', channel: 'longtaitou' }),
proxy: moduleCell('proxy', { moduleLabel: '代理设置', channel: 'jikip' }),
status: 'passed',
statusMessage: '三项均检测通过',
createdAt: '2026-11-01T09:00:00',
updatedAt: '2026-11-05T10:30:00',
...over,
}
}
function llmCells(userId: number) {
return [
{
moduleKey: 'appearance-patent', moduleLabel: '外观专利密钥',
channel: 'longtaitou', channelLabel: '龙抬头',
available: true, balance: '88.888882', availableBalance: '85.288882', frozen: '3.6',
unit: 'CREDIT', message: null, checkedAt: '2026-11-05T10:30:00',
},
{
moduleKey: 'similar-asin', moduleLabel: '货源查询密钥',
channel: 'longtaitou', channelLabel: '龙抬头',
available: true, balance: '88.888882', availableBalance: '85.288882', frozen: '3.6',
unit: 'CREDIT', message: null, checkedAt: '2026-11-05T10:30:00',
},
].map((cell) => (userId === 7 ? cell : { ...cell, balance: '12.5', availableBalance: '10', frozen: null }))
}
function indexByHeader(wrapper: VueWrapper<Element>, header: string) {
const headers = wrapper.findAll('thead th').map((th) => th.text().trim())
const index = headers.findIndex((label) => label.includes(header))
expect(index, `表头里找不到「${header}」`).toBeGreaterThanOrEqual(0)
return index
}
function cellText(wrapper: VueWrapper<Element>, header: string, rowIndex = 0): string {
const index = indexByHeader(wrapper, header)
return wrapper.findAll('tbody tr')[rowIndex].findAll('td')[index].text().trim()
}
function cellTitle(wrapper: VueWrapper<Element>, header: string, rowIndex = 0): string {
const index = indexByHeader(wrapper, header)
const cell = wrapper.findAll('tbody tr')[rowIndex].findAll('td')[index]
return cell.find('.balance-line').attributes('title') ?? ''
}
let pinia: Pinia
beforeEach(() => {
vi.clearAllMocks()
pinia = createPinia()
setActivePinia(pinia)
useAdminSessionStore().user = { id: 1, username: 'root', role: 'super_admin' }
useCompanyTabStore().setActiveId(1)
})
async function mountWith(rowValues: unknown[], balances?: unknown) {
secretsApi.fetchUserSecretList.mockResolvedValue({
items: rowValues, total: rowValues.length, page: 1, pageSize: 15, groupOptions: [],
})
secretsApi.fetchAdminSecretBalances.mockResolvedValue(
balances === undefined
? { items: rowValues.map((item: any) => ({ userId: item.userId, llm: llmCells(item.userId), proxy: { available: true, surplus: '1234', balance: '56', scope: 'user', message: null } })), deniedUserIds: [], timedOutUserIds: [] }
: balances,
)
const wrapper = mount(UserSecretsPage, { global: { plugins: [pinia] } })
await flushPromises()
await flushPromises()
return wrapper
}
describe('余额两列接在密钥管理列表上', () => {
it('表头数=行内格数=空态 colspan(加列忘改 colspan 直接红)', async () => {
const wrapper = await mountWith([row(7)])
const headerCount = wrapper.findAll('thead th').length
const cellCount = wrapper.findAll('tbody tr')[0].findAll('td').length
expect(cellCount, '每行的 td 数必须等于表头列数').toBe(headerCount)
expect(headerCount).toBe(12)
const emptyWrapper = await mountWith([])
const colspan = Number(emptyWrapper.find('tbody td').attributes('colspan'))
expect(colspan, '空态行的 colspan 必须跟着列数走').toBe(headerCount)
})
it('非超管少一列分组时,三个数仍然彼此相等', async () => {
useAdminSessionStore().user = { id: 2, username: 'leader', role: 'admin' }
const wrapper = await mountWith([row(7)])
const headerCount = wrapper.findAll('thead th').length
expect(headerCount).toBe(11)
expect(wrapper.findAll('tbody tr')[0].findAll('td').length).toBe(headerCount)
const emptyWrapper = await mountWith([])
expect(Number(emptyWrapper.find('tbody td').attributes('colspan'))).toBe(headerCount)
})
it('LLM 列给人民币读数,按渠道折成一行(同一个钱不排两遍)', async () => {
const wrapper = await mountWith([row(7)])
expect(cellText(wrapper, 'LLM 余额')).toBe('龙抬头 ¥88.89')
expect(cellTitle(wrapper, 'LLM 余额')).toContain('外观专利密钥')
expect(cellTitle(wrapper, 'LLM 余额')).toContain('货源查询密钥')
expect(cellTitle(wrapper, 'LLM 余额')).toContain('取数于 2026-11-05 10:30')
})
it('代理列给次数并说清是谁的池子,不套 ¥', async () => {
const wrapper = await mountWith([row(7)])
const text = cellText(wrapper, '代理余量')
expect(text).toContain('你的套餐')
expect(text).toContain('1234 次')
expect(text).not.toContain('¥')
})
it('两列各读各的:LLM 列里不出现次数、代理列里不出现金额', async () => {
const wrapper = await mountWith([row(7)])
expect(cellText(wrapper, 'LLM 余额')).not.toMatch(/\d+\s*次/)
expect(cellText(wrapper, '代理余量')).not.toContain('¥')
})
it('整轮没取到时两列都是 —,一格都不许是 0', async () => {
const wrapper = await mountWith([row(7)], { items: [], deniedUserIds: [7], timedOutUserIds: [] })
expect(cellText(wrapper, 'LLM 余额')).toBe('—')
expect(cellText(wrapper, '代理余量')).toBe('—')
expect(cellText(wrapper, 'LLM 余额')).not.toContain('0.00')
})
it('超预算的行说「本轮未应答」,不冒充欠费', async () => {
const wrapper = await mountWith([row(7)], {
items: [{ userId: 7, llm: [], proxy: { available: false, surplus: null, balance: null, scope: null, message: '上游未在本轮时间预算内应答,稍后重试;这不代表余量为 0' } }],
deniedUserIds: [],
timedOutUserIds: [7],
})
expect(cellText(wrapper, 'LLM 余额')).toBe('—')
expect(cellText(wrapper, '代理余量')).toBe('查不了')
expect(cellTitle(wrapper, '代理余量')).toContain('不代表余量为 0')
})
it('余额接口整个失败也不把整页判成加载失败', async () => {
secretsApi.fetchUserSecretList.mockResolvedValue({ items: [row(7)], total: 1, page: 1, pageSize: 15, groupOptions: [] })
secretsApi.fetchAdminSecretBalances.mockRejectedValue(new Error('上游 502'))
const wrapper = mount(UserSecretsPage, { global: { plugins: [pinia] } })
await flushPromises()
await flushPromises()
expect(wrapper.findAll('tbody tr')).toHaveLength(1)
expect(wrapper.find('.load-failure-bar').exists(), '列表主数据在,就不该把整页报成加载失败').toBe(false)
expect(cellText(wrapper, 'LLM 余额')).toBe('—')
})
it('点「刷新余额」重取一轮,不动列表请求', async () => {
const wrapper = await mountWith([row(7)])
const listCalls = secretsApi.fetchUserSecretList.mock.calls.length
await wrapper.findAll('.filter-actions button').at(-1)!.trigger('click')
await flushPromises()
expect(secretsApi.fetchAdminSecretBalances).toHaveBeenCalledTimes(2)
expect(secretsApi.fetchUserSecretList).toHaveBeenCalledTimes(listCalls)
})
})
@@ -25,6 +25,7 @@ import { useCompanyTabStore } from '@/stores/company-tab'
const secretsApi = vi.hoisted(() => ({
fetchUserSecretList: vi.fn(),
fetchAdminSecretBalances: vi.fn(),
checkUserSecret: vi.fn(),
deleteUserSecret: vi.fn(),
saveUserSecretModule: vi.fn(),
@@ -0,0 +1,140 @@
/**
* 密钥管理页「余额两列」的读数判据(2026-11-05 B83)。
*
* 靶子是口径与归属,不是排版:
* ① LLM 那格只认 `unit=CREDIT`(人民币=龙抬头 ⚡),认不出就一律 `—`,不猜、不给 0;
* ② 两把密钥同属一个渠道账户时**折成一行**(同一个钱排两遍会被读成两笔钱);
* ③ 代理那格的 `surplus` 是**次数**,读数带「次」不带 `¥`;`scope=platform` 必须说清是平台池,
* 不许被读成这个用户自己的量(铁律 25 的串档形状);
* ④ 查不到 ≠ 没钱:`available=false` 与「整格没取到」都得出可分辨的文字。
*
* 跑法:`cd crawler-plugin/admin-frontend-vue && npm test`
*/
import test from 'node:test'
import assert from 'node:assert/strict'
import {
formatYuan,
llmBalanceLine,
llmBalanceLines,
proxyBalanceLine,
} from '../src/pages/account/user-secret-model.ts'
function llmCell(over: Record<string, unknown> = {}) {
return {
moduleKey: 'appearance-patent',
moduleLabel: '外观专利密钥',
channel: 'longtaitou',
channelLabel: '龙抬头',
available: true,
balance: '88.888882',
availableBalance: '85.288882',
frozen: '3.6',
unit: 'CREDIT',
message: null,
checkedAt: '2026-11-05T10:30:00',
...over,
}
}
test('人民币读数保留两位且不提前取整', () => {
assert.equal(formatYuan('88.888882'), '¥88.89')
assert.equal(formatYuan('0'), '¥0.00')
assert.equal(formatYuan(''), '')
assert.equal(formatYuan(null), '')
// 认不出数字时原样回显,不套 ¥(套了就是宣称它是人民币)
assert.equal(formatYuan('$12.345678'), '$12.345678')
})
test('LLM 一行给渠道名与金额,悬停带模块原文与取数时刻', () => {
const line = llmBalanceLine(llmCell())
assert.equal(line.text, '龙抬头 ¥88.89')
assert.match(line.title, /外观专利密钥/)
assert.match(line.title, /可用 ¥85\.29/)
assert.match(line.title, /预冻结 ¥3\.60/)
assert.match(line.title, /取数于 2026-11-05 10:30/)
})
test('单位不是 CREDIT 时按认不出处理,一个金额都不给', () => {
const line = llmBalanceLine(llmCell({ unit: 'USD', message: '龙抬头没返回人民币口径的余额块' }))
assert.equal(line.text, '龙抬头 查不到')
assert.ok(!line.text.includes('¥'), `认不出口径不许显示金额:${line.text}`)
assert.match(line.title, /没返回人民币/)
})
test('available=false 说查不到,不显示 0', () => {
const line = llmBalanceLine(llmCell({
available: false, balance: null, availableBalance: null, frozen: null,
channel: 't8star', channelLabel: '贞贞', message: '贞贞渠道不提供余额查询',
}))
assert.equal(line.text, '贞贞 查不到')
assert.ok(!line.text.includes('0.00'), '查不到不许读成欠费')
})
test('两把密钥同渠道时折成一行,同一个钱不排两遍', () => {
const lines = llmBalanceLines([
llmCell(),
llmCell({ moduleKey: 'similar-asin', moduleLabel: '货源查询密钥' }),
])
assert.equal(lines.length, 1)
assert.equal(lines[0].text, '龙抬头 ¥88.89')
assert.match(lines[0].title, /外观专利密钥/)
assert.match(lines[0].title, /货源查询密钥/, '折叠后每一把的原文都要还在悬停里')
})
test('两把密钥分属两渠道时各出一行', () => {
const lines = llmBalanceLines([
llmCell(),
llmCell({
channel: 't8star', channelLabel: '贞贞', available: false,
balance: null, availableBalance: null, frozen: null, unit: null,
message: '贞贞渠道不提供余额查询',
}),
])
assert.deepEqual(lines.map((line) => line.text), ['龙抬头 ¥88.89', '贞贞 查不到'])
})
test('没取到数与查询中是两件事,都不许画成 0', () => {
assert.equal(llmBalanceLine(null).text, '—')
assert.match(llmBalanceLine(null).title, /不是余额为 0/)
assert.equal(llmBalanceLine(undefined, true).text, '查询中…')
assert.deepEqual(llmBalanceLines([], true).map((l) => l.text), ['查询中…'])
assert.deepEqual(llmBalanceLines([], false), [])
})
test('渠道认不出时整格占位,连金额都不给', () => {
const line = llmBalanceLine(llmCell({ channel: 'jikip', channelLabel: '极客' }))
assert.equal(line.text, '—')
assert.ok(!line.text.includes('¥'), '把供应商名贴到 LLM 列就是那处错标的形状')
assert.match(line.title, /渠道值认不出,未显示金额/)
})
test('代理余量给的是次数,带单位且不套 ¥', () => {
const line = proxyBalanceLine({ available: true, surplus: '1234', balance: '56', scope: 'user', message: null })
assert.equal(line.text, '你的套餐 1234 次')
assert.ok(!line.text.includes('¥'), `次数不是钱:${line.text}`)
assert.match(line.title, /剩余 IP 1234/)
assert.match(line.title, /账户余额 56/)
})
test('平台池必须自报是平台的钱,不许冒充这个用户的余量', () => {
const line = proxyBalanceLine({ available: true, surplus: '9', balance: '1', scope: 'platform', message: null })
assert.match(line.text, /^平台池/)
assert.match(line.title, /平台池/)
assert.ok(!line.text.includes('你的套餐'), '串档形状:平台池的量被写成用户自己的套餐')
})
test('青果那一档说查不了,句子用后端原文', () => {
const line = proxyBalanceLine({
available: false, surplus: null, balance: null, scope: 'none',
message: '青果不提供余量/余额查询(它的余额接口要控制台 Appid 与 Appkey 签名)',
})
assert.equal(line.text, '查不了')
assert.match(line.title, /查不了/)
assert.match(line.title, /青果不提供/)
})
test('scope 缺失时不硬认,标成来源未标注', () => {
const line = proxyBalanceLine({ available: true, surplus: '5', balance: null, scope: null, message: null })
assert.match(line.text, /^来源未标注/)
})