diff --git a/admin-frontend-vue/src/pages/asin/QueryAsinPage.vue b/admin-frontend-vue/src/pages/asin/QueryAsinPage.vue index 0c929943..6658bc3c 100644 --- a/admin-frontend-vue/src/pages/asin/QueryAsinPage.vue +++ b/admin-frontend-vue/src/pages/asin/QueryAsinPage.vue @@ -8,6 +8,7 @@ import { createQueryAsin, fetchQueryAsinList, fetchShopNamesByGroup } from './qu import { QUERY_ASIN_COUNTRIES, queryAsinDisplayRows, type QueryAsinItem } from './query-asin-model.ts' import { asinCountryLabel } from './asin-country.ts' import { createQueryAsinFilterState, type QueryAsinFilterState } from './query-asin-filter.ts' +import { toQueryAsinExportUrl } from './query-asin-export.ts' import { deleteQueryAsinCountryAsin, updateQueryAsinCountryAsin } from './query-asin-detail-api.ts' import { fetchQueryAsinImportProgress, startQueryAsinImport } from './query-asin-import-api.ts' import { fetchQueryAsinDeleteImportProgress, startQueryAsinDeleteImport } from './query-asin-delete-import-api.ts' @@ -263,8 +264,9 @@ async function submitImport(): Promise { // ---- 导出 ---- function doExport(): void { + // 带当前筛选(分组/店铺名/ASIN/国家)导出,范围与列表筛选一致(此前不带参数导致导出恒为全量)。 const anchor = document.createElement('a') - anchor.href = '/api/admin/query-asins/export' + anchor.href = toQueryAsinExportUrl(filter) document.body.appendChild(anchor) anchor.click() anchor.remove() diff --git a/admin-frontend-vue/src/pages/asin/query-asin-delete-import-api.ts b/admin-frontend-vue/src/pages/asin/query-asin-delete-import-api.ts index 3971903f..d7907d43 100644 --- a/admin-frontend-vue/src/pages/asin/query-asin-delete-import-api.ts +++ b/admin-frontend-vue/src/pages/asin/query-asin-delete-import-api.ts @@ -8,7 +8,9 @@ import { export const QUERY_ASIN_DELETE_IMPORT_ENDPOINT = '/api/admin/query-asins/delete-import' -/** 启动导入删除;groupId 为 Excel 未提供分组时的兜底,可选(>=1 才下发)。 */ +/** 启动导入删除;groupId 为 Excel 未提供分组时的兜底,可选(>=1 才下发)。 + * 注意:后端 deleteImportExcel 仍是隐式 camel 参数名(groupId),此处必须发 groupId; + * 与 import 的 group_id 不同源,后端统一为 snake 时需两端同步改。 */ export async function startQueryAsinDeleteImport(file: File, groupId?: number): Promise { const form = new FormData() form.append('file', file, file.name) diff --git a/admin-frontend-vue/src/pages/asin/query-asin-export.ts b/admin-frontend-vue/src/pages/asin/query-asin-export.ts new file mode 100644 index 00000000..43e28b21 --- /dev/null +++ b/admin-frontend-vue/src/pages/asin/query-asin-export.ts @@ -0,0 +1,24 @@ +/** 查询 ASIN 导出 URL 构建:按当前筛选下发 group_id/shop_name/asin/country(对齐 Java export @RequestParam snake_case)。 */ +import { normalizeQueryAsinCountry, type QueryAsinFilterState } from './query-asin-filter.ts' + +export const QUERY_ASIN_EXPORT_ENDPOINT = '/api/admin/query-asins/export' + +/** 按导出可用筛选(分组/店铺名/ASIN/国家)构建查询串;空白/非法条件不下发,避免导出范围被误解。 */ +export function buildQueryAsinExportQuery(state: QueryAsinFilterState): string { + const params = new URLSearchParams() + const groupId = state.groupId + if (typeof groupId === 'number' && groupId >= 1) params.set('group_id', String(Math.floor(groupId))) + const shopName = (state.shopName || '').trim() + if (shopName) params.set('shop_name', shopName) + const asin = (state.asin || '').trim() + if (asin) params.set('asin', asin) + const country = normalizeQueryAsinCountry(state.country) + if (country) params.set('country', country) + return params.toString() +} + +/** 导出下载地址:浏览器直接访问该 URL 触发流式下载;无筛选时为全量导出。 */ +export function toQueryAsinExportUrl(state: QueryAsinFilterState): string { + const query = buildQueryAsinExportQuery(state) + return query ? `${QUERY_ASIN_EXPORT_ENDPOINT}?${query}` : QUERY_ASIN_EXPORT_ENDPOINT +} diff --git a/admin-frontend-vue/src/pages/asin/query-asin-filter.ts b/admin-frontend-vue/src/pages/asin/query-asin-filter.ts index f2b3d2fb..f95bcc60 100644 --- a/admin-frontend-vue/src/pages/asin/query-asin-filter.ts +++ b/admin-frontend-vue/src/pages/asin/query-asin-filter.ts @@ -1,4 +1,5 @@ -/** 查询 ASIN 页面筛选/分页状态(任务 71):分组/店铺名/ASIN/国家,仅下发非空且受支持的条件;Java 参数名 camelCase。 */ +/** 查询 ASIN 页面筛选/分页状态(任务 71):分组/店铺名/ASIN/国家,仅下发非空且受支持的条件; + * Java 参数名 snake_case(与 asin-filter 共享契约一致):page_size/group_id/shop_name,裸 camel 后端收不到会导致筛选失效。 */ import { ASIN_PAGE_DEFAULT_SIZE } from './asin-filter.ts' import { QUERY_ASIN_COUNTRIES } from './query-asin-model.ts' @@ -24,9 +25,9 @@ export interface QueryAsinListParams { export interface QueryAsinQuery { page: number - pageSize: number - groupId?: number - shopName?: string + page_size: number + group_id?: number + shop_name?: string asin?: string country?: string } @@ -92,11 +93,11 @@ export function toQueryAsinParams( }) } -/** 前端查询参数 → Java 查询参数;与 QueryAsinController @RequestParam(camel) 对齐,仅下发非空字段。 */ +/** 前端查询参数 → Java 查询参数;与 QueryAsinController @RequestParam(snake_case: page_size/group_id/shop_name/asin/country) 对齐,仅下发非空字段。 */ export function toQueryAsinQuery(params: QueryAsinListParams): QueryAsinQuery { - const query: QueryAsinQuery = { page: params.page, pageSize: params.pageSize } - if (typeof params.groupId === 'number' && params.groupId >= 1) query.groupId = params.groupId - if (params.shopName) query.shopName = params.shopName + const query: QueryAsinQuery = { page: params.page, page_size: params.pageSize } + if (typeof params.groupId === 'number' && params.groupId >= 1) query.group_id = params.groupId + if (params.shopName) query.shop_name = params.shopName if (params.asin) query.asin = params.asin if (params.country) query.country = params.country return query diff --git a/admin-frontend-vue/src/pages/asin/query-asin-import-api.ts b/admin-frontend-vue/src/pages/asin/query-asin-import-api.ts index 643c8e78..b6c59f67 100644 --- a/admin-frontend-vue/src/pages/asin/query-asin-import-api.ts +++ b/admin-frontend-vue/src/pages/asin/query-asin-import-api.ts @@ -8,12 +8,13 @@ import { export const QUERY_ASIN_IMPORT_ENDPOINT = '/api/admin/query-asins/import' -/** 启动导入添加;groupId 为 Excel 未提供分组时的兜底,可选(>=1 才下发)。 */ +/** 启动导入添加;groupId 为 Excel 未提供分组时的兜底,可选(>=1 才下发)。 + * 参数名必须用 group_id:Java importExcel @RequestParam(name="group_id"),发 groupId 会被丢弃致兜底分组失效。 */ export async function startQueryAsinImport(file: File, groupId?: number): Promise { const form = new FormData() form.append('file', file, file.name) if (typeof groupId === 'number' && Number.isFinite(groupId) && groupId >= 1) { - form.append('groupId', String(Math.floor(groupId))) + form.append('group_id', String(Math.floor(groupId))) } const { data } = await http.post(QUERY_ASIN_IMPORT_ENDPOINT, form) return parseQueryAsinImportStart(data) diff --git a/admin-frontend-vue/tests/task-71.test.ts b/admin-frontend-vue/tests/task-71.test.ts index 429102e9..bb233326 100644 --- a/admin-frontend-vue/tests/task-71.test.ts +++ b/admin-frontend-vue/tests/task-71.test.ts @@ -15,6 +15,7 @@ import { toQueryAsinParams, toQueryAsinQuery, } from '../src/pages/asin/query-asin-filter.ts' +import { buildQueryAsinExportQuery, toQueryAsinExportUrl } from '../src/pages/asin/query-asin-export.ts' test('test_task_071_query_asin_list_normal_primary_path', () => { // 正常主路径:Java QueryAsinPageVo(camel) 宽行(每店铺 5 国家 ASIN)解析为前端分页结果。 @@ -115,24 +116,26 @@ test('test_task_071_query_asin_list_boundary_limit_or_missing_field', () => { 999, )) assert.equal(query.page, 1) - assert.equal(query.pageSize, 100) - assert.equal('groupId' in query, false, '分组 0 不应下发') - assert.equal('shopName' in query, false, '空白店铺名不应下发') + assert.equal(query.page_size, 100) + assert.equal('group_id' in query, false, '分组 0 不应下发') + assert.equal('shop_name' in query, false, '空白店铺名不应下发') assert.equal('asin' in query, false) assert.equal('country' in query, false, '不支持的国家码不应下发') - // 正常非空值仍以 Java camelCase 参数名下发。 + // 正常非空值以 Java snake_case 参数名下发(QueryAsinController @RequestParam(page_size/group_id/shop_name) 契约)。 const filled = toQueryAsinQuery(toQueryAsinParams( { groupId: 5, shopName: ' 蓝店 ', asin: 'B0X', country: 'de' }, 3, 25, )) assert.equal(filled.page, 3) - assert.equal(filled.pageSize, 25) - assert.equal(filled.groupId, 5) - assert.equal(filled.shopName, '蓝店') + assert.equal(filled.page_size, 25) + assert.equal(filled.group_id, 5) + assert.equal(filled.shop_name, '蓝店') assert.equal(filled.asin, 'B0X') assert.equal(filled.country, 'DE') - assert.equal('page_size' in (filled as Record), false, '不应下发 page_size(snake)') + assert.equal('pageSize' in (filled as Record), false, '不应下发 pageSize(camel):后端收不到会导致筛选/分页失效') + assert.equal('groupId' in (filled as Record), false, '不应下发 groupId(camel)') + assert.equal('shopName' in (filled as Record), false, '不应下发 shopName(camel)') }) test('test_task_071_query_asin_country_semantics', () => { @@ -174,3 +177,16 @@ test('test_task_071_query_asin_list_dependency_failure_returns_actionable_messag const model = readSource('src/pages/asin/query-asin-model.ts') assert.equal(/axios|http\./.test(model), false, '查询 ASIN 列表解析保持纯逻辑') }) + +test('test_task_071_query_asin_export_url_follows_filter', () => { + // 导出 URL 跟随当前筛选:非空条件以 snake 参数下发(后端 export @RequestParam 契约),空白/非法条件与无筛选时退回全量。 + const url = toQueryAsinExportUrl({ groupId: 5, shopName: ' 蓝店 ', asin: ' B0X ', country: 'de' }) + assert.equal(url.startsWith('/api/admin/query-asins/export?'), true) + const params = new URLSearchParams(url.split('?')[1]) + assert.equal(params.get('group_id'), '5') + assert.equal(params.get('shop_name'), '蓝店') + assert.equal(params.get('asin'), 'B0X') + assert.equal(params.get('country'), 'DE') + assert.equal(buildQueryAsinExportQuery({ groupId: 0, shopName: ' ', asin: '', country: 'XX' }), '', '空白/非法条件不下发') + assert.equal(toQueryAsinExportUrl({ groupId: null, shopName: '', asin: '', country: '' }), '/api/admin/query-asins/export', '无筛选即全量导出') +})