feat：【mall 商城】API 风格调整

apps/web-antd/src/api/mall/promotion/article/index.ts

@@ -5,32 +5,19 @@ import { requestClient } from '#/api/request';
 export namespace MallArticleApi {
   /** 文章管理 */
   export interface Article {
-    /** 文章编号 */
-    id: number;
-    /** 分类编号 */
-    categoryId: number;
-    /** 文章标题 */
-    title: string;
-    /** 作者 */
-    author: string;
-    /** 封面图 */
-    picUrl: string;
-    /** 文章简介 */
-    introduction: string;
-    /** 浏览数量 */
-    browseCount: string;
-    /** 排序 */
-    sort: number;
-    /** 状态 */
-    status: number;
-    /** 商品编号 */
-    spuId: number;
-    /** 是否热门 */
-    recommendHot: boolean;
-    /** 是否轮播图 */
-    recommendBanner: boolean;
-    /** 文章内容 */
-    content: string;
+    id: number; // 文章编号
+    categoryId: number; // 分类编号
+    title: string; // 文章标题
+    author: string; // 作者
+    picUrl: string; // 封面图
+    introduction: string; // 文章简介
+    browseCount: string; // 浏览数量
+    sort: number; // 排序
+    status: number; // 状态
+    spuId: number; // 商品编号
+    recommendHot: boolean; // 是否热门
+    recommendBanner: boolean; // 是否轮播图
+    content: string; // 文章内容
   }
 }
 

apps/web-antd/src/api/mall/promotion/articleCategory/index.ts

@@ -5,16 +5,11 @@ import { requestClient } from '#/api/request';
 export namespace MallArticleCategoryApi {
   /** 文章分类 */
   export interface ArticleCategory {
-    /** 分类编号 */
-    id: number;
-    /** 分类名称 */
-    name: string;
-    /** 分类图片 */
-    picUrl: string;
-    /** 状态 */
-    status: number;
-    /** 排序 */
-    sort: number;
+    id: number; // 分类编号
+    name: string; // 分类名称
+    picUrl: string; // 分类图片
+    status: number; // 状态
+    sort: number; // 排序
   }
 }
 

apps/web-antd/src/api/mall/promotion/bargain/bargainActivity.ts

@@ -7,62 +7,40 @@ import { requestClient } from '#/api/request';
 export namespace MallBargainActivityApi {
   /** 砍价活动 */
   export interface BargainActivity {
-    /** 活动编号 */
-    id?: number;
-    /** 活动名称 */
-    name?: string;
-    /** 开始时间 */
-    startTime?: Date;
-    /** 结束时间 */
-    endTime?: Date;
-    /** 状态 */
-    status?: number;
-    /** 达到该人数，才能砍到低价 */
-    helpMaxCount?: number;
-    /** 最大帮砍次数 */
-    bargainCount?: number;
-    /** 最大购买次数 */
-    totalLimitCount?: number;
-    /** 商品 SPU 编号 */
-    spuId: number;
-    /** 商品 SKU 编号 */
-    skuId: number;
-    /** 砍价起始价格，单位分 */
-    bargainFirstPrice: number;
-    /** 砍价底价 */
-    bargainMinPrice: number;
-    /** 活动库存 */
-    stock: number;
-    /** 用户每次砍价的最小金额，单位：分 */
-    randomMinPrice?: number;
-    /** 用户每次砍价的最大金额，单位：分 */
-    randomMaxPrice?: number;
+    id?: number; // 活动编号
+    name?: string; // 活动名称
+    startTime?: Date; // 开始时间
+    endTime?: Date; // 结束时间
+    status?: number; // 状态
+    helpMaxCount?: number; // 达到该人数，才能砍到低价
+    bargainCount?: number; // 最大帮砍次数
+    totalLimitCount?: number; // 最大购买次数
+    spuId: number; // 商品 SPU 编号
+    skuId: number; // 商品 SKU 编号
+    bargainFirstPrice: number; // 砍价起始价格，单位分
+    bargainMinPrice: number; // 砍价底价
+    stock: number; // 活动库存
+    randomMinPrice?: number; // 用户每次砍价的最小金额，单位：分
+    randomMaxPrice?: number; // 用户每次砍价的最大金额，单位：分
   }
 
   /** 砍价活动所需属性。选择的商品和属性的时候使用方便使用活动的通用封装 */
   export interface BargainProduct {
-    /** 商品 SPU 编号 */
-    spuId: number;
-    /** 商品 SKU 编号 */
-    skuId: number;
-    /** 砍价起始价格，单位分 */
-    bargainFirstPrice: number;
-    /** 砍价底价 */
-    bargainMinPrice: number;
-    /** 活动库存 */
-    stock: number;
+    spuId: number; // 商品 SPU 编号
+    skuId: number; // 商品 SKU 编号
+    bargainFirstPrice: number; // 砍价起始价格，单位分
+    bargainMinPrice: number; // 砍价底价
+    stock: number; // 活动库存
   }
 
   /** 扩展 SKU 配置 */
   export type SkuExtension = {
-    /** 砍价活动配置 */
-    productConfig: BargainProduct;
+    productConfig: BargainProduct; // 砍价活动配置
   } & MallSpuApi.Sku;
 
   /** 扩展 SPU 配置 */
   export interface SpuExtension extends MallSpuApi.Spu {
-    /** SKU 列表 */
-    skus: SkuExtension[];
+    skus: SkuExtension[]; // SKU 列表
   }
 }
 

