diff --git a/build/build.js b/build/build.js index 8f2ad8a..f6d4840 100644 --- a/build/build.js +++ b/build/build.js @@ -2,7 +2,6 @@ require('./check-versions')() process.env.NODE_ENV = 'production' - const ora = require('ora') const rm = require('rimraf') const path = require('path') @@ -10,10 +9,8 @@ const chalk = require('chalk') const webpack = require('webpack') const config = require('../config') const webpackConfig = require('./webpack.prod.conf') - const spinner = ora('building for production...') spinner.start() - rm(path.join(config.build.assetsRoot, config.build.assetsSubDirectory), err => { if (err) throw err webpack(webpackConfig, (err, stats) => { diff --git a/build/utils.js b/build/utils.js index e534fb0..822d454 100644 --- a/build/utils.js +++ b/build/utils.js @@ -8,7 +8,6 @@ exports.assetsPath = function (_path) { const assetsSubDirectory = process.env.NODE_ENV === 'production' ? config.build.assetsSubDirectory : config.dev.assetsSubDirectory - return path.posix.join(assetsSubDirectory, _path) } diff --git a/git-bash.exe b/git-bash.exe new file mode 100644 index 0000000..58d9bcf Binary files /dev/null and b/git-bash.exe differ diff --git a/src/api/brand.js b/src/api/brand.js index 8b622e5..e79e2a2 100644 --- a/src/api/brand.js +++ b/src/api/brand.js @@ -1,54 +1,70 @@ +// 引入自定义的请求工具模块 import request from '@/utils/request' + +// 获取品牌列表 export function fetchList(params) { + // 调用请求方法,发送GET请求到 '/brand/list',并将参数作为请求的查询参数 return request({ - url:'/brand/list', - method:'get', - params:params + url: '/brand/list', // 请求的API接口地址 + method: 'get', // 请求方法:GET + params: params // 请求参数,将被附加到URL的查询字符串中 }) } -//dwj1111111 + +// 创建新品牌 export function createBrand(data) { + // 调用请求方法,发送POST请求到 '/brand/create',请求体包含品牌数据 return request({ - url:'/brand/create', - method:'post', - data:data + url: '/brand/create', // 请求的API接口地址 + method: 'post', // 请求方法:POST + data: data // 请求体数据,包含品牌的详细信息 }) } + +// 更新品牌的展示状态 export function updateShowStatus(data) { + // 调用请求方法,发送POST请求到 '/brand/update/showStatus',请求体包含展示状态的更新数据 return request({ - url:'/brand/update/showStatus', - method:'post', - data:data + url: '/brand/update/showStatus', // 请求的API接口地址 + method: 'post', // 请求方法:POST + data: data // 请求体数据,包含要更新的展示状态信息 }) } +// 更新品牌的工厂状态 export function updateFactoryStatus(data) { + // 调用请求方法,发送POST请求到 '/brand/update/factoryStatus',请求体包含工厂状态的更新数据 return request({ - url:'/brand/update/factoryStatus', - method:'post', - data:data + url: '/brand/update/factoryStatus', // 请求的API接口地址 + method: 'post', // 请求方法:POST + data: data // 请求体数据,包含要更新的工厂状态信息 }) } +// 删除品牌 export function deleteBrand(id) { + // 调用请求方法,发送GET请求到 '/brand/delete/{id}',{id}为品牌的唯一标识 return request({ - url:'/brand/delete/'+id, - method:'get', + url: '/brand/delete/' + id, // 请求的API接口地址,{id}动态插入 + method: 'get', // 请求方法:GET }) } +// 获取单个品牌的详细信息 export function getBrand(id) { + // 调用请求方法,发送GET请求到 '/brand/{id}',{id}为品牌唯一标识 return request({ - url:'/brand/'+id, - method:'get', + url: '/brand/' + id, // 请求的API接口地址,{id}动态插入 + method: 'get', // 请求方法:GET }) } -export function updateBrand(id,data) { +// 更新品牌的详细信息 +export function updateBrand(id, data) { + // 调用请求方法,发送POST请求到 '/brand/update/{id}',请求体包含品牌的更新数据 return request({ - url:'/brand/update/'+id, - method:'post', - data:data + url: '/brand/update/' + id, // 请求的API接口地址,{id}动态插入 + method: 'post', // 请求方法:POST + data: data // 请求体数据,包含要更新的品牌详细信息 }) } - diff --git a/src/api/companyAddress.js b/src/api/companyAddress.js index a046ad2..ce41988 100644 --- a/src/api/companyAddress.js +++ b/src/api/companyAddress.js @@ -1,7 +1,27 @@ +// 导入封装好的请求工具,用于发起HTTP请求 import request from '@/utils/request' + +/** + * fetchList - 获取公司地址列表数据的函数 + * + * 该函数通过发送一个 GET 请求到指定的后端接口, + * 以获取公司地址列表数据。数据返回后,可以用于前端页面渲染。 + * + * @returns {Promise} - 返回一个Promise对象,包含接口返回的数据 + * + * 用法示例: + * fetchList().then(response => { + * console.log(response); // 处理接口返回的数据 + * }).catch(error => { + * console.error(error); // 处理错误 + * }); + */ export function fetchList() { return request({ - url:'/companyAddress/list', - method:'get' + // 接口的URL路径,指向公司地址列表的后端接口 + url: '/companyAddress/list', + + // 请求方法:使用 HTTP GET 方法获取数据 + method: 'get' }) } diff --git a/src/api/coupon.js b/src/api/coupon.js index 7253ea7..fdfacbf 100644 --- a/src/api/coupon.js +++ b/src/api/coupon.js @@ -1,38 +1,106 @@ +// 导入封装的 HTTP 请求工具,用于与后端接口通信 import request from '@/utils/request' + +/** + * fetchList - 获取优惠券列表 + * + * 该函数通过 GET 请求获取优惠券列表,并支持通过参数进行查询筛选。 + * + * @param {Object} params - 查询参数,例如分页、筛选条件等。 + * @returns {Promise} - 返回一个Promise对象,包含接口返回的数据 + * + * 用法示例: + * fetchList({ pageNum: 1, pageSize: 10 }).then(response => { + * console.log(response); + * }); + */ export function fetchList(params) { return request({ - url:'/coupon/list', - method:'get', - params:params + url: '/coupon/list', // 接口URL路径:获取优惠券列表 + method: 'get', // 请求方法:GET + params: params // 查询参数,通过URL参数传递 }) } +/** + * createCoupon - 创建新的优惠券 + * + * 该函数通过 POST 请求向后端提交新优惠券的数据。 + * + * @param {Object} data - 优惠券的详细数据,包含名称、折扣等字段。 + * @returns {Promise} - 返回一个Promise对象,包含接口返回的数据 + * + * 用法示例: + * createCoupon({ name: 'Spring Sale', discount: 20 }).then(response => { + * console.log(response); + * }); + */ export function createCoupon(data) { return request({ - url:'/coupon/create', - method:'post', - data:data + url: '/coupon/create', // 接口URL路径:创建优惠券 + method: 'post', // 请求方法:POST + data: data // 请求体,包含优惠券数据 }) } +/** + * getCoupon - 获取单个优惠券的详情 + * + * 该函数通过 GET 请求获取指定ID的优惠券详细信息。 + * + * @param {number|string} id - 优惠券的唯一标识ID。 + * @returns {Promise} - 返回一个Promise对象,包含优惠券的详细数据 + * + * 用法示例: + * getCoupon(1).then(response => { + * console.log(response); + * }); + */ export function getCoupon(id) { return request({ - url:'/coupon/'+id, - method:'get', + url: '/coupon/' + id, // 接口URL路径:根据ID获取优惠券详情 + method: 'get' // 请求方法:GET }) } -export function updateCoupon(id,data) { +/** + * updateCoupon - 更新指定优惠券的信息 + * + * 该函数通过 POST 请求提交修改后的优惠券数据,更新指定ID的优惠券。 + * + * @param {number|string} id - 优惠券的唯一标识ID。 + * @param {Object} data - 修改后的优惠券数据。 + * @returns {Promise} - 返回一个Promise对象,包含操作结果 + * + * 用法示例: + * updateCoupon(1, { name: 'Updated Sale', discount: 25 }).then(response => { + * console.log(response); + * }); + */ +export function updateCoupon(id, data) { return request({ - url:'/coupon/update/'+id, - method:'post', - data:data + url: '/coupon/update/' + id, // 接口URL路径:更新指定ID的优惠券 + method: 'post', // 请求方法:POST + data: data // 请求体,包含修改后的数据 }) } +/** + * deleteCoupon - 删除指定优惠券 + * + * 该函数通过 POST 请求删除指定ID的优惠券。 + * + * @param {number|string} id - 优惠券的唯一标识ID。 + * @returns {Promise} - 返回一个Promise对象,包含操作结果 + * + * 用法示例: + * deleteCoupon(1).then(response => { + * console.log(response); + * }); + */ export function deleteCoupon(id) { return request({ - url:'/coupon/delete/'+id, - method:'post', + url: '/coupon/delete/' + id, // 接口URL路径:删除指定ID的优惠券 + method: 'post' // 请求方法:POST }) } diff --git a/src/api/couponHistory.js b/src/api/couponHistory.js index 278a410..1a498b1 100644 --- a/src/api/couponHistory.js +++ b/src/api/couponHistory.js @@ -1,8 +1,27 @@ +// 导入封装的 HTTP 请求工具,用于发送 HTTP 请求 import request from '@/utils/request' + +/** + * fetchList - 获取优惠券历史记录列表 + * + * 该函数通过 GET 请求获取优惠券使用历史的记录列表。 + * 可以通过传入查询参数(如分页、筛选条件等)来筛选数据。 + * + * @param {Object} params - 查询参数,包括分页信息、筛选条件等。 + * 示例参数:{ pageNum: 1, pageSize: 10, couponId: 1001 } + * @returns {Promise} - 返回一个 Promise 对象,包含接口返回的数据。 + * + * 用法示例: + * fetchList({ pageNum: 1, pageSize: 10 }).then(response => { + * console.log(response); // 处理接口返回的数据 + * }).catch(error => { + * console.error('获取数据失败:', error); // 处理请求错误 + * }); + */ export function fetchList(params) { return request({ - url:'/couponHistory/list', - method:'get', - params:params + url: '/couponHistory/list', // 接口URL路径:获取优惠券历史记录列表 + method: 'get', // 请求方法:GET + params: params // 查询参数,通过 URL 参数传递 }) } diff --git a/src/api/flash.js b/src/api/flash.js index 52d499d..17685bc 100644 --- a/src/api/flash.js +++ b/src/api/flash.js @@ -1,35 +1,109 @@ +// 导入封装的 HTTP 请求工具,用于发送 HTTP 请求 import request from '@/utils/request' + +/** + * fetchList - 获取限时购活动列表 + * + * 该函数通过 GET 请求获取限时购活动的列表数据,并支持通过参数进行查询筛选。 + * + * @param {Object} params - 查询参数,例如分页、筛选条件等。 + * 示例:{ pageNum: 1, pageSize: 10 } + * @returns {Promise} - 返回一个 Promise 对象,包含接口返回的数据 + * + * 用法示例: + * fetchList({ pageNum: 1, pageSize: 10 }).then(response => { + * console.log(response); + * }); + */ export function fetchList(params) { return request({ - url:'/flash/list', - method:'get', - params:params + url: '/flash/list', // 接口URL:获取限时购活动列表 + method: 'get', // 请求方法:GET + params: params // 查询参数,通过 URL 查询字符串传递 }) } -export function updateStatus(id,params) { + +/** + * updateStatus - 更新限时购活动状态 + * + * 该函数通过 POST 请求更新指定限时购活动的状态。 + * + * @param {number|string} id - 限时购活动的唯一标识ID + * @param {Object} params - 状态更新参数,例如 { status: 1 } + * @returns {Promise} - 返回一个 Promise 对象,包含操作结果 + * + * 用法示例: + * updateStatus(1, { status: 1 }).then(response => { + * console.log(response); + * }); + */ +export function updateStatus(id, params) { return request({ - url:'/flash/update/status/'+id, - method:'post', - params:params + url: '/flash/update/status/' + id, // 接口URL:更新指定活动状态 + method: 'post', // 请求方法:POST + params: params // 状态参数,通过 URL 查询字符串传递 }) } + +/** + * deleteFlash - 删除指定的限时购活动 + * + * 该函数通过 POST 请求删除指定ID的限时购活动。 + * + * @param {number|string} id - 限时购活动的唯一标识ID + * @returns {Promise} - 返回一个 Promise 对象,包含操作结果 + * + * 用法示例: + * deleteFlash(1).then(response => { + * console.log(response); + * }); + */ export function deleteFlash(id) { return request({ - url:'/flash/delete/'+id, - method:'post' + url: '/flash/delete/' + id, // 接口URL:删除指定活动 + method: 'post' // 请求方法:POST }) } + +/** + * createFlash - 创建新的限时购活动 + * + * 该函数通过 POST 请求向后端提交新的限时购活动数据。 + * + * @param {Object} data - 活动的详细数据,例如 { name: 'Flash Sale', startTime: '2024-06-01' } + * @returns {Promise} - 返回一个 Promise 对象,包含创建结果 + * + * 用法示例: + * createFlash({ name: 'Summer Flash Sale', startTime: '2024-06-01' }).then(response => { + * console.log(response); + * }); + */ export function createFlash(data) { return request({ - url:'/flash/create', - method:'post', - data:data + url: '/flash/create', // 接口URL:创建限时购活动 + method: 'post', // 请求方法:POST + data: data // 请求体,包含活动的详细数据 }) } -export function updateFlash(id,data) { + +/** + * updateFlash - 更新指定的限时购活动 + * + * 该函数通过 POST 请求提交更新后的活动数据,更新指定ID的限时购活动。 + * + * @param {number|string} id - 限时购活动的唯一标识ID + * @param {Object} data - 更新后的活动数据 + * @returns {Promise} - 返回一个 Promise 对象,包含操作结果 + * + * 用法示例: + * updateFlash(1, { name: 'Updated Flash Sale', startTime: '2024-06-15' }).then(response => { + * console.log(response); + * }); + */ +export function updateFlash(id, data) { return request({ - url:'/flash/update/'+id, - method:'post', - data:data + url: '/flash/update/' + id, // 接口URL:更新指定ID的活动 + method: 'post', // 请求方法:POST + data: data // 请求体,包含更新后的活动数据 }) } diff --git a/src/api/flashProductRelation.js b/src/api/flashProductRelation.js index 0e739d5..199dd9d 100644 --- a/src/api/flashProductRelation.js +++ b/src/api/flashProductRelation.js @@ -1,28 +1,88 @@ +// 导入封装的 HTTP 请求工具,用于与后端 API 进行通信 import request from '@/utils/request' + +/** + * fetchList - 获取限时购商品关联列表 + * + * 该函数通过 GET 请求获取限时购活动与商品的关联列表, + * 支持通过查询参数进行筛选和分页。 + * + * @param {Object} params - 查询参数,例如分页和过滤条件。 + * 示例:{ flashId: 1, pageNum: 1, pageSize: 10 } + * @returns {Promise} - 返回一个 Promise 对象,包含接口返回的数据。 + * + * 用法示例: + * fetchList({ flashId: 1, pageNum: 1, pageSize: 10 }).then(response => { + * console.log(response); + * }); + */ export function fetchList(params) { return request({ - url:'/flashProductRelation/list', - method:'get', - params:params + url: '/flashProductRelation/list', // 接口URL:获取关联列表 + method: 'get', // 请求方法:GET + params: params // 查询参数,通过 URL 传递 }) } + +/** + * createFlashProductRelation - 创建新的限时购商品关联 + * + * 该函数通过 POST 请求提交限时购活动与商品的关联数据。 + * + * @param {Object} data - 关联数据,例如 { flashId: 1, productId: 100, sort: 1 } + * @returns {Promise} - 返回一个 Promise 对象,包含操作结果。 + * + * 用法示例: + * createFlashProductRelation({ flashId: 1, productId: 100, sort: 1 }).then(response => { + * console.log(response); + * }); + */ export function createFlashProductRelation(data) { return request({ - url:'/flashProductRelation/create', - method:'post', - data:data + url: '/flashProductRelation/create', // 接口URL:创建关联 + method: 'post', // 请求方法:POST + data: data // 请求体,包含关联数据 }) } + +/** + * deleteFlashProductRelation - 删除指定的限时购商品关联 + * + * 该函数通过 POST 请求删除指定 ID 的限时购商品关联数据。 + * + * @param {number|string} id - 限时购商品关联的唯一标识 ID。 + * @returns {Promise} - 返回一个 Promise 对象,包含操作结果。 + * + * 用法示例: + * deleteFlashProductRelation(1).then(response => { + * console.log(response); + * }); + */ export function deleteFlashProductRelation(id) { return request({ - url:'/flashProductRelation/delete/'+id, - method:'post' + url: '/flashProductRelation/delete/' + id, // 接口URL:删除关联 + method: 'post' // 请求方法:POST }) } -export function updateFlashProductRelation(id,data) { + +/** + * updateFlashProductRelation - 更新指定的限时购商品关联数据 + * + * 该函数通过 POST 请求提交更新后的限时购商品关联数据。 + * + * @param {number|string} id - 限时购商品关联的唯一标识 ID。 + * @param {Object} data - 更新后的关联数据,例如 { sort: 2 } + * @returns {Promise} - 返回一个 Promise 对象,包含操作结果。 + * + * 用法示例: + * updateFlashProductRelation(1, { sort: 2 }).then(response => { + * console.log(response); + * }); + */ +export function updateFlashProductRelation(id, data) { return request({ - url:'/flashProductRelation/update/'+id, - method:'post', - data:data + url: '/flashProductRelation/update/' + id, // 接口URL:更新关联 + method: 'post', // 请求方法:POST + data: data // 请求体,包含更新数据 }) } diff --git a/src/api/flashSession.js b/src/api/flashSession.js index 2349f89..1ec29bb 100644 --- a/src/api/flashSession.js +++ b/src/api/flashSession.js @@ -1,48 +1,131 @@ +// 导入封装的 HTTP 请求工具,用于与后端 API 进行通信 import request from '@/utils/request' +/** + * fetchList - 获取限时购场次列表 + * + * 通过 GET 请求获取限时购场次的列表数据,支持查询参数筛选结果。 + * + * @param {Object} params - 查询参数,例如分页信息等。 + * 示例:{ pageNum: 1, pageSize: 10 } + * @returns {Promise} - 返回一个 Promise 对象,包含接口返回的数据。 + * + * 用法示例: + * fetchList({ pageNum: 1, pageSize: 10 }).then(response => { + * console.log(response); + * }); + */ export function fetchList(params) { return request({ - url: '/flashSession/list', - method: 'get', - params: params + url: '/flashSession/list', // 接口URL:获取限时购场次列表 + method: 'get', // 请求方法:GET + params: params // 查询参数,通过 URL 传递 }) } +/** + * fetchSelectList - 获取可选择的限时购场次列表 + * + * 通过 GET 请求获取简化版的限时购场次数据,用于下拉选择框等场景。 + * + * @param {Object} params - 查询参数,例如过滤条件等。 + * 示例:{ flashId: 1 } + * @returns {Promise} - 返回一个 Promise 对象,包含接口返回的数据。 + * + * 用法示例: + * fetchSelectList({ flashId: 1 }).then(response => { + * console.log(response); + * }); + */ export function fetchSelectList(params) { return request({ - url: '/flashSession/selectList', - method: 'get', - params: params + url: '/flashSession/selectList', // 接口URL:获取可选的场次列表 + method: 'get', // 请求方法:GET + params: params // 查询参数 }) } +/** + * updateStatus - 更新指定场次的状态 + * + * 通过 POST 请求更新场次的状态,例如启用或禁用状态。 + * + * @param {number|string} id - 限时购场次的唯一标识ID。 + * @param {Object} params - 状态参数,例如 { status: 1 }。 + * @returns {Promise} - 返回一个 Promise 对象,包含操作结果。 + * + * 用法示例: + * updateStatus(1, { status: 1 }).then(response => { + * console.log(response); + * }); + */ export function updateStatus(id, params) { return request({ - url: '/flashSession/update/status/' + id, - method: 'post', - params: params + url: '/flashSession/update/status/' + id, // 接口URL:更新场次状态 + method: 'post', // 请求方法:POST + params: params // 状态参数,通过 URL 查询字符串传递 }) } +/** + * deleteSession - 删除指定的限时购场次 + * + * 通过 POST 请求删除指定 ID 的限时购场次。 + * + * @param {number|string} id - 限时购场次的唯一标识ID。 + * @returns {Promise} - 返回一个 Promise 对象,包含操作结果。 + * + * 用法示例: + * deleteSession(1).then(response => { + * console.log(response); + * }); + */ export function deleteSession(id) { return request({ - url: '/flashSession/delete/' + id, - method: 'post' + url: '/flashSession/delete/' + id, // 接口URL:删除场次 + method: 'post' // 请求方法:POST }) } +/** + * createSession - 创建新的限时购场次 + * + * 通过 POST 请求提交新的场次数据,创建限时购场次。 + * + * @param {Object} data - 场次的详细数据,例如 { name: '上午场', startTime: '08:00', endTime: '12:00' }。 + * @returns {Promise} - 返回一个 Promise 对象,包含操作结果。 + * + * 用法示例: + * createSession({ name: '上午场', startTime: '08:00', endTime: '12:00' }).then(response => { + * console.log(response); + * }); + */ export function createSession(data) { return request({ - url: '/flashSession/create', - method: 'post', - data: data + url: '/flashSession/create', // 接口URL:创建场次 + method: 'post', // 请求方法:POST + data: data // 请求体,包含场次数据 }) } +/** + * updateSession - 更新指定的限时购场次数据 + * + * 通过 POST 请求提交更新后的场次数据,更新指定 ID 的场次信息。 + * + * @param {number|string} id - 限时购场次的唯一标识ID。 + * @param {Object} data - 更新后的场次数据,例如 { name: '下午场', startTime: '13:00', endTime: '18:00' }。 + * @returns {Promise} - 返回一个 Promise 对象,包含操作结果。 + * + * 用法示例: + * updateSession(1, { name: '下午场', startTime: '13:00', endTime: '18:00' }).then(response => { + * console.log(response); + * }); + */ export function updateSession(id, data) { return request({ - url: '/flashSession/update/' + id, - method: 'post', - data: data + url: '/flashSession/update/' + id, // 接口URL:更新场次信息 + method: 'post', // 请求方法:POST + data: data // 请求体,包含更新数据 }) } diff --git a/src/api/homeAdvertise.js b/src/api/homeAdvertise.js index 6cc3a02..7307dfd 100644 --- a/src/api/homeAdvertise.js +++ b/src/api/homeAdvertise.js @@ -1,43 +1,130 @@ +// 导入封装的 HTTP 请求工具,用于与后端 API 进行通信 import request from '@/utils/request' + +/** + * fetchList - 获取首页广告列表 + * + * 通过 GET 请求获取首页广告列表,支持查询参数进行筛选或分页。 + * + * @param {Object} params - 查询参数,例如分页和过滤条件。 + * 示例:{ pageNum: 1, pageSize: 10 } + * @returns {Promise} - 返回一个 Promise 对象,包含接口返回的数据。 + * + * 用法示例: + * fetchList({ pageNum: 1, pageSize: 10 }).then(response => { + * console.log(response); + * }); + */ export function fetchList(params) { return request({ - url:'/home/advertise/list', - method:'get', - params:params + url: '/home/advertise/list', // 接口URL:获取首页广告列表 + method: 'get', // 请求方法:GET + params: params // 查询参数,通过 URL 传递 }) } -export function updateStatus(id,params) { + +/** + * updateStatus - 更新指定广告的状态 + * + * 通过 POST 请求更新首页广告的状态(启用/禁用)。 + * + * @param {number|string} id - 广告的唯一标识ID。 + * @param {Object} params - 状态参数,例如 { status: 1 }。 + * @returns {Promise} - 返回一个 Promise 对象,包含操作结果。 + * + * 用法示例: + * updateStatus(1, { status: 1 }).then(response => { + * console.log(response); + * }); + */ +export function updateStatus(id, params) { return request({ - url:'/home/advertise/update/status/'+id, - method:'post', - params:params + url: '/home/advertise/update/status/' + id, // 接口URL:更新广告状态 + method: 'post', // 请求方法:POST + params: params // 状态参数,通过 URL 查询字符串传递 }) } + +/** + * deleteHomeAdvertise - 批量删除首页广告 + * + * 通过 POST 请求删除多个广告记录。 + * + * @param {Array} data - 广告ID数组,例如 [1, 2, 3]。 + * @returns {Promise} - 返回一个 Promise 对象,包含操作结果。 + * + * 用法示例: + * deleteHomeAdvertise([1, 2, 3]).then(response => { + * console.log(response); + * }); + */ export function deleteHomeAdvertise(data) { return request({ - url:'/home/advertise/delete', - method:'post', - data:data + url: '/home/advertise/delete', // 接口URL:批量删除广告 + method: 'post', // 请求方法:POST + data: data // 请求体,包含广告ID数组 }) } + +/** + * createHomeAdvertise - 创建新的首页广告 + * + * 通过 POST 请求提交新的广告数据,创建首页广告。 + * + * @param {Object} data - 广告的详细数据,例如 { name: '新广告', type: 1, pic: 'url' }。 + * @returns {Promise} - 返回一个 Promise 对象,包含操作结果。 + * + * 用法示例: + * createHomeAdvertise({ name: '新广告', type: 1 }).then(response => { + * console.log(response); + * }); + */ export function createHomeAdvertise(data) { return request({ - url:'/home/advertise/create', - method:'post', - data:data + url: '/home/advertise/create', // 接口URL:创建广告 + method: 'post', // 请求方法:POST + data: data // 请求体,包含广告数据 }) } + +/** + * getHomeAdvertise - 获取指定广告详情 + * + * 通过 GET 请求获取单个广告的详细信息。 + * + * @param {number|string} id - 广告的唯一标识ID。 + * @returns {Promise} - 返回一个 Promise 对象,包含广告详情数据。 + * + * 用法示例: + * getHomeAdvertise(1).then(response => { + * console.log(response); + * }); + */ export function getHomeAdvertise(id) { return request({ - url:'/home/advertise/'+id, - method:'get', + url: '/home/advertise/' + id, // 接口URL:获取广告详情 + method: 'get' // 请求方法:GET }) } -export function updateHomeAdvertise(id,data) { +/** + * updateHomeAdvertise - 更新指定广告的信息 + * + * 通过 POST 请求提交更新后的广告数据,更新指定广告的信息。 + * + * @param {number|string} id - 广告的唯一标识ID。 + * @param {Object} data - 更新后的广告数据,例如 { name: '更新广告', type: 2 }。 + * @returns {Promise} - 返回一个 Promise 对象,包含操作结果。 + * + * 用法示例: + * updateHomeAdvertise(1, { name: '更新广告', type: 2 }).then(response => { + * console.log(response); + * }); + */ +export function updateHomeAdvertise(id, data) { return request({ - url:'/home/advertise/update/'+id, - method:'post', - data:data + url: '/home/advertise/update/' + id, // 接口URL:更新广告信息 + method: 'post', // 请求方法:POST + data: data // 请求体,包含更新后的广告数据 }) } diff --git a/src/api/homeBrand.js b/src/api/homeBrand.js index abd4452..c457562 100644 --- a/src/api/homeBrand.js +++ b/src/api/homeBrand.js @@ -1,40 +1,110 @@ +// 导入封装的 HTTP 请求工具,用于与后端 API 进行通信 import request from '@/utils/request' + +/** + * fetchList - 获取首页品牌列表 + * + * 通过 GET 请求获取首页品牌列表,支持分页和条件筛选。 + * + * @param {Object} params - 查询参数,例如分页和筛选条件。 + * 示例:{ pageNum: 1, pageSize: 10, keyword: '品牌名' } + * @returns {Promise} - 返回一个 Promise 对象,包含接口返回的数据。 + * + * 用法示例: + * fetchList({ pageNum: 1, pageSize: 10 }).then(response => { + * console.log(response); + * }); + */ export function fetchList(params) { return request({ - url:'/home/brand/list', - method:'get', - params:params + url: '/home/brand/list', // 接口URL:获取品牌列表 + method: 'get', // 请求方法:GET + params: params // 查询参数,通过 URL 传递 }) } +/** + * updateRecommendStatus - 批量更新品牌推荐状态 + * + * 通过 POST 请求批量更新品牌的推荐状态(如是否推荐)。 + * + * @param {Array} data - 推荐状态数据,包含品牌ID数组和推荐状态。 + * 示例:{ ids: [1, 2, 3], recommendStatus: 1 } + * @returns {Promise} - 返回一个 Promise 对象,包含操作结果。 + * + * 用法示例: + * updateRecommendStatus({ ids: [1, 2], recommendStatus: 1 }).then(response => { + * console.log(response); + * }); + */ export function updateRecommendStatus(data) { return request({ - url:'/home/brand/update/recommendStatus', - method:'post', - data:data + url: '/home/brand/update/recommendStatus', // 接口URL:更新推荐状态 + method: 'post', // 请求方法:POST + data: data // 请求体,包含品牌ID和状态 }) } +/** + * deleteHomeBrand - 批量删除首页品牌 + * + * 通过 POST 请求删除多个品牌记录。 + * + * @param {Array} data - 品牌ID数组,例如 [1, 2, 3]。 + * @returns {Promise} - 返回一个 Promise 对象,包含操作结果。 + * + * 用法示例: + * deleteHomeBrand([1, 2, 3]).then(response => { + * console.log(response); + * }); + */ export function deleteHomeBrand(data) { return request({ - url:'/home/brand/delete', - method:'post', - data:data + url: '/home/brand/delete', // 接口URL:批量删除品牌 + method: 'post', // 请求方法:POST + data: data // 请求体,包含品牌ID数组 }) } +/** + * createHomeBrand - 创建新的首页品牌 + * + * 通过 POST 请求提交新的品牌数据,创建首页品牌。 + * + * @param {Object} data - 品牌的详细数据,例如 { brandId: 1, brandName: '品牌名', sort: 0 }。 + * @returns {Promise} - 返回一个 Promise 对象,包含操作结果。 + * + * 用法示例: + * createHomeBrand({ brandId: 1, brandName: '新品牌', sort: 1 }).then(response => { + * console.log(response); + * }); + */ export function createHomeBrand(data) { return request({ - url:'/home/brand/create', - method:'post', - data:data + url: '/home/brand/create', // 接口URL:创建品牌 + method: 'post', // 请求方法:POST + data: data // 请求体,包含品牌数据 }) } +/** + * updateHomeBrandSort - 更新品牌的排序值 + * + * 通过 POST 请求更新指定品牌的排序值。 + * + * @param {Object} params - 排序参数,包含品牌ID和新的排序值。 + * 示例:{ id: 1, sort: 10 } + * @returns {Promise} - 返回一个 Promise 对象,包含操作结果。 + * + * 用法示例: + * updateHomeBrandSort({ id: 1, sort: 10 }).then(response => { + * console.log(response); + * }); + */ export function updateHomeBrandSort(params) { return request({ - url:'/home/brand/update/sort/'+params.id, - method:'post', - params:params + url: '/home/brand/update/sort/' + params.id, // 接口URL:更新品牌排序 + method: 'post', // 请求方法:POST + params: params // 排序参数,通过 URL 查询字符串传递 }) } diff --git a/src/api/homeSubject.js b/src/api/homeSubject.js index 7588922..c8e2efe 100644 --- a/src/api/homeSubject.js +++ b/src/api/homeSubject.js @@ -1,40 +1,110 @@ +// 导入封装的 HTTP 请求工具,用于与后端 API 进行通信 import request from '@/utils/request' + +/** + * fetchList - 获取首页推荐专题列表 + * + * 通过 GET 请求获取首页推荐专题列表,支持分页和条件筛选。 + * + * @param {Object} params - 查询参数,例如分页和筛选条件。 + * 示例:{ pageNum: 1, pageSize: 10, keyword: '专题名' } + * @returns {Promise} - 返回一个 Promise 对象,包含接口返回的数据。 + * + * 用法示例: + * fetchList({ pageNum: 1, pageSize: 10 }).then(response => { + * console.log(response); + * }); + */ export function fetchList(params) { return request({ - url:'/home/recommendSubject/list', - method:'get', - params:params + url: '/home/recommendSubject/list', // 接口URL:获取推荐专题列表 + method: 'get', // 请求方法:GET + params: params // 查询参数,通过 URL 传递 }) } +/** + * updateRecommendStatus - 批量更新推荐专题的推荐状态 + * + * 通过 POST 请求批量更新首页推荐专题的推荐状态。 + * + * @param {Object} data - 推荐状态数据,包含专题ID数组和推荐状态。 + * 示例:{ ids: [1, 2, 3], recommendStatus: 1 } + * @returns {Promise} - 返回一个 Promise 对象,包含操作结果。 + * + * 用法示例: + * updateRecommendStatus({ ids: [1, 2, 3], recommendStatus: 1 }).then(response => { + * console.log(response); + * }); + */ export function updateRecommendStatus(data) { return request({ - url:'/home/recommendSubject/update/recommendStatus', - method:'post', - data:data + url: '/home/recommendSubject/update/recommendStatus', // 接口URL:更新推荐状态 + method: 'post', // 请求方法:POST + data: data // 请求体,包含专题ID和推荐状态 }) } +/** + * deleteHomeSubject - 批量删除推荐专题 + * + * 通过 POST 请求删除多个推荐专题。 + * + * @param {Array} data - 专题ID数组,例如 [1, 2, 3]。 + * @returns {Promise} - 返回一个 Promise 对象,包含操作结果。 + * + * 用法示例: + * deleteHomeSubject([1, 2, 3]).then(response => { + * console.log(response); + * }); + */ export function deleteHomeSubject(data) { return request({ - url:'/home/recommendSubject/delete', - method:'post', - data:data + url: '/home/recommendSubject/delete', // 接口URL:批量删除专题 + method: 'post', // 请求方法:POST + data: data // 请求体,包含专题ID数组 }) } +/** + * createHomeSubject - 创建新的首页推荐专题 + * + * 通过 POST 请求提交新的专题数据,创建首页推荐专题。 + * + * @param {Object} data - 推荐专题的详细数据,例如 { subjectId: 1, subjectName: '专题名', sort: 0 }。 + * @returns {Promise} - 返回一个 Promise 对象,包含操作结果。 + * + * 用法示例: + * createHomeSubject({ subjectId: 1, subjectName: '新专题', sort: 1 }).then(response => { + * console.log(response); + * }); + */ export function createHomeSubject(data) { return request({ - url:'/home/recommendSubject/create', - method:'post', - data:data + url: '/home/recommendSubject/create', // 接口URL:创建推荐专题 + method: 'post', // 请求方法:POST + data: data // 请求体,包含推荐专题数据 }) } +/** + * updateHomeSubjectSort - 更新推荐专题的排序值 + * + * 通过 POST 请求更新指定推荐专题的排序值。 + * + * @param {Object} params - 排序参数,包含专题ID和新的排序值。 + * 示例:{ id: 1, sort: 10 } + * @returns {Promise} - 返回一个 Promise 对象,包含操作结果。 + * + * 用法示例: + * updateHomeSubjectSort({ id: 1, sort: 10 }).then(response => { + * console.log(response); + * }); + */ export function updateHomeSubjectSort(params) { return request({ - url:'/home/recommendSubject/update/sort/'+params.id, - method:'post', - params:params + url: '/home/recommendSubject/update/sort/' + params.id, // 接口URL:更新专题排序 + method: 'post', // 请求方法:POST + params: params // 排序参数,通过 URL 查询字符串传递 }) } diff --git a/src/api/hotProduct.js b/src/api/hotProduct.js index 4b5cead..483f410 100644 --- a/src/api/hotProduct.js +++ b/src/api/hotProduct.js @@ -1,40 +1,110 @@ +// 导入封装的 HTTP 请求工具,用于与后端 API 进行通信 import request from '@/utils/request' + +/** + * fetchList - 获取首页推荐商品列表 + * + * 通过 GET 请求获取首页推荐商品列表,支持分页和条件筛选。 + * + * @param {Object} params - 查询参数,例如分页和筛选条件。 + * 示例:{ pageNum: 1, pageSize: 10, keyword: '商品名' } + * @returns {Promise} - 返回一个 Promise 对象,包含接口返回的数据。 + * + * 用法示例: + * fetchList({ pageNum: 1, pageSize: 10 }).then(response => { + * console.log(response); + * }); + */ export function fetchList(params) { return request({ - url:'/home/recommendProduct/list', - method:'get', - params:params + url: '/home/recommendProduct/list', // 接口URL:获取推荐商品列表 + method: 'get', // 请求方法:GET + params: params // 查询参数,通过 URL 传递 }) } +/** + * updateRecommendStatus - 批量更新推荐商品的推荐状态 + * + * 通过 POST 请求批量更新首页推荐商品的推荐状态。 + * + * @param {Object} data - 推荐状态数据,包含商品ID数组和推荐状态。 + * 示例:{ ids: [1, 2, 3], recommendStatus: 1 } + * @returns {Promise} - 返回一个 Promise 对象,包含操作结果。 + * + * 用法示例: + * updateRecommendStatus({ ids: [1, 2, 3], recommendStatus: 1 }).then(response => { + * console.log(response); + * }); + */ export function updateRecommendStatus(data) { return request({ - url:'/home/recommendProduct/update/recommendStatus', - method:'post', - data:data + url: '/home/recommendProduct/update/recommendStatus', // 接口URL:更新推荐状态 + method: 'post', // 请求方法:POST + data: data // 请求体,包含商品ID和推荐状态 }) } +/** + * deleteHotProduct - 批量删除推荐商品 + * + * 通过 POST 请求删除多个推荐商品。 + * + * @param {Array} data - 商品ID数组,例如 [1, 2, 3]。 + * @returns {Promise} - 返回一个 Promise 对象,包含操作结果。 + * + * 用法示例: + * deleteHotProduct([1, 2, 3]).then(response => { + * console.log(response); + * }); + */ export function deleteHotProduct(data) { return request({ - url:'/home/recommendProduct/delete', - method:'post', - data:data + url: '/home/recommendProduct/delete', // 接口URL:批量删除推荐商品 + method: 'post', // 请求方法:POST + data: data // 请求体,包含商品ID数组 }) } +/** + * createHotProduct - 创建新的首页推荐商品 + * + * 通过 POST 请求提交新的商品数据,创建首页推荐商品。 + * + * @param {Object} data - 商品的详细数据,例如 { productId: 1, productName: '商品名', sort: 0 }。 + * @returns {Promise} - 返回一个 Promise 对象,包含操作结果。 + * + * 用法示例: + * createHotProduct({ productId: 1, productName: '新商品', sort: 1 }).then(response => { + * console.log(response); + * }); + */ export function createHotProduct(data) { return request({ - url:'/home/recommendProduct/create', - method:'post', - data:data + url: '/home/recommendProduct/create', // 接口URL:创建推荐商品 + method: 'post', // 请求方法:POST + data: data // 请求体,包含商品数据 }) } +/** + * updateHotProductSort - 更新推荐商品的排序值 + * + * 通过 POST 请求更新指定推荐商品的排序值。 + * + * @param {Object} params - 排序参数,包含商品ID和新的排序值。 + * 示例:{ id: 1, sort: 10 } + * @returns {Promise} - 返回一个 Promise 对象,包含操作结果。 + * + * 用法示例: + * updateHotProductSort({ id: 1, sort: 10 }).then(response => { + * console.log(response); + * }); + */ export function updateHotProductSort(params) { return request({ - url:'/home/recommendProduct/update/sort/'+params.id, - method:'post', - params:params + url: '/home/recommendProduct/update/sort/' + params.id, // 接口URL:更新商品排序 + method: 'post', // 请求方法:POST + params: params // 排序参数,通过 URL 查询字符串传递 }) } diff --git a/src/views/404.vue b/src/views/404.vue index 53eae15..b563dd0 100644 --- a/src/views/404.vue +++ b/src/views/404.vue @@ -1,15 +1,33 @@ diff --git a/src/views/pms/brand/add.vue b/src/views/pms/brand/add.vue index 95eed17..37e2d4a 100644 --- a/src/views/pms/brand/add.vue +++ b/src/views/pms/brand/add.vue @@ -1,14 +1,19 @@ -