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:
@@ -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, /^来源未标注/)
|
||||
})
|
||||
Reference in New Issue
Block a user