优化

src/modules/self-operated/turnoverNavigation.ts

@@ -0,0 +1,48 @@
+import type { TurnoverQuery, TurnoverSort } from './turnoverTypes'
+export const turnoverSorts: TurnoverSort[] = ['PHYSICAL_DESC', 'AVAILABLE_DESC', 'OUTBOUND_7_DESC', 'OUTBOUND_15_DESC', 'OUTBOUND_30_DESC', 'COVERAGE_ASC', 'COVERAGE_DESC', 'TURNOVER_DESC', 'NO_OUTBOUND_PHYSICAL_DESC']
+const detailOnly = ['salesWindowDays', 'salesWindowEndDate', 'attention', 'coverageSelection', 'coverageBucket', 'bucketRuleVersion']
+const turnoverOnly = ['groupBy', 'baseWindowDays', 'focus', 'turnoverStatus', 'snapshotContext']
+function scalar(q: Record<string, unknown>, 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<string, unknown>): '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()) {
+  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 (![7, 15, 30].includes(q.baseWindowDays)) throw new Error('计算基准仅支持7、15、30天')
+  if (!['SKU', 'OWNER'].includes(q.groupBy)) throw new Error('分组无效')
+  if (q.groupBy === 'OWNER' && q.sku) throw new Error('货主汇总不能携带SKU搜索')
+  if (!['ALL', 'NO_OUTBOUND_30D', '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'].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<string, unknown>): Partial<TurnoverQuery> {
+  if (inventoryView(q) !== 'TURNOVER') throw new Error('当前为库存明细入口')
+  const allowed = new Set(['view', 'warehouseCode', 'sku', 'customerCode', '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<string, string | number> = {}
+  for (const key of allowed) {
+    const value = scalar(q, key)
+    if (value != null && key !== 'view') result[key] = ['baseWindowDays', 'coverageDaysThreshold', 'current', 'size'].includes(key) ? Number(value) : value
+  }
+  return result as Partial<TurnoverQuery>
+}