Version: 0.2.3.dev.260211

fix: 🐛 修复刷新 Token 接口错误返回问题

- 当 token 本身存在问题时，改为返回 400 业务错误
- 不再错误地返回 500 服务端异常状态码 ✅

feat: 🔁 新增基于 X-Idempotency-Key 与 Redis 的通用幂等中间件

- 基于 X-Idempotency-Key 实现请求幂等控制 🧩
- 记录 UUID 及对应返回结果至 Redis
- 当相同 UUID 重复请求时，直接返回缓存结果 ⚡
- 应用于所有涉及增删改操作的接口
- 解决部分接口未实现幂等性的问题 🔒

backend/dao/cache.go

@@ -20,13 +20,13 @@ func NewCacheDAO(client *redis.Client) *CacheDAO {
 }
 
 // SetBlacklist 把 Token 扔进黑名单
-func (dao *CacheDAO) SetBlacklist(jti string, expiration time.Duration) error {
-	return dao.client.Set(context.Background(), "blacklist:"+jti, "1", expiration).Err()
+func (d *CacheDAO) SetBlacklist(jti string, expiration time.Duration) error {
+	return d.client.Set(context.Background(), "blacklist:"+jti, "1", expiration).Err()
 }
 
 // IsBlacklisted 检查 Token 是否在黑名单中
-func (dao *CacheDAO) IsBlacklisted(jti string) (bool, error) {
-	result, err := dao.client.Get(context.Background(), "blacklist:"+jti).Result()
+func (d *CacheDAO) IsBlacklisted(jti string) (bool, error) {
+	result, err := d.client.Get(context.Background(), "blacklist:"+jti).Result()
 	if errors.Is(err, redis.Nil) {
 		return false, nil // 不在黑名单
 	} else if err != nil {
@@ -35,7 +35,7 @@ func (dao *CacheDAO) IsBlacklisted(jti string) (bool, error) {
 	return result == "1", nil // 在黑名单
 }
 
-func (dao *CacheDAO) AddTaskClassList(ctx context.Context, userID int, list *model.UserGetTaskClassesResponse) error {
+func (d *CacheDAO) AddTaskClassList(ctx context.Context, userID int, list *model.UserGetTaskClassesResponse) error {
 	// 1. 定义 Key，使用 userID 隔离不同用户的数据
 	key := fmt.Sprintf("smartflow:task_classes:%d", userID)
 	// 2. 序列化：将结构体转为 []byte
@@ -44,14 +44,14 @@ func (dao *CacheDAO) AddTaskClassList(ctx context.Context, userID int, list *mod
 		return err
 	}
 	// 3. 存储：设置 30 分钟过期（根据业务灵活调整）
-	return dao.client.Set(ctx, key, data, 30*time.Minute).Err()
+	return d.client.Set(ctx, key, data, 30*time.Minute).Err()
 }
 
-func (dao *CacheDAO) GetTaskClassList(ctx context.Context, userID int) (model.UserGetTaskClassesResponse, error) {
+func (d *CacheDAO) GetTaskClassList(ctx context.Context, userID int) (model.UserGetTaskClassesResponse, error) {
 	key := fmt.Sprintf("smartflow:task_classes:%d", userID)
 	var resp model.UserGetTaskClassesResponse
 	// 1. 从 Redis 获取字符串
-	val, err := dao.client.Get(ctx, key).Result()
+	val, err := d.client.Get(ctx, key).Result()
 	if err != nil {
 		// 注意：如果是 redis.Nil，交给 Service 层处理查库逻辑
 		return resp, err
@@ -61,7 +61,27 @@ func (dao *CacheDAO) GetTaskClassList(ctx context.Context, userID int) (model.Us
 	return resp, err
 }
 
-func (dao *CacheDAO) DeleteTaskClassList(ctx context.Context, userID int) error {
+func (d *CacheDAO) DeleteTaskClassList(ctx context.Context, userID int) error {
 	key := fmt.Sprintf("smartflow:task_classes:%d", userID)
-	return dao.client.Del(ctx, key).Err()
+	return d.client.Del(ctx, key).Err()
+}
+
+func (d *CacheDAO) GetRecord(ctx context.Context, key string) (string, error) {
+	val, err := d.client.Get(ctx, key).Result()
+	if errors.Is(err, redis.Nil) {
+		return "", nil // 正常没命中的情况
+	}
+	return val, err // 真正的 Redis 报错
+}
+
+func (d *CacheDAO) SaveRecord(ctx context.Context, key string, val string, ttl time.Duration) error {
+	return d.client.Set(ctx, key, val, ttl).Err()
+}
+
+func (d *CacheDAO) AcquireLock(ctx context.Context, key string, ttl time.Duration) (bool, error) {
+	return d.client.SetNX(ctx, key, "processing", ttl).Result()
+}
+
+func (d *CacheDAO) ReleaseLock(ctx context.Context, key string) error {
+	return d.client.Del(ctx, key).Err()
 }