feat: 流量记录查询、套餐人工冲正与退款资产后处理
Some checks failed
构建并部署前端到测试环境 / deploy (push) Failing after 7m27s

- 新增采集成功/失败记录、卡日流量、套餐日流量详单、冲正流水、退款后处理尝试记录 6 个查询页
- 资产详情新增采集记录、冲正记录与人工冲正,同步后展示本次流量入账结果
- 退款列表与详情展示资产后处理状态,支持按状态筛选、人工重试与查看尝试记录
- 新增前端权限码常量(需在 tb_permission 补数据)
This commit is contained in:
邹进
2026-11-07 13:19:26 +09:00
parent 49a4d32eab
commit 984db9889c
35 changed files with 2693 additions and 31 deletions

View File

@@ -0,0 +1,150 @@
import {
RECORD_MAX_SPAN_DAYS,
TRAFFIC_DECISION_LABELS,
TRAFFIC_RESULT_LABELS
} from '@/config/constants/trafficRecords'
import type { AssetTrafficRefreshResult } from '@/types/api/trafficRecords'
/** 账号类型:1 超级管理员 2 平台 3 代理 4 企业 */
export const USER_TYPE_SUPER_ADMIN = 1
export const USER_TYPE_PLATFORM = 2
export const USER_TYPE_ENTERPRISE = 4
export const isPlatformAccount = (userType?: number) =>
userType === USER_TYPE_SUPER_ADMIN || userType === USER_TYPE_PLATFORM
export const isEnterpriseAccount = (userType?: number) => userType === USER_TYPE_ENTERPRISE
const DAY_MS = 86400000
const pad = (value: number) => String(value).padStart(2, '0')
/** 上海时间展示格式,与后端接受的 "2006-01-02 15:04:05" 一致 */
export function formatRecordDateTime(date: Date): string {
return (
`${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())} ` +
`${pad(date.getHours())}:${pad(date.getMinutes())}:${pad(date.getSeconds())}`
)
}
export function formatRecordDate(date: Date): string {
return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`
}
/** 最近 N 天的时间范围(结束时间为当前时刻) */
export function recentTimeRange(days = 1): [string, string] {
const end = new Date()
return [formatRecordDateTime(new Date(end.getTime() - days * DAY_MS)), formatRecordDateTime(end)]
}
/** 最近 N 天的日期范围(含今天) */
export function recentDateRange(days = 7): [string, string] {
const end = new Date()
return [formatRecordDate(new Date(end.getTime() - (days - 1) * DAY_MS)), formatRecordDate(end)]
}
const parseTime = (value: string) => new Date(value.replace(' ', 'T')).getTime()
function assertRange(range: unknown): asserts range is [string, string] {
if (!Array.isArray(range) || range.length !== 2 || range.some((value) => !value)) {
throw new Error('请选择完整的时间范围')
}
}
/**
* 时间范围转查询参数(结束时间不含)。required=false 且未选择时返回空对象。
* 跨度超过 31 天直接报错,不发请求。
*/
export function toTimeQuery(range: unknown, required = true) {
if (!required && (!Array.isArray(range) || range.length === 0 || range.every((v) => !v))) {
return {}
}
assertRange(range)
const start = parseTime(range[0])
const end = parseTime(range[1])
if (!Number.isFinite(start) || !Number.isFinite(end) || end <= start) {
throw new Error('时间范围无效,结束时间必须晚于开始时间')
}
if (end - start > RECORD_MAX_SPAN_DAYS * DAY_MS) {
throw new Error(`时间跨度不能超过 ${RECORD_MAX_SPAN_DAYS} 天`)
}
return { start_time: range[0], end_time: range[1] }
}
/** 日期范围转查询参数(含首尾) */
export function toDateQuery(range: unknown) {
assertRange(range)
const start = parseTime(`${range[0]} 00:00:00`)
const end = parseTime(`${range[1]} 00:00:00`)
if (!Number.isFinite(start) || !Number.isFinite(end) || end < start) {
throw new Error('日期范围无效,结束日期不得早于开始日期')
}
// 含首尾:1 日至 31 日共 31 天
if ((end - start) / DAY_MS + 1 > RECORD_MAX_SPAN_DAYS) {
throw new Error(`日期跨度不能超过 ${RECORD_MAX_SPAN_DAYS} 天`)
}
return { start_date: range[0], end_date: range[1] }
}
/** 非平台账号必须填资产标识才能查询(后端不传资产标识查全部仅平台账号可用) */
export function requireIdentifierForNonPlatform(identifier: string | undefined, userType?: number) {
if (!isPlatformAccount(userType) && !identifier?.trim()) {
throw new Error('请先输入资产标识')
}
}
/** 去掉空值,避免把空字符串当筛选条件 */
export function compactQuery<T extends object>(query: T): Partial<T> {
return Object.fromEntries(
Object.entries(query).filter(
([, value]) => value !== '' && value !== null && value !== undefined
)
) as Partial<T>
}
/** 选填的正整数输入 */
export function optionalPositiveInt(value: unknown, label: string): number | undefined {
if (value === undefined || value === null || value === '') return undefined
const number = Number(value)
if (!Number.isSafeInteger(number) || number <= 0) throw new Error(`${label}须为正整数`)
return number
}
/** 选填的布尔筛选(下拉值为 'true' / 'false') */
export function optionalBoolean(value: unknown): boolean | undefined {
if (value === 'true' || value === true) return true
if (value === 'false' || value === false) return false
return undefined
}
/** 流量数值展示(MB,最多两位小数) */
export function formatMb(value: unknown): string {
if (value === undefined || value === null || value === '') return '-'
const number = Number(value)
if (!Number.isFinite(number)) return String(value)
return `${Number.isInteger(number) ? number : number.toFixed(2)} MB`
}
export function errorMessage(error: unknown): string {
const data = (error as { response?: { data?: { msg?: string; message?: string } } })?.response
?.data
if (data?.msg || data?.message) return (data.msg || data.message) as string
return error instanceof Error ? error.message : '请求失败,请重试'
}
/** 资产同步后的流量入账结果文案;没有 traffic_refresh 时返回空串,保持原提示 */
export function describeTrafficRefresh(result?: AssetTrafficRefreshResult | null): string {
if (!result) return ''
if (result.result && result.result !== 'ok') {
return `流量读数${TRAFFIC_RESULT_LABELS[result.result] || result.result},未写入`
}
const reading =
result.reading_mb === undefined || result.reading_mb === null
? '未返回读数'
: `本次读数 ${formatMb(result.reading_mb)}`
if (result.written) {
return `${reading},已写入,增量 ${formatMb(result.delta_mb ?? 0)}`
}
const reason = result.decision ? TRAFFIC_DECISION_LABELS[result.decision] || result.decision : ''
return `${reading},未写入${reason ? `:${reason}` : ''}`
}