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

apps/web-antd/src/api/mall/product/comment.ts

@@ -4,47 +4,47 @@ import { requestClient } from '#/api/request';
 
 export namespace MallCommentApi {
   export interface Property {
-    propertyId: number;
-    propertyName: string;
-    valueId: number;
-    valueName: string;
+    propertyId: number; // 属性 ID
+    propertyName: string; // 属性名称
+    valueId: number; // 属性值 ID
+    valueName: string; // 属性值名称
   }
   /** 商品评论 */
   export interface Comment {
-    id: number;
-    userId: number;
-    userNickname: string;
-    userAvatar: string;
-    anonymous: boolean;
-    orderId: number;
-    orderItemId: number;
-    spuId: number;
-    spuName: string;
-    skuId: number;
-    visible: boolean;
-    scores: number;
-    descriptionScores: number;
-    benefitScores: number;
-    content: string;
-    picUrls: string[];
-    replyStatus: boolean;
-    replyUserId: number;
-    replyContent: string;
-    replyTime: Date;
-    createTime: Date;
-    skuProperties: Property[];
+    id: number; // 评论编号
+    userId: number; // 用户编号
+    userNickname: string; // 用户昵称
+    userAvatar: string; // 用户头像
+    anonymous: boolean; // 是否匿名
+    orderId: number; // 订单编号
+    orderItemId: number; // 订单项编号
+    spuId: number; // 商品SPU编号
+    spuName: string; // 商品名称
+    skuId: number; // 商品SKU编号
+    visible: boolean; // 是否可见
+    scores: number; // 总评分
+    descriptionScores: number; // 描述评分
+    benefitScores: number; // 服务评分
+    content: string; // 评论内容
+    picUrls: string[]; // 评论图片
+    replyStatus: boolean; // 是否回复
+    replyUserId: number; // 回复人编号
+    replyContent: string; // 回复内容
+    replyTime: Date; // 回复时间
+    createTime: Date; // 创建时间
+    skuProperties: Property[]; // SKU 属性数组
   }
 
   /** 评论可见性更新 */
   export interface CommentVisibleUpdate {
-    id: number;
-    visible: boolean;
+    id: number; // 评论编号
+    visible: boolean; // 是否可见
   }
 
   /** 评论回复 */
   export interface CommentReply {
-    id: number;
-    replyContent: string;
+    id: number; // 评论编号
+    replyContent: string; // 回复内容
   }
 }