apps/web-antd/src/api/mall/promotion/bargain/bargainHelp.ts

@@ -5,16 +5,11 @@ import { requestClient } from '#/api/request';
 export namespace MallBargainHelpApi {
   /** 砍价记录 */
   export interface BargainHelp {
-    /** 记录编号 */
-    id: number;
-    /** 砍价记录编号 */
-    record: number;
-    /** 用户编号 */
-    userId: number;
-    /** 砍掉金额 */
-    reducePrice: number;
-    /** 结束时间 */
-    endTime: Date;
+    id: number; // 记录编号
+    record: number; // 砍价记录编号
+    userId: number; // 用户编号
+    reducePrice: number; // 砍掉金额
+    endTime: Date; // 结束时间
   }
 }
 

apps/web-antd/src/api/mall/promotion/bargain/bargainRecord.ts

@@ -5,26 +5,16 @@ import { requestClient } from '#/api/request';
 export namespace MallBargainRecordApi {
   /** 砍价记录 */
   export interface BargainRecord {
-    /** 记录编号 */
-    id: number;
-    /** 活动编号 */
-    activityId: number;
-    /** 用户编号 */
-    userId: number;
-    /** 商品 SPU 编号 */
-    spuId: number;
-    /** 商品 SKU 编号 */
-    skuId: number;
-    /** 砍价起始价格 */
-    bargainFirstPrice: number;
-    /** 砍价价格 */
-    bargainPrice: number;
-    /** 状态 */
-    status: number;
-    /** 订单编号 */
-    orderId: number;
-    /** 结束时间 */
-    endTime: Date;
+    id: number; // 记录编号
+    activityId: number; // 活动编号
+    userId: number; // 用户编号
+    spuId: number; // 商品 SPU 编号
+    skuId: number; // 商品 SKU 编号
+    bargainFirstPrice: number; // 砍价起始价格
+    bargainPrice: number; // 砍价价格
+    status: number; // 状态
+    orderId: number; // 订单编号
+    endTime: Date; // 结束时间
   }
 }
 

apps/web-antd/src/api/mall/promotion/combination/combinationActivity.ts

