docs: 更新优惠券相关文档- 新增优惠券API集成文档

- 新增优惠券卡片对齐修复文档
- 新增优惠券状态显示调试文档
- 新增优惠券组件警告修复文档- 更新用ShopInfo Hook字段迁移文档
- 更新Arguments关键字修复文档

src/api/shop/shopUserCoupon/model/index.ts

@@ -32,8 +32,16 @@ export interface ShopUserCoupon {
   endTime?: string;
   // 使用状态(0未使用 1已使用 2已过期)
   status?: number;
+  // 状态文本描述
+  statusText?: string;
   // 是否过期, 0否, 1是
   isExpire?: number;
+  // 是否即将过期（后端计算）
+  isExpiringSoon?: boolean;
+  // 剩余天数（后端计算）
+  daysRemaining?: number;
+  // 剩余小时数（后端计算）
+  hoursRemaining?: number;
   // 使用时间
   useTime?: string;
   // 使用订单ID
@@ -63,5 +71,13 @@ export interface ShopUserCouponParam extends PageParam {
   isExpire?: number;
   sortBy?: string;
   sortOrder?: string;
+  // 仅查询有效的优惠券
+  validOnly?: boolean;
+  // 仅查询已过期的优惠券
+  expired?: boolean;
+  // 查询即将过期的优惠券
+  expiringSoon?: boolean;
+  // 当前时间（用于测试）
+  currentTime?: string;
   keywords?: string;
 }