Some checks failed
构建并部署前端到测试环境 / deploy (push) Has been cancelled
- 卡 / 设备列优先显示 ICCID、设备号(IMEI),后端未返回时才退回内部 ID - 运营商账户筛选改为按名称搜索
175 lines
6.7 KiB
TypeScript
175 lines
6.7 KiB
TypeScript
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}` : ''}`
|
||
}
|