@@ -7,59 +7,38 @@ import { requestClient } from '#/api/request';
 export namespace MallCombinationActivityApi {
   /** 拼团活动所需属性 */
   export interface CombinationProduct {
-    /** 商品 SPU 编号 */
-    spuId: number;
-    /** 商品 SKU 编号 */
-    skuId: number;
-    /** 拼团价格 */
-    combinationPrice: number;
+    spuId: number; // 商品 SPU 编号
+    skuId: number; // 商品 SKU 编号
+    combinationPrice: number; // 拼团价格
   }
   /** 拼团活动 */
   export interface CombinationActivity {
-    /** 活动编号 */
-    id?: number;
-    /** 活动名称 */
-    name?: string;
-    /** 商品 SPU 编号 */
-    spuId?: number;
-    /** 总限购数量 */
-    totalLimitCount?: number;
-    /** 单次限购数量 */
-    singleLimitCount?: number;
-    /** 开始时间 */
-    startTime?: Date;
-    /** 结束时间 */
-    endTime?: Date;
-    /** 用户数量 */
-    userSize?: number;
-    /** 总数量 */
-    totalCount?: number;
-    /** 成功数量 */
-    successCount?: number;
-    /** 订单用户数量 */
-    orderUserCount?: number;
-    /** 虚拟成团 */
-    virtualGroup?: number;
-    /** 状态 */
-    status?: number;
-    /** 限制时长 */
-    limitDuration?: number;
-    /** 拼团价格 */
-    combinationPrice?: number;
-    /** 商品列表 */
-    products: CombinationProduct[];
+    id?: number; // 活动编号
+    name?: string; // 活动名称
+    spuId?: number; // 商品 SPU 编号
+    totalLimitCount?: number; // 总限购数量
+    singleLimitCount?: number; // 单次限购数量
+    startTime?: Date; // 开始时间
+    endTime?: Date; // 结束时间
+    userSize?: number; // 用户数量
+    totalCount?: number; // 总数量
+    successCount?: number; // 成功数量
+    orderUserCount?: number; // 订单用户数量
+    virtualGroup?: number; // 虚拟成团
+    status?: number; // 状态
+    limitDuration?: number; // 限制时长
+    combinationPrice?: number; // 拼团价格
+    products: CombinationProduct[]; // 商品列表
   }
 
   /** 扩展 SKU 配置 */
   export type SkuExtension = {
-    /** 拼团活动配置 */
-    productConfig: CombinationProduct;
+    productConfig: CombinationProduct; // 拼团活动配置
   } & MallSpuApi.Sku;
 
   /** 扩展 SPU 配置 */
   export interface SpuExtension extends MallSpuApi.Spu {
-    /** SKU 列表 */
-    skus: SkuExtension[];
+    skus: SkuExtension[]; // SKU 列表
   }
 }
 

apps/web-antd/src/api/mall/promotion/combination/combinationRecord.ts

@@ -5,44 +5,27 @@ import { requestClient } from '#/api/request';
 export namespace MallCombinationRecordApi {
   /** 拼团记录 */
   export interface CombinationRecord {
-    /** 拼团记录编号 */
-    id: number;
-    /** 拼团活动编号 */
-    activityId: number;
-    /** 用户昵称 */
-    nickname: string;
-    /** 用户头像 */
-    avatar: string;
-    /** 团长编号 */
-    headId: number;
-    /** 过期时间 */
-    expireTime: string;
-    /** 可参团人数 */
-    userSize: number;
-    /** 已参团人数 */
-    userCount: number;
-    /** 拼团状态 */
-    status: number;
-    /** 商品名字 */
-    spuName: string;
-    /** 商品图片 */
-    picUrl: string;
-    /** 是否虚拟成团 */
-    virtualGroup: boolean;
-    /** 开始时间 (订单付款后开始的时间) */
-    startTime: string;
-    /** 结束时间（成团时间/失败时间） */
-    endTime: string;
+    id: number; // 拼团记录编号
+    activityId: number; // 拼团活动编号
+    nickname: string; // 用户昵称
+    avatar: string; // 用户头像
+    headId: number; // 团长编号
+    expireTime: string; // 过期时间
+    userSize: number; // 可参团人数
+    userCount: number; // 已参团人数
+    status: number; // 拼团状态
+    spuName: string; // 商品名字
+    picUrl: string; // 商品图片
+    virtualGroup: boolean; // 是否虚拟成团
+    startTime: string; // 开始时间 (订单付款后开始的时间)
+    endTime: string; // 结束时间（成团时间/失败时间）
   }
 
   /** 拼团记录概要信息 */
   export interface RecordSummary {
-    /** 待成团数量 */
-    pendingCount: number;
-    /** 已成团数量 */
-    successCount: number;
-    /** 已失败数量 */
-    failCount: number;
+    pendingCount: number; // 待成团数量
+    successCount: number; // 已成团数量
+    failCount: number; // 已失败数量
   }
 }
 

apps/web-antd/src/api/mall/promotion/coupon/couponTemplate.ts

