feat(ticket): 添加水票功能模块

- 新增水票相关API接口,包括水票模板、用户水票、消费日志和水票释放功能
- 添加水票管理页面,实现水票的增删改查和详情展示功能
- 实现水票的分页查询和列表展示界面
- 替换原有的礼品卡功能为水票功能,在首页导航中更新路由链接
- 添加水票详情页面,支持二维码展示和兑换码复制功能
- 实现水票的状态管理和使用流程控制
This commit is contained in:
2026-02-04 10:02:26 +08:00
parent cb17e48b03
commit a3c952d092
23 changed files with 2393 additions and 5 deletions

View File

@@ -0,0 +1,105 @@
import request from '@/utils/request';
import type { ApiResult, PageResult } from '@/api';
import type { GltTicketTemplate, GltTicketTemplateParam } from './model';
/**
* 分页查询水票
*/
export async function pageGltTicketTemplate(params: GltTicketTemplateParam) {
const res = await request.get<ApiResult<PageResult<GltTicketTemplate>>>(
'/glt/glt-ticket-template/page',
{
params
}
);
if (res.code === 0) {
return res.data;
}
return Promise.reject(new Error(res.message));
}
/**
* 查询水票列表
*/
export async function listGltTicketTemplate(params?: GltTicketTemplateParam) {
const res = await request.get<ApiResult<GltTicketTemplate[]>>(
'/glt/glt-ticket-template',
{
params
}
);
if (res.code === 0 && res.data) {
return res.data;
}
return Promise.reject(new Error(res.message));
}
/**
* 添加水票
*/
export async function addGltTicketTemplate(data: GltTicketTemplate) {
const res = await request.post<ApiResult<unknown>>(
'/glt/glt-ticket-template',
data
);
if (res.code === 0) {
return res.message;
}
return Promise.reject(new Error(res.message));
}
/**
* 修改水票
*/
export async function updateGltTicketTemplate(data: GltTicketTemplate) {
const res = await request.put<ApiResult<unknown>>(
'/glt/glt-ticket-template',
data
);
if (res.code === 0) {
return res.message;
}
return Promise.reject(new Error(res.message));
}
/**
* 删除水票
*/
export async function removeGltTicketTemplate(id?: number) {
const res = await request.del<ApiResult<unknown>>(
'/glt/glt-ticket-template/' + id
);
if (res.code === 0) {
return res.message;
}
return Promise.reject(new Error(res.message));
}
/**
* 批量删除水票
*/
export async function removeBatchGltTicketTemplate(data: (number | undefined)[]) {
const res = await request.del<ApiResult<unknown>>(
'/glt/glt-ticket-template/batch',
{
data
}
);
if (res.code === 0) {
return res.message;
}
return Promise.reject(new Error(res.message));
}
/**
* 根据id查询水票
*/
export async function getGltTicketTemplate(id: number) {
const res = await request.get<ApiResult<GltTicketTemplate>>(
'/glt/glt-ticket-template/' + id
);
if (res.code === 0 && res.data) {
return res.data;
}
return Promise.reject(new Error(res.message));
}

View File

@@ -0,0 +1,55 @@
import type { PageParam } from '@/api';
/**
* 水票
*/
export interface GltTicketTemplate {
//
id?: number;
// 关联商品ID
goodsId?: number;
// 名称
name?: string;
// 启用
enabled?: boolean;
// 单位名称
unitName?: string;
// 最小购买数量
minBuyQty?: number;
// 起始发送数量
startSendQty?: number;
// 买赠买1送4 => gift_multiplier=4
giftMultiplier?: number;
// 是否把购买量也计入套票总量(默认仅计入赠送量)
includeBuyQty?: boolean;
// 每期释放数量默认每月释放10
monthlyReleaseQty?: number;
// 总共释放多少期(若配置>0则按期数平均分摊
releasePeriods?: number;
// 首期释放时机0=支付成功当刻1=下个月同日
firstReleaseMode?: number;
// 用户ID
userId?: number;
// 排序(数字越小越靠前)
sortNumber?: number;
// 备注
comments?: string;
// 状态, 0正常, 1冻结
status?: number;
// 是否删除, 0否, 1是
deleted?: number;
// 租户id
tenantId?: number;
// 创建时间
createTime?: string;
// 修改时间
updateTime?: string;
}
/**
* 水票搜索条件
*/
export interface GltTicketTemplateParam extends PageParam {
id?: number;
keywords?: string;
}

View File

