This commit is contained in:
yin 2026-05-09 18:18:05 +08:00
parent 70ed7232ef
commit 18e875ad56
96 changed files with 4658 additions and 385 deletions

View File

@ -86,6 +86,11 @@ export type WaveGroupOrderFetchListResponse = {
pagination: WaveListPagination
}
/** order.wave.singleOrderFetchList:参数与团购列表接口一致,语义为散单候选分组(小于同组订单阈值) */
export type WaveSingleOrderFetchListParams = WaveGroupOrderFetchListParams
export type WaveSingleOrderFetchListResponse = WaveGroupOrderFetchListResponse
export type WaveStrategyListParams = {
pagination?: {
page?: number
@ -205,21 +210,38 @@ export type WaveStrategyMutationResponse = {
code: number
}
export type WaveStrategyFetchAdminParams = { strategy_id: number } | { strategyId: number }
type WaveStrategyFetchStrategyId =
| { strategy_id: number; strategyId?: number }
| { strategy_id?: number; strategyId: number }
export type WaveStrategyFetchPdaParams = { strategy_id: number } | { strategyId: number }
/** 按策略提交抓取任务(Admin / PDA)受理响应 */
export type WaveStrategyFetchByStrategyResponse = {
status: string
task_id: string
warehouse_id: number
strategy_id: number
state: string
message?: string
accepted_at?: string
/** order.wave.waveStrategyFetchAdmin / waveStrategyFetchPda 入参(支持下划线/驼峰别名) */
export type WaveStrategyFetchAdminParams = WaveStrategyFetchStrategyId & {
cart_id?: string | number
cartId?: string | number
source?: string
operation_source?: string
strategy_params?: Record<string, unknown>
strategyParams?: Record<string, unknown>
}
export type WaveStrategyFetchPdaParams = WaveStrategyFetchAdminParams
/** 按策略创建抓取主流程任务后的响应(Admin / PDA 一致) */
export type WaveStrategyFetchTaskCreatedResponse = {
state: string
task_id: string
task_no: string
plan: Record<string, unknown>
plan_summary: string
warehouse_id?: number
strategy_id?: number
validation_errors?: Array<{ field?: string; message?: string }>
message?: string
}
/** @deprecated 使用 WaveStrategyFetchTaskCreatedResponse */
export type WaveStrategyFetchByStrategyResponse = WaveStrategyFetchTaskCreatedResponse
export type WaveStrategyQuickScanTaskProgressParams = {
task_id?: string
taskId?: string
@ -279,12 +301,23 @@ export type WaveFetchParams = {
}>
}
/** order.wave.singleFetch:每项须含 max_fetch_quantity(上限订单数) */
export type WaveSingleFetchParams = {
structure_list: Array<{
item_detail_machine: string
max_fetch_quantity: number
quantity?: number
}>
}
export type WaveFetchResponse = {
task_id: string
warehouse_id: number
structure_count: number
default_quantity: number
auto_fetch_disabled_marker: string
fetch_mode?: string
max_fetch_quantity?: number
message?: string
}
@ -305,6 +338,10 @@ export type WaveFetchTaskProgressResponse = {
error?: string
update_time?: string
message?: string
fetch_mode?: string
max_fetch_quantity?: number
limit_reached?: boolean
stop_reason?: string
}
export type WaveBatchAllocateExpressParams = {
@ -503,7 +540,12 @@ export type WaveBatchFinishAutoGroupingResponse = {
}
export type WaveBatchRemoveOrdersParams = {
ids: Array<string | number> | string | number
ids?: Array<string | number> | string | number
order_ids?: Array<string | number> | string | number
orderIds?: Array<string | number> | string | number
order_id?: string | number
orderId?: string | number
id?: string | number
}
export type WaveBatchRemoveOrdersResponse = {
@ -579,6 +621,22 @@ export function orderWaveGroupOrderFetchList(
} as any)
}
export function orderWaveSingleOrderFetchList(
data: WaveSingleOrderFetchListParams = {}
): Promise<WaveSingleOrderFetchListResponse & { code?: number; message?: string; data?: Partial<WaveSingleOrderFetchListResponse> }> {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.wave.singleOrderFetchList',
v,
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}
export function orderWaveWaveStrategyList(
data: WaveStrategyListParams = {}
): Promise<WaveStrategyListResponse & { code?: number; message?: string; data?: Partial<WaveStrategyListResponse> }> {
@ -645,12 +703,12 @@ export function orderWaveWaveStrategyQuickScan(
export function orderWaveWaveStrategyFetchAdmin(
data: WaveStrategyFetchAdminParams
): Promise<WaveStrategyFetchByStrategyResponse & { code?: number; message?: string }> {
): Promise<WaveStrategyFetchTaskCreatedResponse & { code?: number; message?: string }> {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.wave.waveStrategyFetchPda',
method: 'order.wave.waveStrategyFetchAdmin',
v,
timestamp: new Date().getTime()
},
@ -661,7 +719,7 @@ export function orderWaveWaveStrategyFetchAdmin(
export function orderWaveWaveStrategyFetchPda(
data: WaveStrategyFetchPdaParams
): Promise<WaveStrategyFetchByStrategyResponse & { code?: number; message?: string }> {
): Promise<WaveStrategyFetchTaskCreatedResponse & { code?: number; message?: string }> {
return request({
url: '/system',
method: 'post',
@ -768,6 +826,20 @@ export function orderWaveGroupFetch(data: WaveFetchParams): Promise<WaveFetchRes
} as any)
}
export function orderWaveSingleFetch(data: WaveSingleFetchParams): Promise<WaveFetchResponse & { code?: number; message?: string }> {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.wave.singleFetch',
v,
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}
export function orderWaveFetchTaskProgress(data: WaveFetchTaskProgressParams): Promise<WaveFetchTaskProgressResponse & { code?: number; message?: string }> {
return request({
url: '/system',
@ -949,6 +1021,7 @@ export const orderWave = {
wavePickTaskList: orderWaveWavePickTaskList,
wavePickTaskCancel: orderWaveWavePickTaskCancel,
groupOrderFetchList: orderWaveGroupOrderFetchList,
singleOrderFetchList: orderWaveSingleOrderFetchList,
waveStrategyList: orderWaveWaveStrategyList,
waveStrategyCreate: orderWaveWaveStrategyCreate,
waveStrategyUpdate: orderWaveWaveStrategyUpdate,
@ -959,6 +1032,7 @@ export const orderWave = {
waveStrategyFallbackOrderList: orderWaveWaveStrategyFallbackOrderList,
singleFetchByIds: orderWaveSingleFetchByIds,
groupFetch: orderWaveGroupFetch,
singleFetch: orderWaveSingleFetch,
fetch: orderWaveFetch,
fetchTaskProgress: orderWaveFetchTaskProgress,
batchAllocateExpress: orderWaveBatchAllocateExpress,

View File

@ -376,6 +376,8 @@
<script setup lang="ts">
import { ref, reactive, watch, computed, onMounted, onBeforeUnmount, nextTick } from 'vue'
import { useRoute } from 'vue-router'
import { useScanBoxCacheStore } from '@/stores/modules/scanBoxCache'
import { Operation, DataAnalysis, Search, Files } from '@element-plus/icons-vue'
defineOptions({
@ -466,6 +468,12 @@ const props = defineProps({
default: null
},
// 同一路由下不同功能页的筛选缓存隔离键
cacheKey: {
type: String,
default: ''
},
// 是否自动提交
autoSubmit: {
type: Boolean,
@ -474,6 +482,8 @@ const props = defineProps({
})
const emit = defineEmits(['condition-change', 'reset', 'condition-clear', 'submit'])
const route = useRoute()
const scanBoxCacheStore = useScanBoxCacheStore()
// Data
const activeTab = ref('custom')
@ -486,6 +496,76 @@ const hasScroll = ref(false)
const filterScroll = ref<HTMLElement | null>(null)
const presetTreeRef = ref<any>(null)
let debounceTimer: any = null
let cacheTimer: any = null
function cloneSnapshotValue<T>(value: T): T {
if (value === undefined) {
return value
}
return JSON.parse(JSON.stringify(value))
}
function getRouteCacheKey() {
return String(route.path || '').trim()
}
function getScopedCacheKey() {
return String(props.cacheKey || '').trim()
}
function saveSnapshot() {
const routePath = getRouteCacheKey()
if (!routePath) return
scanBoxCacheStore.setSnapshot(routePath, {
activeTab: activeTab.value,
activeCondition: cloneSnapshotValue(activeCondition.value),
customConditions: cloneSnapshotValue(customConditions)
}, getScopedCacheKey())
}
function scheduleSaveSnapshot() {
clearTimeout(cacheTimer)
cacheTimer = setTimeout(() => {
saveSnapshot()
}, 120)
}
function clearSnapshot() {
const routePath = getRouteCacheKey()
if (!routePath) return
scanBoxCacheStore.clearSnapshot(routePath, getScopedCacheKey())
}
function hasAnyCondition() {
if (activeTab.value === 'preset') {
return Boolean(activeCondition.value)
}
return Object.keys(buildConditionsObject() || {}).length > 0
}
function restoreSnapshotIfExists() {
const routePath = getRouteCacheKey()
if (!routePath) return
const snapshot = scanBoxCacheStore.getSnapshot(routePath, getScopedCacheKey())
if (!snapshot) return
if (snapshot.activeTab) {
activeTab.value = snapshot.activeTab
}
activeCondition.value = cloneSnapshotValue(snapshot.activeCondition)
Object.keys(snapshot.customConditions || {}).forEach((fieldKey) => {
if (!customConditions[fieldKey]) return
Object.assign(customConditions[fieldKey], snapshot.customConditions[fieldKey])
})
nextTick(() => {
if (hasAnyCondition()) {
emit('condition-change', activeCondition.value)
}
})
}
// Watchers
watch(() => props.initialConditions, (val) => {
@ -506,6 +586,10 @@ watch(() => props.availableFields, (fields) => {
initCustomConditions(fields)
}, { immediate: true })
watch(activeTab, () => {
scheduleSaveSnapshot()
})
// Computed
const fieldValues = computed(() => {
return props.availableFields.map((field: any) => field.value)
@ -514,6 +598,7 @@ const fieldValues = computed(() => {
// Lifecycle
onMounted(() => {
initCustomConditions(props.availableFields)
restoreSnapshotIfExists()
if (filterScroll.value) {
filterScroll.value.addEventListener('scroll', handleScroll)
}
@ -521,6 +606,8 @@ onMounted(() => {
})
onBeforeUnmount(() => {
clearTimeout(cacheTimer)
clearTimeout(debounceTimer)
if (filterScroll.value) {
filterScroll.value.removeEventListener('scroll', handleScroll)
}
@ -697,10 +784,12 @@ function getOperators(field: any) {
function handlePresetClick(data: any, node: any) {
if (!node.isLeaf) return
activeCondition.value = data.value
scheduleSaveSnapshot()
emit('condition-change', activeCondition.value)
}
function handleCustomChange() {
scheduleSaveSnapshot()
if (props.autoSubmit) {
clearTimeout(debounceTimer)
debounceTimer = setTimeout(() => {
@ -832,6 +921,7 @@ function applyResetState() {
function handleReset() {
applyResetState()
clearSnapshot()
emit('reset')
}
@ -865,6 +955,7 @@ function handleSubmit() {
function clearActiveCondition() {
activeCondition.value = null
clearSnapshot()
emit('condition-clear')
}

View File

@ -54,6 +54,7 @@ import { useRoute, useRouter } from 'vue-router'
import { useTagsViewStore } from '@/stores/modules/tagsView'
import { usePermissionStore } from '@/stores/modules/permission'
import { useShortcutsStore } from '@/stores/modules/shortcuts'
import { useScanBoxCacheStore } from '@/stores/modules/scanBoxCache'
import ScrollPane from './ScrollPane.vue'
import Navbar from '../Navbar.vue'
import path from 'path-browserify'
@ -75,6 +76,7 @@ const tagsViewStore = useTagsViewStore()
const permissionStore = usePermissionStore()
const shortcutsStore = useShortcutsStore()
const settingsStore = useSettingsStore()
const scanBoxCacheStore = useScanBoxCacheStore()
const route = useRoute()
const router = useRouter()
const scrollPane = ref()
@ -182,6 +184,7 @@ const refreshSelectedTag = (view: any) => {
}
const closeSelectedTag = (view: any) => {
scanBoxCacheStore.clearByRoutePath(String(view?.path || ''))
tagsViewStore.delView(view).then(({ visitedViews }: any) => {
if (isActive(view)) {
toLastView(visitedViews, view)
@ -191,13 +194,15 @@ const closeSelectedTag = (view: any) => {
const closeOthersTags = () => {
router.push(selectedTag.value)
tagsViewStore.delOthersViews(selectedTag.value).then(() => {
tagsViewStore.delOthersViews(selectedTag.value).then(({ visitedViews }: any) => {
scanBoxCacheStore.clearExceptRoutePaths((visitedViews || []).map((item: any) => String(item?.path || '')))
moveToCurrentTag()
})
}
const closeAllTags = (view: any) => {
tagsViewStore.delAllViews().then(({ visitedViews }: any) => {
scanBoxCacheStore.clearExceptRoutePaths((visitedViews || []).map((item: any) => String(item?.path || '')))
if (affixTags.value.some(tag => tag.path === view.path)) {
return
}

View File

@ -0,0 +1,66 @@
import { defineStore } from 'pinia'
export interface ScanBoxSnapshot {
activeTab: string
activeCondition: any
customConditions: Record<string, any>
}
interface ScanBoxCacheState {
cacheByRoutePath: Record<string, ScanBoxSnapshot>
}
function composeCacheKey(routePath: string, scopeKey?: string) {
const base = String(routePath || '').trim()
const scope = String(scopeKey || '').trim()
if (!base) return ''
return scope ? `${base}::${scope}` : base
}
export const useScanBoxCacheStore = defineStore('scanBoxCache', {
state: (): ScanBoxCacheState => ({
cacheByRoutePath: {}
}),
actions: {
setSnapshot(routePath: string, snapshot: ScanBoxSnapshot, scopeKey?: string) {
const key = composeCacheKey(routePath, scopeKey)
if (!key) return
this.cacheByRoutePath[key] = snapshot
},
getSnapshot(routePath: string, scopeKey?: string): ScanBoxSnapshot | null {
const key = composeCacheKey(routePath, scopeKey)
if (!key) return null
return this.cacheByRoutePath[key] || null
},
clearSnapshot(routePath: string, scopeKey?: string) {
const key = composeCacheKey(routePath, scopeKey)
if (!key) return
delete this.cacheByRoutePath[key]
},
clearByRoutePath(routePath: string) {
const base = String(routePath || '').trim()
if (!base) return
Object.keys(this.cacheByRoutePath).forEach((key) => {
if (key === base || key.startsWith(`${base}::`)) {
delete this.cacheByRoutePath[key]
}
})
},
clearExceptRoutePaths(routePaths: string[]) {
const keepBases = (routePaths || []).map((item) => String(item || '').trim()).filter(Boolean)
Object.keys(this.cacheByRoutePath).forEach((key) => {
const shouldKeep = keepBases.some((base) => key === base || key.startsWith(`${base}::`))
if (!shouldKeep) {
delete this.cacheByRoutePath[key]
}
})
},
// backward compatible aliases
clearExcept(routePaths: string[]) {
this.clearExceptRoutePaths(routePaths)
},
clearAll() {
this.cacheByRoutePath = {}
}
}
})

View File

@ -2,6 +2,7 @@
<div class="order-sub-container">
<scan-box
ref="scanBox"
cache-key="orderManagement:archiveOrder"
width="320px"
:tree-props="{ children: 'children', label: 'label' }"
:auto-submit="false"

View File

@ -759,6 +759,12 @@ export const pendingAvailableFields = [
{ label: '已作废', value: 'cancelled' },
{ label: '已归档', value: 'archived' },
] },
{ label:'快递', value: 'post_status', type: 'select', options: [
{ label: '未分配', value: 'none' },
{ label: '分配中', value: 'padding' },
{ label: '已完成', value: 'fin' },
{ label: '错误', value: 'error' },
] },
{ label: '储位', value: 'storage_status', type: 'select', options: [
{ label: '未分配', value: 'none' },
{ label: '分配中', value: 'padding' },

View File

@ -2,6 +2,7 @@
<div class="order-sub-container">
<scan-box
ref="scanBox"
cache-key="orderManagement:deliveryException"
width="320px"
:tree-props="{ children: 'children', label: 'label' }"
:auto-submit="false"

View File

@ -2,6 +2,7 @@
<div class="order-sub-container">
<scan-box
ref="scanBox"
cache-key="orderManagement:deliveryOrder"
width="320px"
:tree-props="{ children: 'children', label: 'label' }"
:auto-submit="false"

View File

@ -2,6 +2,7 @@
<div class="order-sub-container">
<scan-box
ref="scanBox"
cache-key="orderManagement:entrustWarehouse"
width="320px"
:tree-props="{ children: 'children', label: 'label' }"
:auto-submit="false"

View File

@ -2,6 +2,7 @@
<div class="order-sub-container">
<scan-box
ref="scanBox"
cache-key="orderManagement:exceptionOrder"
width="320px"
:tree-props="{ children: 'children', label: 'label' }"
:auto-submit="false"

View File

@ -2,6 +2,7 @@
<div class="order-sub-container">
<scan-box
ref="scanBox"
cache-key="orderManagement:outboundOrder"
width="320px"
:tree-props="{ children: 'children', label: 'label' }"
:auto-submit="false"

View File

@ -2,6 +2,7 @@
<div class="order-sub-container">
<scan-box
ref="scanBox"
cache-key="orderManagement:pendingOrder"
width="320px"
:tree-props="{ children: 'children', label: 'label' }"
:auto-submit="false"

View File

@ -2,6 +2,7 @@
<div class="order-sub-container">
<scan-box
ref="scanBox"
cache-key="orderManagement:reviewOrder"
width="320px"
:tree-props="{ children: 'children', label: 'label' }"
:auto-submit="false"

View File

@ -897,6 +897,7 @@ import {
orderWaveBatchList,
orderWaveFetch,
orderWaveGroupFetch,
orderWaveSingleFetch,
orderWaveSingleFetchByIds,
orderWaveWaveStrategyCreate,
orderWaveWaveStrategyFetchAdmin,
@ -924,8 +925,9 @@ import type {
WaveFetchParams,
WaveFetchResponse,
WaveFetchTaskProgressResponse,
WaveSingleFetchParams,
WaveStrategyCreateParams,
WaveStrategyFetchByStrategyResponse,
WaveStrategyFetchTaskCreatedResponse,
WaveStrategyFallbackOrderListResponse,
WaveStrategyFallbackOrderListRow,
WaveStrategyListResponse,
@ -998,7 +1000,11 @@ const fetchTaskProgress = reactive({
durationMs: 0,
error: '',
updateTime: '',
message: ''
message: '',
fetchMode: '' as string,
maxFetchQuantity: undefined as number | undefined,
limitReached: undefined as boolean | undefined,
stopReason: '' as string
})
const batchAllocateExpressTaskProgress = reactive({
taskId: '',
@ -1804,6 +1810,14 @@ function applyFetchTaskProgress(progress: Partial<WaveFetchTaskProgressResponse>
fetchTaskProgress.error = String(progress.error || '')
fetchTaskProgress.updateTime = String(progress.update_time || '')
fetchTaskProgress.message = String(progress.message || '')
fetchTaskProgress.fetchMode = String(progress.fetch_mode || '')
fetchTaskProgress.maxFetchQuantity =
progress.max_fetch_quantity !== undefined && progress.max_fetch_quantity !== null
? Number(progress.max_fetch_quantity)
: undefined
fetchTaskProgress.limitReached =
typeof progress.limit_reached === 'boolean' ? progress.limit_reached : undefined
fetchTaskProgress.stopReason = String(progress.stop_reason || '')
}
function resetFetchTaskProgress() {
@ -1818,6 +1832,10 @@ function resetFetchTaskProgress() {
fetchTaskProgress.error = ''
fetchTaskProgress.updateTime = ''
fetchTaskProgress.message = ''
fetchTaskProgress.fetchMode = ''
fetchTaskProgress.maxFetchQuantity = undefined
fetchTaskProgress.limitReached = undefined
fetchTaskProgress.stopReason = ''
}
async function pollFetchTaskProgress() {
@ -2799,14 +2817,31 @@ async function submitWaveStrategyFetchAdmin(row: Record<string, any>) {
waveStrategyFetchSubmittingId.value = strategyId
try {
const res = await orderWaveWaveStrategyFetchAdmin({
strategy_id: strategyId
}) as WaveStrategyFetchByStrategyResponse & { code?: number; message?: string }
strategy_id: strategyId,
source: 'pda'
}) as WaveStrategyFetchTaskCreatedResponse & { code?: number; message?: string }
if (!res || !okCode(res.code)) {
throw new Error(res?.message || '提交后台抓取任务失败')
}
const taskId = String(res?.task_id || '')
const message = res?.message || '后台抓取任务已受理'
ElMessage.success(taskId ? `${message}(任务ID:${taskId})` : message)
const payload =
res && typeof (res as any).data === 'object' && (res as any).data !== null && !Array.isArray((res as any).data)
? ((res as any).data as WaveStrategyFetchTaskCreatedResponse)
: (res as WaveStrategyFetchTaskCreatedResponse)
const validationErrors = payload?.validation_errors
if (Array.isArray(validationErrors) && validationErrors.length) {
const detail = validationErrors
.map((e) => [e?.field, e?.message].filter(Boolean).join(': ') || '')
.filter(Boolean)
.join(';')
ElMessage.warning(detail || payload?.message || '入参校验未通过')
return
}
const taskId = String(payload?.task_id || '')
const taskNo = String(payload?.task_no || '')
const summary = String(payload?.plan_summary || '')
const hint = summary || payload?.message || res?.message || '后台抓取任务已创建'
const suffix = [taskNo ? `任务编号:${taskNo}` : '', taskId ? `任务ID:${taskId}` : ''].filter(Boolean).join(',')
ElMessage.success(suffix ? `${hint}(${suffix})` : hint)
} catch (error: any) {
console.error('submit wave strategy fetch admin failed:', error)
ElMessage.error(error?.message || '提交后台抓取任务失败')
@ -3280,27 +3315,56 @@ function getGroupOrderItemSnapshotText(row: any) {
async function submitGroupOrderDialog() {
if (!groupOrderSelectionRows.value.length) {
ElMessage.warning('请先勾选要抓取的团购单结构')
ElMessage.warning('请先勾选要抓取的结构')
return
}
groupOrderSubmitting.value = true
try {
const structureList: WaveFetchParams['structure_list'] = groupOrderSelectionRows.value.map((row: any) => {
const key = String(row?.item_detail_machine || '')
const payload: WaveFetchParams['structure_list'][number] = {
item_detail_machine: key
}
const quantity = groupOrderQuantityMap[key]
if (quantity !== undefined) {
payload.quantity = quantity
}
return payload
})
let res: WaveFetchResponse & { code?: number; message?: string }
const res = await orderWaveGroupFetch({ structure_list: structureList }) as WaveFetchResponse & { code?: number; message?: string }
if (!res || !okCode(res.code)) {
throw new Error(res?.message || '抓取团购单失败')
if (isGroupWaveTab.value) {
const structureList: WaveFetchParams['structure_list'] = groupOrderSelectionRows.value.map((row: any) => {
const key = String(row?.item_detail_machine || '')
const payload: WaveFetchParams['structure_list'][number] = {
item_detail_machine: key
}
const quantity = groupOrderQuantityMap[key]
if (quantity !== undefined) {
payload.quantity = quantity
}
return payload
})
res = (await orderWaveGroupFetch({ structure_list: structureList })) as WaveFetchResponse & {
code?: number
message?: string
}
if (!res || !okCode(res.code)) {
throw new Error(res?.message || '抓取团购单失败')
}
} else {
const structureList: WaveSingleFetchParams['structure_list'] = groupOrderSelectionRows.value.map((row: any) => {
const key = String(row?.item_detail_machine || '')
const quantity = groupOrderQuantityMap[key]
const groupCount = Number(row?.group_count)
const max_fetch_quantity =
quantity !== undefined ? quantity : Math.max(1, Number.isFinite(groupCount) && groupCount > 0 ? groupCount : 100)
const payload: WaveSingleFetchParams['structure_list'][number] = {
item_detail_machine: key,
max_fetch_quantity
}
if (quantity !== undefined) {
payload.quantity = quantity
}
return payload
})
res = (await orderWaveSingleFetch({ structure_list: structureList })) as WaveFetchResponse & {
code?: number
message?: string
}
if (!res || !okCode(res.code)) {
throw new Error(res?.message || '抓取散单失败')
}
}
const acceptedMessage = [
@ -3317,7 +3381,9 @@ async function submitGroupOrderDialog() {
finished_structure_count: 0,
progress_percent: 0,
total_fetched_quantity: 0,
message: res.message || '任务已提交,后端异步处理中'
message: res.message || '任务已提交,后端异步处理中',
fetch_mode: res.fetch_mode,
max_fetch_quantity: res.max_fetch_quantity
})
scheduleFetchTaskPolling(1000)
@ -3327,7 +3393,7 @@ async function submitGroupOrderDialog() {
resetGroupOrderQuantityMap()
} catch (error: any) {
console.error('fetch group order failed:', error)
ElMessage.error(error?.message || '抓取团购单失败')
ElMessage.error(error?.message || (isGroupWaveTab.value ? '抓取团购单失败' : '抓取散单失败'))
} finally {
groupOrderSubmitting.value = false
}

View File

@ -279,7 +279,7 @@
<el-dialog
v-model="groupOrderDialogVisible"
title="抓取团购单"
title="抓取散单候选"
width="1280px"
align-center
:close-on-click-modal="false"
@ -405,7 +405,7 @@
</el-table-column>
<template #empty>
<div class="empty-tip">暂无可抓取的团购单结构</div>
<div class="empty-tip">暂无可抓取的散单候选结构</div>
</template>
</el-table>
@ -628,7 +628,7 @@
size="small"
:loading="waveStrategyFetchSubmittingId === Number(row?.id || 0)"
:disabled="!Number(row?.id || 0)"
@click="submitWaveStrategyFetchAdmin(row)"
@click="submitWaveStrategyFetchPda(row)"
>
后台抓取
</el-button>
@ -897,16 +897,17 @@ import {
orderWaveBatchList,
orderWaveFetch,
orderWaveGroupFetch,
orderWaveSingleFetch,
orderWaveSingleFetchByIds,
orderWaveSingleOrderFetchList,
orderWaveWaveStrategyCreate,
orderWaveWaveStrategyFetchAdmin,
orderWaveWaveStrategyFetchPda,
orderWaveWaveStrategyFallbackOrderList,
orderWaveWaveStrategyQuickScan,
orderWaveWaveStrategyQuickScanTaskProgress,
orderWaveWaveStrategyUpdate,
orderWaveWaveStrategyList,
orderWaveFetchTaskProgress,
orderWaveGroupOrderFetchList
orderWaveFetchTaskProgress
} from '@/api/order.wave/orderwave'
import type {
WaveBatchAutoGroupingResponse,
@ -924,8 +925,9 @@ import type {
WaveFetchParams,
WaveFetchResponse,
WaveFetchTaskProgressResponse,
WaveSingleFetchParams,
WaveStrategyCreateParams,
WaveStrategyFetchByStrategyResponse,
WaveStrategyFetchTaskCreatedResponse,
WaveStrategyFallbackOrderListResponse,
WaveStrategyFallbackOrderListRow,
WaveStrategyListResponse,
@ -998,7 +1000,11 @@ const fetchTaskProgress = reactive({
durationMs: 0,
error: '',
updateTime: '',
message: ''
message: '',
fetchMode: '' as string,
maxFetchQuantity: undefined as number | undefined,
limitReached: undefined as boolean | undefined,
stopReason: '' as string
})
const batchAllocateExpressTaskProgress = reactive({
taskId: '',
@ -1246,7 +1252,7 @@ const groupOrderFilters = reactive({
returnOrderIds: false
})
const groupOrderQuantityMap = reactive<Record<string, number | undefined>>({})
const isGroupWaveTab = computed(() => WAVE_TYPE === 1)
const isGroupWaveTab = computed(() => false)
const currentWaveType = computed(() => WAVE_TYPE)
const tableListId = computed(() => `wave-management-list-${WAVE_TYPE}`)
@ -1804,6 +1810,14 @@ function applyFetchTaskProgress(progress: Partial<WaveFetchTaskProgressResponse>
fetchTaskProgress.error = String(progress.error || '')
fetchTaskProgress.updateTime = String(progress.update_time || '')
fetchTaskProgress.message = String(progress.message || '')
fetchTaskProgress.fetchMode = String(progress.fetch_mode || '')
fetchTaskProgress.maxFetchQuantity =
progress.max_fetch_quantity !== undefined && progress.max_fetch_quantity !== null
? Number(progress.max_fetch_quantity)
: undefined
fetchTaskProgress.limitReached =
typeof progress.limit_reached === 'boolean' ? progress.limit_reached : undefined
fetchTaskProgress.stopReason = String(progress.stop_reason || '')
}
function resetFetchTaskProgress() {
@ -1818,6 +1832,10 @@ function resetFetchTaskProgress() {
fetchTaskProgress.error = ''
fetchTaskProgress.updateTime = ''
fetchTaskProgress.message = ''
fetchTaskProgress.fetchMode = ''
fetchTaskProgress.maxFetchQuantity = undefined
fetchTaskProgress.limitReached = undefined
fetchTaskProgress.stopReason = ''
}
async function pollFetchTaskProgress() {
@ -2789,7 +2807,7 @@ async function fetchWaveStrategyList() {
}
}
async function submitWaveStrategyFetchAdmin(row: Record<string, any>) {
async function submitWaveStrategyFetchPda(row: Record<string, any>) {
const strategyId = Number(row?.id || 0)
if (!strategyId) {
ElMessage.warning('无法识别策略ID,请刷新后重试')
@ -2798,15 +2816,32 @@ async function submitWaveStrategyFetchAdmin(row: Record<string, any>) {
waveStrategyFetchSubmittingId.value = strategyId
try {
const res = await orderWaveWaveStrategyFetchAdmin({
strategy_id: strategyId
}) as WaveStrategyFetchByStrategyResponse & { code?: number; message?: string }
const res = await orderWaveWaveStrategyFetchPda({
strategy_id: strategyId,
source: 'pda'
}) as WaveStrategyFetchTaskCreatedResponse & { code?: number; message?: string }
if (!res || !okCode(res.code)) {
throw new Error(res?.message || '提交后台抓取任务失败')
}
const taskId = String(res?.task_id || '')
const message = res?.message || '后台抓取任务已受理'
ElMessage.success(taskId ? `${message}(任务ID:${taskId})` : message)
const payload =
res && typeof (res as any).data === 'object' && (res as any).data !== null && !Array.isArray((res as any).data)
? ((res as any).data as WaveStrategyFetchTaskCreatedResponse)
: (res as WaveStrategyFetchTaskCreatedResponse)
const validationErrors = payload?.validation_errors
if (Array.isArray(validationErrors) && validationErrors.length) {
const detail = validationErrors
.map((e) => [e?.field, e?.message].filter(Boolean).join(': ') || '')
.filter(Boolean)
.join(';')
ElMessage.warning(detail || payload?.message || '入参校验未通过')
return
}
const taskId = String(payload?.task_id || '')
const taskNo = String(payload?.task_no || '')
const summary = String(payload?.plan_summary || '')
const hint = summary || payload?.message || res?.message || '后台抓取任务已创建'
const suffix = [taskNo ? `任务编号:${taskNo}` : '', taskId ? `任务ID:${taskId}` : ''].filter(Boolean).join(',')
ElMessage.success(suffix ? `${hint}(${suffix})` : hint)
} catch (error: any) {
console.error('submit wave strategy fetch admin failed:', error)
ElMessage.error(error?.message || '提交后台抓取任务失败')
@ -3140,10 +3175,10 @@ function getFallbackOrderItemSnapshotText(row: WaveStrategyFallbackOrderListRow)
async function fetchGroupOrderList() {
groupOrderListLoading.value = true
try {
const res = await orderWaveGroupOrderFetchList(buildGroupOrderListPayload()) as
const res = await orderWaveSingleOrderFetchList(buildGroupOrderListPayload()) as
WaveGroupOrderFetchListResponse & { code?: number; message?: string; data?: Partial<WaveGroupOrderFetchListResponse> }
if (!res || !okCode(res.code)) {
throw new Error(res?.message || '获取可抓取团购单列表失败')
throw new Error(res?.message || '获取散单候选结构列表失败')
}
const responseList = Array.isArray(res.list)
? res.list
@ -3159,7 +3194,7 @@ async function fetchGroupOrderList() {
console.error('fetch group order list failed:', error)
groupOrderList.value = []
groupOrderPagination.total = 0
ElMessage.error(error?.message || '获取可抓取团购单列表失败')
ElMessage.error(error?.message || '获取散单候选结构列表失败')
} finally {
groupOrderListLoading.value = false
}
@ -3280,27 +3315,56 @@ function getGroupOrderItemSnapshotText(row: any) {
async function submitGroupOrderDialog() {
if (!groupOrderSelectionRows.value.length) {
ElMessage.warning('请先勾选要抓取的团购单结构')
ElMessage.warning('请先勾选要抓取的结构')
return
}
groupOrderSubmitting.value = true
try {
const structureList: WaveFetchParams['structure_list'] = groupOrderSelectionRows.value.map((row: any) => {
const key = String(row?.item_detail_machine || '')
const payload: WaveFetchParams['structure_list'][number] = {
item_detail_machine: key
}
const quantity = groupOrderQuantityMap[key]
if (quantity !== undefined) {
payload.quantity = quantity
}
return payload
})
let res: WaveFetchResponse & { code?: number; message?: string }
const res = await orderWaveGroupFetch({ structure_list: structureList }) as WaveFetchResponse & { code?: number; message?: string }
if (!res || !okCode(res.code)) {
throw new Error(res?.message || '抓取团购单失败')
if (isGroupWaveTab.value) {
const structureList: WaveFetchParams['structure_list'] = groupOrderSelectionRows.value.map((row: any) => {
const key = String(row?.item_detail_machine || '')
const payload: WaveFetchParams['structure_list'][number] = {
item_detail_machine: key
}
const quantity = groupOrderQuantityMap[key]
if (quantity !== undefined) {
payload.quantity = quantity
}
return payload
})
res = (await orderWaveGroupFetch({ structure_list: structureList })) as WaveFetchResponse & {
code?: number
message?: string
}
if (!res || !okCode(res.code)) {
throw new Error(res?.message || '抓取团购单失败')
}
} else {
const structureList: WaveSingleFetchParams['structure_list'] = groupOrderSelectionRows.value.map((row: any) => {
const key = String(row?.item_detail_machine || '')
const quantity = groupOrderQuantityMap[key]
const groupCount = Number(row?.group_count)
const max_fetch_quantity =
quantity !== undefined ? quantity : Math.max(1, Number.isFinite(groupCount) && groupCount > 0 ? groupCount : 100)
const payload: WaveSingleFetchParams['structure_list'][number] = {
item_detail_machine: key,
max_fetch_quantity
}
if (quantity !== undefined) {
payload.quantity = quantity
}
return payload
})
res = (await orderWaveSingleFetch({ structure_list: structureList })) as WaveFetchResponse & {
code?: number
message?: string
}
if (!res || !okCode(res.code)) {
throw new Error(res?.message || '抓取散单失败')
}
}
const acceptedMessage = [
@ -3317,7 +3381,9 @@ async function submitGroupOrderDialog() {
finished_structure_count: 0,
progress_percent: 0,
total_fetched_quantity: 0,
message: res.message || '任务已提交,后端异步处理中'
message: res.message || '任务已提交,后端异步处理中',
fetch_mode: res.fetch_mode,
max_fetch_quantity: res.max_fetch_quantity
})
scheduleFetchTaskPolling(1000)
@ -3327,7 +3393,7 @@ async function submitGroupOrderDialog() {
resetGroupOrderQuantityMap()
} catch (error: any) {
console.error('fetch group order failed:', error)
ElMessage.error(error?.message || '抓取团购单失败')
ElMessage.error(error?.message || (isGroupWaveTab.value ? '抓取团购单失败' : '抓取散单失败'))
} finally {
groupOrderSubmitting.value = false
}

View File

@ -19,6 +19,12 @@
<span>状态:{{ statusText }}</span>
<span>已完成结构:{{ progress.finishedStructureCount }} / {{ progress.structureCount }}</span>
<span>已抓取件数:{{ progress.totalFetchedQuantity }}</span>
<span v-if="progress.fetchMode">模式:{{ progress.fetchMode }}</span>
<span v-if="progress.maxFetchQuantity !== undefined && progress.maxFetchQuantity !== null">
抓取上限:{{ progress.maxFetchQuantity }}
</span>
<span v-if="progress.limitReached === true">已达上限</span>
<span v-if="progress.stopReason">停止原因:{{ progress.stopReason }}</span>
<span v-if="progress.updateTime">更新时间:{{ formattedUpdateTime }}</span>
</div>
<div v-if="progress.message || progress.error" class="task-progress-panel__message">
@ -43,6 +49,10 @@ export interface WaveFetchTaskProgressViewModel {
error: string
updateTime: string
message: string
fetchMode?: string
maxFetchQuantity?: number
limitReached?: boolean
stopReason?: string
}
const props = defineProps<{

View File

@ -67,16 +67,6 @@ export const waveAvailableFields = [
{ label: '部分分配', value: '部分分配' },
{ label: '已分配', value: '已分配' },
]},
{label:'快递分配', value: 'express_assignment_status', type: 'select', options: [
{ label: '未分配', value: 'none' },
{ label: '分配中', value: 'padding' },
{ label: '已完成', value: 'fin' }
]},
{label:'打印状态', value: 'print_assignment_status', type: 'select', options: [
{ label: '未打印', value: 'none' },
{ label: '打印中', value: 'padding' },
{ label: '已完成', value: 'fin' }
]},
{ label: '最小订单数', value: 'total_orders_min', type: 'number' },
{ label: '最大订单数', value: 'total_orders_max', type: 'number' },
{ label: '最小已处理订单', value: 'processed_orders_min', type: 'number' },
@ -139,8 +129,6 @@ export const waveWhereAllowedFieldList = [
'item_detail_machine',
'distinguish_express',
'storage_assignment_status',
'express_assignment_status',
'print_assignment_status',
'total_orders_min',
'total_orders_max',
'processed_orders_min',

File diff suppressed because it is too large Load Diff

View File

@ -1,11 +1,11 @@
# 接口
- 更新时间: 2026-05-08 09:22:13
- 更新时间: 2026-05-09 10:21:22
- 扫描目录: `src\api`
- 模块数: 34
- API 文件数: 34
- 接口数: 277
- 已启用: 246
- 接口数: 280
- 已启用: 249
- 占位接口: 2
## 模块统计
@ -25,7 +25,7 @@
| order.pendingorder | 1 | 16 | 16 | 0 |
| order.print | 1 | 1 | 1 | 0 |
| order.revieworder | 1 | 3 | 3 | 0 |
| order.wave | 1 | 26 | 25 | 0 |
| order.wave | 1 | 29 | 28 | 0 |
| pick | 1 | 1 | 1 | 0 |
| print | 1 | 13 | 12 | 1 |
| printer.station | 1 | 11 | 1 | 0 |
@ -132,8 +132,11 @@
| order.wave | orderWaveFetchTaskProgress | order.wave.fetchTaskProgress | POST | 是 | 否 | order.wave/orderwave.ts | |
| order.wave | orderWaveGroupFetch | order.wave.groupFetch | POST | 是 | 否 | order.wave/orderwave.ts | |
| order.wave | orderWaveGroupOrderFetchList | order.wave.groupOrderFetchList | POST | 是 | 否 | order.wave/orderwave.ts | |
| order.wave | orderWaveSingleFetch | order.wave.singleFetch | POST | 是 | 否 | order.wave/orderwave.ts | |
| order.wave | orderWaveSingleFetchByIds | order.wave.singleFetchByIds | POST | 是 | 否 | order.wave/orderwave.ts | |
| order.wave | orderWaveSingleOrderFetchList | order.wave.singleOrderFetchList | POST | 否 | 否 | order.wave/orderwave.ts | |
| order.wave | orderWaveWavePickTaskCancel | order.wave.wavePickTaskCancel | POST | 是 | 否 | order.wave/orderwave.ts | |
| order.wave | orderWaveWavePickTaskList | order.wave.wavePickTaskList | POST | 是 | 否 | order.wave/orderwave.ts | |
| order.wave | orderWaveWaveStrategyCreate | order.wave.waveStrategyCreate | POST | 是 | 否 | order.wave/orderwave.ts | |
| order.wave | orderWaveWaveStrategyFallbackOrderList | order.wave.waveStrategyFallbackOrderList | POST | 是 | 否 | order.wave/orderwave.ts | |
| order.wave | orderWaveWaveStrategyFetchAdmin | order.wave.waveStrategyFetchAdmin | POST | 是 | 否 | order.wave/orderwave.ts | |

View File

@ -0,0 +1,168 @@
# WMS 自动化测试工作流(Agent 自动执行工作流)
当用户输入 `测试[目标页面]`,Agent 必须全自动执行本流程,完成目标页面各功能的测试并输出测试报告,无需用户干预。
专项触发词:当用户输入 `测试波次管理`,Agent 必须自动执行“波次管理专项测试”(见下文第六节),覆盖 `团购波次`、`散单波次`、`拣货中任务` 三个页面。
## 一、 测试上下文基准 (Context Baseline)
项目类型: 基于 Vue3 + Vite + TypeScript 的 WMS 前端系统。
路由模式: 动态路由。
说明:此工作流仅对项目进行测试并根据测试结果输出测试报告,不涉及任何针对项目代码的修改。禁止任何对项目代码的修改操作。
目的:测试接口后端是否可用、前端对接口的使用是否有问题、通过测试排查出请求/响应有更新但前端未更新的接口功能等。
依赖参考
- 前端 API 目录:`src/api`
- 前端 公共组件目录:`src/components`
- 前端 路由目录:`src/router`
- 前端 页面框架目录:`src/layout`
- 前端 页面目录:`src/views`
- 前端 状态管理目录:`src/stores`
- 前端 组合式逻辑目录:`src/composables`
- 前端 工具方法目录:`src/utils`
- 前端 语言包目录:`src/lang`
- 后端 接口文档:`workflows/api-doc-system/data/module`
波次管理关键文件(测试优先参考):
- 波次 API:`src/api/order.wave/orderwave.ts`
- 团购波次:`src/views/order/waveOrder/GroupWaveBatchListPanel.vue`
- 散单波次:`src/views/order/waveOrder/SandanWaveBatchListPanel.vue`
- 拣货中任务:`src/views/order/waveOrder/WavePickTaskListPanel.vue`
- 波次配置:`src/views/order/waveOrder/config/wave-config.ts`
页面/标签页基础结构:
- 主入口一般为 `index.vue` 或标签页组件(如 `GroupWaveBatchListPanel.vue`、`SandanWaveBatchListPanel.vue`、`WavePickTaskListPanel.vue`)。
- `config` 配置文件管理 `scan-box` 筛选条件、`upper-table` 列配置及工具栏按钮。
## 二、 环境引导 (Environment Setup)
前置条件:
确认本地开发服务器已运行 (npm run dev)。
访问规则:
基准路径:http://localhost:5174
登录账号:
"username": "yjm",
"password": "111111"
## 三、 测试任务定义 (Task Definition)
路径导航: 按照路由表进入目标页面。
UI 完整性检查: 验证核心按钮(如“入库确认”、“打印标签”)是否按权限加载。
基础数据显示:检查目标页面upper-table是否有正常获取数据并显示,表格哪些状态字段数据显示为英文而不是翻译字段(如"订单状态"显示'pedding'而不是'待审核')。
筛选条件测试:测试各筛选条件能否正常使用获取符合筛选条件的数据,将不可用或筛选结果包含非筛选条件数据的问题筛选进行记录。
- 功能测试: 根据页面按钮和接口信息分别测试页面各功能。
1、请求测试:发起请求后,根据接口文档检查该功能请求的传参是否符合接口文档的要求。
2、后端功能测试:根据响应结果判断后端该接口服务是否可用,区分后端接口不可用与前端请求传参错误导致的失败。
3、根据接口设计,刷新页面或刷新相关数据表单,查看功能是否被应用/添加。
4、检查项目是否符合接口响应设计,统计项目响应设计与接口响应数据、设计有不符的接口。
异常捕获: 记录 Console Error 或 4xx/5xx 错误。
## 四、 断言与逻辑校验 (Assertions)
视觉断言: 提交后是否出现 ElMessage.success 或预期的跳转。
业务断言: 操作后页面状态(如单据状态位)是否发生预期更新。
## 五、 报告生成标准 (Reporting Specification)
规定测试结果的输出格式。
报告标题: [TEST_REPORT] - {模块名} - {时间}
核心板块:
Test Summary: 成功/失败总览。
API Compliance: 实际请求与接口文档的匹配程度(字段缺失、类型错误等)。
Issue Logs: 发现的 Bug 描述及复现建议。
最小必填字段:
- 通过测试的接口:按页面分组列出 `method`、请求摘要、通过结论。
- 问题接口:按严重级别列出 `method`、失败类型(前端参数/后端异常/文档不一致/响应兼容问题)、证据摘要。
- 页面功能通过率:页面维度统计(通过项 / 总项)。
- 复现步骤:问题接口对应的最短复现路径。
- 修复建议:对前端或后端的最小改动建议。
---
## 六、 波次管理专项测试(触发词:`测试波次管理`)
### 6.1 执行目标(必须全量覆盖)
当输入 `测试波次管理` 时,默认目标页面固定为:
1. 团购波次(`GroupWaveBatchListPanel`)
2. 散单波次(`SandanWaveBatchListPanel`)
3. 拣货中任务(`WavePickTaskListPanel`)
### 6.2 自动执行步骤(严格顺序)
1. 启动前检查:
- 确认本地服务可访问(`http://localhost:5174`)。
- 使用文档中的账号完成登录。
2. 逐页面执行测试(按“团购波次 -> 散单波次 -> 拣货中任务”顺序):
- 页面加载:检查首屏渲染、表格数据加载、分页是否可用。
- 筛选能力:至少验证 3 类筛选(文本、枚举、数值区间)并校验结果一致性。
- 核心功能按钮:逐个触发并记录调用接口、请求参数、响应状态与页面回显。
- 异常链路:对可预期异常场景(空选择、非法条件、任务未完成)进行校验。
3. 接口核对:
- 以 `src/api/order.wave/orderwave.ts` 的接口封装为基准,映射本次实际触发接口。
- 对照接口文档检查参数与响应结构兼容性。
4. 归因分类:
- 前端问题:参数拼装错误、字段名不匹配、状态映射错误、UI 未按响应更新。
- 后端问题:5xx、业务报错、返回结构缺失或类型不符合约定。
- 文档问题:接口文档与实际行为不一致。
5. 输出报告:
- 必须输出“通过测试的接口”和“问题接口”两大清单(见 6.3)。
### 6.3 波次管理报告模板(必须使用)
报告标题:
`[TEST_REPORT] - 波次管理 - {YYYY-MM-DD HH:mm:ss}`
1) Test Summary
- 页面覆盖:团购波次 / 散单波次 / 拣货中任务(3/3)
- 功能点通过率:{passed}/{total}
- 接口通过率:{api_passed}/{api_total}
2) Passed APIs(通过测试的接口)
- 页面:{页面名}
- method:`xxx.xxx.xxx`
- 请求校验:通过/不通过(说明)
- 响应校验:通过/不通过(说明)
- 最终结论:通过
3) Problem APIs(问题接口)
- 严重级别:P0/P1/P2
- 页面:{页面名}
- method:`xxx.xxx.xxx`
- 问题类型:前端问题 / 后端问题 / 文档不一致
- 现象:{错误码、报错信息、页面表现}
- 复现步骤:{最短步骤}
- 期望结果:{按文档或业务预期}
- 实际结果:{当前表现}
- 建议处理:{前端/后端/文档修正建议}
4) API Compliance
- 参数不一致接口:{数量与列表}
- 响应不一致接口:{数量与列表}
- 向后兼容风险:{有/无,说明}
5) Issue Logs
- Console Error 摘要
- 4xx/5xx 请求清单
- 关联页面与操作路径
### 6.4 完成判定
满足以下条件才算完成:
1. 三个页面均已执行测试并有结果记录。
2. 报告中包含“通过测试的接口”与“问题接口”两个清单。
3. 每个问题接口均包含可复现步骤与归因分类。
4. 给出接口维度与页面维度的通过率统计。

View File

@ -11,24 +11,112 @@
"method": "order.wave.waveStrategyList",
"body": {}
},
{
"method": "order.wave.waveStrategyCreate",
"body": {}
},
{
"method": "order.wave.waveStrategyUpdate",
"body": {}
},
{
"method": "order.wave.waveStrategyQuickScan",
"body": {}
},
{
"method": "",
"method": "order.wave.waveStrategyFetchPda",
"body": {}
},
{
"method": "",
"method": "order.wave.waveStrategyFetchAdmin",
"body": {}
},
{
"method": "",
"method": "order.wave.waveStrategyQuickScanTaskProgress",
"body": {}
},
{
"method": "",
"method": "order.wave.groupOrderFetchList",
"body": {}
},
{
"method": "order.wave.singleFetchByIds",
"body": {}
},
{
"method": "order.wave.waveStrategyFallbackOrderList",
"body": {}
},
{
"method": "order.wave.singleOrderFetchList",
"body": {}
},
{
"method": "order.wave.wavePickTaskList",
"body": {}
},
{
"method": "order.wave.wavePickTaskCancel",
"body": {}
},
{
"method": "order.wave.batchCancel",
"body": {}
},
{
"method": "order.wave.batchCancelTaskProgress",
"body": {}
},
{
"method": "order.wave.batchAllocateExpress",
"body": {}
},
{
"method": "order.wave.batchAllocateExpressTaskProgress",
"body": {}
},
{
"method": "order.wave.batchRemoveExceptionOrders",
"body": {}
},
{
"method": "order.wave.batchRemoveExceptionOrdersTaskProgress",
"body": {}
},
{
"method": "order.wave.batchAllocateStorage",
"body": {}
},
{
"method": "order.wave.batchAllocateStorageTaskProgress",
"body": {}
},
{
"method": "order.wave.groupFetch",
"body": {}
},
{
"method": "order.wave.singleFetch",
"body": {}
},
{
"method": "order.wave.fetch",
"body": {}
},
{
"method": "order.wave.fetchTaskProgress",
"body": {}
},
{
"method": "order.wave.batchAutoGrouping",
"body": {}
},
{
"method": "order.wave.batchFinishAutoGrouping",
"body": {}
},
{
"method": "order.wave.batchRemoveOrders",
"body": {}
}
],

File diff suppressed because it is too large Load Diff

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-08 17:47:16",
"generatedAtLocal": "2026-05-08 17:47:16",
"generatedAt": "2026-05-09 09:52:14",
"generatedAtLocal": "2026-05-09 09:52:14",
"source": "remote",
"filter": {
"platform": {
@ -12,27 +12,114 @@
"label": "全部"
}
},
"totalInterfaceCount": 243,
"totalInterfaceCount": 245,
"changes": {
"summary": {
"moduleAdded": 0,
"moduleAdded": 1,
"moduleDeleted": 0,
"moduleUpdated": 0,
"interfaceAdded": 0,
"interfaceDeleted": 0,
"interfaceParamsUpdated": 0,
"interfaceResponseUpdated": 0
"moduleUpdated": 1,
"interfaceAdded": 3,
"interfaceDeleted": 1,
"interfaceParamsUpdated": 2,
"interfaceResponseUpdated": 2
},
"moduleUpdates": {
"added": [],
"added": [
{
"moduleName": "order.wave",
"moduleKey": "order",
"folder": "order",
"methods": [
"order.wave.batchList"
],
"interfaceCount": 1
}
],
"deleted": [],
"updated": []
"updated": [
{
"moduleName": "订单波次模块",
"moduleKey": "order.wave",
"folder": "order.wave",
"previousModuleName": "订单波次模块",
"previousModuleKey": "order.wave",
"interfaceChanges": {
"addedMethods": [
"order.wave.wavePickTaskCancel",
"order.wave.wavePickTaskList"
],
"deletedMethods": [
"order.wave.batchList"
],
"paramsUpdatedMethods": [
"order.wave.waveStrategyFetchAdmin",
"order.wave.waveStrategyFetchPda"
],
"responseUpdatedMethods": [
"order.wave.waveStrategyFetchAdmin",
"order.wave.waveStrategyFetchPda"
]
}
}
]
},
"interfaceUpdates": {
"added": [],
"deleted": [],
"paramsUpdated": [],
"responseUpdated": []
"added": [
{
"moduleName": "order.wave",
"moduleKey": "order",
"folder": "order",
"method": "order.wave.batchList"
},
{
"moduleName": "订单波次模块",
"moduleKey": "order.wave",
"folder": "order.wave",
"method": "order.wave.wavePickTaskCancel"
},
{
"moduleName": "订单波次模块",
"moduleKey": "order.wave",
"folder": "order.wave",
"method": "order.wave.wavePickTaskList"
}
],
"deleted": [
{
"moduleName": "订单波次模块",
"moduleKey": "order.wave",
"folder": "order.wave",
"method": "order.wave.batchList"
}
],
"paramsUpdated": [
{
"moduleName": "订单波次模块",
"moduleKey": "order.wave",
"folder": "order.wave",
"method": "order.wave.waveStrategyFetchAdmin"
},
{
"moduleName": "订单波次模块",
"moduleKey": "order.wave",
"folder": "order.wave",
"method": "order.wave.waveStrategyFetchPda"
}
],
"responseUpdated": [
{
"moduleName": "订单波次模块",
"moduleKey": "order.wave",
"folder": "order.wave",
"method": "order.wave.waveStrategyFetchAdmin"
},
{
"moduleName": "订单波次模块",
"moduleKey": "order.wave",
"folder": "order.wave",
"method": "order.wave.waveStrategyFetchPda"
}
]
}
},
"interfaces": [
@ -3980,9 +4067,9 @@
]
},
{
"moduleName": "订单波次模块",
"moduleKey": "order.wave",
"moduleFolder": "order.wave",
"moduleName": "order.wave",
"moduleKey": "order",
"moduleFolder": "order",
"method": "order.wave.batchList",
"title": "波次列表查询。仅使用当前登录操作者的仓库ID作为查询约束(禁止传入 warehouse_id / warehouseId)。支持通过白名单字段进行过滤(通过 where 对象传入),接口对 wave_status 固定叠加查询状态 0/1,无需客户端传入。列表按订单数量从大到小排序,并附带波次基础信息与分配状态汇总。",
"description": "波次列表查询。仅使用当前登录操作者的仓库ID作为查询约束(禁止传入 warehouse_id / warehouseId)。支持通过白名单字段进行过滤(通过 where 对象传入),接口对 wave_status 固定叠加查询状态 0/1,无需客户端传入。列表按订单数量从大到小排序,并附带波次基础信息与分配状态汇总。",
@ -4012,7 +4099,7 @@
"name": "where",
"type": "object",
"required": false,
"description": "筛选白名单字段(object,可选)。仅支持下列字段过滤,且禁止传入 warehouse_id / warehouseId: - wave_id(等值) - wave_no(模糊) - wave_type(等值) - wave_status(等值,接口固定叠加状态 0/1) - creator(模糊) - logistics_name(模糊) - item_part_type(等值) - item_part(模糊) - item_snapshot_key(模糊) - item_detail_machine(模糊) - distinguish_express(等值) - total_orders_min / total_orders_max(范围) - processed_orders_min / processed_orders_max(范围) - storage_assignment_status(等值,string,可选,取值:未分配、部分分配、已分配;默认不传不做限制)。过滤语义:已分配=聚合后全部 fin;部分分配=不含 error,且既不是全 none,也不是全 fin;未分配=全 none 或包含 error(异常并入未分配筛选集合)。说明:返回字段 storage_assignment_status 的展示值保持不变,包含 error 时仍可显示“分配异常”;此处 where 的过滤语义会把异常计入“未分配”,以避免把过滤语义与展示值混淆。"
"description": "筛选白名单字段(object,可选)。仅支持下列字段过滤,且禁止传入 warehouse_id / warehouseId: - wave_id(等值) - wave_no(模糊) - wave_type(等值) - wave_status(等值,接口固定叠加状态 0/1) - creator(模糊) - logistics_name(模糊) - item_part_type(等值) - item_part(模糊) - item_snapshot_key(模糊) - item_detail_machine(模糊) - distinguish_express(等值) - total_orders_min / total_orders_max(范围) - processed_orders_min / processed_orders_max(范围) - storage_assignment_status(等值,string,可选,取值:未分配、部分分配、已分配;默认不传不做限制)。过滤语义:已分配=聚合后全部 fin;部分分配=不含 error,且既不是全 none,也不是全 fin;未分配=全 none 或包含 error(异常并入未分配筛选集合)。说明:返回字段 storage_assignment_status 的展示值保持不变,包含 error 时仍可显示“分配异常”;此处 where 的过滤语义会把异常计入“未分配”,以避免把过滤语义与展示值混淆。 - source(可选,number)来源过滤:0=普通波次(正常后台操作),1=管理后台策略任务,2=PDA策略任务;不传则不过滤。"
}
],
"response": [
@ -4020,7 +4107,7 @@
"name": "list",
"type": "array",
"required": true,
"description": "波次列表,包含波次基础信息与状态汇总(order_count / storage_assignment_status / express_assignment_status / print_assignment_status)"
"description": "波次列表,包含波次基础信息与状态汇总(order_count / storage_assignment_status / express_assignment_status / print_assignment_status)。每条记录新增字段 source(number):来源标识,0=普通波次(正常后台操作),1=管理后台策略任务,2=PDA策略任务。"
},
{
"name": "pagination",
@ -4870,6 +4957,222 @@
}
]
},
{
"moduleName": "订单波次模块",
"moduleKey": "order.wave",
"moduleFolder": "order.wave",
"method": "order.wave.wavePickTaskCancel",
"title": "取消拣货任务(批量),同时释放关联波次(物理删除波次记录,订单回池)、解绑拣货车、写操作日志。入参仅支持 task_ids(数组,必填),不再支持单个 task_id。操作人与仓库从请求上下文获取(例如当前登录用户上下文 ctx.user),若上下文缺失接口将返回错误。",
"description": "取消拣货任务(批量),同时释放关联波次(物理删除波次记录,订单回池)、解绑拣货车、写操作日志。入参仅支持 task_ids(数组,必填),不再支持单个 task_id。操作人与仓库从请求上下文获取(例如当前登录用户上下文 ctx.user),若上下文缺失接口将返回错误。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "task_ids",
"type": "array",
"required": true,
"description": "任务ID数组,例如 [123,124];仅支持批量处理,不再支持单个 task_id。"
}
],
"response": [
{
"name": "cancelled_count",
"type": "number",
"required": false,
"description": "成功取消的任务数量"
},
{
"name": "task_ids",
"type": "array",
"required": false,
"description": "处理的任务ID数组(若后端返回)"
},
{
"name": "task_nos",
"type": "array",
"required": false,
"description": "处理的任务编号数组(若后端返回)"
},
{
"name": "task_id",
"type": "number",
"required": false,
"description": "任务ID(历史兼容,若后端仍返回)"
},
{
"name": "task_no",
"type": "string",
"required": false,
"description": "任务编号(历史兼容,若后端仍返回)"
}
]
},
{
"moduleName": "订单波次模块",
"moduleKey": "order.wave",
"moduleFolder": "order.wave",
"method": "order.wave.wavePickTaskList",
"title": "按当前仓库分页查询拣货任务列表。支持顶层分页参数 `page_no`/`page_size`(兼容 `pagination` 对象与 `current/size`),支持 `status` 单值或数组;兼容历史 `where` 结构,顶层参数优先。默认按 create_time desc 排序。",
"description": "按当前仓库分页查询拣货任务列表。支持顶层分页参数 `page_no`/`page_size`(兼容 `pagination` 对象与 `current/size`),支持 `status` 单值或数组;兼容历史 `where` 结构,顶层参数优先。默认按 create_time desc 排序。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "warehouse_id",
"type": "number",
"required": true,
"description": "仓库ID(必填)"
},
{
"name": "pagination",
"type": "object",
"required": false,
"description": "分页参数,支持 page / pageSize,兼容 current / size(兼容旧客户端)"
},
{
"name": "page_no",
"type": "number",
"required": false,
"description": "页码(优先于 pagination.page/current)"
},
{
"name": "page_size",
"type": "number",
"required": false,
"description": "每页大小(优先于 pagination.pageSize/size)"
},
{
"name": "status",
"type": "array",
"required": false,
"description": "拣货任务状态过滤;建议传数组,也兼容单值或逗号分隔字符串,兼容 where.status;顶层参数优先"
},
{
"name": "review_status",
"type": "number",
"required": false,
"description": "复核状态过滤"
},
{
"name": "pick_mode",
"type": "number",
"required": false,
"description": "拣货模式(如批量/逐单等)"
},
{
"name": "source",
"type": "string",
"required": false,
"description": "任务来源标识(业务端语义)"
},
{
"name": "pick_user_id",
"type": "number",
"required": false,
"description": "拣货执行人ID(兼容旧字段)"
},
{
"name": "review_user_id",
"type": "number",
"required": false,
"description": "复核人ID"
},
{
"name": "task_no",
"type": "string",
"required": false,
"description": "任务编号(支持模糊匹配)"
},
{
"name": "cart_id",
"type": "number",
"required": false,
"description": "拣货车/作业车ID"
},
{
"name": "keyword",
"type": "string",
"required": false,
"description": "关键字搜索:支持 task_no / batch_no / current_cart_code_snapshot 等字段的模糊匹配"
},
{
"name": "start_time_start",
"type": "string",
"required": false,
"description": "开始时间(ISO 字符串),与 start_time_end 一起用于时间范围过滤"
},
{
"name": "start_time_end",
"type": "string",
"required": false,
"description": "结束时间(ISO 字符串),与 start_time_start 一起用于时间范围过滤"
},
{
"name": "where",
"type": "object",
"required": false,
"description": "兼容历史 where 结构(可包含 status 等字段);当存在顶层同名参数时,顶层参数优先"
},
{
"name": "strategy_id",
"type": "number",
"required": false,
"description": "策略ID(当前主表未存,该接口会忽略此过滤,建议勿使用)"
}
],
"response": [
{
"name": "list",
"type": "array",
"required": true,
"description": "拣货任务列表(数组),每项字段如下"
},
{
"name": "total",
"type": "number",
"required": false,
"description": "总记录数"
},
{
"name": "page",
"type": "number",
"required": false,
"description": "当前页码"
},
{
"name": "page_size",
"type": "number",
"required": false,
"description": "每页大小"
}
]
},
{
"moduleName": "订单波次模块",
"moduleKey": "order.wave",
@ -5085,8 +5388,8 @@
"moduleKey": "order.wave",
"moduleFolder": "order.wave",
"method": "order.wave.waveStrategyFetchAdmin",
"title": "按策略提交抓取任务(仅后台管理使用,壳子方法,当前仅受理返回任务信息,后续补真实执行逻辑)",
"description": "按策略提交抓取任务(仅后台管理使用,壳子方法,当前仅受理返回任务信息,后续补真实执行逻辑)",
"title": "按策略提交并创建抓取主流程任务(后台管理)。当前为最小主流程:执行入参校验并创建任务记录,返回创建结果与计划预览;后续将扩展完整扫描/执行链路。",
"description": "按策略提交并创建抓取主流程任务(后台管理)。当前为最小主流程:执行入参校验并创建任务记录,返回创建结果与计划预览;后续将扩展完整扫描/执行链路。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
@ -5108,50 +5411,80 @@
"type": "number",
"required": true,
"description": "策略ID(正整数,支持下划线/驼峰)"
},
{
"name": "cart_id / cartId",
"type": "string|number",
"required": false,
"description": "可选,关联拣货车/作业车ID,用于记录作业上下文或幂等识别"
},
{
"name": "source / operation_source",
"type": "string",
"required": false,
"description": "可选,操作来源标识(例如 admin/pda/manual/auto),用于审计与分流策略"
},
{
"name": "strategy_params / strategyParams",
"type": "object",
"required": false,
"description": "可选,策略参数透传对象(如 order_min_qty/order_max_qty/allow_cross_owner 等),在创建任务时作为策略覆盖或附加参数使用"
}
],
"response": [
{
"name": "status",
"name": "state",
"type": "string",
"required": true,
"description": "提交状态,固定 success"
"description": "任务状态:created(已创建主流程任务),后续可能为 running/success/failed"
},
{
"name": "task_id",
"type": "string",
"required": true,
"description": "任务ID"
"description": "任务唯一 ID(用于后续查询或关联)"
},
{
"name": "task_no",
"type": "string",
"required": true,
"description": "任务业务编号(便于展示与关联)"
},
{
"name": "warehouse_id",
"type": "number",
"required": true,
"description": "仓库ID"
"required": false,
"description": "生效的仓库 ID(来自当前上下文,如可用则返回)"
},
{
"name": "strategy_id",
"type": "number",
"required": true,
"description": "策略ID"
"required": false,
"description": "生效的策略 ID(与入参保持一致,兼容回传)"
},
{
"name": "state",
"name": "plan",
"type": "object",
"required": true,
"description": "任务计划/执行预览对象,描述本次任务预估的执行计划"
},
{
"name": "plan_summary",
"type": "string",
"required": true,
"description": "任务状态,固定 submitted"
"description": "计划摘要字符串,便于前端在受理后快速展示(例如:'创建 3 个波次,涉及 120 单,约 450 件')"
},
{
"name": "validation_errors",
"type": "array",
"required": false,
"description": "当入参校验失败时返回的数组,每项为 { field, message } 对象,供前端展示或定位问题"
},
{
"name": "message",
"type": "string",
"required": false,
"description": "可选提示信息"
},
{
"name": "accepted_at",
"type": "string",
"required": false,
"description": "任务受理时间(ISO)"
"description": "可选提示信息或错误说明(创建失败时返回简短说明)"
}
]
},
@ -5160,8 +5493,8 @@
"moduleKey": "order.wave",
"moduleFolder": "order.wave",
"method": "order.wave.waveStrategyFetchPda",
"title": "按策略提交抓取任务(仅PDA使用,壳子方法,当前仅受理返回任务信息,后续补真实执行逻辑)",
"description": "按策略提交抓取任务(仅PDA使用,壳子方法,当前仅受理返回任务信息,后续补真实执行逻辑)",
"title": "按策略提交并创建抓取主流程任务(PDA)。当前为最小主流程:进行入参校验并创建任务记录,返回创建结果与计划预览;后续扫描/执行阶段将扩展为完整执行流。",
"description": "按策略提交并创建抓取主流程任务(PDA)。当前为最小主流程:进行入参校验并创建任务记录,返回创建结果与计划预览;后续扫描/执行阶段将扩展为完整执行流。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
@ -5183,50 +5516,80 @@
"type": "number",
"required": true,
"description": "策略ID(正整数,支持下划线/驼峰)"
},
{
"name": "cart_id / cartId",
"type": "string|number",
"required": false,
"description": "可选,关联拣货车/作业车ID,支持字符串或数字,用于记录作业上下文"
},
{
"name": "source / operation_source",
"type": "string",
"required": false,
"description": "可选,操作来源标识(例如 pda/admin/manual/auto),用于审计与分流策略"
},
{
"name": "strategy_params / strategyParams",
"type": "object",
"required": false,
"description": "可选,策略参数透传对象(如 order_min_qty/order_max_qty/allow_cross_owner 等),在创建任务时作为策略覆盖或附加参数使用"
}
],
"response": [
{
"name": "status",
"name": "state",
"type": "string",
"required": true,
"description": "提交状态,固定 success"
"description": "任务状态:created(已创建主流程任务),后续可能为 running/success/failed"
},
{
"name": "task_id",
"type": "string",
"required": true,
"description": "任务ID"
"description": "任务唯一 ID(用于后续查询或关联)"
},
{
"name": "task_no",
"type": "string",
"required": true,
"description": "任务业务编号(便于展示与关联)"
},
{
"name": "warehouse_id",
"type": "number",
"required": true,
"description": "仓库ID"
"required": false,
"description": "生效的仓库 ID(来自当前上下文,如可用则返回)"
},
{
"name": "strategy_id",
"type": "number",
"required": true,
"description": "策略ID"
"required": false,
"description": "生效的策略 ID(与入参保持一致,兼容回传)"
},
{
"name": "state",
"name": "plan",
"type": "object",
"required": true,
"description": "任务计划/执行预览对象,描述本次任务预估的执行计划"
},
{
"name": "plan_summary",
"type": "string",
"required": true,
"description": "任务状态,固定 submitted"
"description": "计划摘要字符串,便于前端在受理后快速展示(例如:'创建 3 个波次,涉及 120 单,约 450 件')"
},
{
"name": "validation_errors",
"type": "array",
"required": false,
"description": "当入参校验失败时返回的数组,每项为 { field, message } 对象,供前端展示或定位问题"
},
{
"name": "message",
"type": "string",
"required": false,
"description": "可选提示信息"
},
{
"name": "accepted_at",
"type": "string",
"required": false,
"description": "任务受理时间(ISO)"
"description": "可选提示信息或错误说明(创建失败时返回简短说明)"
}
]
},

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-08 17:47:16",
"generatedAtLocal": "2026-05-08 17:47:16",
"generatedAt": "2026-05-09 09:52:14",
"generatedAtLocal": "2026-05-09 09:52:14",
"source": "remote",
"filter": {
"platform": {
@ -12,28 +12,115 @@
"label": "全部"
}
},
"moduleCount": 34,
"totalInterfaceCount": 243,
"moduleCount": 35,
"totalInterfaceCount": 245,
"changes": {
"summary": {
"moduleAdded": 0,
"moduleAdded": 1,
"moduleDeleted": 0,
"moduleUpdated": 0,
"interfaceAdded": 0,
"interfaceDeleted": 0,
"interfaceParamsUpdated": 0,
"interfaceResponseUpdated": 0
"moduleUpdated": 1,
"interfaceAdded": 3,
"interfaceDeleted": 1,
"interfaceParamsUpdated": 2,
"interfaceResponseUpdated": 2
},
"moduleUpdates": {
"added": [],
"added": [
{
"moduleName": "order.wave",
"moduleKey": "order",
"folder": "order",
"methods": [
"order.wave.batchList"
],
"interfaceCount": 1
}
],
"deleted": [],
"updated": []
"updated": [
{
"moduleName": "订单波次模块",
"moduleKey": "order.wave",
"folder": "order.wave",
"previousModuleName": "订单波次模块",
"previousModuleKey": "order.wave",
"interfaceChanges": {
"addedMethods": [
"order.wave.wavePickTaskCancel",
"order.wave.wavePickTaskList"
],
"deletedMethods": [
"order.wave.batchList"
],
"paramsUpdatedMethods": [
"order.wave.waveStrategyFetchAdmin",
"order.wave.waveStrategyFetchPda"
],
"responseUpdatedMethods": [
"order.wave.waveStrategyFetchAdmin",
"order.wave.waveStrategyFetchPda"
]
}
}
]
},
"interfaceUpdates": {
"added": [],
"deleted": [],
"paramsUpdated": [],
"responseUpdated": []
"added": [
{
"moduleName": "order.wave",
"moduleKey": "order",
"folder": "order",
"method": "order.wave.batchList"
},
{
"moduleName": "订单波次模块",
"moduleKey": "order.wave",
"folder": "order.wave",
"method": "order.wave.wavePickTaskCancel"
},
{
"moduleName": "订单波次模块",
"moduleKey": "order.wave",
"folder": "order.wave",
"method": "order.wave.wavePickTaskList"
}
],
"deleted": [
{
"moduleName": "订单波次模块",
"moduleKey": "order.wave",
"folder": "order.wave",
"method": "order.wave.batchList"
}
],
"paramsUpdated": [
{
"moduleName": "订单波次模块",
"moduleKey": "order.wave",
"folder": "order.wave",
"method": "order.wave.waveStrategyFetchAdmin"
},
{
"moduleName": "订单波次模块",
"moduleKey": "order.wave",
"folder": "order.wave",
"method": "order.wave.waveStrategyFetchPda"
}
],
"responseUpdated": [
{
"moduleName": "订单波次模块",
"moduleKey": "order.wave",
"folder": "order.wave",
"method": "order.wave.waveStrategyFetchAdmin"
},
{
"moduleName": "订单波次模块",
"moduleKey": "order.wave",
"folder": "order.wave",
"method": "order.wave.waveStrategyFetchPda"
}
]
}
},
"modules": [
@ -280,7 +367,7 @@
"moduleName": "订单波次模块",
"moduleKey": "order.wave",
"folder": "order.wave",
"interfaceCount": 27,
"interfaceCount": 28,
"interfaces": [
{
"method": "order.wave.waveStrategyList"
@ -316,7 +403,10 @@
"method": "order.wave.singleOrderFetchList"
},
{
"method": "order.wave.batchList"
"method": "order.wave.wavePickTaskList"
},
{
"method": "order.wave.wavePickTaskCancel"
},
{
"method": "order.wave.batchCancel"
@ -1037,6 +1127,17 @@
"method": "store.auditApply"
}
]
},
{
"moduleName": "order.wave",
"moduleKey": "order",
"folder": "order",
"interfaceCount": 1,
"interfaces": [
{
"method": "order.wave.batchList"
}
]
}
]
}

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-08 17:47:16",
"updatedAt": "2026-05-09 09:52:14",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-08 17:47:16",
"generatedAtLocal": "2026-05-08 17:47:16",
"generatedAt": "2026-05-09 09:52:14",
"generatedAtLocal": "2026-05-09 09:52:14",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-08 17:47:16",
"updatedAt": "2026-05-09 09:52:14",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-08 17:47:16",
"generatedAtLocal": "2026-05-08 17:47:16",
"generatedAt": "2026-05-09 09:52:14",
"generatedAtLocal": "2026-05-09 09:52:14",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-08 17:47:16",
"updatedAt": "2026-05-09 09:52:14",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-08 17:47:16",
"generatedAtLocal": "2026-05-08 17:47:16",
"generatedAt": "2026-05-09 09:52:14",
"generatedAtLocal": "2026-05-09 09:52:14",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-08 17:47:16",
"updatedAt": "2026-05-09 09:52:14",
"deletedAt": null,
"restoredAt": "2026-04-17 19:16:50"
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-08 17:47:16",
"generatedAtLocal": "2026-05-08 17:47:16",
"generatedAt": "2026-05-09 09:52:14",
"generatedAtLocal": "2026-05-09 09:52:14",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-08 17:47:16",
"updatedAt": "2026-05-09 09:52:14",
"deletedAt": null,
"restoredAt": "2026-04-17 19:16:50"
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-08 17:47:16",
"generatedAtLocal": "2026-05-08 17:47:16",
"generatedAt": "2026-05-09 09:52:14",
"generatedAtLocal": "2026-05-09 09:52:14",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-08 17:47:16",
"updatedAt": "2026-05-09 09:52:14",
"deletedAt": null,
"restoredAt": "2026-04-17 19:16:50"
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-08 17:47:16",
"generatedAtLocal": "2026-05-08 17:47:16",
"generatedAt": "2026-05-09 09:52:14",
"generatedAtLocal": "2026-05-09 09:52:14",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-08 17:47:16",
"updatedAt": "2026-05-09 09:52:14",
"deletedAt": null,
"restoredAt": "2026-04-17 19:16:50"
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-08 17:47:16",
"generatedAtLocal": "2026-05-08 17:47:16",
"generatedAt": "2026-05-09 09:52:14",
"generatedAtLocal": "2026-05-09 09:52:14",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-08 17:47:16",
"updatedAt": "2026-05-09 09:52:14",
"deletedAt": null,
"restoredAt": "2026-04-17 19:16:50"
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-08 17:47:16",
"generatedAtLocal": "2026-05-08 17:47:16",
"generatedAt": "2026-05-09 09:52:14",
"generatedAtLocal": "2026-05-09 09:52:14",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-08 17:47:16",
"updatedAt": "2026-05-09 09:52:14",
"deletedAt": null,
"restoredAt": "2026-04-17 19:16:50"
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-08 17:47:16",
"generatedAtLocal": "2026-05-08 17:47:16",
"generatedAt": "2026-05-09 09:52:14",
"generatedAtLocal": "2026-05-09 09:52:14",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-08 17:47:16",
"updatedAt": "2026-05-09 09:52:14",
"deletedAt": null,
"restoredAt": "2026-04-17 19:16:50"
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-08 17:47:16",
"generatedAtLocal": "2026-05-08 17:47:16",
"generatedAt": "2026-05-09 09:52:14",
"generatedAtLocal": "2026-05-09 09:52:14",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-08 17:47:16",
"updatedAt": "2026-05-09 09:52:14",
"deletedAt": null,
"restoredAt": "2026-04-17 19:16:50"
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-08 17:47:16",
"generatedAtLocal": "2026-05-08 17:47:16",
"generatedAt": "2026-05-09 09:52:14",
"generatedAtLocal": "2026-05-09 09:52:14",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-05-05 09:15:19",
"updatedAt": "2026-05-08 17:47:16",
"updatedAt": "2026-05-09 09:52:14",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-08 17:47:16",
"generatedAtLocal": "2026-05-08 17:47:16",
"generatedAt": "2026-05-09 09:52:14",
"generatedAtLocal": "2026-05-09 09:52:14",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-08 17:47:16",
"updatedAt": "2026-05-09 09:52:14",
"deletedAt": null,
"restoredAt": "2026-04-17 19:16:50"
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-08 17:47:16",
"generatedAtLocal": "2026-05-08 17:47:16",
"generatedAt": "2026-05-09 09:52:14",
"generatedAtLocal": "2026-05-09 09:52:14",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-05-04 09:11:04",
"updatedAt": "2026-05-08 17:47:16",
"updatedAt": "2026-05-09 09:52:14",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-08 17:47:16",
"generatedAtLocal": "2026-05-08 17:47:16",
"generatedAt": "2026-05-09 09:52:14",
"generatedAtLocal": "2026-05-09 09:52:14",
"source": "remote",
"filter": {
"platform": {
@ -16,17 +16,28 @@
"name": "订单波次模块",
"key": "order.wave",
"folder": "order.wave",
"interfaceCount": 27
"interfaceCount": 28
},
"changes": {
"fromPreviousSnapshot": {
"moduleAdded": false,
"moduleRenamed": false,
"interfaceChanges": {
"addedMethods": [],
"deletedMethods": [],
"paramsUpdatedMethods": [],
"responseUpdatedMethods": []
"addedMethods": [
"order.wave.wavePickTaskCancel",
"order.wave.wavePickTaskList"
],
"deletedMethods": [
"order.wave.batchList"
],
"paramsUpdatedMethods": [
"order.wave.waveStrategyFetchAdmin",
"order.wave.waveStrategyFetchPda"
],
"responseUpdatedMethods": [
"order.wave.waveStrategyFetchAdmin",
"order.wave.waveStrategyFetchPda"
]
}
}
},
@ -452,8 +463,8 @@
},
{
"method": "order.wave.waveStrategyFetchPda",
"title": "按策略提交抓取任务(仅PDA使用,壳子方法,当前仅受理返回任务信息,后续补真实执行逻辑)",
"description": "按策略提交抓取任务(仅PDA使用,壳子方法,当前仅受理返回任务信息,后续补真实执行逻辑)",
"title": "按策略提交并创建抓取主流程任务(PDA)。当前为最小主流程:进行入参校验并创建任务记录,返回创建结果与计划预览;后续扫描/执行阶段将扩展为完整执行流。",
"description": "按策略提交并创建抓取主流程任务(PDA)。当前为最小主流程:进行入参校验并创建任务记录,返回创建结果与计划预览;后续扫描/执行阶段将扩展为完整执行流。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
@ -475,57 +486,87 @@
"type": "number",
"required": true,
"description": "策略ID(正整数,支持下划线/驼峰)"
},
{
"name": "cart_id / cartId",
"type": "string|number",
"required": false,
"description": "可选,关联拣货车/作业车ID,支持字符串或数字,用于记录作业上下文"
},
{
"name": "source / operation_source",
"type": "string",
"required": false,
"description": "可选,操作来源标识(例如 pda/admin/manual/auto),用于审计与分流策略"
},
{
"name": "strategy_params / strategyParams",
"type": "object",
"required": false,
"description": "可选,策略参数透传对象(如 order_min_qty/order_max_qty/allow_cross_owner 等),在创建任务时作为策略覆盖或附加参数使用"
}
],
"response": [
{
"name": "status",
"name": "state",
"type": "string",
"required": true,
"description": "提交状态,固定 success"
"description": "任务状态:created(已创建主流程任务),后续可能为 running/success/failed"
},
{
"name": "task_id",
"type": "string",
"required": true,
"description": "任务ID"
"description": "任务唯一 ID(用于后续查询或关联)"
},
{
"name": "task_no",
"type": "string",
"required": true,
"description": "任务业务编号(便于展示与关联)"
},
{
"name": "warehouse_id",
"type": "number",
"required": true,
"description": "仓库ID"
"required": false,
"description": "生效的仓库 ID(来自当前上下文,如可用则返回)"
},
{
"name": "strategy_id",
"type": "number",
"required": true,
"description": "策略ID"
"required": false,
"description": "生效的策略 ID(与入参保持一致,兼容回传)"
},
{
"name": "state",
"name": "plan",
"type": "object",
"required": true,
"description": "任务计划/执行预览对象,描述本次任务预估的执行计划"
},
{
"name": "plan_summary",
"type": "string",
"required": true,
"description": "任务状态,固定 submitted"
"description": "计划摘要字符串,便于前端在受理后快速展示(例如:'创建 3 个波次,涉及 120 单,约 450 件')"
},
{
"name": "validation_errors",
"type": "array",
"required": false,
"description": "当入参校验失败时返回的数组,每项为 { field, message } 对象,供前端展示或定位问题"
},
{
"name": "message",
"type": "string",
"required": false,
"description": "可选提示信息"
},
{
"name": "accepted_at",
"type": "string",
"required": false,
"description": "任务受理时间(ISO)"
"description": "可选提示信息或错误说明(创建失败时返回简短说明)"
}
]
},
{
"method": "order.wave.waveStrategyFetchAdmin",
"title": "按策略提交抓取任务(仅后台管理使用,壳子方法,当前仅受理返回任务信息,后续补真实执行逻辑)",
"description": "按策略提交抓取任务(仅后台管理使用,壳子方法,当前仅受理返回任务信息,后续补真实执行逻辑)",
"title": "按策略提交并创建抓取主流程任务(后台管理)。当前为最小主流程:执行入参校验并创建任务记录,返回创建结果与计划预览;后续将扩展完整扫描/执行链路。",
"description": "按策略提交并创建抓取主流程任务(后台管理)。当前为最小主流程:执行入参校验并创建任务记录,返回创建结果与计划预览;后续将扩展完整扫描/执行链路。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
@ -547,50 +588,80 @@
"type": "number",
"required": true,
"description": "策略ID(正整数,支持下划线/驼峰)"
},
{
"name": "cart_id / cartId",
"type": "string|number",
"required": false,
"description": "可选,关联拣货车/作业车ID,用于记录作业上下文或幂等识别"
},
{
"name": "source / operation_source",
"type": "string",
"required": false,
"description": "可选,操作来源标识(例如 admin/pda/manual/auto),用于审计与分流策略"
},
{
"name": "strategy_params / strategyParams",
"type": "object",
"required": false,
"description": "可选,策略参数透传对象(如 order_min_qty/order_max_qty/allow_cross_owner 等),在创建任务时作为策略覆盖或附加参数使用"
}
],
"response": [
{
"name": "status",
"name": "state",
"type": "string",
"required": true,
"description": "提交状态,固定 success"
"description": "任务状态:created(已创建主流程任务),后续可能为 running/success/failed"
},
{
"name": "task_id",
"type": "string",
"required": true,
"description": "任务ID"
"description": "任务唯一 ID(用于后续查询或关联)"
},
{
"name": "task_no",
"type": "string",
"required": true,
"description": "任务业务编号(便于展示与关联)"
},
{
"name": "warehouse_id",
"type": "number",
"required": true,
"description": "仓库ID"
"required": false,
"description": "生效的仓库 ID(来自当前上下文,如可用则返回)"
},
{
"name": "strategy_id",
"type": "number",
"required": true,
"description": "策略ID"
"required": false,
"description": "生效的策略 ID(与入参保持一致,兼容回传)"
},
{
"name": "state",
"name": "plan",
"type": "object",
"required": true,
"description": "任务计划/执行预览对象,描述本次任务预估的执行计划"
},
{
"name": "plan_summary",
"type": "string",
"required": true,
"description": "任务状态,固定 submitted"
"description": "计划摘要字符串,便于前端在受理后快速展示(例如:'创建 3 个波次,涉及 120 单,约 450 件')"
},
{
"name": "validation_errors",
"type": "array",
"required": false,
"description": "当入参校验失败时返回的数组,每项为 { field, message } 对象,供前端展示或定位问题"
},
{
"name": "message",
"type": "string",
"required": false,
"description": "可选提示信息"
},
{
"name": "accepted_at",
"type": "string",
"required": false,
"description": "任务受理时间(ISO)"
"description": "可选提示信息或错误说明(创建失败时返回简短说明)"
}
]
},
@ -991,9 +1062,9 @@
]
},
{
"method": "order.wave.batchList",
"title": "波次列表查询。仅使用当前登录操作者的仓库ID作为查询约束(禁止传入 warehouse_id / warehouseId)。支持通过白名单字段进行过滤(通过 where 对象传入),接口对 wave_status 固定叠加查询状态 0/1,无需客户端传入。列表按订单数量从大到小排序,并附带波次基础信息与分配状态汇总。",
"description": "波次列表查询。仅使用当前登录操作者的仓库ID作为查询约束(禁止传入 warehouse_id / warehouseId)。支持通过白名单字段进行过滤(通过 where 对象传入),接口对 wave_status 固定叠加查询状态 0/1,无需客户端传入。列表按订单数量从大到小排序,并附带波次基础信息与分配状态汇总。",
"method": "order.wave.wavePickTaskList",
"title": "按当前仓库分页查询拣货任务列表。支持顶层分页参数 `page_no`/`page_size`(兼容 `pagination` 对象与 `current/size`),支持 `status` 单值或数组;兼容历史 `where` 结构,顶层参数优先。默认按 create_time desc 排序。",
"description": "按当前仓库分页查询拣货任务列表。支持顶层分页参数 `page_no`/`page_size`(兼容 `pagination` 对象与 `current/size`),支持 `status` 单值或数组;兼容历史 `where` 结构,顶层参数优先。默认按 create_time desc 排序。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
@ -1010,17 +1081,107 @@
}
],
"params": [
{
"name": "warehouse_id",
"type": "number",
"required": true,
"description": "仓库ID(必填)"
},
{
"name": "pagination",
"type": "object",
"required": false,
"description": "分页参数,支持 page / pageSize"
"description": "分页参数,支持 page / pageSize,兼容 current / size(兼容旧客户端)"
},
{
"name": "page_no",
"type": "number",
"required": false,
"description": "页码(优先于 pagination.page/current)"
},
{
"name": "page_size",
"type": "number",
"required": false,
"description": "每页大小(优先于 pagination.pageSize/size)"
},
{
"name": "status",
"type": "array",
"required": false,
"description": "拣货任务状态过滤;建议传数组,也兼容单值或逗号分隔字符串,兼容 where.status;顶层参数优先"
},
{
"name": "review_status",
"type": "number",
"required": false,
"description": "复核状态过滤"
},
{
"name": "pick_mode",
"type": "number",
"required": false,
"description": "拣货模式(如批量/逐单等)"
},
{
"name": "source",
"type": "string",
"required": false,
"description": "任务来源标识(业务端语义)"
},
{
"name": "pick_user_id",
"type": "number",
"required": false,
"description": "拣货执行人ID(兼容旧字段)"
},
{
"name": "review_user_id",
"type": "number",
"required": false,
"description": "复核人ID"
},
{
"name": "task_no",
"type": "string",
"required": false,
"description": "任务编号(支持模糊匹配)"
},
{
"name": "cart_id",
"type": "number",
"required": false,
"description": "拣货车/作业车ID"
},
{
"name": "keyword",
"type": "string",
"required": false,
"description": "关键字搜索:支持 task_no / batch_no / current_cart_code_snapshot 等字段的模糊匹配"
},
{
"name": "start_time_start",
"type": "string",
"required": false,
"description": "开始时间(ISO 字符串),与 start_time_end 一起用于时间范围过滤"
},
{
"name": "start_time_end",
"type": "string",
"required": false,
"description": "结束时间(ISO 字符串),与 start_time_start 一起用于时间范围过滤"
},
{
"name": "where",
"type": "object",
"required": false,
"description": "筛选白名单字段(object,可选)。仅支持下列字段过滤,且禁止传入 warehouse_id / warehouseId: - wave_id(等值) - wave_no(模糊) - wave_type(等值) - wave_status(等值,接口固定叠加状态 0/1) - creator(模糊) - logistics_name(模糊) - item_part_type(等值) - item_part(模糊) - item_snapshot_key(模糊) - item_detail_machine(模糊) - distinguish_express(等值) - total_orders_min / total_orders_max(范围) - processed_orders_min / processed_orders_max(范围) - storage_assignment_status(等值,string,可选,取值:未分配、部分分配、已分配;默认不传不做限制)。过滤语义:已分配=聚合后全部 fin;部分分配=不含 error,且既不是全 none,也不是全 fin;未分配=全 none 或包含 error(异常并入未分配筛选集合)。说明:返回字段 storage_assignment_status 的展示值保持不变,包含 error 时仍可显示“分配异常”;此处 where 的过滤语义会把异常计入“未分配”,以避免把过滤语义与展示值混淆。"
"description": "兼容历史 where 结构(可包含 status 等字段);当存在顶层同名参数时,顶层参数优先"
},
{
"name": "strategy_id",
"type": "number",
"required": false,
"description": "策略ID(当前主表未存,该接口会忽略此过滤,建议勿使用)"
}
],
"response": [
@ -1028,13 +1189,85 @@
"name": "list",
"type": "array",
"required": true,
"description": "波次列表,包含波次基础信息与状态汇总(order_count / storage_assignment_status / express_assignment_status / print_assignment_status)"
"description": "拣货任务列表(数组),每项字段如下"
},
{
"name": "pagination",
"type": "object",
"name": "total",
"type": "number",
"required": false,
"description": "总记录数"
},
{
"name": "page",
"type": "number",
"required": false,
"description": "当前页码"
},
{
"name": "page_size",
"type": "number",
"required": false,
"description": "每页大小"
}
]
},
{
"method": "order.wave.wavePickTaskCancel",
"title": "取消拣货任务(批量),同时释放关联波次(物理删除波次记录,订单回池)、解绑拣货车、写操作日志。入参仅支持 task_ids(数组,必填),不再支持单个 task_id。操作人与仓库从请求上下文获取(例如当前登录用户上下文 ctx.user),若上下文缺失接口将返回错误。",
"description": "取消拣货任务(批量),同时释放关联波次(物理删除波次记录,订单回池)、解绑拣货车、写操作日志。入参仅支持 task_ids(数组,必填),不再支持单个 task_id。操作人与仓库从请求上下文获取(例如当前登录用户上下文 ctx.user),若上下文缺失接口将返回错误。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "分页信息(page、pageSize、total、totalPages、hasPrevious、hasNext)"
"description": "Bearer token"
}
],
"params": [
{
"name": "task_ids",
"type": "array",
"required": true,
"description": "任务ID数组,例如 [123,124];仅支持批量处理,不再支持单个 task_id。"
}
],
"response": [
{
"name": "cancelled_count",
"type": "number",
"required": false,
"description": "成功取消的任务数量"
},
{
"name": "task_ids",
"type": "array",
"required": false,
"description": "处理的任务ID数组(若后端返回)"
},
{
"name": "task_nos",
"type": "array",
"required": false,
"description": "处理的任务编号数组(若后端返回)"
},
{
"name": "task_id",
"type": "number",
"required": false,
"description": "任务ID(历史兼容,若后端仍返回)"
},
{
"name": "task_no",
"type": "string",
"required": false,
"description": "任务编号(历史兼容,若后端仍返回)"
}
]
},

View File

@ -0,0 +1,12 @@
{
"module": {
"name": "order.wave",
"key": "order",
"folder": "order"
},
"status": "active",
"createdAt": "2026-05-09 09:52:14",
"updatedAt": "2026-05-09 09:52:14",
"deletedAt": null,
"restoredAt": null
}

View File

@ -0,0 +1,85 @@
{
"generatedAt": "2026-05-09 09:52:14",
"generatedAtLocal": "2026-05-09 09:52:14",
"source": "remote",
"filter": {
"platform": {
"value": "web",
"label": "网页端"
},
"project": {
"value": "all",
"label": "全部"
}
},
"module": {
"name": "order.wave",
"key": "order",
"folder": "order",
"interfaceCount": 1
},
"changes": {
"fromPreviousSnapshot": {
"moduleAdded": true,
"moduleRenamed": false,
"interfaceChanges": {
"addedMethods": [
"order.wave.batchList"
],
"deletedMethods": [],
"paramsUpdatedMethods": [],
"responseUpdatedMethods": []
}
}
},
"interfaces": [
{
"method": "order.wave.batchList",
"title": "波次列表查询。仅使用当前登录操作者的仓库ID作为查询约束(禁止传入 warehouse_id / warehouseId)。支持通过白名单字段进行过滤(通过 where 对象传入),接口对 wave_status 固定叠加查询状态 0/1,无需客户端传入。列表按订单数量从大到小排序,并附带波次基础信息与分配状态汇总。",
"description": "波次列表查询。仅使用当前登录操作者的仓库ID作为查询约束(禁止传入 warehouse_id / warehouseId)。支持通过白名单字段进行过滤(通过 where 对象传入),接口对 wave_status 固定叠加查询状态 0/1,无需客户端传入。列表按订单数量从大到小排序,并附带波次基础信息与分配状态汇总。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "pagination",
"type": "object",
"required": false,
"description": "分页参数,支持 page / pageSize"
},
{
"name": "where",
"type": "object",
"required": false,
"description": "筛选白名单字段(object,可选)。仅支持下列字段过滤,且禁止传入 warehouse_id / warehouseId: - wave_id(等值) - wave_no(模糊) - wave_type(等值) - wave_status(等值,接口固定叠加状态 0/1) - creator(模糊) - logistics_name(模糊) - item_part_type(等值) - item_part(模糊) - item_snapshot_key(模糊) - item_detail_machine(模糊) - distinguish_express(等值) - total_orders_min / total_orders_max(范围) - processed_orders_min / processed_orders_max(范围) - storage_assignment_status(等值,string,可选,取值:未分配、部分分配、已分配;默认不传不做限制)。过滤语义:已分配=聚合后全部 fin;部分分配=不含 error,且既不是全 none,也不是全 fin;未分配=全 none 或包含 error(异常并入未分配筛选集合)。说明:返回字段 storage_assignment_status 的展示值保持不变,包含 error 时仍可显示“分配异常”;此处 where 的过滤语义会把异常计入“未分配”,以避免把过滤语义与展示值混淆。 - source(可选,number)来源过滤:0=普通波次(正常后台操作),1=管理后台策略任务,2=PDA策略任务;不传则不过滤。"
}
],
"response": [
{
"name": "list",
"type": "array",
"required": true,
"description": "波次列表,包含波次基础信息与状态汇总(order_count / storage_assignment_status / express_assignment_status / print_assignment_status)。每条记录新增字段 source(number):来源标识,0=普通波次(正常后台操作),1=管理后台策略任务,2=PDA策略任务。"
},
{
"name": "pagination",
"type": "object",
"required": true,
"description": "分页信息(page、pageSize、total、totalPages、hasPrevious、hasNext)"
}
]
}
]
}

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-05-04 17:23:48",
"updatedAt": "2026-05-08 17:47:16",
"updatedAt": "2026-05-09 09:52:14",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-08 17:47:16",
"generatedAtLocal": "2026-05-08 17:47:16",
"generatedAt": "2026-05-09 09:52:14",
"generatedAtLocal": "2026-05-09 09:52:14",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-08 17:47:16",
"updatedAt": "2026-05-09 09:52:14",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-08 17:47:16",
"generatedAtLocal": "2026-05-08 17:47:16",
"generatedAt": "2026-05-09 09:52:14",
"generatedAtLocal": "2026-05-09 09:52:14",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-08 17:47:16",
"updatedAt": "2026-05-09 09:52:14",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-08 17:47:16",
"generatedAtLocal": "2026-05-08 17:47:16",
"generatedAt": "2026-05-09 09:52:14",
"generatedAtLocal": "2026-05-09 09:52:14",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-08 17:47:16",
"updatedAt": "2026-05-09 09:52:14",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-08 17:47:16",
"generatedAtLocal": "2026-05-08 17:47:16",
"generatedAt": "2026-05-09 09:52:14",
"generatedAtLocal": "2026-05-09 09:52:14",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-17 19:37:49",
"updatedAt": "2026-05-08 17:47:16",
"updatedAt": "2026-05-09 09:52:14",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-08 17:47:16",
"generatedAtLocal": "2026-05-08 17:47:16",
"generatedAt": "2026-05-09 09:52:14",
"generatedAtLocal": "2026-05-09 09:52:14",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-17 20:21:27",
"updatedAt": "2026-05-08 17:47:16",
"updatedAt": "2026-05-09 09:52:14",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-08 17:47:16",
"generatedAtLocal": "2026-05-08 17:47:16",
"generatedAt": "2026-05-09 09:52:14",
"generatedAtLocal": "2026-05-09 09:52:14",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-08 17:47:16",
"updatedAt": "2026-05-09 09:52:14",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-08 17:47:16",
"generatedAtLocal": "2026-05-08 17:47:16",
"generatedAt": "2026-05-09 09:52:14",
"generatedAtLocal": "2026-05-09 09:52:14",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-17 19:16:50",
"updatedAt": "2026-05-08 17:47:16",
"updatedAt": "2026-05-09 09:52:14",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-08 17:47:16",
"generatedAtLocal": "2026-05-08 17:47:16",
"generatedAt": "2026-05-09 09:52:14",
"generatedAtLocal": "2026-05-09 09:52:14",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-08 17:47:16",
"updatedAt": "2026-05-09 09:52:14",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-08 17:47:16",
"generatedAtLocal": "2026-05-08 17:47:16",
"generatedAt": "2026-05-09 09:52:14",
"generatedAtLocal": "2026-05-09 09:52:14",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-08 17:47:16",
"updatedAt": "2026-05-09 09:52:14",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-08 17:47:16",
"generatedAtLocal": "2026-05-08 17:47:16",
"generatedAt": "2026-05-09 09:52:14",
"generatedAtLocal": "2026-05-09 09:52:14",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-05-04 09:11:04",
"updatedAt": "2026-05-08 17:47:16",
"updatedAt": "2026-05-09 09:52:14",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-08 17:47:16",
"generatedAtLocal": "2026-05-08 17:47:16",
"generatedAt": "2026-05-09 09:52:14",
"generatedAtLocal": "2026-05-09 09:52:14",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-08 17:47:16",
"updatedAt": "2026-05-09 09:52:14",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-08 17:47:16",
"generatedAtLocal": "2026-05-08 17:47:16",
"generatedAt": "2026-05-09 09:52:14",
"generatedAtLocal": "2026-05-09 09:52:14",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-08 17:47:16",
"updatedAt": "2026-05-09 09:52:14",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-08 17:47:16",
"generatedAtLocal": "2026-05-08 17:47:16",
"generatedAt": "2026-05-09 09:52:14",
"generatedAtLocal": "2026-05-09 09:52:14",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-08 17:47:16",
"updatedAt": "2026-05-09 09:52:14",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-08 17:47:16",
"generatedAtLocal": "2026-05-08 17:47:16",
"generatedAt": "2026-05-09 09:52:14",
"generatedAtLocal": "2026-05-09 09:52:14",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-08 17:47:16",
"updatedAt": "2026-05-09 09:52:14",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-08 17:47:16",
"generatedAtLocal": "2026-05-08 17:47:16",
"generatedAt": "2026-05-09 09:52:14",
"generatedAtLocal": "2026-05-09 09:52:14",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-08 17:47:16",
"updatedAt": "2026-05-09 09:52:14",
"deletedAt": null,
"restoredAt": "2026-04-17 19:16:50"
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-08 17:47:16",
"generatedAtLocal": "2026-05-08 17:47:16",
"generatedAt": "2026-05-09 09:52:14",
"generatedAtLocal": "2026-05-09 09:52:14",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-08 17:47:16",
"updatedAt": "2026-05-09 09:52:14",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-08 17:47:16",
"generatedAtLocal": "2026-05-08 17:47:16",
"generatedAt": "2026-05-09 09:52:14",
"generatedAtLocal": "2026-05-09 09:52:14",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-08 17:47:16",
"updatedAt": "2026-05-09 09:52:14",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-08 17:47:16",
"generatedAtLocal": "2026-05-08 17:47:16",
"generatedAt": "2026-05-09 09:52:14",
"generatedAtLocal": "2026-05-09 09:52:14",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-08 17:47:16",
"updatedAt": "2026-05-09 09:52:14",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-08 17:47:16",
"generatedAtLocal": "2026-05-08 17:47:16",
"generatedAt": "2026-05-09 09:52:14",
"generatedAtLocal": "2026-05-09 09:52:14",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-08 17:47:16",
"updatedAt": "2026-05-09 09:52:14",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-08 17:47:16",
"generatedAtLocal": "2026-05-08 17:47:16",
"generatedAt": "2026-05-09 09:52:14",
"generatedAtLocal": "2026-05-09 09:52:14",
"source": "remote",
"filter": {
"platform": {

View File

@ -1 +1,82 @@
{}
{
"generatedAt": "2026-05-09 09:52:14",
"generatedAtLocal": "2026-05-09 09:52:14",
"source": "remote",
"filter": {
"platform": {
"value": "web",
"label": "网页端"
},
"project": {
"value": "all",
"label": "全部"
}
},
"summary": {
"moduleAdded": 1,
"moduleDeleted": 0,
"interfaceAdded": 3,
"interfaceDeleted": 1,
"interfaceParamsUpdated": 2,
"interfaceResponseUpdated": 2,
"totalChangedItems": 9
},
"interfaceUpdates": {
"added": [
{
"moduleName": "order.wave",
"moduleKey": "order",
"folder": "order",
"method": "order.wave.batchList"
},
{
"moduleName": "订单波次模块",
"moduleKey": "order.wave",
"folder": "order.wave",
"method": "order.wave.wavePickTaskCancel"
},
{
"moduleName": "订单波次模块",
"moduleKey": "order.wave",
"folder": "order.wave",
"method": "order.wave.wavePickTaskList"
}
],
"deleted": [
{
"moduleName": "订单波次模块",
"moduleKey": "order.wave",
"folder": "order.wave",
"method": "order.wave.batchList"
}
],
"paramsUpdated": [
{
"moduleName": "订单波次模块",
"moduleKey": "order.wave",
"folder": "order.wave",
"method": "order.wave.waveStrategyFetchAdmin"
},
{
"moduleName": "订单波次模块",
"moduleKey": "order.wave",
"folder": "order.wave",
"method": "order.wave.waveStrategyFetchPda"
}
],
"responseUpdated": [
{
"moduleName": "订单波次模块",
"moduleKey": "order.wave",
"folder": "order.wave",
"method": "order.wave.waveStrategyFetchAdmin"
},
{
"moduleName": "订单波次模块",
"moduleKey": "order.wave",
"folder": "order.wave",
"method": "order.wave.waveStrategyFetchPda"
}
]
}
}