@@ -5,54 +5,32 @@ import { requestClient } from '#/api/request';
 export namespace MallCouponTemplateApi {
   /** 优惠券模板 */
   export interface CouponTemplate {
-    /** 模板编号 */
-    id: number;
-    /** 模板名称 */
-    name: string;
-    /** 状态 */
-    status: number;
-    /** 发放数量 */
-    totalCount: number;
-    /** 每人限领个数 */
-    takeLimitCount: number;
-    /** 领取方式 */
-    takeType: number;
-    /** 使用门槛 */
-    usePrice: number;
-    /** 商品范围 */
-    productScope: number;
-    /** 商品范围值 */
-    productScopeValues: number[];
-    /** 有效期类型 */
-    validityType: number;
-    /** 固定日期-生效开始时间 */
-    validStartTime: Date;
-    /** 固定日期-生效结束时间 */
-    validEndTime: Date;
-    /** 领取日期-开始天数 */
-    fixedStartTerm: number;
-    /** 领取日期-结束天数 */
-    fixedEndTerm: number;
-    /** 优惠类型 */
-    discountType: number;
-    /** 折扣百分比 */
-    discountPercent: number;
-    /** 优惠金额 */
-    discountPrice: number;
-    /** 折扣上限 */
-    discountLimitPrice: number;
-    /** 已领取数量 */
-    takeCount: number;
-    /** 已使用数量 */
-    useCount: number;
+    id: number; // 模板编号
+    name: string; // 模板名称
+    status: number; // 状态
+    totalCount: number; // 发放数量
+    takeLimitCount: number; // 每人限领个数
+    takeType: number; // 领取方式
+    usePrice: number; // 使用门槛
+    productScope: number; // 商品范围
+    productScopeValues: number[]; // 商品范围值
+    validityType: number; // 有效期类型
+    validStartTime: Date; // 固定日期-生效开始时间
+    validEndTime: Date; // 固定日期-生效结束时间
+    fixedStartTerm: number; // 领取日期-开始天数
+    fixedEndTerm: number; // 领取日期-结束天数
+    discountType: number; // 优惠类型
+    discountPercent: number; // 折扣百分比
+    discountPrice: number; // 优惠金额
+    discountLimitPrice: number; // 折扣上限
+    takeCount: number; // 已领取数量
+    useCount: number; // 已使用数量
   }
 
   /** 优惠券模板状态更新 */
   export interface StatusUpdate {
-    /** 模板编号 */
-    id: number;
-    /** 状态 */
-    status: 0 | 1;
+    id: number; // 模板编号
+    status: 0 | 1; // 状态
   }
 }
 

apps/web-antd/src/api/mall/promotion/discount/discountActivity.ts

@@ -7,48 +7,33 @@ import { requestClient } from '#/api/request';
 export namespace MallDiscountActivityApi {
   /** 限时折扣相关属性 */
   export interface DiscountProduct {
-    /** 商品 SPU 编号 */
-    spuId: number;
-    /** 商品 SKU 编号 */
-    skuId: number;
-    /** 折扣类型 */
-    discountType: number;
-    /** 折扣百分比 */
-    discountPercent: number;
-    /** 折扣价格 */
-    discountPrice: number;
+    spuId: number; // 商品 SPU 编号
+    skuId: number; // 商品 SKU 编号
+    discountType: number; // 折扣类型
+    discountPercent: number; // 折扣百分比
+    discountPrice: number; // 折扣价格
   }
 
   /** 限时折扣活动 */
   export interface DiscountActivity {
-    /** 活动编号 */
-    id?: number;
-    /** 商品 SPU 编号 */
-    spuId?: number;
-    /** 活动名称 */
-    name?: string;
-    /** 状态 */
-    status?: number;
-    /** 备注 */
-    remark?: string;
-    /** 开始时间 */
-    startTime?: Date;
-    /** 结束时间 */
-    endTime?: Date;
-    /** 商品列表 */
-    products?: DiscountProduct[];
+    id?: number; // 活动编号
+    spuId?: number; // 商品 SPU 编号
+    name?: string; // 活动名称
+    status?: number; // 状态
+    remark?: string; // 备注
+    startTime?: Date; // 开始时间
+    endTime?: Date; // 结束时间
+    products?: DiscountProduct[]; // 商品列表
   }
 
   /** 扩展 SKU 配置 */
   export type SkuExtension = {
-    /** 限时折扣配置 */
-    productConfig: DiscountProduct;
+    productConfig: DiscountProduct; // 限时折扣配置
   } & MallSpuApi.Sku;
 
   /** 扩展 SPU 配置 */
   export interface SpuExtension extends MallSpuApi.Spu {
-    /** SKU 列表 */
-    skus: SkuExtension[];
+    skus: SkuExtension[]; // SKU 列表
   }
 }
 

