Files
one-pipe-system/src/utils/business/trafficRecords.ts
邹进 3411b66c71
Some checks failed
构建并部署前端到测试环境 / deploy (push) Has been cancelled
fix: 记录查询列表显示 ICCID、设备号、套餐名称、运营商名称与操作人,不再显示内部 ID
- 卡 / 设备列优先显示 ICCID、设备号(IMEI),后端未返回时才退回内部 ID
- 运营商账户筛选改为按名称搜索
2026-11-07 17:07:31 +09:00

175 lines
6.7 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
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`
}
/** 卡 / 设备展示:优先 ICCID、设备号(IMEI),都没有时才显示内部 ID */
export function assetDisplay(row: {
iot_card_id?: number | null
iccid?: string
device_id?: number | null
device_virtual_no?: string
device_imei?: string
}): string {
if (row.iccid) return row.iccid
if (row.device_virtual_no || row.device_imei) {
const no = row.device_virtual_no || row.device_imei
return row.device_imei && row.device_imei !== no
? `${no}(IMEI ${row.device_imei})`
: String(no)
}
if (row.iot_card_id) return `卡ID ${row.iot_card_id}`
if (row.device_id) return `设备ID ${row.device_id}`
return '-'
}
/** 名称为空时退回显示 ID */
export const nameOrId = (name?: string, id?: number | null, idLabel = 'ID'): string =>
name || (id ? `${idLabel} ${id}` : '-')
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}` : ''}`
}