feate:添加拼单类型接口
Build and Deploy Vue3 / build (push) Successful in 1m6s
Build and Deploy Vue3 / deploy (push) Successful in 10m44s

This commit is contained in:
2025-12-31 13:07:05 +08:00
parent 4cc684eca6
commit f6dcec75d7
10 changed files with 755 additions and 672 deletions
+115
View File
@@ -59,3 +59,118 @@ export const joinGroupBuy = (groupBuyId, data) => {
export const deleteGroupBuy = (groupBuyId) => {
return request.delete(`/api/v1/group-buy/${groupBuyId}`)
}
// ==================== 拼团类型管理接口 ====================
/**
* 获取拼团活动类型列表
* @param {Object} params - 查询参数
* @param {number} [params.page=1] - 页码
* @param {number} [params.count=10] - 每页条数
* @param {string} [params.key] - 关键词筛选
* @param {number} [params.expire_time] - 过期时间筛选(时间戳)
* @param {string} [params.tag] - 标签筛选
* @returns {Promise} 返回拼团类型列表
*/
export const getGroupBuyTypeList = (params) => {
return request.get("/api/v1/admin/activity/group_buy/type/list", params)
}
/**
* 获取拼团活动类型标签列表
* @returns {Promise} 返回标签列表
*/
export const getGroupBuyTypeTags = () => {
return request.get("/api/v1/admin/activity/group_buy/type/tags")
}
/**
* 新增拼团活动类型
* @param {Object} data - 类型数据
* @param {string} data.name - 名称
* @param {string} [data.note] - 备注
* @param {string} data.price - 价格(分)
* @param {string} [data.renew_price] - 续费价格(分)
* @param {string} data.max_person - 拼团需要人数
* @param {string} [data.tag] - 标签
* @param {number} [data.expire_time] - 活动过期时间
* @returns {Promise} 返回新增结果
*/
export const addGroupBuyType = (data) => {
return request.post("/api/v1/admin/activity/group_buy/type/add", data,{
})
}
/**
* 修改拼团活动类型
* @param {Object} data - 类型数据
* @param {string} data.id - ID编号
* @param {string} [data.name] - 名称
* @param {string} [data.note] - 备注
* @param {string} [data.price] - 价格(分)
* @param {string} [data.renew_price] - 续费价格(分)
* @param {string} [data.max_person] - 拼团需要人数
* @param {string} [data.tag] - 标签
* @param {number} [data.expire_time] - 活动过期时间
* @returns {Promise} 返回修改结果
*/
export const updateGroupBuyType = (data) => {
return request.post("/api/v1/admin/activity/group_buy/type/update", data)
}
/**
* 删除拼团活动类型
* @param {string} id - 类型ID
* @returns {Promise} 返回删除结果
*/
export const deleteGroupBuyType = (id) => {
return request.delete("/api/v1/admin/activity/group_buy/type/delete", { params: { id } })
}
// ==================== 拼团队伍管理接口 ====================
/**
* 检查队伍列表
* @returns {Promise} 返回队伍检查结果
*/
export const checkGroupBuyTeams = () => {
return request.get("/api/v1/admin/activity/group_buy/check")
}
/**
* 为队伍添加随机伪人
* @param {string} groupBuyId - 队伍ID
* @returns {Promise} 返回添加结果
*/
export const addRandomUser = (groupBuyId) => {
return request.post("/api/v1/admin/activity/group_buy/add_random_user", { group_buy_id: groupBuyId })
}
/**
* 创建随机伪人队伍
* @param {Object} data - 队伍数据
* @param {string} data.name - 队伍名称
* @param {string} data.group_buy_type_id - 队伍类型ID
* @returns {Promise} 返回创建结果
*/
export const addRandomGroup = (data) => {
return request.post("/api/v1/admin/activity/group_buy/add_random_group", data)
}
/**
* 导出成功队伍信息
* @returns {Promise} 返回导出数据
*/
export const exportGroupBuyIdcInfo = () => {
return request.get("/api/v1/admin/activity/group_buy/export_idc_info")
}
/**
* 为指定队伍下发订单
* @param {string} groupBuyId - 队伍ID
* @returns {Promise} 返回下发结果
*/
export const setGroupBuyOrder = (groupBuyId) => {
return request.post("/api/v1/admin/activity/group_buy/set_order", { group_buy_id: groupBuyId })
}
+3
View File
@@ -88,6 +88,9 @@ export const menus = [
},{
path:'/activity/groupbuy',
title:'拼团活动',
},{
path:'/activity/groupbuy-type',
title:'拼团类型'
}
]
},
+8
View File
@@ -337,6 +337,14 @@ const routes = [
meta: {
title: '拼团活动'
}
},
{
path: '/activity/groupbuy-type',
name: 'GroupBuyType',
component: () => import('../views/activity/GroupBuyType.vue'),
meta: {
title: '拼团类型'
}
}
]
},
+2 -2
View File
@@ -94,8 +94,8 @@ class Request {
}
// DELETE 请求
delete(url,data={}, config = {}) {
return this.instance.delete(url,data, config)
delete(url, config = {}) {
return this.instance.delete(url, config)
}
// PATCH 请求
+69 -26
View File
@@ -2,7 +2,7 @@
<div class="group-buy-container">
<el-card class="header-card">
<div class="header-actions">
<el-button type="primary" icon="Plus" @click="showCreateDialog = true">
<el-button type="primary" icon="Plus" @click="openCreateDialog">
创建随机队伍
</el-button>
<el-button type="success" icon="Download" @click="handleExport" :loading="exportLoading">
@@ -18,13 +18,13 @@
<el-table :data="groupList" v-loading="loading" stripe border>
<el-table-column prop="id" label="队伍ID" />
<el-table-column prop="name" label="队伍名称" min-width="150" />
<el-table-column label="队伍类型" width="120">
<!-- <el-table-column label="队伍类型" width="120">
<template #default="{ row }">
<el-tag :type="row.type === 0 ? 'primary' : 'success'">
{{ row.type === 0 ? '5人队' : '10人队' }}
</el-tag>
</template>
</el-table-column>
</el-table-column> -->
<el-table-column prop="currentMembers" label="当前人数" width="100" align="center" />
<el-table-column prop="maxMembers" label="需要人数" width="100" align="center" />
<el-table-column label="状态" width="120">
@@ -77,11 +77,15 @@
<el-form-item label="队伍名称" prop="name">
<el-input v-model="createForm.name" placeholder="请输入队伍名称" />
</el-form-item>
<el-form-item label="队伍类型" prop="groupBuyType">
<el-radio-group v-model="createForm.groupBuyType">
<el-radio :label="0">5人队</el-radio>
<el-radio :label="1">10人队</el-radio>
</el-radio-group>
<el-form-item label="标签" prop="tag">
<el-select v-model="createForm.tag" placeholder="请选择标签" style="width: 100%" @change="handleTagChange">
<el-option v-for="tag in tagList" :key="tag" :label="tag" :value="tag" />
</el-select>
</el-form-item>
<el-form-item label="拼团类型" prop="groupBuyTypeId">
<el-select v-model="createForm.groupBuyTypeId" placeholder="请先选择标签" :disabled="!createForm.tag" style="width: 100%">
<el-option v-for="item in typeList" :key="item.id" :label="`${item.name} (${item.maxPerson}人)`" :value="item.id" />
</el-select>
</el-form-item>
</el-form>
<template #footer>
@@ -116,8 +120,8 @@
<el-tag v-if="row.teamLeader" type="warning" size="small">队长</el-tag>
</template>
</el-table-column>
<el-table-column prop="idcUid" label="IDC UID" width="120" />
<el-table-column prop="idcPhone" label="IDC手机号" width="130" />
<!-- <el-table-column prop="idcUid" label="IDC UID" width="120" />
<el-table-column prop="idcPhone" label="IDC手机号" width="130" /> -->
</el-table>
</el-dialog>
</div>
@@ -134,6 +138,7 @@ import {
exportIdcInfo,
setOrder
} from '@/api/admin/activity'
import { getGroupBuyTypeList,getGroupBuyTypeTags } from '@/api/groupBuy'
// 数据状态
const loading = ref(false)
@@ -150,18 +155,67 @@ const currentMembers = ref([])
const createFormRef = ref(null)
const createForm = reactive({
name: '',
groupBuyType: 0
tag: '',
groupBuyTypeId: ''
})
const typeList = ref([])
const tagList = ref([])
const createRules = {
name: [
{ required: true, message: '请输入队伍名称', trigger: 'blur' }
],
groupBuyType: [
{ required: true, message: '请选择队伍类型', trigger: 'change' }
tag: [
{ required: true, message: '请选择标签', trigger: 'change' }
],
groupBuyTypeId: [
{ required: true, message: '请选择拼团类型', trigger: 'change' }
]
}
// 获取标签列表
const fetchTags = async () => {
try {
const res = await getGroupBuyTypeTags()
if (res.code === 200) {
tagList.value = res.data || []
}
} catch (error) {
console.error('获取标签失败:', error)
}
}
// 根据 tag 获取拼团类型列表
const fetchTypeListByTag = async (tag) => {
try {
const res = await getGroupBuyTypeList({ page: 1, count: 100, tag })
if (res.code === 200) {
typeList.value = res.data?.data || []
}
} catch (error) {
console.error('获取拼团类型失败:', error)
}
}
// tag 变化时获取对应的拼团类型
const handleTagChange = (tag) => {
createForm.groupBuyTypeId = ''
typeList.value = []
if (tag) {
fetchTypeListByTag(tag)
}
}
// 打开创建对话框
const openCreateDialog = () => {
createForm.name = ''
createForm.tag = ''
createForm.groupBuyTypeId = ''
typeList.value = []
fetchTags()
showCreateDialog.value = true
}
// 获取队伍列表
const fetchGroupList = async () => {
loading.value = true
@@ -239,25 +293,14 @@ const handleCreate = async () => {
if (valid) {
createLoading.value = true
try {
const res = await addRandomGroup(createForm.name, createForm.groupBuyType)
const res = await addRandomGroup({ name: createForm.name, group_buy_type_id: String(createForm.groupBuyTypeId) })
console.log('创建队伍响应:', res)
if (res.data.code === 200) {
// API 返回的数据结构:
// {
// group_buy_id: "17670733070-5",
// name: "发士大夫",
// maxPerson: 5,
// createTime: "2025-12-30T13:41:47.216888773+08:00",
// users: [{...}]
// }
ElMessage.success(`创建成功!队伍ID: ${res.data.group_buy_id}`)
showCreateDialog.value = false
createForm.name = ''
createForm.groupBuyType = 0
// 刷新列表
createForm.groupBuyTypeId = ''
fetchGroupList()
} else {
ElMessage.error(res.message || '创建失败')
+226
View File
@@ -0,0 +1,226 @@
<template>
<div class="group-buy-type-container">
<el-card class="header-card">
<div class="header-actions">
<el-button type="primary" icon="Plus" @click="handleAdd">新增类型</el-button>
<el-select v-model="searchTag" placeholder="请选择标签" style="width: 180px; margin-left: 12px" @change="handleTagChange">
<el-option v-for="tag in tagList" :key="tag" :label="tag" :value="tag" />
</el-select>
<el-input v-model="searchKey" placeholder="关键词搜索" style="width: 200px; margin-left: 12px" clearable :disabled="!searchTag" @keyup.enter="fetchList" />
<el-button type="info" icon="Refresh" @click="fetchList" :loading="loading" :disabled="!searchTag" style="margin-left: 12px">刷新</el-button>
</div>
</el-card>
<el-card class="table-card">
<el-empty v-if="!searchTag" description="请先选择标签" />
<template v-else>
<el-table :data="tableData" v-loading="loading" stripe border>
<el-table-column prop="id" label="ID" width="80" />
<el-table-column prop="name" label="名称" min-width="120" />
<el-table-column label="价格" width="120">
<template #default="{ row }">¥{{ (row.price / 100).toFixed(2) }}</template>
</el-table-column>
<el-table-column label="续费价格" width="120">
<template #default="{ row }">¥{{ (row.renewPrice / 100).toFixed(2) }}</template>
</el-table-column>
<el-table-column prop="maxPerson" label="拼团人数" width="100" align="center" />
<el-table-column prop="tag" label="标签" width="120">
<template #default="{ row }">
<el-tag v-if="row.tag" type="info">{{ row.tag }}</el-tag>
<span v-else>-</span>
</template>
</el-table-column>
<el-table-column label="过期时间" width="180">
<template #default="{ row }">{{ row.expireTime ? formatTime(row.expireTime) : '永久' }}</template>
</el-table-column>
<el-table-column prop="note" label="备注" min-width="150" show-overflow-tooltip />
<el-table-column label="操作" width="160" fixed="right">
<template #default="{ row }">
<el-button type="primary" size="small" @click="handleEdit(row)">编辑</el-button>
<el-button type="danger" size="small" @click="handleDelete(row)">删除</el-button>
</template>
</el-table-column>
</el-table>
<div class="pagination-wrapper">
<el-pagination v-model:current-page="page" v-model:page-size="pageSize" :total="total" :page-sizes="[10, 20, 50]" layout="total, sizes, prev, pager, next" @size-change="fetchList" @current-change="fetchList" />
</div>
</template>
</el-card>
<el-dialog v-model="dialogVisible" :title="isEdit ? '编辑拼团类型' : '新增拼团类型'" width="500px" :close-on-click-modal="false">
<el-form :model="form" :rules="rules" ref="formRef" label-width="100px">
<el-form-item label="名称" prop="name">
<el-input v-model="form.name" placeholder="请输入名称" />
</el-form-item>
<el-form-item label="价格(分)" prop="price">
<el-input-number v-model="form.price" :min="0" style="width: 100%" />
</el-form-item>
<el-form-item label="续费价格(分)" prop="renewPrice">
<el-input-number v-model="form.renewPrice" :min="0" style="width: 100%" />
</el-form-item>
<el-form-item label="拼团人数" prop="maxPerson">
<el-input-number v-model="form.maxPerson" :min="2" :max="100" style="width: 100%" />
</el-form-item>
<el-form-item label="标签" prop="tag">
<el-select v-model="form.tag" placeholder="选择标签" filterable allow-create style="width: 100%">
<el-option v-for="tag in tagList" :key="tag" :label="tag" :value="tag" />
</el-select>
</el-form-item>
<el-form-item label="过期时间" prop="expireTime">
<el-date-picker v-model="form.expireTime" type="datetime" placeholder="选择过期时间" style="width: 100%" />
</el-form-item>
<el-form-item label="备注" prop="note">
<el-input v-model="form.note" type="textarea" :rows="3" placeholder="请输入备注" />
</el-form-item>
</el-form>
<template #footer>
<el-button @click="dialogVisible = false">取消</el-button>
<el-button type="primary" @click="handleSubmit" :loading="submitLoading">确定</el-button>
</template>
</el-dialog>
</div>
</template>
<script setup>
import { ref, reactive, onMounted } from 'vue'
import { ElMessage, ElMessageBox } from 'element-plus'
import { getGroupBuyTypeList, getGroupBuyTypeTags, addGroupBuyType, updateGroupBuyType, deleteGroupBuyType } from '@/api/groupBuy'
const loading = ref(false)
const tableData = ref([])
const total = ref(0)
const page = ref(1)
const pageSize = ref(10)
const searchKey = ref('')
const searchTag = ref('')
const tagList = ref([])
const dialogVisible = ref(false)
const isEdit = ref(false)
const submitLoading = ref(false)
const formRef = ref(null)
const form = reactive({ id: '', name: '', price: 0, renewPrice: 0, maxPerson: 5, tag: '', expireTime: null, note: '' })
const rules = {
name: [{ required: true, message: '请输入名称', trigger: 'blur' }],
price: [{ required: true, message: '请输入价格', trigger: 'blur' }],
renewPrice: [{ required: true, message: '请输入续费价格', trigger: 'blur' }],
maxPerson: [{ required: true, message: '请输入拼团人数', trigger: 'blur' }],
tag: [{ required: true, message: '请选择标签', trigger: 'change' }],
expireTime: [{ required: true, message: '请选择过期时间', trigger: 'change' }],
note: [{ required: true, message: '请输入备注', trigger: 'blur' }]
}
const formatTime = (timeStr) => {
if (!timeStr) return '-'
return new Date(timeStr).toLocaleString('zh-CN')
}
const fetchList = async () => {
loading.value = true
try {
const res = await getGroupBuyTypeList({ page: page.value, count: pageSize.value, key: searchKey.value || undefined, tag: searchTag.value || undefined })
console.log("获取拼团类型列表数据:",res)
if (res.code === 200) {
tableData.value = res.data?.data || []
total.value = res.data?.all_count || 0
} else {
ElMessage.error(res.data.message || '获取列表失败')
}
} catch (error) {
console.error('获取列表失败:', error)
ElMessage.error('网络错误')
} finally {
loading.value = false
}
}
const fetchTags = async () => {
try {
const res = await getGroupBuyTypeTags()
if (res.code === 200) tagList.value = res.data || []
} catch (error) {
console.error('获取标签失败:', error)
}
}
// 标签变化时重新获取列表
const handleTagChange = (tag) => {
page.value = 1
searchKey.value = ''
tableData.value = []
total.value = 0
if (tag) {
fetchList()
}
}
const handleAdd = () => {
isEdit.value = false
Object.assign(form, { id: '', name: '', price: 0, renewPrice: 0, maxPerson: 5, tag: '', expireTime: null, note: '' })
dialogVisible.value = true
}
const handleEdit = (row) => {
isEdit.value = true
Object.assign(form, { id: row.id, name: row.name, price: row.price, renewPrice: row.renewPrice, maxPerson: row.maxPerson, tag: row.tag || '', expireTime: row.expireTime || null, note: row.note || '' })
dialogVisible.value = true
}
const handleSubmit = async () => {
if (!formRef.value) return
await formRef.value.validate(async (valid) => {
if (!valid) return
submitLoading.value = true
try {
const data = {
name: form.name,
price: String(form.price),
renew_price: String(form.renewPrice),
max_person: String(form.maxPerson),
tag: form.tag,
expire_time: form.expireTime ? Math.floor(new Date(form.expireTime).getTime() / 1000) : 0,
note: form.note
}
if (isEdit.value) data.id = String(form.id)
const res = isEdit.value ? await updateGroupBuyType(data) : await addGroupBuyType(data)
if (res.code === 200) {
ElMessage.success(isEdit.value ? '修改成功' : '新增成功')
dialogVisible.value = false
fetchList()
fetchTags()
} else {
ElMessage.error(res.message || '操作失败')
}
} catch (error) {
console.error('提交失败:', error)
ElMessage.error('网络错误')
} finally {
submitLoading.value = false
}
})
}
const handleDelete = async (row) => {
try {
await ElMessageBox.confirm('确定要删除该拼团类型吗?', '确认删除', { type: 'warning' })
const res = await deleteGroupBuyType(row.id)
if (res.code === 200) {
ElMessage.success('删除成功')
fetchList()
fetchTags()
} else {
ElMessage.error(res.data.message || '删除失败')
}
} catch { /* 取消 */ }
}
onMounted(() => { fetchTags() })
</script>
<style scoped>
.group-buy-type-container { padding: 20px; }
.header-card { margin-bottom: 20px; }
.header-actions { display: flex; align-items: center; }
.table-card { box-shadow: 0 2px 12px 0 rgba(0, 0, 0, 0.1); }
.pagination-wrapper { margin-top: 20px; display: flex; justify-content: flex-end; }
</style>
-92
View File
@@ -1,92 +0,0 @@
# 商品管理 API 对接完成报告
## 概述
已成功完成 `默认模块.openapi.json` 中所有商品管理相关接口的对接工作。
## 对接详情
### 1. API 接口实现 (18个接口)
#### 商品分组管理 (6个接口)
-`GET /api/v1/admin/good/group/list` - 获取商品分组列表
-`POST /api/v1/admin/good/group/create` - 创建商品分组
-`POST /api/v1/admin/good/group/update` - 更新商品分组
-`POST /api/v1/admin/good/group/disable` - 隐藏商品组
-`POST /api/v1/admin/good/group/enable` - 启用商品组
-`DELETE /api/v1/admin/good/group/delete` - 删除商品分组
#### 商品管理 (5个接口)
-`GET /api/v1/admin/good/goods/list` - 获取商品列表
-`GET /api/v1/admin/good/goods/tag_list` - 获取商品标签列表 (新增)
-`POST /api/v1/admin/good/goods/create` - 创建商品
-`POST /api/v1/admin/good/goods/update` - 更新商品
-`DELETE /api/v1/admin/good/goods/delete` - 删除商品
#### 商品参数管理 (7个接口)
-`GET /api/v1/admin/good/spec/list` - 获取商品参数列表
-`POST /api/v1/admin/good/spec/create` - 创建商品参数
-`GET /api/v1/admin/good/spec/detail` - 获取商品参数详情
-`POST /api/v1/admin/good/spec/update` - 更新商品参数
-`DELETE /api/v1/admin/good/spec/delete` - 删除商品参数
-`POST /api/v1/admin/good/spec/add_value` - 增加商品参数值
-`DELETE /api/v1/admin/good/spec/delete_value` - 删除商品参数值
-`POST /api/v1/admin/good/spec/update_value` - 更新商品参数值
### 2. 页面实现
#### ProductList.vue (商品列表管理)
- ✅ 商品列表展示与分页
- ✅ 商品搜索与筛选 (按分组)
- ✅ 商品新增/编辑/删除
- ✅ 批量删除功能
- ✅ 商品参数管理 (完整的参数和参数值管理)
- ✅ 商品标签选择 (新增功能)
- ✅ 骨架屏加载效果
#### ProductGroup.vue (商品分组管理)
- ✅ 分组列表展示与分页
- ✅ 分组新增/编辑/删除
- ✅ 分组状态切换 (启用/禁用)
- ✅ 骨架屏加载效果
### 3. 文件修改记录
#### 新增文件
- `src/api/admin/product-test.js` - API 接口测试验证文件
#### 修改文件
- `src/api/admin/product.js` - 新增商品标签列表接口,修正参数接口
- `src/views/product/ProductList.vue` - 新增商品标签功能,修复价格处理
### 4. 技术要点
#### API 接口规范
- 所有 POST/DELETE 接口使用 `multipart/form-data` 格式
- 更新商品参数接口使用 query 参数
- 统一的错误处理和响应格式
#### 数据处理
- 价格以分为单位存储和传输
- 商品标签从专用接口获取
- 完整的表单验证和数据校验
#### 用户体验
- 骨架屏加载效果
- 批量操作支持
- 实时状态切换
- 友好的错误提示
## 完成状态
- **接口对接完成度**: 100% (18/18)
- **页面功能完成度**: 100%
- **测试验证**: 已完成
- **文档更新**: 已完成
## 使用说明
1. **商品分组管理**: 访问 ProductGroup.vue 页面进行分组管理
2. **商品管理**: 访问 ProductList.vue 页面进行商品管理
3. **参数管理**: 在商品列表页面点击"参数"按钮进行参数管理
所有功能已完整实现,可以直接投入使用。
-268
View File
@@ -1,268 +0,0 @@
# 拼团 API 对接说明
## API 文件位置
- 管理端接口:`src/api/admin/activity.js`
- 用户端接口:`src/api/groupBuy.js`
## 管理端 API 接口(已更新)
### 1. 获取拼团列表 ✅ 已更新
```javascript
import { getGroupBuyList } from '@/api/admin/activity.js'
// 调用示例
const resp = await getGroupBuyList()
// 接口路径:GET /api/v1/users/activity/group_buy/list
// 实际返回数据结构:
{
code: 200,
message: "Success",
data: {
group_buy_list: ["17670726110-5", "17670733070-5"], // 所有队伍ID
lack_group_buy_list: ["17670726110-5"], // 未满员队伍ID
success_group_buy_list: [] // 已满员队伍ID
}
}
```
### 2. 获取拼团队伍详情 ✅ 新增
```javascript
import { getGroupBuyDetail } from '@/api/admin/activity.js'
// 调用示例
const resp = await getGroupBuyDetail('17670733070-5')
// 接口路径:GET /api/v1/users/activity/group_buy/detail/:id
// 实际返回数据结构:
{
code: 200,
message: "Success",
data: {
group_buy_id: "17670733070-5",
name: "发士大夫",
maxPerson: 5,
createTime: "2025-12-30T13:41:47.216888773+08:00",
users: [{
user_id: 0,
user_name: "",
team_leader: true,
cover: "https://...",
idc_phone: "",
idc_uid: ""
}]
}
}
```
### 3. 创建随机伪人队伍 ✅ 已验证
```javascript
import { addRandomGroup } from '@/api/admin/activity.js'
// 调用示例
const resp = await addRandomGroup('队伍名称', 0) // 0=5人队, 1=10人队
// 实际返回数据结构:
{
code: 200,
message: "Success",
data: {
group_buy_id: "17670733070-5",
name: "发士大夫",
maxPerson: 5,
createTime: "2025-12-30T13:41:47.216888773+08:00",
users: [{
user_id: 0,
user_name: "",
team_leader: true,
cover: "https://...",
idc_phone: "",
idc_uid: ""
}]
}
}
```
### 4. 为队伍添加随机伪人
```javascript
import { addRandomUser } from '@/api/admin/activity.js'
const resp = await addRandomUser(groupBuyId)
```
### 5. 为指定队伍下发订单
```javascript
import { setOrder } from '@/api/admin/activity.js'
const resp = await setOrder(groupBuyId)
```
### 6. 导出成功队伍信息
```javascript
import { exportIdcInfo } from '@/api/admin/activity.js'
const resp = await exportIdcInfo()
// 返回 Excel 文件流
```
## 用户端 API 接口
### 1. 创建拼团
```javascript
import { createGroupBuy } from '@/api/groupBuy.js'
// 调用示例
const data = {
name: '地擦拭大',
maxPerson: 5,
cover: 'https://example.com/cover.jpg'
}
const resp = await createGroupBuy(data)
// 响应数据结构
{
code: 200,
message: "Success",
data: {
group_buy_id: "17670726110-5",
name: "地擦拭大",
maxPerson: 5,
createTime: "2025-12-30T13:30:11.918394294+08:00",
users: [{
user_id: 0,
user_name: "",
team_leader: true,
cover: "https://...",
idc_phone: "",
idc_uid: ""
}]
}
}
```
### 2. 检查拼团
```javascript
import { checkGroupBuy } from '@/api/groupBuy.js'
// 调用示例
const groupBuyId = "17670726110-5"
const resp = await checkGroupBuy(groupBuyId)
// 响应数据结构
{
code: 200,
message: "Success",
data: "ok"
}
```
### 3. 获取拼团详情
```javascript
import { getGroupBuyDetail } from '@/api/groupBuy.js'
const resp = await getGroupBuyDetail(groupBuyId)
```
### 4. 获取拼团列表(用户端)
```javascript
import { getGroupBuyList } from '@/api/groupBuy.js'
const resp = await getGroupBuyList({ page: 1, pageSize: 20 })
// 接口路径:GET /api/v1/users/activity/group_buy/list
```
### 5. 加入拼团
```javascript
import { joinGroupBuy } from '@/api/groupBuy.js'
const resp = await joinGroupBuy(groupBuyId, {
user_id: 123,
user_name: "张三"
})
```
### 6. 删除拼团
```javascript
import { deleteGroupBuy } from '@/api/groupBuy.js'
const resp = await deleteGroupBuy(groupBuyId)
```
## 完整示例页面
- 管理端页面:`src/views/activity/GroupBuyActivity.vue` ✅ 已存在
- 用户端示例:`src/views/marketing/GroupBuyManage.vue`
管理端页面包含:
- ✅ 拼团列表展示(使用正确的接口路径)
- ✅ 创建随机伪人队伍
- ✅ 添加随机伪人
- ✅ 下发订单功能
- ✅ 导出成功队伍
- ✅ 查看队伍成员
## 接口路径总结
### 管理端接口
- `GET /api/v1/users/activity/group_buy/list` - 获取拼团列表 ✅ 返回队伍ID数组
- `GET /api/v1/users/activity/group_buy/detail/:id` - 获取队伍详情 ✅ 新增
- `POST /api/v1/admin/activity/group_buy/add_random_group` - 创建随机队伍 ✅ 已验证
- `POST /api/v1/admin/activity/group_buy/add_random_user` - 添加随机伪人
- `POST /api/v1/admin/activity/group_buy/set_order` - 下发订单
- `GET /api/v1/admin/activity/group_buy/export_idc_info` - 导出信息
### 用户端接口(根据需要调整)
- `POST /api/v1/group-buy/create` - 创建拼团
- `GET /api/v1/group-buy/check/:id` - 检查拼团
- `GET /api/v1/group-buy/:id` - 获取拼团详情
- `GET /api/v1/users/activity/group_buy/list` - 获取拼团列表 ✅
- `POST /api/v1/group-buy/:id/join` - 加入拼团
- `DELETE /api/v1/group-buy/:id` - 删除拼团
## 使用方法
### 在管理端页面使用
```vue
<script setup>
import { getGroupBuyList, addRandomUser } from '@/api/admin/activity.js'
import { ElMessage } from 'element-plus'
// 获取列表
const fetchList = async () => {
try {
const resp = await getGroupBuyList()
if (resp && resp.code === 200) {
console.log('拼团列表:', resp.data)
}
} catch (error) {
console.error('获取失败:', error)
ElMessage.error('获取失败')
}
}
// 添加伪人
const addUser = async (groupBuyId) => {
try {
const resp = await addRandomUser(groupBuyId)
if (resp && resp.code === 200) {
ElMessage.success('添加成功')
}
} catch (error) {
console.error('添加失败:', error)
ElMessage.error('添加失败')
}
}
</script>
```
## 注意事项
1. **接口路径已更新**:获取拼团列表接口已更新为 `/api/v1/users/activity/group_buy/list`
2. **错误处理**:所有 API 调用都应该包含 try-catch 错误处理
3. **响应检查**:始终检查 `resp.code === 200` 来判断请求是否成功
4. **空值处理**:使用可选链 `?.` 和空值合并 `||` 来处理可能为空的数据
5. **用户提示**:使用 `ElMessage` 给用户友好的提示信息
-282
View File
@@ -1,282 +0,0 @@
# 拼团 API 测试示例
## 实际数据结构(已验证)
### 1. 获取队伍列表
**接口**: `GET /api/v1/users/activity/group_buy/list`
**返回数据**:
```json
{
"code": 200,
"message": "Success",
"data": {
"group_buy_list": ["17670726110-5"], // 所有队伍ID
"lack_group_buy_list": ["17670726110-5"], // 未满员队伍ID
"success_group_buy_list": [] // 已满员队伍ID
}
}
```
**数据说明**:
- `group_buy_list`: 所有队伍的 ID 列表
- `lack_group_buy_list`: 人数不足的队伍 ID(进行中)
- `success_group_buy_list`: 已满员的队伍 ID(成功)
- 队伍 ID 格式: `时间戳-人数` (如 `17670726110-5` 表示5人队)
---
### 2. 创建队伍
**接口**: `POST /api/v1/admin/activity/group_buy/add_random_group`
**请求参数**:
```javascript
{
name: "发士大夫",
group_buy_type: 0 // 0=5人队, 1=10人队
}
```
**返回数据**:
```json
{
"code": 200,
"message": "Success",
"data": {
"group_buy_id": "17670733070-5",
"name": "发士大夫",
"maxPerson": 5,
"createTime": "2025-12-30T13:41:47.216888773+08:00",
"users": [{
"user_id": 0,
"user_name": "",
"team_leader": true,
"cover": "https://oss.hostidc.net/api-server/static/files/...",
"idc_phone": "",
"idc_uid": ""
}]
}
}
```
**数据说明**:
- 创建成功后会自动添加一个团长(伪人)
- `team_leader: true` 表示是团长
- 返回完整的队伍信息,包括初始成员
---
### 3. 获取队伍详情
**接口**: `GET /api/v1/users/activity/group_buy/detail/:id`
**返回数据**: 与创建队伍返回的数据结构相同
---
## 在代码中使用
### 完整流程示例
```vue
<script setup>
import { ref } from 'vue'
import { ElMessage } from 'element-plus'
import {
getGroupBuyList,
getGroupBuyDetail,
addRandomGroup,
addRandomUser,
setOrder
} from '@/api/admin/activity.js'
// 1. 获取队伍列表
const fetchList = async () => {
try {
const res = await getGroupBuyList()
console.log('队伍列表:', res)
if (res.code === 200) {
const allIds = res.data.group_buy_list || []
const lackIds = res.data.lack_group_buy_list || []
const successIds = res.data.success_group_buy_list || []
console.log('所有队伍:', allIds)
console.log('未满员:', lackIds)
console.log('已满员:', successIds)
ElMessage.success(`${allIds.length} 个队伍`)
}
} catch (error) {
console.error('获取失败:', error)
ElMessage.error('获取失败')
}
}
// 2. 创建队伍
const createTeam = async () => {
try {
const res = await addRandomGroup('测试队伍', 0) // 0=5人队
console.log('创建结果:', res)
if (res.code === 200) {
const teamId = res.data.group_buy_id
const teamName = res.data.name
const memberCount = res.data.users?.length || 0
ElMessage.success(`创建成功!队伍ID: ${teamId},当前 ${memberCount}`)
// 刷新列表
await fetchList()
}
} catch (error) {
console.error('创建失败:', error)
ElMessage.error('创建失败')
}
}
// 3. 获取队伍详情
const getDetail = async (teamId) => {
try {
const res = await getGroupBuyDetail(teamId)
console.log('队伍详情:', res)
if (res.code === 200) {
const team = res.data
console.log('队伍名称:', team.name)
console.log('最大人数:', team.maxPerson)
console.log('当前成员:', team.users)
}
} catch (error) {
console.error('获取详情失败:', error)
}
}
// 4. 添加伪人
const addFakeUser = async (teamId) => {
try {
const res = await addRandomUser(teamId)
console.log('添加伪人结果:', res)
if (res.code === 200) {
ElMessage.success('添加伪人成功')
// 刷新详情
await getDetail(teamId)
}
} catch (error) {
console.error('添加失败:', error)
ElMessage.error('添加失败')
}
}
// 5. 下发订单
const sendOrder = async (teamId) => {
try {
const res = await setOrder(teamId)
console.log('下发订单结果:', res)
if (res.code === 200) {
ElMessage.success('订单下发成功')
}
} catch (error) {
console.error('下发失败:', error)
ElMessage.error('下发失败')
}
}
</script>
```
---
## 测试步骤
### 步骤 1: 创建队伍
```javascript
await addRandomGroup('测试5人队', 0)
// 返回: { group_buy_id: "xxx-5", name: "测试5人队", maxPerson: 5, users: [1个团长] }
```
### 步骤 2: 查看列表
```javascript
await getGroupBuyList()
// 返回: { group_buy_list: ["xxx-5"], lack_group_buy_list: ["xxx-5"], success_group_buy_list: [] }
```
### 步骤 3: 添加伪人(重复4次,凑满5人)
```javascript
await addRandomUser("xxx-5") // 第2人
await addRandomUser("xxx-5") // 第3人
await addRandomUser("xxx-5") // 第4人
await addRandomUser("xxx-5") // 第5人
```
### 步骤 4: 再次查看列表
```javascript
await getGroupBuyList()
// 返回: { group_buy_list: ["xxx-5"], lack_group_buy_list: [], success_group_buy_list: ["xxx-5"] }
// 注意: 队伍从 lack_group_buy_list 移到了 success_group_buy_list
```
### 步骤 5: 下发订单
```javascript
await setOrder("xxx-5")
// 为满员队伍下发订单
```
---
## 队伍状态判断逻辑
```javascript
const getTeamStatus = (teamId, lackList, successList) => {
if (successList.includes(teamId)) {
return 'success' // 已满员
} else if (lackList.includes(teamId)) {
return 'pending' // 进行中(未满员)
} else {
return 'empty' // 空队伍(理论上不会出现)
}
}
```
---
## 队伍类型判断
根据队伍 ID 判断类型:
```javascript
const getTeamType = (teamId) => {
if (teamId.includes('-5')) {
return { type: 0, maxPerson: 5, typeName: '5人队' }
} else if (teamId.includes('-10')) {
return { type: 1, maxPerson: 10, typeName: '10人队' }
}
return { type: 0, maxPerson: 5, typeName: '未知' }
}
```
---
## 注意事项
1. **列表接口只返回 ID**:需要调用详情接口获取完整信息
2. **队伍 ID 格式**`时间戳-人数`,可以从 ID 判断队伍类型
3. **状态判断**:通过 `lack_group_buy_list``success_group_buy_list` 判断队伍状态
4. **创建即有团长**:创建队伍时会自动添加一个团长(伪人)
5. **满员条件**5人队需要5人,10人队需要10人
6. **下发订单**:只能对已满员的队伍下发订单
---
## 当前页面功能
`src/views/activity/GroupBuyActivity.vue` 已实现:
✅ 获取队伍列表(显示所有队伍及状态)
✅ 创建随机伪人队伍
✅ 添加随机伪人到队伍
✅ 查看队伍成员详情
✅ 为满员队伍下发订单
✅ 导出成功队伍信息
✅ 实时状态更新
所有功能都已根据实际 API 数据结构进行了适配!
+332 -2
View File
@@ -7,6 +7,336 @@
},
"tags": [],
"paths": {
"/api/v1/admin/activity/group_buy/type/list": {
"get": {
"summary": "获取拼团活动类型列表",
"deprecated": false,
"description": "",
"tags": [],
"parameters": [
{
"name": "page",
"in": "query",
"description": "获取页码 默认 1",
"required": false,
"example": "",
"schema": {
"type": "string"
}
},
{
"name": "count",
"in": "query",
"description": "获取条数 默认 10",
"required": false,
"example": "",
"schema": {
"type": "string"
}
},
{
"name": "key",
"in": "query",
"description": "关键词筛选",
"required": false,
"example": "",
"schema": {
"type": "string"
}
},
{
"name": "expire_time",
"in": "query",
"description": "过期时间筛选 时间戳",
"required": false,
"example": 0,
"schema": {
"type": "integer"
}
},
{
"name": "tag",
"in": "query",
"description": "标签筛选",
"required": false,
"example": "",
"schema": {
"type": "string"
}
},
{
"name": "Authorization",
"in": "header",
"description": "",
"example": "Bearer {{token}}",
"schema": {
"type": "string",
"default": "Bearer {{token}}"
}
}
],
"responses": {
"200": {
"description": "",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {}
}
}
},
"headers": {}
}
},
"security": []
}
},
"/api/v1/admin/activity/group_buy/type/tags": {
"get": {
"summary": "获取拼团活动类型tag列表",
"deprecated": false,
"description": "",
"tags": [],
"parameters": [
{
"name": "Authorization",
"in": "header",
"description": "",
"example": "Bearer {{token}}",
"schema": {
"type": "string",
"default": "Bearer {{token}}"
}
}
],
"responses": {
"200": {
"description": "",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {}
}
}
}
}
},
"security": []
}
},
"/api/v1/admin/activity/group_buy/type/add": {
"post": {
"summary": "新增拼团活动类型",
"deprecated": false,
"description": "",
"tags": [],
"parameters": [
{
"name": "Authorization",
"in": "header",
"description": "",
"example": "Bearer {{token}}",
"schema": {
"type": "string",
"default": "Bearer {{token}}"
}
}
],
"requestBody": {
"content": {
"multipart/form-data": {
"schema": {
"type": "object",
"properties": {
"name": {
"description": "名称",
"example": "",
"type": "string"
},
"note": {
"description": "备注",
"example": "",
"type": "string"
},
"price": {
"description": "价格 /分",
"example": "",
"type": "string"
},
"renew_price": {
"description": "续费价格 /分",
"example": "",
"type": "string"
},
"max_person": {
"description": "拼团需要人数",
"example": "",
"type": "string"
},
"tag": {
"description": "标签",
"example": "",
"type": "string"
},
"expire_time": {
"description": "活动过期时间",
"example": 0,
"type": "integer"
}
}
}
}
}
},
"responses": {
"200": {
"description": "",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {}
}
}
},
"headers": {}
}
},
"security": []
}
},
"/api/v1/admin/activity/group_buy/type/update": {
"post": {
"summary": "修改拼团活动类型",
"deprecated": false,
"description": "",
"tags": [],
"parameters": [
{
"name": "Authorization",
"in": "header",
"description": "",
"example": "Bearer {{token}}",
"schema": {
"type": "string",
"default": "Bearer {{token}}"
}
}
],
"requestBody": {
"content": {
"multipart/form-data": {
"schema": {
"type": "object",
"properties": {
"id": {
"description": "ID 编号",
"example": "",
"type": "string"
},
"name": {
"description": "名称",
"example": "",
"type": "string"
},
"note": {
"description": "备注",
"example": "",
"type": "string"
},
"price": {
"description": "价格 /分",
"example": "",
"type": "string"
},
"renew_price": {
"description": "续费价格 /分",
"example": "",
"type": "string"
},
"max_person": {
"description": "拼团需要人数",
"example": "",
"type": "string"
},
"tag": {
"description": "标签",
"example": "",
"type": "string"
},
"expire_time": {
"description": "活动过期时间",
"example": 0,
"type": "integer"
}
}
}
}
}
},
"responses": {
"200": {
"description": "",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {}
}
}
},
"headers": {}
}
},
"security": []
}
},
"/api/v1/admin/activity/group_buy/type/delete": {
"delete": {
"summary": "删除拼团活动类型",
"deprecated": false,
"description": "",
"tags": [],
"parameters": [
{
"name": "id",
"in": "query",
"description": "",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "Authorization",
"in": "header",
"description": "",
"example": "Bearer {{token}}",
"schema": {
"type": "string",
"default": "Bearer {{token}}"
}
}
],
"responses": {
"200": {
"description": "",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {}
}
}
},
"headers": {}
}
},
"security": []
}
},
"/api/v1/admin/activity/group_buy/check": {
"get": {
"summary": "检查队伍列表",
@@ -121,8 +451,8 @@
"example": "",
"type": "string"
},
"group_buy_type": {
"description": "队伍类型0为5人队;1为10人队)",
"group_buy_type_id": {
"description": "队伍类型id",
"example": "",
"type": "string"
}