apps/web-antd/src/api/mall/promotion/diy/page.ts

@@ -5,18 +5,12 @@ import { requestClient } from '#/api/request';
 export namespace MallDiyPageApi {
   /** 装修页面 */
   export interface DiyPage {
-    /** 页面编号 */
-    id?: number;
-    /** 模板编号 */
-    templateId?: number;
-    /** 页面名称 */
-    name: string;
-    /** 备注 */
-    remark: string;
-    /** 预览图片地址数组 */
-    previewPicUrls: string[];
-    /** 页面属性 */
-    property: string;
+    id?: number; // 页面编号
+    templateId?: number; // 模板编号
+    name: string; // 页面名称
+    remark: string; // 备注
+    previewPicUrls: string[]; // 预览图片地址数组
+    property: string; // 页面属性
   }
 }
 

apps/web-antd/src/api/mall/promotion/diy/template.ts

@@ -7,26 +7,18 @@ import { requestClient } from '#/api/request';
 export namespace MallDiyTemplateApi {
   /** 装修模板 */
   export interface DiyTemplate {
-    /** 模板编号 */
-    id?: number;
-    /** 模板名称 */
-    name: string;
-    /** 是否使用 */
-    used: boolean;
-    /** 使用时间 */
-    usedTime?: Date;
-    /** 备注 */
-    remark: string;
-    /** 预览图片地址数组 */
-    previewPicUrls: string[];
-    /** 模板属性 */
-    property: string;
+    id?: number; // 模板编号
+    name: string; // 模板名称
+    used: boolean; // 是否使用
+    usedTime?: Date; // 使用时间
+    remark: string; // 备注
+    previewPicUrls: string[]; // 预览图片地址数组
+    property: string; // 模板属性
   }
 
   /** 装修模板属性（包含页面列表） */
   export interface DiyTemplateProperty extends DiyTemplate {
-    /** 页面列表 */
-    pages: MallDiyPageApi.DiyPage[];
+    pages: MallDiyPageApi.DiyPage[]; // 页面列表
   }
 }
 

apps/web-antd/src/api/mall/promotion/kefu/conversation/index.ts

@@ -5,38 +5,24 @@ import { requestClient } from '#/api/request';
 export namespace MallKefuConversationApi {
   /** 客服会话 */
   export interface Conversation {
-    /** 编号 */
-    id: number;
-    /** 会话所属用户 */
-    userId: number;
-    /** 会话所属用户头像 */
-    userAvatar: string;
-    /** 会话所属用户昵称 */
-    userNickname: string;
-    /** 最后聊天时间 */
-    lastMessageTime: Date;
-    /** 最后聊天内容 */
-    lastMessageContent: string;
-    /** 最后发送的消息类型 */
-    lastMessageContentType: number;
-    /** 管理端置顶 */
-    adminPinned: boolean;
-    /** 用户是否可见 */
-    userDeleted: boolean;
-    /** 管理员是否可见 */
-    adminDeleted: boolean;
-    /** 管理员未读消息数 */
-    adminUnreadMessageCount: number;
-    /** 创建时间 */
-    createTime?: string;
+    id: number; // 编号
+    userId: number; // 会话所属用户
+    userAvatar: string; // 会话所属用户头像
+    userNickname: string; // 会话所属用户昵称
+    lastMessageTime: Date; // 最后聊天时间
+    lastMessageContent: string; // 最后聊天内容
+    lastMessageContentType: number; // 最后发送的消息类型
+    adminPinned: boolean; // 管理端置顶
+    userDeleted: boolean; // 用户是否可见
+    adminDeleted: boolean; // 管理员是否可见
+    adminUnreadMessageCount: number; // 管理员未读消息数
+    createTime?: string; // 创建时间
   }
 
   /** 会话置顶请求 */
   export interface ConversationPinnedUpdate {
-    /** 会话编号 */
-    id: number;
-    /** 是否置顶 */
-    pinned: boolean;
+    id: number; // 会话编号
+    pinned: boolean; // 是否置顶
   }
 }
 