@@ -0,0 +1,105 @@
import request from '@/utils/request';
import type { ApiResult, PageResult } from '@/api';
import type { GltUserTicket, GltUserTicketParam } from './model';
/**
* 分页查询我的水票
*/
export async function pageGltUserTicket(params: GltUserTicketParam) {
const res = await request.get<ApiResult<PageResult<GltUserTicket>>>(
'/glt/glt-user-ticket/page',
{
params
}
);
if (res.code === 0 && res.data) {
return res.data;
}
return Promise.reject(new Error(res.message));
}
/**
* 查询我的水票列表
*/
export async function listGltUserTicket(params?: GltUserTicketParam) {
const res = await request.get<ApiResult<GltUserTicket[]>>(
'/glt/glt-user-ticket',
{
params
}
);
if (res.code === 0 && res.data) {
return res.data;
}
return Promise.reject(new Error(res.message));
}
/**
* 添加我的水票
*/
export async function addGltUserTicket(data: GltUserTicket) {
const res = await request.post<ApiResult<unknown>>(
'/glt/glt-user-ticket',
data
);
if (res.code === 0) {
return res.message;
}
return Promise.reject(new Error(res.message));
}
/**
* 修改我的水票
*/
export async function updateGltUserTicket(data: GltUserTicket) {
const res = await request.put<ApiResult<unknown>>(
'/glt/glt-user-ticket',
data
);
if (res.code === 0) {
return res.message;
}
return Promise.reject(new Error(res.message));
}
/**
* 删除我的水票
*/
export async function removeGltUserTicket(id?: number) {
const res = await request.del<ApiResult<unknown>>(
'/glt/glt-user-ticket/' + id
);
if (res.code === 0) {
return res.message;
}
return Promise.reject(new Error(res.message));
}
/**
* 批量删除我的水票
*/
export async function removeBatchGltUserTicket(data: (number | undefined)[]) {
const res = await request.del<ApiResult<unknown>>(
'/glt/glt-user-ticket/batch',
{
data
}
);
if (res.code === 0) {
return res.message;
}
return Promise.reject(new Error(res.message));
}
/**
* 根据id查询我的水票
*/
export async function getGltUserTicket(id: number) {
const res = await request.get<ApiResult<GltUserTicket>>(
'/glt/glt-user-ticket/' + id
);
if (res.code === 0 && res.data) {
return res.data;
}
return Promise.reject(new Error(res.message));
}

View File

@@ -0,0 +1,66 @@
import type { PageParam } from '@/api';
/**
* 我的水票
*/
export interface GltUserTicket {
//
id?: number;
// 模板ID
templateId?: number;
// 模板名称
templateName?: string;
// 商品ID
goodsId?: number;
// 订单ID
orderId?: number;
// 订单编号
orderNo?: string;
// 订单商品ID
orderGoodsId?: number;
// 总数量
totalQty?: number;
// 可用数量
availableQty?: number;
// 冻结数量
frozenQty?: number;
// 已使用数量
usedQty?: number;
// 已释放数量
releasedQty?: number;
// 用户ID
userId?: number;
// 用户昵称
nickname?: string;
// 用户头像
avatar?: string;
// 用户手机号
phone?: string;
// 排序(数字越小越靠前)
sortNumber?: number;
// 备注
comments?: string;
// 状态, 0正常, 1冻结
status?: number;
// 是否删除, 0否, 1是
deleted?: number;
// 租户id
tenantId?: number;
// 创建时间
createTime?: string;
// 修改时间
updateTime?: string;
}
/**
* 我的水票搜索条件
*/
export interface GltUserTicketParam extends PageParam {
id?: number;
templateId?: number;
userId?: number;
phone?: string;
keywords?: string;
// 状态过滤0正常1冻结
status?: number;
}

View File

@@ -0,0 +1,105 @@
import request from '@/utils/request';
import type { ApiResult, PageResult } from '@/api';
import type { GltUserTicketLog, GltUserTicketLogParam } from './model';
/**
* 分页查询消费日志
*/
export async function pageGltUserTicketLog(params: GltUserTicketLogParam) {
const res = await request.get<ApiResult<PageResult<GltUserTicketLog>>>(
'/glt/glt-user-ticket-log/page',
{
params
}
);
if (res.code === 0) {
return res.data;
}
return Promise.reject(new Error(res.message));
}
/**
* 查询消费日志列表
*/
export async function listGltUserTicketLog(params?: GltUserTicketLogParam) {
const res = await request.get<ApiResult<GltUserTicketLog[]>>(
'/glt/glt-user-ticket-log',
{
params
}
);
if (res.code === 0 && res.data) {
return res.data;
}
return Promise.reject(new Error(res.message));
}
/**
* 添加消费日志
*/
export async function addGltUserTicketLog(data: GltUserTicketLog) {
const res = await request.post<ApiResult<unknown>>(
'/glt/glt-user-ticket-log',
data
);
if (res.code === 0) {
return res.message;
}
return Promise.reject(new Error(res.message));
}
/**
* 修改消费日志
*/
export async function updateGltUserTicketLog(data: GltUserTicketLog) {
const res = await request.put<ApiResult<unknown>>(
'/glt/glt-user-ticket-log',
data
);
if (res.code === 0) {
return res.message;
}
return Promise.reject(new Error(res.message));
}
/**
* 删除消费日志
*/
export async function removeGltUserTicketLog(id?: number) {
const res = await request.del<ApiResult<unknown>>(
'/glt/glt-user-ticket-log/' + id
);
if (res.code === 0) {
return res.message;
}
return Promise.reject(new Error(res.message));
}
/**
* 批量删除消费日志
*/
export async function removeBatchGltUserTicketLog(data: (number | undefined)[]) {
const res = await request.del<ApiResult<unknown>>(
'/glt/glt-user-ticket-log/batch',
{
data
}
);
if (res.code === 0) {
return res.message;
}
return Promise.reject(new Error(res.message));
}
/**
* 根据id查询消费日志
*/
export async function getGltUserTicketLog(id: number) {
const res = await request.get<ApiResult<GltUserTicketLog>>(
'/glt/glt-user-ticket-log/' + id
);
if (res.code === 0 && res.data) {
return res.data;
}
return Promise.reject(new Error(res.message));
}

