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(query: T): Partial { return Object.fromEntries( Object.entries(query).filter( ([, value]) => value !== '' && value !== null && value !== undefined ) ) as Partial } /** 选填的正整数输入 */ 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}` : ''}` }