apps/web-antd/src/api/mall/promotion/kefu/message/index.ts

@@ -5,44 +5,29 @@ import { requestClient } from '#/api/request';
 export namespace MallKefuMessageApi {
   /** 客服消息 */
   export interface Message {
-    /** 编号 */
-    id: number;
-    /** 会话编号 */
-    conversationId: number;
-    /** 发送人编号 */
-    senderId: number;
-    /** 发送人头像 */
-    senderAvatar: string;
-    /** 发送人类型 */
-    senderType: number;
-    /** 接收人编号 */
-    receiverId: number;
-    /** 接收人类型 */
-    receiverType: number;
-    /** 消息类型 */
-    contentType: number;
-    /** 消息内容 */
-    content: string;
-    /** 是否已读 */
-    readStatus: boolean;
-    /** 创建时间 */
-    createTime: Date;
+    id: number; // 编号
+    conversationId: number; // 会话编号
+    senderId: number; // 发送人编号
+    senderAvatar: string; // 发送人头像
+    senderType: number; // 发送人类型
+    receiverId: number; // 接收人编号
+    receiverType: number; // 接收人类型
+    contentType: number; // 消息类型
+    content: string; // 消息内容
+    readStatus: boolean; // 是否已读
+    createTime: Date; // 创建时间
   }
 
   /** 发送消息请求 */
   export interface MessageSend {
-    /** 会话编号 */
-    conversationId: number;
-    /** 消息类型 */
-    contentType: number;
-    /** 消息内容 */
-    content: string;
+    conversationId: number; // 会话编号
+    contentType: number; // 消息类型
+    content: string; // 消息内容
   }
 
   /** 消息列表查询参数 */
   export interface MessageQuery extends PageParam {
-    /** 会话编号 */
-    conversationId: number;
+    conversationId: number; // 会话编号
   }
 }
 

apps/web-antd/src/api/mall/promotion/point/index.ts

@@ -7,80 +7,51 @@ import { requestClient } from '#/api/request';
 export namespace MallPointActivityApi {
   /** 积分商城商品 */
   export interface PointProduct {
-    /** 积分商城商品编号 */
-    id?: number;
-    /** 积分商城活动 id */
-    activityId?: number;
-    /** 商品 SPU 编号 */
-    spuId?: number;
-    /** 商品 SKU 编号 */
-    skuId: number;
-    /** 可兑换数量 */
-    count: number;
-    /** 兑换积分 */
-    point: number;
-    /** 兑换金额，单位：分 */
-    price: number;
-    /** 积分商城商品库存 */
-    stock: number;
-    /** 积分商城商品状态 */
-    activityStatus?: number;
+    id?: number; // 积分商城商品编号
+    activityId?: number; // 积分商城活动 id
+    spuId?: number; // 商品 SPU 编号
+    skuId: number; // 商品 SKU 编号
+    count: number; // 可兑换数量
+    point: number; // 兑换积分
+    price: number; // 兑换金额，单位：分
+    stock: number; // 积分商城商品库存
+    activityStatus?: number; // 积分商城商品状态
   }
 
   /** 积分商城活动 */
   export interface PointActivity {
-    /** 积分商城活动编号 */
-    id: number;
-    /** 积分商城活动商品 */
-    spuId: number;
-    /** 活动状态 */
-    status: number;
-    /** 积分商城活动库存 */
-    stock: number;
-    /** 积分商城活动总库存 */
-    totalStock: number;
-    /** 备注 */
-    remark?: string;
-    /** 排序 */
-    sort: number;
-    /** 创建时间 */
-    createTime: string;
-    /** 积分商城商品 */
-    products: PointProduct[];
-    /** 商品名称 */
-    spuName: string;
-    /** 商品主图 */
-    picUrl: string;
-    /** 商品市场价，单位：分 */
-    marketPrice: number;
-    /** 兑换积分 */
-    point: number;
-    /** 兑换金额，单位：分 */
-    price: number;
+    id: number; // 积分商城活动编号
+    spuId: number; // 积分商城活动商品
+    status: number; // 活动状态
+    stock: number; // 积分商城活动库存
+    totalStock: number; // 积分商城活动总库存
+    remark?: string; // 备注
+    sort: number; // 排序
+    createTime: string; // 创建时间
+    products: PointProduct[]; // 积分商城商品
+    spuName: string; // 商品名称
+    picUrl: string; // 商品主图
+    marketPrice: number; // 商品市场价，单位：分
+    point: number; // 兑换积分
+    price: number; // 兑换金额，单位：分
   }
 
   /** 扩展 SKU 配置 */
   export type SkuExtension = {
-    /** 积分商城商品配置 */
-    productConfig: PointProduct;
+    productConfig: PointProduct; // 积分商城商品配置
   } & MallSpuApi.Sku;
 
   /** 扩展 SPU 配置 */
   export interface SpuExtension extends MallSpuApi.Spu {
-    /** SKU 列表 */
-    skus: SkuExtension[];
+    skus: SkuExtension[]; // SKU 列表
   }
 
   /** 扩展 SPU 配置（带积分信息） */
   export interface SpuExtensionWithPoint extends MallSpuApi.Spu {
-    /** 积分商城活动库存 */
-    pointStock: number;
-    /** 积分商城活动总库存 */
-    pointTotalStock: number;
-    /** 兑换积分 */
-    point: number;
-    /** 兑换金额，单位：分 */
-    pointPrice: number;
+    pointStock: number; // 积分商城活动库存
+    pointTotalStock: number; // 积分商城活动总库存
+    point: number; // 兑换积分
+    pointPrice: number; // 兑换金额，单位：分
   }
 }
 

