import type { TurnoverQuery, TurnoverSort } from './turnoverTypes' import { turnoverSortOptions } from './turnoverSorting' export const turnoverSorts: TurnoverSort[] = turnoverSortOptions.map(option => option.value) const detailOnly = ['salesWindowDays', 'salesWindowEndDate', 'attention', 'coverageSelection', 'coverageBucket', 'bucketRuleVersion'] const turnoverOnly = ['customerCodes', 'hideZeroInventory', 'groupBy', 'baseWindowDays', 'focus', 'turnoverStatus', 'snapshotContext'] export function normalizeTurnoverOwners(value: unknown): string[] { if (value == null) return [] if (!Array.isArray(value) || value.length > 100 || value.some(code => typeof code !== 'string' || !code.trim() || code.length > 64)) throw new Error('请选择有效货主,最多100个') return [...new Set(value as string[])].sort() } function scalar(q: Record, key: string) { const v = q[key] if (v == null) return undefined if (typeof v !== 'string' || !v.trim()) throw new Error(`参数 ${key} 无效`) return v } export function inventoryView(q: Record): 'TURNOVER' | 'DETAIL' { const view = scalar(q, 'view') if (view && view !== 'TURNOVER' && view !== 'DETAIL') throw new Error('库存视图参数无效') const strict = q.from === 'overview' || q.drilldownFrom === 'DASHBOARD' const detail = strict || detailOnly.some(k => q[k] != null) if (view === 'TURNOVER' && detail) throw new Error('库存周转不能混用总览下钻或库存明细条件') const selected = detail || view === 'DETAIL' ? 'DETAIL' : 'TURNOVER' if (selected === 'DETAIL' && turnoverOnly.some(k => q[k] != null)) throw new Error('库存明细不能携带周转专属条件') return selected } export function yesterdayBeijing(now = new Date()) { const date = new Intl.DateTimeFormat('en-CA', { timeZone: 'Asia/Shanghai', year: 'numeric', month: '2-digit', day: '2-digit' }).format(now) return new Date(Date.parse(`${date}T00:00:00Z`) - 86400000).toISOString().slice(0, 10) } export function validateTurnover(q: TurnoverQuery, latestDate = yesterdayBeijing()) { normalizeTurnoverOwners(q.customerCodes) if (q.hideZeroInventory != null && typeof q.hideZeroInventory !== 'boolean') throw new Error('隐藏零库存参数无效') if (!q.warehouseCode.trim()) throw new Error('请选择可用仓库') if (!/^\d{4}-\d{2}-\d{2}$/.test(q.endDate) || !Number.isFinite(Date.parse(q.endDate)) || new Date(q.endDate).toISOString().slice(0, 10) !== q.endDate || q.endDate > latestDate) throw new Error('截止日必须是已结束的北京时间日期') if (!Number.isInteger(q.baseWindowDays) || q.baseWindowDays < 1 || q.baseWindowDays > 366) throw new Error('统计区间须为1至366个完整自然日') if (!['SKU', 'OWNER'].includes(q.groupBy)) throw new Error('分组无效') if (q.groupBy === 'OWNER' && q.sku) throw new Error('货主汇总不能携带SKU搜索') if (!['ALL', 'NO_OUTBOUND_IN_WINDOW', 'COVERAGE_GT', 'COVERAGE_LE', 'FROZEN', 'DEFECTIVE', 'UNASSESSABLE'].includes(q.focus)) throw new Error('关注条件无效') if (q.coverageDaysThreshold != null && (!Number.isSafeInteger(q.coverageDaysThreshold) || q.coverageDaysThreshold <= 0)) throw new Error('阈值必须为正整数天数') if (['COVERAGE_GT', 'COVERAGE_LE'].includes(q.focus) && q.coverageDaysThreshold == null) throw new Error('请填写快慢判断的天数阈值') if (q.turnoverStatus && q.turnoverStatus !== 'INSUFFICIENT') throw new Error('周转样本条件无效') if (!turnoverSorts.includes(q.sortBy) || q.groupBy === 'OWNER' && ['COVERAGE_ASC', 'COVERAGE_DESC', 'UNIT_VOLUME_ASC', 'UNIT_VOLUME_DESC'].includes(q.sortBy) || q.groupBy === 'SKU' && q.sortBy === 'NO_OUTBOUND_PHYSICAL_DESC') throw new Error('排序不适用于当前分组') if (!Number.isSafeInteger(q.current) || q.current < 1 || !Number.isSafeInteger(q.size) || q.size < 1 || q.size > 100) throw new Error('分页参数无效') } export function turnoverRoute(q: Record): Partial { if (inventoryView(q) !== 'TURNOVER') throw new Error('当前为库存明细入口') const allowed = new Set(['view', 'warehouseCode', 'hideZeroInventory', 'sku', 'customerCodes', 'endDate', 'baseWindowDays', 'groupBy', 'focus', 'coverageDaysThreshold', 'turnoverStatus', 'sortBy', 'snapshotContext', 'current', 'size']) for (const key of Object.keys(q)) if (!allowed.has(key)) throw new Error(`库存周转不接受参数 ${key}`) const result: Record = {} for (const key of allowed) { if (key === 'customerCodes') { result[key] = normalizeTurnoverOwners(q[key] == null ? [] : Array.isArray(q[key]) ? q[key] : [q[key]]) continue } const value = scalar(q, key) if (key === 'hideZeroInventory' && value != null) { if (!['true', 'false'].includes(value)) throw new Error('隐藏零库存参数无效') result[key] = value === 'true' continue } if (value != null && key !== 'view') result[key] = ['baseWindowDays', 'coverageDaysThreshold', 'current', 'size'].includes(key) ? Number(value) : value } return result as Partial }