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

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

docs/TAB_SWITCH_DATA_FIX.md

@@ -0,0 +1,196 @@
+# 🔄 Tab切换数据丢失问题修复
+
+## 🚨 问题描述
+
+用户反馈：
+- **可用状态下的数据**：默认能看到优惠券
+- **切换Tab后**：数据消失，其他Tab显示空状态
+- **问题现象**：只有"可用"Tab有数据，"已使用"和"已过期"Tab没有数据
+
+## 🔍 问题分析
+
+### 根本原因
+Tab切换时存在**状态更新时序问题**：
+
+```typescript
+// 问题代码
+const handleTabChange = (value: string | number) => {
+  setActiveTab(tabValue)  // 1. 设置新Tab
+  // ...
+  setTimeout(() => {
+    reload(true)          // 2. 延迟调用reload
+  }, 100)
+}
+
+const reload = async (isRefresh = false) => {
+  const statusFilter = getStatusFilter() // 3. 但这里用的还是旧的activeTab！
+  // ...
+}
+```
+
+**问题**：
+1. `setActiveTab(tabValue)` 是异步的
+2. `setTimeout` 中的 `reload()` 可能在状态更新前执行
+3. `getStatusFilter()` 读取的是旧的 `activeTab` 值
+4. 导致请求参数错误，获取不到正确数据
+
+### 状态更新时序图
+```
+时间轴: ----1----2----3----4----5----
+操作:   点击  设置  延迟  调用  状态
+       Tab   状态  100ms reload 更新完成
+                    ↑
+                   这里activeTab可能还是旧值！
+```
+
+## ✅ 修复方案
+
+### 1. 创建专用的Tab数据加载函数
+```typescript
+// 新增：根据指定tab加载数据
+const reloadWithTab = async (tab: string, isRefresh = true) => {
+  const getStatusFilterForTab = (tabValue: string) => {
+    switch (tabValue) {
+      case '0': return { status: 0, isExpire: 0 } // 可用
+      case '1': return { status: 1 }              // 已使用  
+      case '2': return { isExpire: 1 }            // 已过期
+      default: return {}
+    }
+  }
+  
+  const statusFilter = getStatusFilterForTab(tab) // 直接使用传入的tab值
+  // ... 数据加载逻辑
+}
+```
+
+### 2. 修复Tab切换逻辑
+```typescript
+// 修复后的Tab切换
+const handleTabChange = (value: string | number) => {
+  const tabValue = String(value)
+  setActiveTab(tabValue)
+  setPage(1)
+  setList([])
+  setHasMore(true)
+  
+  // 直接调用，传入新的tab值，不依赖状态更新
+  reloadWithTab(tabValue)
+}
+```
+
+### 3. 简化原reload函数
+```typescript
+const reload = async (isRefresh = false) => {
+  // 直接调用reloadWithTab，使用当前的activeTab
+  await reloadWithTab(activeTab, isRefresh)
+}
+```
+
+## 🎯 修复的核心改进
+
+### 状态管理优化
+- ✅ **消除时序依赖**：不再依赖异步状态更新
+- ✅ **直接传参**：Tab切换时直接传入新值
+- ✅ **统一逻辑**：所有数据加载使用同一个函数
+
+### 数据加载优化
+- ✅ **精确过滤**：每个Tab使用正确的过滤条件
+- ✅ **调试增强**：添加详细的日志输出
+- ✅ **错误处理**：完善的异常处理机制
+
+### 用户体验优化
+- ✅ **即时响应**：Tab切换立即加载数据
+- ✅ **状态清晰**：每个Tab显示对应的数据
+- ✅ **加载提示**：保持loading状态管理
+
+## 📋 Tab过滤条件对照表
+
+| Tab状态 | Tab值 | API过滤条件 | 说明 |
+|---------|-------|-------------|------|
+| 可用 | "0" | `{ status: 0, isExpire: 0 }` | 未使用且未过期 |
+| 已使用 | "1" | `{ status: 1 }` | 已使用状态 |
+| 已过期 | "2" | `{ isExpire: 1 }` | 已过期状态 |
+
+## 🚀 验证步骤
+
+现在你可以测试：
+
+### 1. 重新编译项目
+```bash
+npm run build:weapp
+```
+
+### 2. 测试Tab切换
+- 点击"可用"Tab - 应该显示可用优惠券
+- 点击"已使用"Tab - 应该显示已使用优惠券  
+- 点击"已过期"Tab - 应该显示已过期优惠券
+
+### 3. 查看控制台日志
+每次Tab切换时会显示：
+```
+Tab切换: { from: "0", to: "1" }
+使用Tab加载数据: { tab: "1", statusFilter: { status: 1 } }
+Tab数据加载成功: { tab: "1", newListLength: 3, ... }
+```
+
+## 🔍 调试信息说明
+
+### Tab切换日志
+```javascript
+Tab切换: { from: "0", to: "1" }
+```
+- `from`: 切换前的Tab
+- `to`: 切换后的Tab
+
+### 数据加载日志
+```javascript
+使用Tab加载数据: { tab: "1", statusFilter: { status: 1 } }
+```
+- `tab`: 当前加载的Tab值
+- `statusFilter`: 使用的过滤条件
+
+### 加载结果日志
+```javascript
+Tab数据加载成功: { tab: "1", newListLength: 3, responseData: {...} }
+```
+- `newListLength`: 加载到的数据数量
+- `responseData`: 服务器返回的完整数据
+
+## 🎉 预期效果
+
+修复后的Tab切换应该：
+- ✅ **可用Tab**：显示未使用且未过期的优惠券
+- ✅ **已使用Tab**：显示已使用的优惠券
+- ✅ **已过期Tab**：显示已过期的优惠券
+- ✅ **切换流畅**：每次切换都能正确加载对应数据
+- ✅ **状态准确**：每个Tab显示正确的数据状态
+
+## 🔧 技术细节
+
+### 异步状态管理
+React的`setState`是异步的，直接在`setTimeout`中使用可能读取到旧值：
+```typescript
+// ❌ 错误方式
+setActiveTab(newTab)
+setTimeout(() => {
+  const filter = getStatusFilter() // 可能还是旧的activeTab
+}, 100)
+
+// ✅ 正确方式  
+setActiveTab(newTab)
+reloadWithTab(newTab) // 直接传入新值
+```
+
+### 状态更新时序
+```typescript
+// React状态更新是异步的
+setActiveTab("1")           // 发起状态更新
+console.log(activeTab)      // 可能还是旧值 "0"
+
+// 解决方案：直接使用新值
+const newTab = "1"
+setActiveTab(newTab)        // 发起状态更新
+reloadWithTab(newTab)       // 直接使用新值
+```
+
+**现在重新编译测试，Tab切换应该完全正常了！** 🎯