apps/web-antd/src/api/mall/promotion/reward/rewardActivity.ts

@@ -5,46 +5,29 @@ import { requestClient } from '#/api/request';
 export namespace MallRewardActivityApi {
   /** 优惠规则 */
   export interface RewardRule {
-    /** 满足金额 */
-    limit?: number;
-    /** 优惠金额 */
-    discountPrice?: number;
-    /** 是否包邮 */
-    freeDelivery?: boolean;
-    /** 赠送积分 */
-    point: number;
-    /** 赠送优惠券数量 */
+    limit?: number; // 满足金额
+    discountPrice?: number; // 优惠金额
+    freeDelivery?: boolean; // 是否包邮
+    point: number; // 赠送积分
     giveCouponTemplateCounts?: {
       [key: number]: number;
-    };
+    }; // 赠送优惠券数量
   }
 
   /** 满减送活动 */
   export interface RewardActivity {
-    /** 活动编号 */
-    id?: number;
-    /** 活动名称 */
-    name?: string;
-    /** 开始时间 */
-    startTime?: Date;
-    /** 结束时间 */
-    endTime?: Date;
-    /** 开始和结束时间（仅前端使用） */
-    startAndEndTime?: Date[];
-    /** 备注 */
-    remark?: string;
-    /** 条件类型 */
-    conditionType?: number;
-    /** 商品范围 */
-    productScope?: number;
-    /** 优惠规则列表 */
-    rules: RewardRule[];
-    /** 商品范围值（仅表单使用）：值为品类编号列表、商品编号列表 */
-    productScopeValues?: number[];
-    /** 商品分类编号列表（仅表单使用） */
-    productCategoryIds?: number[];
-    /** 商品 SPU 编号列表（仅表单使用） */
-    productSpuIds?: number[];
+    id?: number; // 活动编号
+    name?: string; // 活动名称
+    startTime?: Date; // 开始时间
+    endTime?: Date; // 结束时间
+    startAndEndTime?: Date[]; // 开始和结束时间（仅前端使用）
+    remark?: string; // 备注
+    conditionType?: number; // 条件类型
+    productScope?: number; // 商品范围
+    rules: RewardRule[]; // 优惠规则列表
+    productScopeValues?: number[]; // 商品范围值（仅表单使用）：值为品类编号列表、商品编号列表
+    productCategoryIds?: number[]; // 商品分类编号列表（仅表单使用）
+    productSpuIds?: number[]; // 商品 SPU 编号列表（仅表单使用）
   }
 }
 