View File

@@ -0,0 +1,53 @@
import type { PageParam } from '@/api';
/**
* 消费日志
*/
export interface GltUserTicketLog {
//
id?: number;
// 用户水票ID
userTicketId?: number;
// 变更类型
changeType?: number;
// 可更改
changeAvailable?: number;
// 更改冻结状态
changeFrozen?: number;
// 已使用更改
changeUsed?: number;
// 可用后
availableAfter?: number;
// 冻结后
frozenAfter?: number;
// 使用后
usedAfter?: number;
// 订单ID
orderId?: number;
// 订单编号
orderNo?: string;
// 用户ID
userId?: number;
// 排序(数字越小越靠前)
sortNumber?: number;
// 备注
comments?: string;
// 状态, 0正常, 1冻结
status?: number;
// 是否删除, 0否, 1是
deleted?: number;
// 租户id
tenantId?: number;
// 创建时间
createTime?: string;
// 修改时间
updateTime?: string;
}
/**
* 消费日志搜索条件
*/
export interface GltUserTicketLogParam extends PageParam {
id?: number;
keywords?: string;
}

View File

@@ -0,0 +1,105 @@
import request from '@/utils/request';
import type { ApiResult, PageResult } from '@/api';
import type { GltUserTicketRelease, GltUserTicketReleaseParam } from './model';
/**
* 分页查询水票释放
*/
export async function pageGltUserTicketRelease(params: GltUserTicketReleaseParam) {
const res = await request.get<ApiResult<PageResult<GltUserTicketRelease>>>(
'/glt/glt-user-ticket-release/page',
{
params
}
);
if (res.code === 0) {
return res.data;
}
return Promise.reject(new Error(res.message));
}
/**
* 查询水票释放列表
*/
export async function listGltUserTicketRelease(params?: GltUserTicketReleaseParam) {
const res = await request.get<ApiResult<GltUserTicketRelease[]>>(
'/glt/glt-user-ticket-release',
{
params
}
);
if (res.code === 0 && res.data) {
return res.data;
}
return Promise.reject(new Error(res.message));
}
/**
* 添加水票释放
*/
export async function addGltUserTicketRelease(data: GltUserTicketRelease) {
const res = await request.post<ApiResult<unknown>>(
'/glt/glt-user-ticket-release',
data
);
if (res.code === 0) {
return res.message;
}
return Promise.reject(new Error(res.message));
}
/**
* 修改水票释放
*/
export async function updateGltUserTicketRelease(data: GltUserTicketRelease) {
const res = await request.put<ApiResult<unknown>>(
'/glt/glt-user-ticket-release',
data
);
if (res.code === 0) {
return res.message;
}
return Promise.reject(new Error(res.message));
}
/**
* 删除水票释放
*/
export async function removeGltUserTicketRelease(id?: number) {
const res = await request.del<ApiResult<unknown>>(
'/glt/glt-user-ticket-release/' + id
);
if (res.code === 0) {
return res.message;
}
return Promise.reject(new Error(res.message));
}
/**
* 批量删除水票释放
*/
export async function removeBatchGltUserTicketRelease(data: (number | undefined)[]) {
const res = await request.del<ApiResult<unknown>>(
'/glt/glt-user-ticket-release/batch',
{
data
}
);
if (res.code === 0) {
return res.message;
}
return Promise.reject(new Error(res.message));
}
/**
* 根据id查询水票释放
*/
export async function getGltUserTicketRelease(id: number) {
const res = await request.get<ApiResult<GltUserTicketRelease>>(
'/glt/glt-user-ticket-release/' + id
);
if (res.code === 0 && res.data) {
return res.data;
}
return Promise.reject(new Error(res.message));
}

View File

@@ -0,0 +1,38 @@
import type { PageParam } from '@/api';
/**
* 水票释放
*/
export interface GltUserTicketRelease {
//
id?: string;
// 水票ID
userTicketId?: string;
// 用户ID
userId?: number;
// 周期编号
periodNo?: number;
// 释放数量
releaseQty?: number;
// 释放时间
releaseTime?: string;
// 状态
status?: number;
// 是否删除, 0否, 1是
deleted?: number;
// 租户id
tenantId?: number;
// 创建时间
createTime?: string;
// 修改时间
updateTime?: string;
}
/**
* 水票释放搜索条件
*/
export interface GltUserTicketReleaseParam extends PageParam {
id?: number;
userId?: number;
keywords?: string;
}