apps/web-antd/src/api/mall/promotion/seckill/seckillActivity.ts

@@ -7,66 +7,42 @@ import { requestClient } from '#/api/request';
 export namespace MallSeckillActivityApi {
   /** 秒杀商品 */
   export interface SeckillProduct {
-    /** 商品 SKU 编号 */
-    skuId: number;
-    /** 商品 SPU 编号 */
-    spuId: number;
-    /** 秒杀价格 */
-    seckillPrice: number;
-    /** 秒杀库存 */
-    stock: number;
+    skuId: number; // 商品 SKU 编号
+    spuId: number; // 商品 SPU 编号
+    seckillPrice: number; // 秒杀价格
+    stock: number; // 秒杀库存
   }
 
   /** 秒杀活动 */
   export interface SeckillActivity {
-    /** 活动编号 */
-    id?: number;
-    /** 商品 SPU 编号 */
-    spuId?: number;
-    /** 活动名称 */
-    name?: string;
-    /** 活动状态 */
-    status?: number;
-    /** 备注 */
-    remark?: string;
-    /** 开始时间 */
-    startTime?: Date;
-    /** 结束时间 */
-    endTime?: Date;
-    /** 排序 */
-    sort?: number;
-    /** 配置编号 */
-    configIds?: string;
-    /** 订单数量 */
-    orderCount?: number;
-    /** 用户数量 */
-    userCount?: number;
-    /** 总金额 */
-    totalPrice?: number;
-    /** 总限购数量 */
-    totalLimitCount?: number;
-    /** 单次限购数量 */
-    singleLimitCount?: number;
-    /** 秒杀库存 */
-    stock?: number;
-    /** 秒杀总库存 */
-    totalStock?: number;
-    /** 秒杀价格 */
-    seckillPrice?: number;
-    /** 秒杀商品列表 */
-    products?: SeckillProduct[];
+    id?: number; // 活动编号
+    spuId?: number; // 商品 SPU 编号
+    name?: string; // 活动名称
+    status?: number; // 活动状态
+    remark?: string; // 备注
+    startTime?: Date; // 开始时间
+    endTime?: Date; // 结束时间
+    sort?: number; // 排序
+    configIds?: string; // 配置编号
+    orderCount?: number; // 订单数量
+    userCount?: number; // 用户数量
+    totalPrice?: number; // 总金额
+    totalLimitCount?: number; // 总限购数量
+    singleLimitCount?: number; // 单次限购数量
+    stock?: number; // 秒杀库存
+    totalStock?: number; // 秒杀总库存
+    seckillPrice?: number; // 秒杀价格
+    products?: SeckillProduct[]; // 秒杀商品列表
   }
 
   /** 扩展 SKU 配置 */
   export type SkuExtension = {
-    /** 秒杀商品配置 */
-    productConfig: SeckillProduct;
+    productConfig: SeckillProduct; // 秒杀商品配置
   } & MallSpuApi.Sku;
 
   /** 扩展 SPU 配置 */
   export interface SpuExtension extends MallSpuApi.Spu {
-    /** SKU 列表 */
-    skus: SkuExtension[];
+    skus: SkuExtension[]; // SKU 列表
   }
 }
 

apps/web-antd/src/api/mall/promotion/seckill/seckillConfig.ts

@@ -5,26 +5,18 @@ import { requestClient } from '#/api/request';
 export namespace MallSeckillConfigApi {
   /** 秒杀时段 */
   export interface SeckillConfig {
-    /** 编号 */
-    id: number;
-    /** 秒杀时段名称 */
-    name: string;
-    /** 开始时间点 */
-    startTime: string;
-    /** 结束时间点 */
-    endTime: string;
-    /** 秒杀轮播图 */
-    sliderPicUrls: string[];
-    /** 活动状态 */
-    status: number;
+    id: number; // 编号
+    name: string; // 秒杀时段名称
+    startTime: string; // 开始时间点
+    endTime: string; // 结束时间点
+    sliderPicUrls: string[]; // 秒杀轮播图
+    status: number; // 活动状态
   }
 
   /** 时段配置状态更新 */
   export interface StatusUpdate {
-    /** 编号 */
-    id: number;
-    /** 状态 */
-    status: number;
+    id: number; // 编号
+    status: number; // 状态
   }
 }