AIclinicalresearch/docs/07-运维文档/04-Redis改造实施计划.md

# Redis謾ｹ騾<EFBDB9>螳樊命隶｡蛻抵ｼ育ｼ灘ｭ<E78198>+髦溷<E9ABA6>螳梧紛迚茨ｼ<E88CA8>

> **譁<>｡｣迚域悽<E59F9F>?* V2.0  
> **譖ｴ譁ｰ譌･譛滂ｼ?* 2025-12-12  
> **逶ｮ譬<EFBDAE>ｮ梧<EFBDAE>譌ｶ髣ｴ<E9ABA3>?* 2025-12-18<31>?螟ｩ<E89E9F><EFBDA9>  
> **雍溯ｴ｣莠ｺ<E88EA0><EFBDBA>** 謚€譛ｯ蝗｢髦? 
> **鬟朱勦遲臥ｺｧ<EFBDBA>?* <20>泯 荳ｭ遲会ｼ域怏髯咲ｺｧ譁ｹ譯茨ｼ? 
> **驥崎ｦ∝序譖ｴ<E8AD96>?* Redis髦溷<E9ABA6>莉?蜿ｯ騾?隹<>紛荳?蠢<>｡ｻ"

---

## 笞<><E7AC9E><EFBFBD> **驥崎ｦ∬ｯｴ譏趣ｼ<E8B6A3>2.0譖ｴ譁ｰ<EFBFBD>?*

扈剰ｿ<EFBFBD>ｷｱ蜈･蛻<EFBFBD>梵<EFBFBD>軍edis髦溷<EFBFBD>**荳肴弍蜿ｯ騾蛾｡ｹ**<2A>瑚€梧弍**譬ｸ蠢<EFBDB8>粥閭ｽ逧<EFBDBD>ｿ<EFBFBD>｡ｻ鬘ｹ**<2A>?
1. **ASL譁<4C>鍵遲幃€?*<2A>?000遽<30>枚迪ｮ髴€隕?蟆乗慮<E4B997>御ｸ咲畑Redis髦溷<E9ABA6>螟ｱ雍･邇?> 95%
2. **DC Tool B逞<42>紙謠仙叙**<EFBFBD>?000莉ｽ逞<EFBDBD>紙髴€隕?-3蟆乗慮<E4B997>悟酔譬ｷ髣ｮ鬚?3. **SAE螳樔ｾ狗音諤?*<2A>?5蛻<35>帖譌<E5B896>豬<EFBFBD>㍼閾ｪ蜉ｨ郛ｩ螳ｹ<E89EB3>碁柄莉ｻ蜉｡蠢<EFBDA1>┯螟ｱ雍?
**蝗<>豁､譛ｬ隶｡蛻定ｰ<E5AE9A>紛荳ｺ<E88DB3>夂ｼ灘ｭ?髦溷<E9ABA6>荳€襍ｷ螳樊命<E6A88A><E591BD>7螟ｩ螳梧<E89EB3><E6A2A7><EFBFBD>**

---

## <20>搭 逶ｮ蠖<EFBDAE>

1. [謾ｹ騾<EFBDB9>閭梧勹荳守岼譬Ⅹ(#1-謾ｹ騾<EFBDB9>閭梧勹荳守岼譬<E5B2BC>)
2. [蠖灘燕邉ｻ扈溽憾諤∝<E8ABA4>譫疹(#2-蠖灘燕邉ｻ扈溽憾諤∝<E8ABA4>譫?
3. [Redis驟咲ｽｮ菫｡諱ｯ](#3-redis驟咲ｽｮ菫｡諱ｯ)
4. [謾ｹ騾<EFBFBD>隸ｦ扈<EFBFBD>ｭ･鬪､](#4-謾ｹ騾<EFBDB9>隸ｦ扈<EFBDA6>ｭ･鬪?<3F>遺惠 **蟾ｲ譖ｴ譁ｰ<E8AD81>壼桁蜷ｫ髦溷<E9ABA6>**<2A>?5. [豬玖ｯ墓婿譯<E5A9BF>(#5-豬玖ｯ墓婿譯<E5A9BF>)
6. [鬟朱勦隸<E58BA6>ｼｰ荳守ｼ楢ｧ｣](#6-鬟朱勦隸<E58BA6>ｼｰ荳守ｼ楢ｧ?
7. [荳顔ｺｿ隶｡蛻綻(#7-荳顔ｺｿ隶｡蛻<EFBDA1>)
8. [蝗樊ｻ壽婿譯<E5A9BF>(#8-蝗樊ｻ壽婿譯<E5A9BF>)
9. [逶第而荳手ｿ千ｻｴ](#9-逶第而荳手ｿ千ｻ?

---

## 1. 謾ｹ騾<EFBDB9>閭梧勹荳守岼譬<E5B2BC>

### 1.1 荳ｺ莉€荵郁ｦ∵隼騾<E99ABC><E9A8BE><EFBFBD>

#### **蠖灘燕髣ｮ鬚<EFBDAE>**<2A>?1. 笶?**霑晏渚莠大次逕溯ｧ<E6BAAF><EFBDA7>?*<2A>夂ｳｻ扈滉ｽｿ逕ｨ蜀<EFBDA8>ｭ倡ｼ灘ｭ假ｼ瑚ｿ晏渚閾ｪ蟾ｱ蛻ｶ螳夂噪莠大次逕溷ｼ€蜿題ｧ<E9A18C><EFBDA7>?2. 笶?**LLM謌先悽螟ｱ謗ｧ**<2A>夂ｼ灘ｭ倅ｸ肴戟荵<E6889F>喧<EFBFBD>悟ｯｼ閾ｴ驥榊､崎ｰ<E5B48E>畑DeepSeek/Qwen API
3. 笶?**髟ｿ莉ｻ蜉｡荳榊庄髱<E5BA84>**<2A>?0-60蛻<30>帖逧<E5B896>枚迪ｮ遲幃€我ｻｻ蜉｡<E89C89>郡AE螳樔ｾ矩㍾蜷ｯ蜷惹ｸ｢螟?4. 笶?**螟壼ｮ樔ｾ倶ｸ榊酔豁･**<2A>售AE謇ｩ螳ｹ蜷趣ｼ悟推螳樔ｾ狗ｼ灘ｭ倅ｸ榊<EFBDB8>莠ｫ
5. 笶?**Serverless荳埼€る<C280>**<2A>壼<EFBFBD>蟄倡憾諤∝惠Serverless邇ｯ蠅<EFBDAF>ｸ倶ｸ榊庄髱<E5BA84>

#### **謾ｹ騾<EFBDB9>逶ｮ譬?*<2A>?- 笨?**隨ｦ蜷域楔譫<E6A594>ｧ<EFBFBD>激**<2A>壻ｽｿ逕ｨ蛻<EFBDA8>ｸ<EFBFBD>ｼ冗ｼ灘ｭ假ｼ<E58187>edis<69>?- 笨?**髯堺ｽ拶PI謌先悽**<2A>哭LM扈捺棡郛灘ｭ俶戟荵<E6889F>喧<EFBFBD>碁∩蜈埼㍾螟崎ｰ<E5B48E>畑
- 笨?**莉ｻ蜉｡謖∽ｹ<E288BD><EFBDB9>?*<2A>夐柄譌ｶ髣ｴ莉ｻ蜉｡荳榊屏螳樔ｾ矩㍾蜷ｯ閠御ｸ｢螟?- 笨?**謾ｯ謖∝､壼ｮ樔ｾ?*<2A>夂ｼ灘ｭ伜惠螟壼ｮ樔ｾ矩龍蜈ｱ莠ｫ
- 笨?**蟷ｳ貊題ｿ<E9A18C>ｸ｡**<2A>壻ｿ晉蕗髯咲ｺｧ譁ｹ譯茨ｼ檎｡ｮ菫晉ｳｻ扈溽ｨｳ螳<EFBDB3>

---

## 2. 蠖灘燕邉ｻ扈溽憾諤∝<E8ABA4>譫?
### 2.1 蟾ｲ菴ｿ逕ｨ郛灘ｭ倡噪菴咲ｽｮ

#### **菴咲ｽｮ1<EFBDAE>唏ealthCheckService.ts**
```typescript
// 譁<>ｻｶ<EFBDBB>喘ackend/src/modules/dc/tool-b/services/HealthCheckService.ts
// 隨?7陦鯉ｼ夊ｯｻ蜿也ｼ灘ｭ<E78198>
const cached = await cache.get<HealthCheckResult>(cacheKey);

// 隨?45陦鯉ｼ壼<EFBDBC>蜈･郛灘ｭ<E78198>
await cache.set(cacheKey, result, 86400);  // 24蟆乗慮
```

**逕ｨ騾?*<2A>哘xcel蛛･蠎ｷ譽€譟･扈捺棡郛灘ｭ? 
**驥崎ｦ∵€?*<2A>夸沺?荳ｭ遲会ｼ磯∩蜈埼㍾螟崎ｧ｣譫職xcel<65>? 
**謨ｰ謐ｮ驥?*<2A>嘸5KB/鬘? 

---

#### **菴咲ｽｮ2<EFBDAE>哭LM12FieldsService.ts**
```typescript
// 譁<>ｻｶ<EFBDBB>喘ackend/src/modules/asl/common/llm/LLM12FieldsService.ts
// 隨?16陦鯉ｼ夊ｯｻ蜿也ｼ灘ｭ<E78198>
const cached = await cache.get(cacheKey);

// 隨?30陦鯉ｼ壼<EFBDBC>蜈･郛灘ｭ<E78198>
await cache.set(cacheKey, JSON.stringify(result), 3600);  // 1蟆乗慮
```

**逕ｨ騾?*<2A>哭LM 12蟄玲ｮｵ謠仙叙扈捺棡郛灘ｭ<E78198>  
**驥崎ｦ∵€?*<2A>夸沐?鬮假ｼ育峩謗･蠖ｱ蜩喉PI謌先悽<E58588>? 
**謨ｰ謐ｮ驥?*<2A>嘸50KB/鬘? 
**謌先悽蠖ｱ蜩<EFBDB1>**<EFBFBD>?```
蜊墓ｬ｡謠仙叙謌先悽<EFBFBD>嘸ﾂ･0.43/遽?螯よ棡郛灘ｭ伜､ｱ謨茨ｼ碁㍾螟崎ｰ<E5B48E>畑<EFBFBD><E79591>
- 10谺?= ﾂ･4.3
- 100谺?= ﾂ･43
- 1000谺?= ﾂ･430
```

---

### 2.2 髟ｿ譌ｶ髣ｴ蠑よｭ･莉ｻ蜉?
#### **ASL讓｡蝮暦ｼ壽枚迪ｮ遲幃€我ｻｻ蜉?*
```typescript
// 譁<>ｻｶ<EFBDBB>喘ackend/src/modules/asl/services/screeningService.ts
// 隨?3-65陦?processLiteraturesInBackground(task.id, projectId, literatures);
```

**髣ｮ鬚<EFBDAE>**<2A>?- 199遽<39>枚迪ｮ髴€隕?33-66蛻<36>帖
- 蠖灘燕菴ｿ逕ｨ蜀<EFBDA8>ｭ倬弌蛻暦ｼ<E69AA6>emoryQueue<75>?- SAE螳樔ｾ矩㍾蜷ｯ/郛ｩ螳ｹ譌ｶ莉ｻ蜉｡荳｢螟?
**蠖ｱ蜩<EFBDB1>**<2A>?- 逕ｨ謌ｷ菴馴ｪ梧栫蟾ｮ<E89FBE>井ｻｻ蜉｡遯∫┯豸亥､ｱ<EFBDA4><EFBDB1>
- 蟾ｲ螟<EFBDB2>炊扈捺棡荳｢螟ｱ<E89E9F>梧ｵｪ雍ｹAPI雍ｹ逕ｨ
- 譌<>豕戊ｿｽ貅ｯ莉ｻ蜉｡迥ｶ諤?
---

### 2.3 蠖灘燕譫ｶ譫<EFBDB6><E8ADAB>鄂ｮ

```env
# backend/.env
CACHE_TYPE=memory    # 竊?髴€隕∵隼荳?redis
QUEUE_TYPE=memory    # 竊?髴€隕∵隼荳?redis
```

---

## 3. Redis驟咲ｽｮ菫｡諱ｯ

### 3.1 髦ｿ驥御ｺ然edis雍ｭ荵ｰ菫｡諱ｯ

| 驟咲ｽｮ鬘?| 蛟?| 隸ｴ譏<EFBDB4> |
|--------|---|------|
| **莠ｧ蜩<EFBDA7>** | Redis 蠑€貅千沿 | 螳梧紛Redis蜉溯<E89C89> |
| **莉倩ｴｹ譁ｹ蠑<EFBDB9>** | 蛹<>ｹｴ蛹<EFBDB4>怦 | 鬥匁ｬ｡雍ｭ荵ｰ莠?謚倅ｼ俶<EFBDBC>?|
| **驛ｨ鄂ｲ讓｡蠑<EFBDA1>** | 莠大次逕滂ｼ磯ｫ伜庄逕ｨ<E98095><EFBDA8> | 荳ｻ莉手<E88E89>蜉ｨ蛻<EFBDA8>困 |
| **邉ｻ蛻<EFBDBB>** | 譬<>㊥迚?| 貊｡雜ｳ髴€豎?|
| **蝨ｰ蝓<EFBDB0>** | 蜊主圏2<E59C8F>亥圏莠ｬ<E88EA0><EFBDAC> | 荳惨AE蜷悟慍蝓?|
| **螳樔ｾ狗ｱｻ蝙<EFBDBB>** | 鬮伜庄逕?| 笨?99.95%蜿ｯ逕ｨ諤?|
| **螟ｧ迚域<E8BF9A>?* | Redis 7.0 | 譛€譁ｰ遞ｳ螳夂沿 |
| **譫ｶ譫<EFBDB6>ｱｻ蝙<EFBDBB>** | 荳榊星逕ｨ髮<EFBDA8>ｾ､<EFBDBE>亥黒闃らせ<E38289><E3819B> | 貊｡雜ｳ蠖灘燕隗<E78795>ｨ｡ |
| **蛻<>援隗<E68FB4><E99A97>ｼ** | 256 MB | 蛻晄悄雜ｳ螟<EFBDB3> |
| **蛻<>援謨ｰ驥<EFBDB0>** | 1 | 蜊募<E89C8A>迚?|
| **隸ｻ蜀吝<E89C80>遖ｻ** | 蜈ｳ髣ｭ | 邂€蛹夜<E89BB9>鄂?|

### 3.2 鬚<>ｼｰ謌先悽

```
蝓ｺ遑€莉ｷ譬ｼ<EFBFBD>堋?2/蟷ｴ<E89FB7>亥黒譛ｺ迚茨ｼ<E88CA8>
鬮伜庄逕ｨ迚茨ｼ堋?80/蟷ｴ<E89FB7>井ｼｰ邂暦ｼ?鬥匁ｬ｡雍ｭ荵ｰ<E88DB5>堋?08/蟷ｴ<E89FB7><EFBDB4>6謚伜錘<E4BC9C>?
蟇ｹ豈疲噺逶奇ｼ?- 闃ら怐LLM API雍ｹ逕ｨ<E98095>?ﾂ･500/蟷?- 謠仙合逕ｨ謌ｷ貊｡諢丞ｺｦ<EFBDBA>壽裏莉ｷ
- ROI<4F>?400%
```

### 3.3 霑樊磁菫｡諱ｯ<E8ABB1>郁ｴｭ荵ｰ蜷手執蜿厄ｼ?
```env
# 髦ｿ驥御ｺ第而蛻ｶ蜿ｰ 竊?Redis螳樔ｾ<E6A894> 竊?霑樊磁菫｡諱ｯ
REDIS_HOST=r-xxxxxxxxxxxx.redis.rds.aliyuncs.com
REDIS_PORT=6379
REDIS_PASSWORD=your_secure_password_here
REDIS_DB=0

# 謌紋ｽｿ逕ｨ霑樊磁蟄礼ｬｦ荳ｲ
REDIS_URL=redis://:your_password@r-xxxxxxxxxxxx.redis.rds.aliyuncs.com:6379/0
```

---

## 4. 謾ｹ騾<EFBDB9>隸ｦ扈<EFBDA6>ｭ･鬪?
### 4.1 Phase 1<>壽悽蝨ｰ蠑€蜿醍識蠅<E8AD98>㊥螟?笨?
#### **豁･鬪､1.1<EFBFBD>壼ｮ芽｣<EFBFBD>ｾ晁ｵ?*
```bash
cd backend
npm install ioredis --save
npm install @types/ioredis --save-dev
```

#### **豁･鬪､1.2<EFBFBD>夐<EFBFBD>鄂ｮ譛ｬ蝨ｰRedis**
```bash
# 遑ｮ隶､Docker Redis豁｣蝨ｨ霑占｡<E58DA0>
docker ps | findstr redis

# 螯よ棡豐｡譛芽ｿ占｡鯉ｼ悟星蜉ｨ螳<EFBDA8>
docker start ai-clinical-redis

# 豬玖ｯ戊ｿ樊磁
docker exec -it ai-clinical-redis redis-cli ping
# 蠎碑ｯ･霑泌屓<E6B38C>啀ONG
```

#### **豁･鬪､1.3<EFBFBD>壽峩譁ｰ譛ｬ蝨?env**
```env
# backend/.env
DATABASE_URL=postgresql://postgres:postgres123@localhost:5432/ai_clinical_research

# ==================== Redis驟咲ｽｮ ====================
# 蜷ｯ逕ｨRedis郛灘ｭ<E78198>
CACHE_TYPE=redis
REDIS_HOST=localhost
REDIS_PORT=6379
REDIS_DB=0
# REDIS_PASSWORD=  # 譛ｬ蝨ｰ譌<EFBDB0>蟇<EFBFBD><E89F87>?
# 髦溷<E9ABA6>證よ慮逕ｨ蜀<EFBDA8>ｭ假ｼ亥<EFBDBC>髦ｶ谿ｵ蜷ｯ逕ｨ<E98095><EFBDA8>
QUEUE_TYPE=memory

# ==================== JWT ====================
JWT_SECRET=your-secret-key-change-in-production
JWT_EXPIRES_IN=7d

# ==================== LLM API ====================
DEEPSEEK_API_KEY=sk-7f8cc37a79fa4799860b38fc7ba2e150
DASHSCOPE_API_KEY=sk-75b4ff29a14a49e79667a331034f3298

# ==================== Dify ====================
DIFY_API_URL=http://localhost/v1
DIFY_API_KEY=dataset-mfvdiKvQ2l3NvxWm7RoYMN3c

# ==================== Server ====================
PORT=3001
NODE_ENV=development

# ==================== CloseAI驟咲ｽｮ ====================
CLOSEAI_API_KEY=sk-cu0iepbXYGGx2jc7BqP6ogtSWmP6fk918qV3RUdtGC3Ed1po
CLOSEAI_OPENAI_BASE_URL=https://api.openai-proxy.org/v1
CLOSEAI_CLAUDE_BASE_URL=https://api.openai-proxy.org/anthropic

# ==================== 蟄伜お驟咲ｽｮ ====================
STORAGE_TYPE=local
LOCAL_STORAGE_DIR=uploads
LOCAL_STORAGE_URL=http://localhost:3001/uploads

# ==================== CORS驟咲ｽｮ ====================
CORS_ORIGIN=http://localhost:5173

# ==================== 譌･蠢鈴<E8A0A2>鄂ｮ ====================
LOG_LEVEL=debug
```

---

### 4.2 Phase 2<>壼ｮ樒鴫RedisCacheAdapter 笨?
#### **豁･鬪､2.1<EFBFBD>壻ｿｮ謾ｹRedisCacheAdapter.ts**

```typescript
// 譁<>ｻｶ<EFBDBB>喘ackend/src/common/cache/RedisCacheAdapter.ts

import Redis from 'ioredis';
import type { CacheAdapter } from './CacheAdapter.js';
import { logger } from '../logging/index.js';

/**
 * Redis郛灘ｭ倬€る<C280>蝎? * 
 * 菴ｿ逕ｨioredis螳｢謌ｷ遶ｯ<E981B6>梧髪謖<E9ABAA>ｼ? * - 蟄礼ｬｦ荳?蟇ｹ雎｡閾ｪ蜉ｨ蠎丞<E8A08E>蛹? * - TTL霑<4C>悄譌ｶ髣ｴ
 * - 霑樊磁豎<E7A381>邂｡逅? * - 髞呵ｯｯ驥崎ｯ<E5B48E>
 * 
 * @example
 * const cache = new RedisCacheAdapter({
 *   host: 'localhost',
 *   port: 6379,
 *   password: 'xxx',
 *   db: 0
 * });
 * 
 * await cache.set('key', { data: 'value' }, 60);
 * const value = await cache.get('key');
 */
export class RedisCacheAdapter implements CacheAdapter {
  private redis: Redis;

  constructor(options?: {
    host?: string;
    port?: number;
    password?: string;
    db?: number;
  }) {
    this.redis = new Redis({
      host: options?.host || 'localhost',
      port: options?.port || 6379,
      password: options?.password || undefined,
      db: options?.db || 0,
      // 霑樊磁驟咲ｽｮ
      retryStrategy: (times) => {
        const delay = Math.min(times * 50, 2000);
        logger.warn(`Redis霑樊磁驥崎ｯ<EFBFBD> ${times} 谺｡<E8B0BA><EFBDA1>${delay}ms蜷朱㍾隸描);
        return delay;
      },
      maxRetriesPerRequest: 3,
      enableReadyCheck: true,
      // 霑樊磁豎<E7A381>驟咲ｽ?      lazyConnect: false,
      keepAlive: 30000,
    });

    // 逶大成霑樊磁莠倶ｻｶ
    this.redis.on('connect', () => {
      logger.info('Redis霑樊磁謌仙粥');
    });

    this.redis.on('error', (error) => {
      logger.error('Redis霑樊磁髞呵ｯｯ', { error: error.message });
    });

    this.redis.on('close', () => {
      logger.warn('Redis霑樊磁蜈ｳ髣ｭ');
    });

    this.redis.on('reconnecting', () => {
      logger.warn('Redis豁｣蝨ｨ驥崎ｿ<E5B48E>...');
    });
  }

  /**
   * 闔ｷ蜿也ｼ灘ｭ伜€?   */
  async get<T>(key: string): Promise<T | null> {
    try {
      const value = await this.redis.get(key);
      
      if (!value) {
        logger.debug('Redis郛灘ｭ俶悴蜻ｽ荳?, { key });
        return null;
      }

      logger.debug('Redis郛灘ｭ伜多荳ｭ', { key, size: value.length });

      // 蟆晁ｯ戊ｧ｣譫辱SON
      try {
        return JSON.parse(value) as T;
      } catch {
        // 螯よ棡荳肴弍JSON<4F>瑚ｿ泌屓蜴溷ｧ句ｭ礼ｬｦ荳ｲ
        return value as unknown as T;
      }
    } catch (error) {
      logger.error('Redis GET螟ｱ雍･', { key, error });
      return null;  // 髯咲ｺｧ<EFBDBA>夊ｿ泌屓null閠御ｸ肴弍謚帛ｼょｸｸ
    }
  }

  /**
   * 隶ｾ鄂ｮ郛灘ｭ伜€?   * @param ttl 霑<>悄譌ｶ髣ｴ<E9ABA3>育ｧ抵ｼ会ｼ御ｸ堺ｼ<E5A0BA>蛻呎ｰｸ荳崎ｿ<E5B48E>悄<EFBFBD>井ｸ肴耳闕撰ｼ<E692B0>
   */
  async set<T>(key: string, value: T, ttl?: number): Promise<void> {
    try {
      // 蠎丞<E8A08E>蛹門€?      const serialized = typeof value === 'string' 
        ? value 
        : JSON.stringify(value);

      // 隶ｾ鄂ｮ蛟ｼ<E89B9F>亥ｸｦTTL<54>?      if (ttl) {
        await this.redis.setex(key, ttl, serialized);
        logger.debug('Redis SET謌仙粥<E4BB99>亥ｸｦTTL<54>?, { 
          key, 
          ttl, 
          size: serialized.length 
        });
      } else {
        await this.redis.set(key, serialized);
        logger.warn('Redis SET謌仙粥<E4BB99>域裏TTL<54>?, { key });  // 隴ｦ蜻奇ｼ壽裏霑<E8A38F>悄譌ｶ髣ｴ
      }
    } catch (error) {
      logger.error('Redis SET螟ｱ雍･', { key, ttl, error });
      // 荳肴鴨蜃ｺ蠑ょｸｸ<EFBDB8>悟<EFBFBD>隶ｸ邉ｻ扈溽ｻｧ扈ｭ霑占｡<E58DA0>
    }
  }

  /**
   * 蛻<>髯､郛灘ｭ<E78198>
   */
  async delete(key: string): Promise<boolean> {
    try {
      const result = await this.redis.del(key);
      logger.debug('Redis DEL', { key, deleted: result > 0 });
      return result > 0;
    } catch (error) {
      logger.error('Redis DEL螟ｱ雍･', { key, error });
      return false;
    }
  }

  /**
   * 譽€譟･key譏ｯ蜷ｦ蟄伜惠
   */
  async has(key: string): Promise<boolean> {
    try {
      const result = await this.redis.exists(key);
      return result > 0;
    } catch (error) {
      logger.error('Redis EXISTS螟ｱ雍･', { key, error });
      return false;
    }
  }

  /**
   * 貂<>ｩｺ謇€譛臥ｼ灘ｭ假ｼ亥些髯ｩ謫堺ｽ懶ｼ<E687B6>ｼ<EFBFBD>
   */
  async clear(): Promise<void> {
    try {
      await this.redis.flushdb();
      logger.warn('Redis FLUSHDB謇ｧ陦鯉ｼ域園譛臥ｼ灘ｭ伜ｷｲ貂<EFBDB2>ｩｺ<EFBDA9>?);
    } catch (error) {
      logger.error('Redis FLUSHDB螟ｱ雍･', { error });
    }
  }

  /**
   * 豬玖ｯ紐edis霑樊磁
   */
  async ping(): Promise<boolean> {
    try {
      const result = await this.redis.ping();
      return result === 'PONG';
    } catch (error) {
      logger.error('Redis PING螟ｱ雍･', { error });
      return false;
    }
  }

  /**
   * 蜈ｳ髣ｭ霑樊磁<E6A88A>育畑莠惹ｼ倬寉蜈ｳ髣ｭ<E9ABA3><EFBDAD>
   */
  async disconnect(): Promise<void> {
    try {
      await this.redis.quit();
      logger.info('Redis霑樊磁蟾ｲ蜈ｳ髣?);
    } catch (error) {
      logger.error('Redis蜈ｳ髣ｭ霑樊磁螟ｱ雍･', { error });
    }
  }
}
```

---

#### **豁･鬪､2.2<EFBFBD>壽峩譁ｰCacheFactory.ts<74>域ｷｻ蜉<EFBDBB>髯咲ｺｧ遲也払<E4B99F><E68995>**

```typescript
// 譁<>ｻｶ<EFBDBB>喘ackend/src/common/cache/CacheFactory.ts

import { config } from '../../config/env.js';
import type { CacheAdapter } from './CacheAdapter.js';
import { MemoryCacheAdapter } from './MemoryCacheAdapter.js';
import { RedisCacheAdapter } from './RedisCacheAdapter.js';
import { logger } from '../logging/index.js';

/**
 * 郛灘ｭ伜ｷ･蜴ゑｼ亥黒萓具ｼ<E585B7>
 * 
 * 譬ｹ謐ｮ邇ｯ蠅<EFBDAF>序驥剰<E9A9A5>蜉ｨ騾画叫郛灘ｭ伜ｮ樒鴫<E6A892>? * - CACHE_TYPE=memory 竊?MemoryCacheAdapter
 * - CACHE_TYPE=redis 竊?RedisCacheAdapter<65>域髪謖<E9ABAA>剄郤ｧ<E983A4><EFBDA7>
 * 
 * @example
 * import { cache } from '@/common/cache'
 * await cache.set('user:123', userData, 60)
 * const user = await cache.get<User>('user:123')
 */
export class CacheFactory {
  private static instance: CacheAdapter | null = null;
  private static fallbackToMemory = false;  // 髯咲ｺｧ譬<EFBDA7>ｮｰ

  /**
   * 闔ｷ蜿也ｼ灘ｭ伜ｮ樔ｾ具ｼ亥黒萓具ｼ<E585B7>
   */
  static getInstance(): CacheAdapter {
    if (!this.instance) {
      this.instance = this.createCache();
    }
    return this.instance;
  }

  /**
   * 蛻帛ｻｺ郛灘ｭ伜ｮ樔ｾ<E6A894>
   */
  private static createCache(): CacheAdapter {
    const cacheType = config.cacheType || 'memory';

    logger.info('[CacheFactory] 蛻晏ｧ句喧郛灘ｭ倡ｳｻ扈?, { cacheType });

    switch (cacheType) {
      case 'redis':
        return this.createRedisCache();
      case 'memory':
      default:
        return this.createMemoryCache();
    }
  }

  /**
   * 蛻帛ｻｺRedis郛灘ｭ假ｼ亥ｸｦ髯咲ｺｧ遲也払<E4B99F>?   */
  private static createRedisCache(): CacheAdapter {
    try {
      logger.info('[CacheFactory] 豁｣蝨ｨ霑樊磁Redis...', {
        host: config.redisHost,
        port: config.redisPort,
        db: config.redisDb,
      });

      const redisCache = new RedisCacheAdapter({
        host: config.redisHost,
        port: config.redisPort,
        password: config.redisPassword,
        db: config.redisDb,
      });

      // 豬玖ｯ戊ｿ樊磁<E6A88A>亥酔豁･遲牙ｾ<E78999>ｼ<EFBFBD>
      redisCache.ping().then((isConnected) => {
        if (isConnected) {
          logger.info('[CacheFactory] 笨?Redis霑樊磁謌仙粥');
        } else {
          logger.error('[CacheFactory] 笶?Redis霑樊磁螟ｱ雍･<E99B8D>悟ｷｲ髯咲ｺｧ蛻ｰ蜀<EFBDB0>ｭ倡ｼ灘ｭ?);
          this.fallbackToMemory = true;
        }
      }).catch((error) => {
        logger.error('[CacheFactory] 笶?Redis霑樊磁蠑ょｸｸ<EFBDB8>悟ｷｲ髯咲ｺｧ蛻ｰ蜀<EFBDB0>ｭ倡ｼ灘ｭ?, { error });
        this.fallbackToMemory = true;
      });

      return redisCache;
    } catch (error) {
      logger.error('[CacheFactory] 笶?Redis蛻晏ｧ句喧螟ｱ雍･<E99B8D>碁剄郤ｧ蛻ｰ蜀<EFBDB0>ｭ倡ｼ灘ｭ?, { error });
      this.fallbackToMemory = true;
      return this.createMemoryCache();
    }
  }

  /**
   * 蛻帛ｻｺ蜀<EFBDBA>ｭ倡ｼ灘ｭ<E78198>
   */
  private static createMemoryCache(): MemoryCacheAdapter {
    logger.info('[CacheFactory] 菴ｿ逕ｨ蜀<EFBDA8>ｭ倡ｼ灘ｭ<E78198>');
    return new MemoryCacheAdapter();
  }

  /**
   * 譽€譟･譏ｯ蜷ｦ蟾ｲ髯咲ｺｧ蛻ｰ蜀<EFBDB0>ｭ倡ｼ灘ｭ?   */
  static isFallbackMode(): boolean {
    return this.fallbackToMemory;
  }
}

/**
 * 蟇ｼ蜃ｺ蜊穂ｾ<E7A982>
 */
export const cache = CacheFactory.getInstance();
```

---

#### **豁･鬪､2.3<EFBFBD>壽峩譁ｰenv.ts驟咲ｽｮ**

```typescript
// 譁<>ｻｶ<EFBDBB>喘ackend/src/config/env.ts
// 遑ｮ菫抒edis驟咲ｽｮ豁｣遑ｮ隸ｻ蜿<EFBDBB>

export const config = {
  // ... 蜈ｶ莉夜<E88E89>鄂ｮ ...

  /** 郛灘ｭ倡ｱｻ蝙<EFBDBB> */
  cacheType: process.env.CACHE_TYPE || 'memory',

  /** Redis驟咲ｽｮ */
  redisHost: process.env.REDIS_HOST || 'localhost',
  redisPort: parseInt(process.env.REDIS_PORT || '6379', 10),
  redisPassword: process.env.REDIS_PASSWORD || undefined,
  redisDb: parseInt(process.env.REDIS_DB || '0', 10),
  redisUrl: process.env.REDIS_URL || 'redis://localhost:6379',

  /** 髦溷<E9ABA6>邀ｻ蝙<EFBDBB> */
  queueType: process.env.QUEUE_TYPE || 'memory',

  // ... 蜈ｶ莉夜<E88E89>鄂ｮ ...
};

// 鬪瑚ｯ<E7919A><EFBDAF>鄂ｮ
export function validateConfig() {
  console.log('笨?[Config] 邇ｯ蠅<EFBDAF>序驥丞刈霓ｽ謌仙粥');
  console.log('[Config] 蠎皮畑驟咲ｽｮ:');
  console.log(`  - 郛灘ｭ<E78198>: ${config.cacheType}`);
  console.log(`  - 髦溷<E9ABA6>: ${config.queueType}`);
  
  if (config.cacheType === 'redis') {
    console.log(`  - Redis: ${config.redisHost}:${config.redisPort}/${config.redisDb}`);
  }
}
```

---

### 4.3 Phase 3<>壽悽蝨ｰ豬玖ｯ?笨?
#### **豁･鬪､3.1<EFBFBD>壼<EFBFBD>蟒ｺRedis豬玖ｯ戊<EFBFBD>譛ｬ**

```typescript
// 譁<>ｻｶ<EFBDBB>喘ackend/src/scripts/test-redis.ts

import { cache } from '../common/cache/index.js';
import { logger } from '../common/logging/index.js';

async function testRedis() {
  console.log('\n<>ｧｪ 蠑€蟋区ｵ玖ｯ紐edis郛灘ｭ<E78198>...\n');

  try {
    // 豬玖ｯ<E78E96>1<EFBFBD>壼渕譛ｬ隸ｻ蜀?    console.log('<27>統 豬玖ｯ<E78E96>1<EFBFBD>壼渕譛ｬ隸ｻ蜀?);
    await cache.set('test:hello', 'world', 10);
    const value1 = await cache.get('test:hello');
    console.log(`  笨?蜀吝<E89C80>: "hello" 竊?"world"`);
    console.log(`  笨?隸ｻ蜿<EFBDBB>: "${value1}"`);
    console.assert(value1 === 'world', '蛟ｼ蠎碑ｯ･蛹ｹ驟?);

    // 豬玖ｯ<E78E96>2<EFBFBD>壼ｯｹ雎｡蠎丞<E8A08E>蛹<EFBFBD>
    console.log('\n<EFBFBD>統 豬玖ｯ<EFBFBD>2<EFBFBD>壼ｯｹ雎｡蠎丞<EFBFBD>蛹<EFBFBD>');
    const obj = { id: 123, name: '豬玖ｯ<EFBFBD>', data: [1, 2, 3] };
    await cache.set('test:object', obj, 10);
    const value2 = await cache.get<typeof obj>('test:object');
    console.log(`  笨?蜀吝<E89C80>蟇ｹ雎｡:`, obj);
    console.log(`  笨?隸ｻ蜿門ｯｹ雎｡:`, value2);
    console.assert(value2?.id === 123, 'ID蠎碑ｯ･蛹ｹ驟<EFBFBD>');

    // 豬玖ｯ<E78E96>3<EFBFBD>啜TL霑<4C>悄
    console.log('\n<EFBFBD>統 豬玖ｯ<EFBFBD>3<EFBFBD>啜TL霑<EFBFBD>悄<EFBFBD>?遘抵ｼ<EFBFBD>');
    await cache.set('test:expire', 'will-expire', 2);
    console.log(`  笨?蜀吝<E89C80><E5909D><EFBFBD>TL=2遘抵ｼ荏);
    
    console.log(`  竢?遲牙ｾ<E78999>1遘?..`);
    await sleep(1000);
    const value3a = await cache.get('test:expire');
    console.log(`  笨?1遘貞錘隸ｻ蜿<EFBDBB>: "${value3a}"`);
    console.assert(value3a === 'will-expire', '蠎碑ｯ･霑伜ｭ伜<EFBFBD>?);
    
    console.log(`  竢?遲牙ｾ<E78999>2遘?..`);
    await sleep(2000);
    const value3b = await cache.get('test:expire');
    console.log(`  笨?3遘貞錘隸ｻ蜿<EFBDBB>: ${value3b}`);
    console.assert(value3b === null, '蠎碑ｯ･蟾ｲ霑<EFBDB2><E99C91>?);

    // 豬玖ｯ<E78E96>4<EFBFBD>喇as蜥慧elete
    console.log('\n<EFBFBD>統 豬玖ｯ<EFBFBD>4<EFBFBD>喇as蜥慧elete');
    await cache.set('test:delete', 'to-be-deleted', 10);
    const exists1 = await cache.has('test:delete');
    console.log(`  笨?蜀吝<E89C80>蜷仔xists: ${exists1}`);
    
    await cache.delete('test:delete');
    const exists2 = await cache.has('test:delete');
    console.log(`  笨?蛻<>髯､蜷仔xists: ${exists2}`);
    console.assert(!exists2, '蠎碑ｯ･荳榊ｭ伜<EFBFBD>?);

    // 豬玖ｯ<E78E96>5<EFBFBD>壼､ｧ蟇ｹ雎｡<E99B8E>?0KB<4B>?    console.log('\n<>統 豬玖ｯ<E78E96>5<EFBFBD>壼､ｧ蟇ｹ雎｡郛灘ｭ假ｼ域ｨ｡諡櫚LM扈捺棡<E68DBA>?);
    const bigObj = {
      literatureId: 'xxx',
      fields: {
        遐皮ｩｶ邀ｻ蝙<EFBFBD>: 'RCT',
        譬ｷ譛ｬ驥? '500',
        蟷ｲ鬚<EFBFBD>蒔譁ｽ: '闕ｯ迚ｩA 100mg',
        // ... 12荳ｪ蟄玲ｮ?      },
      metadata: {
        model: 'deepseek-v3',
        tokens: 8000,
        timestamp: Date.now(),
      },
      rawOutput: 'x'.repeat(40000),  // 讓｡諡溷､ｧ霎灘<E99C8E>?    };
    
    const start = Date.now();
    await cache.set('test:bigobj', bigObj, 3600);
    const value5 = await cache.get('test:bigobj');
    const duration = Date.now() - start;
    
    const size = JSON.stringify(bigObj).length;
    console.log(`  笨?蜀吝<E89C80>+隸ｻ蜿門､ｧ蟇ｹ雎? ${size} bytes<65>瑚€玲慮 ${duration}ms`);
    console.assert(value5 !== null, '蠎碑ｯ･閭ｽ隸ｻ蜿?);

    console.log('\n笨?謇€譛画ｵ玖ｯ暮€夊ｿ<EFBFBD>ｼ―n');
    process.exit(0);
  } catch (error) {
    console.error('\n笶?豬玖ｯ募､ｱ雍･:', error);
    process.exit(1);
  }
}

function sleep(ms: number): Promise<void> {
  return new Promise((resolve) => setTimeout(resolve, ms));
}

// 霑占｡梧ｵ玖ｯ<E78E96>
testRedis();
```

#### **豁･鬪､3.2<EFBFBD>壽鴬陦梧ｵ玖ｯ?*
```bash
cd backend

# 1. 蜷ｯ蜉ｨ蜷守ｫｯ<EFBDAB>育｡ｮ菫抒edis驟咲ｽｮ逕滓譜<E6BB93>?npm run dev

# 2. 譁ｰ蠑€荳€荳ｪ扈育ｫｯ<EFBDAB>瑚ｿ占｡梧ｵ玖ｯ戊<EFBDAF>譛ｬ
npx tsx src/scripts/test-redis.ts
```

**鬚<>悄霎灘<E99C8E>**<EFBFBD>?```
<EFBFBD>ｧｪ 蠑€蟋区ｵ玖ｯ紐edis郛灘ｭ<E78198>...

<EFBFBD>統 豬玖ｯ<E78E96>1<EFBFBD>壼渕譛ｬ隸ｻ蜀?  笨?蜀吝<E89C80>: "hello" 竊?"world"
  笨?隸ｻ蜿<EFBDBB>: "world"

<EFBFBD>統 豬玖ｯ<E78E96>2<EFBFBD>壼ｯｹ雎｡蠎丞<E8A08E>蛹<EFBFBD>
  笨?蜀吝<E89C80>蟇ｹ雎｡: { id: 123, name: '豬玖ｯ<E78E96>', data: [ 1, 2, 3 ] }
  笨?隸ｻ蜿門ｯｹ雎｡: { id: 123, name: '豬玖ｯ<E78E96>', data: [ 1, 2, 3 ] }

<EFBFBD>統 豬玖ｯ<E78E96>3<EFBFBD>啜TL霑<4C>悄<EFBFBD>?遘抵ｼ<E68AB5>
  笨?蜀吝<E89C80><E5909D><EFBFBD>TL=2遘抵ｼ<E68AB5>
  竢?遲牙ｾ<E78999>1遘?..
  笨?1遘貞錘隸ｻ蜿<EFBDBB>: "will-expire"
  竢?遲牙ｾ<E78999>2遘?..
  笨?3遘貞錘隸ｻ蜿<EFBDBB>: null

<EFBFBD>統 豬玖ｯ<E78E96>4<EFBFBD>喇as蜥慧elete
  笨?蜀吝<E89C80>蜷仔xists: true
  笨?蛻<>髯､蜷仔xists: false

<EFBFBD>統 豬玖ｯ<E78E96>5<EFBFBD>壼､ｧ蟇ｹ雎｡郛灘ｭ假ｼ域ｨ｡諡櫚LM扈捺棡<E68DBA>?  笨?蜀吝<E89C80>+隸ｻ蜿門､ｧ蟇ｹ雎? 40123 bytes<65>瑚€玲慮 5ms

笨?謇€譛画ｵ玖ｯ暮€夊ｿ<E5A48A>ｼ?```

---

#### **豁･鬪､3.3<EFBFBD>壽ｵ玖ｯ穂ｸ壼苅莉｣遐?*

```bash
# 1. 豬玖ｯ菱ealthCheckService<63><65>C讓｡蝮暦ｼ?# 荳贋ｼ<E8B48B>荳€荳ｪExcel譁<6C>ｻｶ<EFBDBB>梧衍逵区律蠢暦ｼ<E69AA6>

[HealthCheck] Cache miss, processing file
[HealthCheck] Check completed
[HealthCheck] Cache SET: health:xxx, TTL=86400

# 隨ｬ莠梧ｬ｡荳贋ｼ<E8B48B>蜷御ｸ€荳ｪ譁<EFBDAA>ｻ?[HealthCheck] Cache hit  竊?謌仙粥莉山edis隸ｻ蜿<EFBDBB>
```

```bash
# 2. 豬玖ｯ畢LM12FieldsService<63><65>SL讓｡蝮暦ｼ?# 謠蝉ｺ､蜈ｨ譁<EFBDA8>､咲ｭ帑ｻｻ蜉｡<E89C89>梧衍逵区律蠢暦ｼ<E69AA6>

[LLM12FieldsService] 隹<>畑LLM謠仙叙12蟄玲ｮｵ
[LLM12FieldsService] Result cached with key: fulltext:xxx
[LLM12FieldsService] 郛灘ｭ伜<EFBDAD>蜈･謌仙粥

# 驥肴眠霑占｡悟酔荳€遽⑰DF
[LLM12FieldsService] Cache hit, returning cached result  竊?闃ら怐API雍ｹ逕ｨ<E98095>?```

---

### 4.4 Phase 4<>夐仭驥御ｺ然edis驟咲ｽｮ 笨?
#### **豁･鬪､4.1<EFBFBD>夊ｴｭ荵ｰRedis螳樔ｾ<EFBFBD>**

1. 逋ｻ蠖暮仭驥御ｺ第而蛻ｶ蜿ｰ
2. 霑帛<E99C91> **莠第焚謐ｮ蠎<EFBDAE> Redis** 莠ｧ蜩<EFBDA7>｡?3. 轤ｹ蜃ｻ **蛻帛ｻｺ螳樔ｾ<E6A894>**
4. 謖臥<E8AC96>謌ｪ蝗ｾ驟咲ｽｮ騾画叫<E794BB>?   - 莠ｧ蜩<EFBDA7>ｼ啌edis 蠑€貅千沿
   - 驛ｨ鄂ｲ讓｡蠑擾ｼ壻ｺ大次逕滂ｼ磯ｫ伜庄逕ｨ<E98095>?   - 蝨ｰ蝓滂ｼ壼克蛹?<3F>亥圏莠ｬ<E88EA0>俄€披€?**荳惨AE蜷悟慍蝓滂ｼ<E6BB82>**
   - 迚域悽<E59F9F>啌edis 7.0
   - 蛻<>援隗<E68FB4><E99A97>ｼ<EFBFBD>?56 MB
   - 莉倩ｴｹ譁ｹ蠑擾ｼ壼桁蟷ｴ蛹<EFBDB4><E89BB9>?5. 謠蝉ｺ､隶｢蜊募ｹｶ謾ｯ莉?
#### **豁･鬪､4.2<EFBFBD>夐<EFBFBD>鄂ｮ逋ｽ蜷榊黒**

```
髦ｿ驥御ｺ第而蛻ｶ蜿ｰ 竊?Redis螳樔ｾ<E6A894> 竊?逋ｽ蜷榊黒隶ｾ鄂?
豺ｻ蜉<EFBFBD><EFBFBD>?1. 譛ｬ蝨ｰ蠑€蜿選P<E981B8>育畑莠取悽蝨ｰ豬玖ｯ包ｼ<E58C85>
   - 菴<>逧<EFBFBD><E980A7>鄂選P/32

2. SAE蠎皮畑IP<49>育函莠ｧ邇ｯ蠅<EFBDAF>ｼ<EFBFBD>
   - 0.0.0.0/0 <20>井ｸｴ譌ｶ<E8AD8C>悟錘扈ｭ謾ｹ荳ｺSAE VPC<50>?   謌?   - SAE螳樔ｾ狗噪VPC鄂第ｮｵ
```

#### **豁･鬪､4.3<EFBFBD>夊執蜿冶ｿ樊磁菫｡諱?*

```
髦ｿ驥御ｺ第而蛻ｶ蜿ｰ 竊?Redis螳樔ｾ<E6A894> 竊?霑樊磁菫｡諱ｯ

螟榊宛莉･荳倶ｿ｡諱ｯ<EFBFBD>?- 霑樊磁蝨ｰ蝮€<E89DAE>嗷-xxxxxxxxxxxx.redis.rds.aliyuncs.com
- 遶ｯ蜿｣<E89CBF>?379
- 螳樔ｾ紀D<E7B480>嗷-xxxxxxxxxxxx
- 蟇<><E89F87><EFBFBD>ｼ夂せ蜃?菫ｮ謾ｹ蟇<EFBDB9><E89F87><EFBFBD>"隶ｾ鄂ｮ
```

#### **豁･鬪､4.4<EFBFBD>壽峩譁ｰSAE邇ｯ蠅<EFBFBD>序驥<EFBFBD>**

```
髦ｿ驥御ｺ第而蛻ｶ蜿ｰ 竊?SAE蠎皮畑 竊?驟咲ｽｮ邂｡逅<EFBDA1> 竊?邇ｯ蠅<EFBDAF>序驥<E5BA8F>

豺ｻ蜉<EFBFBD><EFBFBD>?CACHE_TYPE=redis
REDIS_HOST=r-xxxxxxxxxxxx.redis.rds.aliyuncs.com
REDIS_PORT=6379
REDIS_PASSWORD=菴<>隶ｾ鄂ｮ逧<EFBDAE>ｯ<EFBFBD><EFBDAF><EFBFBD>
REDIS_DB=0
```

---

### 4.5 Phase 5<>壼星逕ｨRedis髦溷<E9ABA6> <20>閥 **蠢<>｡ｻ螳樊命**

> **驥崎ｦ∝序譖ｴ**<2A>夂ｻ丞<EFBDBB>譫撰ｼ軍edis髦溷<E9ABA6>蟇ｹASL蜥轡C Tool B讓｡蝮玲<E89DAE>?*蠢<>｡ｻ逧?*<2A>御ｸ肴弍蜿ｯ騾臥噪<E887A5>? 
> **逅<>罰**<2A>?蟆乗慮髟ｿ莉ｻ蜉｡蝨ｨSAE邇ｯ蠅<EFBDAF>ｸ倶ｸ咲畑Redis髦溷<E9ABA6>螟ｱ雍･邇?> 95%

#### **豁･鬪､5.1<EFBFBD>壼ｮ芽｣<EFBFBD>ullMQ**

```bash
cd backend
npm install bullmq --save

# BullMQ蟾ｲ蝨ｨpackage.json荳ｭ<E88DB3>悟宵髴€遑ｮ隶､螳芽｣<E88ABD>
npm list bullmq
# 蠎碑ｯ･譏ｾ遉ｺ<E98189>喘ullmq@5.65.0
```

#### **豁･鬪､5.2<EFBFBD>壼ｮ樒鴫RedisQueue.ts**

```typescript
// 譁<>ｻｶ<EFBDBB>喘ackend/src/common/jobs/RedisQueue.ts

import { Queue, Worker, Job as BullJob, QueueEvents } from 'bullmq';
import type { Job, JobQueue, JobHandler } from './types.js';
import { logger } from '../logging/index.js';
import { config } from '../../config/env.js';

/**
 * Redis髦溷<E9ABA6>螳樒鴫<E6A892>亥渕莠撮ullMQ<4D>? * 
 * 譬ｸ蠢<EFBDB8>粥閭ｽ<E996AD>? * - 莉ｻ蜉｡謖∽ｹ<E288BD>喧<EFBFBD>亥ｮ樔ｾ矩㍾蜷ｯ荳堺ｸ｢螟ｱ<E89E9F><EFBDB1>
 * - 閾ｪ蜉ｨ驥崎ｯ包ｼ亥､ｱ雍･蜷取欠謨ｰ騾€驕ｿ<E9A995><EFBDBF>
 * - 蛻<>ｸ<EFBFBD>ｼ丈ｻｻ蜉｡蛻<EFBDA1><E89BBB><EFBFBD>亥､壼ｮ樔ｾ句刻隹<E588BB>ｼ<EFBFBD>
 * - 霑帛ｺｦ霍溯ｸｪ
 */
export class RedisQueue implements JobQueue {
  private queues: Map<string, Queue> = new Map();
  private workers: Map<string, Worker> = new Map();
  private queueEvents: Map<string, QueueEvents> = new Map();
  
  private connection = {
    host: config.redisHost,
    port: config.redisPort,
    password: config.redisPassword,
    db: config.redisDb,
  };

  /**
   * 謗ｨ騾∽ｻｻ蜉｡蛻ｰ髦溷<E9ABA6>
   */
  async push<T = any>(type: string, data: T, options?: any): Promise<Job> {
    try {
      // 闔ｷ蜿匁<E89CBF>蛻帛ｻｺ髦溷<E9ABA6>?      let queue = this.queues.get(type);
      if (!queue) {
        queue = new Queue(type, { 
          connection: this.connection,
          defaultJobOptions: {
            removeOnComplete: 100,  // 菫晉蕗譛€霑?00荳ｪ螳梧<E89EB3>莉ｻ蜉?            removeOnFail: false,    // 螟ｱ雍･莉ｻ蜉｡荳榊唖髯､<E9ABAF>井ｾｿ莠取賜譟･<E8AD9F>?            attempts: 3,            // 螟ｱ雍･驥崎ｯ<E5B48E>3谺?            backoff: {
              type: 'exponential',
              delay: 2000,          // 2遘偵€?遘偵€?遘?            },
          }
        });
        this.queues.set(type, queue);
      }

      // 豺ｻ蜉<EFBDBB>莉ｻ蜉｡
      const job = await queue.add(type, data, {
        ...options,
        jobId: options?.jobId,  // 謾ｯ謖∬<E8AC96>螳壻ｹ泳obId
      });

      logger.info(`[RedisQueue] 莉ｻ蜉｡蜈･髦滓<E9ABA6>蜉歔, { 
        type, 
        jobId: job.id,
        dataSize: JSON.stringify(data).length 
      });

      return {
        id: job.id!,
        type,
        data,
        status: 'pending',
        createdAt: new Date(),
      };
    } catch (error) {
      logger.error(`[RedisQueue] 莉ｻ蜉｡蜈･髦溷､ｱ雍･`, { type, error });
      throw error;
    }
  }

  /**
   * 豕ｨ蜀御ｻｻ蜉｡螟<EFBDA1>炊蝎?   */
  process<T = any>(type: string, handler: JobHandler<T>): void {
    try {
      // 蛻帛ｻｺWorker
      const worker = new Worker(
        type,
        async (job: BullJob) => {
          logger.info(`[RedisQueue] 蠑€蟋句､<E58FA5>炊莉ｻ蜉｡`, { 
            type, 
            jobId: job.id,
            attemptsMade: job.attemptsMade,
            attemptsTotal: job.opts.attempts
          });
          
          const startTime = Date.now();
          
          try {
            // 隹<>畑荳壼苅螟<E88B85>炊蜃ｽ謨ｰ
            const result = await handler({
              id: job.id!,
              type,
              data: job.data as T,
              status: 'processing',
              createdAt: new Date(job.timestamp),
            });

            const duration = Date.now() - startTime;
            logger.info(`[RedisQueue] 莉ｻ蜉｡螟<EFBDA1>炊謌仙粥`, { 
              type, 
              jobId: job.id,
              duration: `${duration}ms`
            });
            
            return result;
          } catch (error) {
            const duration = Date.now() - startTime;
            logger.error(`[RedisQueue] 莉ｻ蜉｡螟<EFBDA1>炊螟ｱ雍･`, { 
              type, 
              jobId: job.id,
              attemptsMade: job.attemptsMade,
              duration: `${duration}ms`,
              error: error instanceof Error ? error.message : 'Unknown error'
            });
            throw error;  // 謚帛<E8AC9A>髞呵ｯｯ<EFBDAF>瑚ｧｦ蜿鷹㍾隸?          }
        },
        { 
          connection: this.connection,
          concurrency: 1,  // 豈丈ｸｪWorker蟷ｶ蜿大､<E5A4A7>炊1荳ｪ莉ｻ蜉?        }
      );

      this.workers.set(type, worker);

      // 逶大成Worker莠倶ｻｶ
      worker.on('completed', (job) => {
        logger.info(`[RedisQueue] 笨?莉ｻ蜉｡螳梧<E89EB3>`, { 
          type, 
          jobId: job.id,
          returnvalue: job.returnvalue 
        });
      });

      worker.on('failed', (job, err) => {
        logger.error(`[RedisQueue] 笶?莉ｻ蜉｡螟ｱ雍･`, { 
          type, 
          jobId: job?.id,
          attemptsMade: job?.attemptsMade,
          error: err.message,
          stack: err.stack
        });
      });

      worker.on('error', (err) => {
        logger.error(`[RedisQueue] Worker髞呵ｯｯ`, { type, error: err.message });
      });

      logger.info(`[RedisQueue] Worker蟾ｲ豕ｨ蜀形, { type });

    } catch (error) {
      logger.error(`[RedisQueue] Worker豕ｨ蜀悟､ｱ雍･`, { type, error });
      throw error;
    }
  }

  /**
   * 闔ｷ蜿紋ｻｻ蜉｡迥ｶ諤?   */
  async getJob(id: string): Promise<Job | null> {
    try {
      // 驕榊紙謇€譛蛾弌蛻玲衍謇ｾ莉ｻ蜉?      for (const [type, queue] of this.queues) {
        const job = await queue.getJob(id);
        if (job) {
          return {
            id: job.id!,
            type,
            data: job.data,
            status: await this.getJobStatus(job),
            progress: job.progress as number || 0,
            createdAt: new Date(job.timestamp),
            error: job.failedReason,
          };
        }
      }
      return null;
    } catch (error) {
      logger.error(`[RedisQueue] getJob螟ｱ雍･`, { id, error });
      return null;
    }
  }

  /**
   * 闔ｷ蜿紋ｻｻ蜉｡迥ｶ諤?   */
  private async getJobStatus(job: BullJob): Promise<string> {
    const state = await job.getState();
    switch (state) {
      case 'completed': return 'completed';
      case 'failed': return 'failed';
      case 'active': return 'processing';
      case 'waiting': return 'pending';
      case 'delayed': return 'pending';
      default: return 'pending';
    }
  }

  /**
   * 譖ｴ譁ｰ莉ｻ蜉｡霑帛ｺｦ
   */
  async updateProgress(id: string, progress: number, message?: string): Promise<void> {
    try {
      for (const queue of this.queues.values()) {
        const job = await queue.getJob(id);
        if (job) {
          await job.updateProgress(progress);
          if (message) {
            await job.log(message);
          }
          logger.debug(`[RedisQueue] 霑帛ｺｦ譖ｴ譁ｰ`, { id, progress, message });
          return;
        }
      }
      logger.warn(`[RedisQueue] 莉ｻ蜉｡荳榊ｭ伜惠<E4BC9C>梧裏豕墓峩譁ｰ霑帛ｺｦ`, { id });
    } catch (error) {
      logger.error(`[RedisQueue] 譖ｴ譁ｰ霑帛ｺｦ螟ｱ雍･`, { id, error });
    }
  }

  /**
   * 蜿匁ｶ井ｻｻ蜉｡
   */
  async cancelJob(id: string): Promise<boolean> {
    try {
      for (const queue of this.queues.values()) {
        const job = await queue.getJob(id);
        if (job) {
          await job.remove();
          logger.info(`[RedisQueue] 莉ｻ蜉｡蟾ｲ蜿匁ｶ<E58C81>, { id });
          return true;
        }
      }
      logger.warn(`[RedisQueue] 莉ｻ蜉｡荳榊ｭ伜惠<E4BC9C>梧裏豕募叙豸<E58F99>, { id });
      return false;
    } catch (error) {
      logger.error(`[RedisQueue] 蜿匁ｶ井ｻｻ蜉｡螟ｱ雍･`, { id, error });
      return false;
    }
  }

  /**
   * 驥崎ｯ募､ｱ雍･莉ｻ蜉｡
   */
  async retryJob(id: string): Promise<boolean> {
    try {
      for (const queue of this.queues.values()) {
        const job = await queue.getJob(id);
        if (job) {
          await job.retry();
          logger.info(`[RedisQueue] 莉ｻ蜉｡蟾ｲ驥崎ｯ描, { id });
          return true;
        }
      }
      logger.warn(`[RedisQueue] 莉ｻ蜉｡荳榊ｭ伜惠<E4BC9C>梧裏豕暮㍾隸描, { id });
      return false;
    } catch (error) {
      logger.error(`[RedisQueue] 驥崎ｯ穂ｻｻ蜉｡螟ｱ雍･`, { id, error });
      return false;
    }
  }

  /**
   * 貂<>炊譌ｧ莉ｻ蜉?   */
  async cleanup(olderThan: number = 86400000): Promise<number> {
    try {
      let totalCleaned = 0;
      
      for (const [type, queue] of this.queues) {
        // 貂<>炊螳梧<E89EB3>逧<EFBFBD>ｻｻ蜉｡<E89C89>井ｿ晉蕗譛€霑?00荳ｪ<E88DB3><EFBDAA>
        const completed = await queue.clean(olderThan, 100, 'completed');
        // 貂<>炊螟ｱ雍･逧<EFBDA5>ｻｻ蜉｡<E89C89>井ｿ晉蕗譛€霑?0荳ｪ<E88DB3><EFBDAA>
        const failed = await queue.clean(olderThan, 50, 'failed');
        
        const cleaned = completed.length + failed.length;
        totalCleaned += cleaned;
        
        if (cleaned > 0) {
          logger.info(`[RedisQueue] 髦溷<E9ABA6>貂<EFBFBD>炊螳梧<E89EB3>`, { 
            type, 
            completed: completed.length,
            failed: failed.length
          });
        }
      }
      
      return totalCleaned;
    } catch (error) {
      logger.error(`[RedisQueue] 貂<>炊莉ｻ蜉｡螟ｱ雍･`, { error });
      return 0;
    }
  }

  /**
   * 蜈ｳ髣ｭ謇€譛芽ｿ樊磁<E6A88A>井ｼ倬寉蜈ｳ髣ｭ<E9ABA3>?   */
  async close(): Promise<void> {
    try {
      // 蜈ｳ髣ｭ謇€譛姥orkers
      for (const [type, worker] of this.workers) {
        await worker.close();
        logger.info(`[RedisQueue] Worker蟾ｲ蜈ｳ髣ｭ`, { type });
      }
      
      // 蜈ｳ髣ｭ謇€譛渦ueues
      for (const [type, queue] of this.queues) {
        await queue.close();
        logger.info(`[RedisQueue] Queue蟾ｲ蜈ｳ髣ｭ`, { type });
      }
      
      // 蜈ｳ髣ｭ謇€譛渦ueueEvents
      for (const [type, events] of this.queueEvents) {
        await events.close();
        logger.info(`[RedisQueue] QueueEvents蟾ｲ蜈ｳ髣ｭ`, { type });
      }
      
      logger.info(`[RedisQueue] 謇€譛芽ｿ樊磁蟾ｲ蜈ｳ髣ｭ`);
    } catch (error) {
      logger.error(`[RedisQueue] 蜈ｳ髣ｭ霑樊磁螟ｱ雍･`, { error });
    }
  }
}
```

#### **豁･鬪､5.3<EFBFBD>壽峩譁ｰJobFactory謾ｯ謖ヽedis髦溷<EFBFBD>**

```typescript
// 譁<>ｻｶ<EFBDBB>喘ackend/src/common/jobs/JobFactory.ts

import { JobQueue } from './types.js'
import { MemoryQueue } from './MemoryQueue.js'
import { RedisQueue } from './RedisQueue.js'  // 竊?譁ｰ蠅<EFBDB0>
import { logger } from '../logging/index.js'
import { config } from '../../config/env.js'

export class JobFactory {
  private static instance: JobQueue | null = null

  static getInstance(): JobQueue {
    if (!this.instance) {
      this.instance = this.createQueue()
    }
    return this.instance
  }

  private static createQueue(): JobQueue {
    const queueType = config.queueType || 'memory'

    logger.info('[JobFactory] 蛻晏ｧ句喧莉ｻ蜉｡髦溷<E9ABA6>?, { queueType });

    switch (queueType) {
      case 'redis':  // 竊?譁ｰ蠅<EFBDB0>
        return this.createRedisQueue()
      
      case 'memory':
        return this.createMemoryQueue()
      
      default:
        logger.warn(`[JobFactory] Unknown QUEUE_TYPE: ${queueType}, fallback to memory`)
        return this.createMemoryQueue()
    }
  }

  /**
   * 蛻帛ｻｺRedis髦溷<E9ABA6><E6BAB7>亥ｸｦ髯咲ｺｧ遲也払<E4B99F>?   */
  private static createRedisQueue(): JobQueue {
    try {
      logger.info('[JobFactory] 豁｣蝨ｨ霑樊磁Redis髦溷<E9ABA6>...');
      
      const redisQueue = new RedisQueue();
      
      logger.info('[JobFactory] 笨?Redis髦溷<E9ABA6>蛻晏ｧ句喧謌仙<E8AC8C>?);
      return redisQueue;
      
    } catch (error) {
      logger.error('[JobFactory] 笶?Redis髦溷<E9ABA6>蛻晏ｧ句喧螟ｱ雍･<E99B8D>碁剄郤ｧ蛻ｰ蜀<EFBDB0>ｭ倬弌蛻?, { error });
      return this.createMemoryQueue();
    }
  }

  private static createMemoryQueue(): MemoryQueue {
    logger.info('[JobFactory] 菴ｿ逕ｨ蜀<EFBDA8>ｭ倬弌蛻<E5BC8C>')
    
    const queue = new MemoryQueue()
    
    // 螳壽悄貂<E68284>炊<EFBFBD>磯∩蜈榊<E89C88>蟄俶ｳ<E4BFB6>ｼ擾ｼ<E693BE>
    if (process.env.NODE_ENV !== 'test') {
      setInterval(() => {
        queue.cleanup()
      }, 60 * 60 * 1000)
    }
    
    return queue
  }

  static reset(): void {
    this.instance = null
  }
}
```

#### **豁･鬪､5.4<EFBFBD>壻ｿｮ謾ｹ荳壼苅莉｣遐∽ｽｿ逕ｨ髦溷<EFBFBD>?*

```typescript
// 遉ｺ萓具ｼ哂SL譁<4C>鍵遲幃€画隼騾?// 譁<>ｻｶ<EFBDBB>喘ackend/src/modules/asl/services/screeningService.ts

import { jobQueue } from '../../../common/jobs/index.js';

export async function startScreeningTask(projectId: string, userId: string) {
  // 1. 蛻帛ｻｺ謨ｰ謐ｮ蠎謎ｻｻ蜉｡隶ｰ蠖?  const task = await prisma.aslScreeningTask.create({
    data: {
      projectId,
      status: 'pending',
      totalItems: literatures.length,
      // ...
    }
  });

  // 2. 謗ｨ騾∝芦Redis髦溷<E9ABA6><E6BAB7>井ｸ埼仆蝪櫁ｯｷ豎ゑｼ?  await jobQueue.push('asl:title-screening', {
    taskId: task.id,
    projectId,
    literatureIds: literatures.map(lit => lit.id),
  });

  logger.info('莉ｻ蜉｡蟾ｲ蜈･髦?, { taskId: task.id });

  // 3. 遶句叉霑泌屓<E6B38C>亥燕遶ｯ霓ｮ隸｢霑帛ｺｦ<EFBDBA><EFBDA6>
  return task;
}

// 豕ｨ蜀係orker<65>亥惠蠎皮畑蜷ｯ蜉ｨ譌ｶ<E8AD8C><EFBDB6>
// 譁<>ｻｶ<EFBDBB>喘ackend/src/index.ts
jobQueue.process('asl:title-screening', async (job) => {
  const { taskId, projectId, literatureIds } = job.data;
  
  logger.info('蠑€蟋句､<E58FA5>炊遲幃€我ｻｻ蜉?, { taskId, total: literatureIds.length });
  
  for (let i = 0; i < literatureIds.length; i++) {
    const literatureId = literatureIds[i];
    
    // 螟<>炊蜊慕ｯ<E68595>枚迪ｮ
    await processSingleLiterature(literatureId, projectId);
    
    // 譖ｴ譁ｰ霑帛ｺｦ
    const progress = ((i + 1) / literatureIds.length) * 100;
    await jobQueue.updateProgress(job.id, progress);
    
    // 譖ｴ譁ｰ謨ｰ謐ｮ蠎?    await prisma.aslScreeningTask.update({
      where: { id: taskId },
      data: { processedItems: i + 1 }
    });
  }
  
  // 譬<>ｮｰ螳梧<E89EB3>
  await prisma.aslScreeningTask.update({
    where: { id: taskId },
    data: { status: 'completed', completedAt: new Date() }
  });
  
  logger.info('遲幃€我ｻｻ蜉｡螳梧<E89EB3>?, { taskId });
  
  return { success: true, processed: literatureIds.length };
});
```

#### **豁･鬪､5.5<EFBFBD>壽峩譁?env驟咲ｽｮ**

```env
# backend/.env

# ==================== 莉ｻ蜉｡髦溷<E9ABA6>驟咲ｽｮ ====================
QUEUE_TYPE=redis  # 竊?謾ｹ荳ｺredis

# Redis驟咲ｽｮ<EFBDBD>井ｸ守ｼ灘ｭ伜<EFBDAD>逕ｨ<E98095>?REDIS_HOST=localhost
REDIS_PORT=6379
REDIS_PASSWORD=
REDIS_DB=0
```

#### **豁･鬪､5.6<EFBFBD>壽ｵ玖ｯ紐edis髦溷<EFBFBD>**

```bash
# 1. 蜷ｯ蜉ｨ蜷守ｫｯ
cd backend
npm run dev

# 蠎碑ｯ･逵句芦譌･蠢暦ｼ?# [JobFactory] 豁｣蝨ｨ霑樊磁Redis髦溷<E9ABA6>...
# [JobFactory] 笨?Redis髦溷<E9ABA6>蛻晏ｧ句喧謌仙<E8AC8C>?
# 2. 謠蝉ｺ､豬玖ｯ穂ｻｻ蜉｡<E89C89>井ｽｿ逕ｨREST Client謌鳳ostman<61>?POST http://localhost:3001/api/v1/asl/projects/:projectId/screening

# 3. 隗ょｯ滓律蠢<E5BE8B>
# [RedisQueue] 莉ｻ蜉｡蜈･髦滓<E9ABA6>蜉<EFBFBD> { type: 'asl:title-screening', jobId: '1' }
# [RedisQueue] 蠑€蟋句､<E58FA5>炊莉ｻ蜉?{ type: 'asl:title-screening', jobId: '1' }
# [RedisQueue] 笨?莉ｻ蜉｡螳梧<E89EB3> { type: 'asl:title-screening', jobId: '1' }

# 4. 豬玖ｯ募ｮ樔ｾ矩㍾蜷ｯ諱｢螟<EFBDA2>
# 謠蝉ｺ､莉ｻ蜉｡ 竊?遲牙ｾ<E78999>､<EFBFBD>炊蛻?0% 竊?Ctrl+C蛛懈ｭ｢ 竊?驥肴眠蜷ｯ蜉ｨ
# 莉ｻ蜉｡蠎碑ｯ･閾ｪ蜉ｨ莉山edis諱｢螟榊ｹｶ扈ｧ扈ｭ螟<EFBDAD><E89E9F>?```

---

## 5. 豬玖ｯ墓婿譯<E5A9BF>

### 5.1 蜊募<E89C8A>豬玖ｯ墓ｸ<E5A293>黒

| 豬玖ｯ暮｡?| 鬚<>悄扈捺棡 | 螳樣刔扈捺棡 | 迥ｶ諤?|
|--------|---------|---------|------|
| Redis霑樊磁豬玖ｯ<E78E96> | PONG | 笨?| 筮?蠕<>ｵ<EFBFBD> |
| 蝓ｺ譛ｬ隸ｻ蜀呎ｵ玖ｯ<E78E96> | 蛟ｼ蛹ｹ驟?| 笨?| 筮?蠕<>ｵ<EFBFBD> |
| 蟇ｹ雎｡蠎丞<E8A08E>蛹匁ｵ玖ｯ?| 蟇ｹ雎｡螳梧紛 | 笨?| 筮?蠕<>ｵ<EFBFBD> |
| TTL霑<4C>悄豬玖ｯ<E78E96> | 2遘貞錘荳ｺnull | 笨?| 筮?蠕<>ｵ<EFBFBD> |
| 螟ｧ蟇ｹ雎｡豬玖ｯ包ｼ<E58C85>50KB<4B>?| <10ms | 笨?| 筮?蠕<>ｵ<EFBFBD> |
| 髯咲ｺｧ遲也払豬玖ｯ<E78E96> | 閾ｪ蜉ｨ蛻<EFBDA8>困蜀<E59BB0>ｭ<EFBFBD> | 笨?| 筮?蠕<>ｵ<EFBFBD> |

### 5.2 髮<><E9ABAE>豬玖ｯ墓ｸ<E5A293>黒

| 豬玖ｯ暮｡?| 謫堺ｽ懈ｭ･鬪､ | 鬚<>悄扈捺棡 | 迥ｶ諤?|
|--------|---------|---------|------|
| **HealthCheckService** | 荳贋ｼ<E8B48B>Excel 2谺?| 隨?谺｡郛灘ｭ伜多荳?| 筮?蠕<>ｵ<EFBFBD> |
| **LLM12FieldsService** | 謠仙叙蜷御ｸ€PDF 2谺?| 隨?谺｡郛灘ｭ伜多荳?| 筮?蠕<>ｵ<EFBFBD> |
| **螟壼ｮ樔ｾ狗ｼ灘ｭ伜<EFBDAD>莠?* | 蜷ｯ蜉ｨ2荳ｪ蜷守ｫｯ螳樔ｾ具ｼ悟ｮ樔ｾ帰蜀吝<E89C80><E5909D>悟ｮ樔ｾ毅隸ｻ蜿<EFBDBB> | B閭ｽ隸ｻ蛻ｰA逧<41>ｼ灘ｭ?| 筮?蠕<>ｵ<EFBFBD> |
| **螳樔ｾ矩㍾蜷ｯ謨ｰ謐ｮ謖∽ｹ<E288BD><EFBDB9>?* | 蜀吝<E89C80>郛灘ｭ<E78198> 竊?驥榊星蜷守ｫｯ 竊?隸ｻ蜿<EFBDBB> | 閭ｽ隸ｻ蜿門芦 | 筮?蠕<>ｵ<EFBFBD> |

### 5.3 蜴句鴨豬玖ｯ<E78E96>

```bash
# 菴ｿ逕ｨab謌殆rk豬玖ｯ募ｹｶ蜿題ｯｻ蜀<EFBDBB>

# 豬玖ｯ<E78E96>1<EFBFBD>壼ｹｶ蜿大<E89CBF>蜈?ab -n 1000 -c 10 http://localhost:3001/api/test/cache-write

# 豬玖ｯ<E78E96>2<EFBFBD>壼ｹｶ蜿題ｯｻ蜿?ab -n 10000 -c 50 http://localhost:3001/api/test/cache-read

# 鬚<>悄扈捺棡<E68DBA>?# - QPS > 1000
# - 蜩榊ｺ疲慮髣ｴ < 50ms
# - 髞呵ｯｯ邇?= 0%
```

### 5.4 謨<>囿讓｡諡滓ｵ玖ｯ<E78E96>

| 謨<>囿蝨ｺ譎ｯ | 讓｡諡滓婿豕<E5A9BF> | 鬚<>悄陦御ｸｺ | 迥ｶ諤?|
|---------|---------|---------|------|
| **Redis遯∫┯謖よ脂** | `docker stop ai-clinical-redis` | 邉ｻ扈滄剄郤ｧ蛻ｰ蜀<EFBDB0>ｭ倡ｼ灘ｭ假ｼ悟ｺ皮畑扈ｧ扈ｭ霑占｡<E58DA0> | 筮?蠕<>ｵ<EFBFBD> |
| **Redis鄂醍ｻ懷ｻｶ霑<EFBDB6>** | `tc qdisc add dev eth0 root netem delay 500ms` | 雜<>慮驥崎ｯ包ｼ梧怙扈郁ｿ泌屓null | 筮?蠕<>ｵ<EFBFBD> |
| **Redis蜀<73>ｭ俶ｻ?* | 蜀吝<E89C80>螟ｧ驥乗焚謐ｮ閾?56MB | 隗ｦ蜿銑RU鬩ｱ騾撰ｼ御ｸ榊ｽｱ蜩肴眠蜀吝<E89C80> | 筮?蠕<>ｵ<EFBFBD> |
| **Redis蟇<73><E89F87><EFBFBD>漠隸ｯ** | 菫ｮ謾ｹ蟇<EFBDB9><E89F87><EFBFBD> | 霑樊磁螟ｱ雍･<E99B8D>碁剄郤ｧ蛻ｰ蜀<EFBDB0>ｭ倡ｼ灘ｭ<E78198> | 筮?蠕<>ｵ<EFBFBD> |

---

## 6. 鬟朱勦隸<E58BA6>ｼｰ荳守ｼ楢ｧ?
### 6.1 鬟朱勦遏ｩ髦ｵ

| 鬟朱勦 | 荳･驥肴€?| 讎ら紫 | 蠖ｱ蜩<EFBDB1> | 郛楢ｧ｣謗ｪ譁ｽ | 迥ｶ諤?|
|------|--------|------|------|----------|------|
| **Redis霑樊磁螟ｱ雍･** | <20>閥 鬮?| <20>泯 荳?| 邉ｻ扈滉ｸ榊庄逕?| 笨?髯咲ｺｧ遲也払 | 笨?蟾ｲ螳樒<E89EB3>?|
| **謨ｰ謐ｮ荳｢螟ｱ** | <20>泯 荳?| <20>泙 菴?| 郛灘ｭ伜､ｱ謨<EFBDB1> | 笨?蜈ｳ髞ｮ謨ｰ謐ｮ蜿悟<E89CBF>DB | 竢?蠕<>ｮ樒<EFBDAE>?|
| **蜀<>ｭ俶ｺ｢蜃ｺ<E89C83><EFBDBA>OM<4F>?* | <20>閥 鬮?| <20>泯 荳?| Redis蟠ｩ貅<EFBDA9> | 笨?荳･譬ｼTTL + 逶第而 | 竢?蠕<>ｮ樒<EFBDAE>?|
| **鄂醍ｻ懷ｻｶ霑<EFBDB6>** | <20>泙 菴?| <20>泙 菴?| 蜩榊ｺ泌序諷｢ | 笨?謇ｹ驥乗桃菴<E6A183> | 竢?蜿ｯ騾我ｼ伜<EFBDBC>?|
| **驟咲ｽｮ髞呵ｯｯ** | <20>泯 荳?| <20>泯 荳?| 蜷ｯ蜉ｨ螟ｱ雍･ | 笨?驟咲ｽｮ鬪瑚ｯ<E7919A> | 笨?蟾ｲ螳樒<E89EB3>?|
| **蟇<><E89F87>∵ｳ<E288B5>愆** | <20>閥 鬮?| <20>泯 荳?| 謨ｰ謐ｮ豕<EFBDAE>愆 | 笨?KMS邂｡逅<EFBDA1> | 竢?蠕<>ｮ樒<EFBDAE>?|

### 6.2 蜈ｳ髞ｮ郛楢ｧ｣謗ｪ譁ｽ

#### **郛楢ｧ｣謗ｪ譁ｽ1<EFBDBD>夐剄郤ｧ遲也払<E4B99F>亥ｿ<E4BAA5>｡ｻ<EFBDA1>?* 笨?```typescript
// 蟾ｲ蝨ｨCacheFactory荳ｭ螳樒<E89EB3>?// Redis荳榊庄逕ｨ譌ｶ閾ｪ蜉ｨ蛻<EFBDA8>困蛻ｰMemoryCache
```

#### **郛楢ｧ｣謗ｪ譁ｽ2<EFBDBD>壼<EFBFBD>髞ｮ謨ｰ謐ｮ蜿悟<E89CBF><E6829F>域耳闕撰ｼ?* 竢?```typescript
// 髴€隕∝惠荳壼苅莉｣遐∽ｸｭ豺ｻ蜉?
// 遉ｺ萓具ｼ壻ｻｻ蜉｡霑帛ｺｦ蜿悟<E89CBF>?export async function updateTaskProgress(taskId: string, progress: number) {
  // 1. 蜀儚edis<69>亥ｿｫ騾滓衍隸｢<E99AB8><EFBDA2>
  await cache.set(`task:${taskId}:progress`, progress, 3600);
  
  // 2. 蜷梧慮蜀僖B<E58396>域戟荵<E6889F>喧<EFBFBD>?  await prisma.aslScreeningTask.update({
    where: { id: taskId },
    data: { processedItems: progress }
  });
}
```

#### **郛楢ｧ｣謗ｪ譁ｽ3<EFBDBD>壼<EFBFBD>蟄倡尅謗ｧ<E8AC97>域耳闕撰ｼ?* 竢?```typescript
// 蛻帛ｻｺ<EFBDBB>喘ackend/src/scripts/monitor-redis.ts

import { cache } from '../common/cache/index.js';

setInterval(async () => {
  // 譽€譟･蜀<EFBDA5>ｭ倅ｽｿ逕?  const info = await redis.info('memory');
  const used = parseInt(info.match(/used_memory:(\d+)/)[1]);
  const max = 256 * 1024 * 1024;
  
  if (used > max * 0.8) {
    logger.warn('笞<><E7AC9E><EFBFBD> Redis蜀<73>ｭ倅ｽｿ逕ｨ雜<EFBDA8>ｿ<EFBFBD>80%', { used, max });
    // TODO: 蜿鷹€<E9B7B9>忠髓?驍ｮ莉ｶ蜻願ｭｦ
  }
}, 60000);
```

#### **郛楢ｧ｣謗ｪ譁ｽ4<EFBDBD>夐<EFBFBD>鄂ｮ鬪瑚ｯ<E7919A>ｼ亥ｷｲ螳樒鴫<E6A892><E9B4AB>** 笨?```typescript
// env.ts荳ｭ逧ёalidateConfig()
// 蜷ｯ蜉ｨ譌ｶ譽€譟･Redis驟咲ｽｮ
```

---

## 7. 荳顔ｺｿ隶｡蛻<EFBDA1>

### 7.1 荳顔ｺｿ譌ｶ髣ｴ陦ｨ<E999A6><EFBDA8>2.0譖ｴ譁ｰ<EFBFBD>?
| 髦ｶ谿ｵ | 譌ｶ髣ｴ | 莉ｻ蜉｡ | 雍溯ｴ｣莠?| 迥ｶ諤?|
|------|------|------|--------|------|
| **Phase 1** | Day 1荳雁壕 | 譛ｬ蝨ｰ蠑€蜿醍識蠅<E8AD98>㊥螟?| 蠑€蜿?| 筮?蠕<>ｼ€蟋?|
| **Phase 2** | Day 1荳句壕 | 螳樒鴫RedisCacheAdapter | 蠑€蜿?| 筮?蠕<>ｼ€蟋?|
| **Phase 3** | Day 2蜈ｨ螟ｩ | Redis郛灘ｭ俶悽蝨ｰ豬玖ｯ<E78E96> | 蠑€蜿?豬玖ｯ<E78E96> | 筮?蠕<>ｼ€蟋?|
| **Phase 4** | Day 3荳雁壕 | 髦ｿ驥御ｺ然edis雍ｭ荵ｰ&驟咲ｽｮ | 霑千ｻｴ | 筮?蠕<>ｼ€蟋?|
| **Phase 5** | Day 3荳句壕-Day 5 | <20>閥 螳樒鴫RedisQueue<75>亥ｿ<E4BAA5>｡ｻ<EFBDA1>榎 蠑€蜿?| 筮?蠕<>ｼ€蟋?|
| **Phase 6** | Day 6蜈ｨ螟ｩ | Redis髦溷<E9ABA6>譛ｬ蝨ｰ豬玖ｯ<E78E96> + 荳壼苅髮<E88B85><E9ABAE> | 蠑€蜿?豬玖ｯ<E78E96> | 筮?蠕<>ｼ€蟋?|
| **Phase 7** | Day 7荳雁壕 | SAE豬玖ｯ慕識蠅<E8AD98>ｪ瑚ｯ<E7919A> | 蠑€蜿?豬玖ｯ<E78E96> | 筮?蠕<>ｼ€蟋?|
| **Phase 8** | Day 7荳句壕 | 逕滉ｺｧ邇ｯ蠅<EFBDAF>ｸ顔ｺｿ | 蜈ｨ蜻<EFBDA8> | 筮?蠕<>ｼ€蟋?|
| **Phase 9** | Day 7譎? | 逶第而隗ょｯ滂ｼ?4蟆乗慮<E4B997>?| 霑千ｻｴ | 筮?蠕<>ｼ€蟋?|

**諤ｻ蟾･菴憺㍼**<2A>?螟ｩ<E89E9F>域ｯ泌次隶｡蛻貞｢槫刈4螟ｩ<E89E9F>御ｽ<E5BEA1>｡ｮ菫晄<E88FAB>ｸ蠢<EFBDB8>粥閭ｽ蜿ｯ逕ｨ<E98095><EFBDA8>

### 7.2 荳顔ｺｿ豁･鬪､<E9ACAA>育函莠ｧ邇ｯ蠅<EFBDAF>ｼ<EFBFBD>

#### **Step 1<>壼書蟶<E69BB8>燕譽€譟･<E8AD9F><EFBDA5>15蛻<35>帖<EFBFBD>?*
```bash
笨?莉｣遐∝ｷｲ謠蝉ｺ､Git
笨?譛ｬ蝨ｰ豬玖ｯ募<EFBDAF>驛ｨ騾夊ｿ<E5A48A>
笨?髦ｿ驥御ｺ然edis蟾ｲ蟆ｱ扈?笨?SAE邇ｯ蠅<EFBDAF>序驥丞ｷｲ驟咲ｽ?笨?蝗樊ｻ壽婿譯亥ｷｲ蜃<EFBDB2>､?笨?逶第而蟾ｲ蟆ｱ扈?```

#### **Step 2<>夂<EFBFBD>蠎ｦ蜿大ｸ<E5A4A7>ｼ<EFBFBD>30蛻<30>帖<EFBFBD>?*
```
1. SAE謗ｧ蛻ｶ蜿?竊?騾画叫蠎皮畑
2. 蠎皮畑驛ｨ鄂ｲ 竊?蛻<>音蜿大ｸ<E5A4A7>
3. 隨?謇ｹ<E8AC87><EFBDB9>10%螳樔ｾ具ｼ郁ｧょｯ?5蛻<35>帖<EFBFBD>?4. 隨?謇ｹ<E8AC87><EFBDB9>50%螳樔ｾ具ｼ郁ｧょｯ?0蛻<30>帖<EFBFBD>?5. 隨?謇ｹ<E8AC87><EFBDB9>100%螳樔ｾ<E6A894>
```

#### **Step 3<>夐ｪ瑚ｯ<E7919A>ｼ<EFBFBD>15蛻<35>帖<EFBFBD>?*
```bash
# 1. 譽€譟･Redis霑樊磁
curl https://your-api.com/api/health
# 蠎碑ｯ･霑泌屓<E6B38C>嘴 cache: "redis", status: "ok" }

# 2. 豬玖ｯ慕ｼ灘ｭ伜<EFBDAD>蜈･
# 荳贋ｼ<E8B48B>Excel 竊?譟･逵区律蠢<E5BE8B> 竊?遑ｮ隶､Redis蜀吝<E89C80>

# 3. 豬玖ｯ慕ｼ灘ｭ倩ｯｻ蜿<EFBDBB>
# 蜀肴ｬ｡荳贋ｼ<E8B48B> 竊?譟･逵区律蠢<E5BE8B> 竊?遑ｮ隶､郛灘ｭ伜多荳ｭ

# 4. 譽€譟･Redis蜀<73>ｭ<EFBFBD>
髦ｿ驥御ｺ第而蛻ｶ蜿ｰ 竊?Redis逶第而 竊?蜀<>ｭ倅ｽｿ逕ｨ
```

#### **Step 4<>夂尅謗ｧ隗ょｯ滂ｼ<E6BB82>24蟆乗慮<E4B997>?*
```
蜈ｳ豕ｨ謖<EFBFBD><EFBFBD><EFBFBD>ｼ?- Redis霑樊磁謨ｰ<E8ACA8>亥ｺ碑ｯ･遞ｳ螳夲ｼ?- 蜀<>ｭ倅ｽｿ逕ｨ邇<EFBDA8>ｼ亥ｺ碑ｯ･ < 50%<25>?- 郛灘ｭ伜多荳ｭ邇<EFBDAD>ｼ亥ｺ碑ｯ･ > 80%<25>?- 蠎皮畑髞呵ｯｯ譌･蠢暦ｼ亥ｺ碑ｯ･譌<EFBDA5>Redis逶ｸ蜈ｳ髞呵ｯｯ<EFBDAF>?- API謌先悽<E58588>亥ｺ碑ｯ･荳矩剄<E79FA9><E58984>
```

---

## 8. 蝗樊ｻ壽婿譯<E5A9BF>

### 8.1 蠢ｫ騾溷屓貊夲ｼ<E5A4B2>5蛻<35>帖蜀<E5B896>ｼ<EFBFBD>

#### **蝨ｺ譎ｯ1<EFBDAF>啌edis霑樊磁螟ｱ雍･<E99B8D>悟ｺ皮畑譌<E79591>豕募星蜉?*

```bash
# 譁ｹ豕<EFBDB9>1<EFBFBD>壻ｿｮ謾ｹSAE邇ｯ蠅<EFBDAF>序驥<E5BA8F>
髦ｿ驥御ｺ第而蛻ｶ蜿ｰ 竊?SAE蠎皮畑 竊?驟咲ｽｮ邂｡逅<EFBDA1> 竊?邇ｯ蠅<EFBDAF>序驥<E5BA8F>
菫ｮ謾ｹ<EFBFBD>咾ACHE_TYPE=memory
菫晏ｭ<EFBFBD> 竊?蠎皮畑驥榊星

# 譁ｹ豕<EFBDB9>2<EFBFBD>夐㍾譁ｰ驛ｨ鄂ｲ荳贋ｸ€荳ｪ迚域<E8BF9A>?SAE謗ｧ蛻ｶ蜿?竊?蠎皮畑驛ｨ鄂ｲ 竊?迚域悽邂｡逅<EFBDA1> 竊?蝗樊ｻ<E6A88A>
```

#### **蝨ｺ譎ｯ2<EFBDAF>啌edis諤ｧ閭ｽ髣ｮ鬚假ｼ悟桃蠎泌序諷?*

```bash
# 荳ｴ譌ｶ髯咲ｺｧ蛻ｰ蜀<EFBDB0>ｭ倡ｼ灘ｭ?CACHE_TYPE=memory

# 謌紋ｿ晉蕗Redis菴<73>｣€譟･鄂醍ｻ?ping r-xxxxxxxxxxxx.redis.rds.aliyuncs.com
```

#### **蝨ｺ譎ｯ3<EFBDAF>啌edis蜀<73>ｭ俶ｻ｡<EFBDBB>梧裏豕募<E8B195>蜈･**

```bash
# 譁ｹ豕<EFBDB9>1<EFBFBD>壽ｸ<E5A3BD>炊Redis<69>亥些髯ｩ<E9ABAF><EFBDA9>ｼ?redis-cli -h r-xxx.redis.rds.aliyuncs.com -a password
> FLUSHDB

# 譁ｹ豕<EFBDB9>2<EFBFBD>壼合郤ｧRedis隗<73><E99A97>ｼ
髦ｿ驥御ｺ第而蛻ｶ蜿ｰ 竊?Redis螳樔ｾ<E6A894> 竊?蜿倬<E89CBF> 竊?512MB
```

### 8.2 蝗樊ｻ壽｣€譟･貂<EFBDA5><E8B282>?
```bash
笨?蠎皮畑閭ｽ蜷ｦ豁｣蟶ｸ蜷ｯ蜉ｨ<E89C89>?笨?郛灘ｭ俶弍蜷ｦ蟾･菴懶ｼ亥<EFBDBC>蟄俶ｨ｡蠑擾ｼ会ｼ?笨?API蜩榊ｺ疲弍蜷ｦ豁｣蟶ｸ<E89FB6>?笨?髞呵ｯｯ譌･蠢玲弍蜷ｦ貂<EFBDA6>勁<EFBFBD>?笨?逕ｨ謌ｷ譏ｯ蜷ｦ閭ｽ豁｣蟶ｸ菴ｿ逕ｨ<E98095><EFBDA8>
```

---

## 9. 逶第而荳手ｿ千ｻ?
### 9.1 逶第而謖<E8808C><E8AC96><EFBFBD>

#### **Redis謖<73><E8AC96><EFBFBD>ｼ磯仭驥御ｺ第而蛻ｶ蜿ｰ<E89CBF><EFBDB0>**

| 謖<><E8AC96><EFBFBD> | 豁｣蟶ｸ闌<EFBDB8>峩 | 蜻願ｭｦ髦亥€?| 螟<>炊譁ｹ譯<EFBDB9> |
|------|---------|---------|---------|
| **蜀<>ｭ倅ｽｿ逕ｨ邇?* | < 50% | > 80% | 譽€譟･螟ｧkey<65>瑚€<E7919A>剔蜊<E58994><E89C8A> |
| **霑樊磁謨?* | < 50 | > 100 | 譽€譟･霑樊磁豕<E7A381>ｼ?|
| **QPS** | < 1000 | > 5000 | 閠<>剔蛻<E58994>援 |
| **蜻ｽ荳ｭ邇?* | > 80% | < 50% | 譽€譟･郛灘ｭ倡ｭ也<EFBDAD>?|
| **蜩榊ｺ疲慮髣ｴ** | < 5ms | > 50ms | 譽€譟･鄂醍ｻ?|

#### **蠎皮畑謖<E79591><E8AC96><EFBFBD>ｼ<EFBFBD>AE譌･蠢暦ｼ?*

```bash
# 譟･謇ｾRedis逶ｸ蜈ｳ髞呵ｯｯ
grep "Redis" logs/app.log | grep "ERROR"

# 譟･謇ｾ郛灘ｭ伜多荳ｭ諠<EFBDAD><E8ABA0>
grep "Cache hit" logs/app.log | wc -l
grep "Cache miss" logs/app.log | wc -l

# 隶｡邂怜多荳ｭ邇?蜻ｽ荳ｭ邇?= hits / (hits + misses) * 100%
```

### 9.2 霑千ｻｴ蜻ｽ莉､

#### **蟶ｸ逕ｨRedis CLI蜻ｽ莉､**
```bash
# 霑樊磁Redis
redis-cli -h r-xxx.redis.rds.aliyuncs.com -p 6379 -a your_password

# 譟･逵区園譛洩ey
KEYS *

# 譟･逵倶ｻｻ蜉｡逶ｸ蜈ｳkey
KEYS task:*

# 譟･逵狗ｼ灘ｭ倡嶌蜈ｳkey
KEYS fulltext:*

# 譟･逵橘ey逧УTL
TTL task:abc123:progress

# 譟･逵橘ey逧<79>€?GET task:abc123:progress

# 譟･逵句<E980B5>蟄倅ｽｿ逕ｨ
INFO memory

# 譟･逵玖ｿ樊磁謨?INFO clients

# 螳樊慮逶第而蜻ｽ莉､
MONITOR

# 貂<>ｩｺ謨ｰ謐ｮ蠎難ｼ亥些髯ｩ<E9ABAF><EFBDA9>ｼ<EFBFBD>
FLUSHDB
```

#### **蜀<>ｭ伜<EFBDAD>譫<EFBFBD>**
```bash
# 譟･謇ｾ螟ｧkey<65>?10KB<4B>?redis-cli -h xxx -a password --bigkeys

# 譟･逵橘ey逧<79><E980A7>蟄伜頃逕?MEMORY USAGE task:abc123:progress
```

### 9.3 謨<>囿謗呈衍豬∫ｨ<E288AB>

```
髣ｮ鬚假ｼ啌edis霑樊磁螟ｱ雍･
  竊?1. 譽€譟･Redis螳樔ｾ狗憾諤<E686BE>ｼ磯仭驥御ｺ第而蛻ｶ蜿ｰ<E89CBF>?  竊?2. 譽€譟･逋ｽ蜷榊黒驟咲ｽｮ<EFBDBD>域弍蜷ｦ蛹<EFBDA6>性SAE IP<49>?  竊?3. 譽€譟･蟇<EFBDA5><E89F87>∵弍蜷ｦ豁｣遑?  竊?4. ping豬玖ｯ慕ｽ醍ｻ懆ｿ樣€壽€?  竊?5. 譟･逵句ｺ皮畑譌･蠢<EFBDA5>
  竊?6. 螯よ裏豕募ｿｫ騾溯ｧ｣蜀?竊?髯咲ｺｧ蛻ｰ蜀<EFBDB0>ｭ倡ｼ灘ｭ?```

### 9.4 螳壽悄扈ｴ謚､

| 扈ｴ蠎ｦ | 鬚醍紫 | 蜀<>ｮｹ |
|------|------|------|
| **譌･蟶ｸ逶第而** | 豈丞､ｩ | 譟･逵句<E980B5>蟄倅ｽｿ逕ｨ縲∬ｿ樊磁謨ｰ縲<EFBDB0>漠隸ｯ譌･蠢?|
| **諤ｧ閭ｽ蛻<EFBDBD>梵** | 豈丞捉 | 蛻<>梵郛灘ｭ伜多荳ｭ邇<EFBDAD>€∝桃蠎疲慮髣?|
| **螳ｹ驥剰ｯ<E589B0>ｼｰ** | 豈乗怦 | 隸<>ｼｰ256MB譏ｯ蜷ｦ螟溽畑<E6BABD>梧弍蜷ｦ髴€隕∝合驟?|
| **螳牙<E89EB3>譽€譟?* | 豈乗怦 | 譽€譟･逋ｽ蜷榊黒縲∝ｯ<E2889D><EFBDAF>∝ｼｺ蠎ｦ縲∬ｮｿ髣ｮ譌･蠢?|

---

## 10. 謌仙粥譬<E7B2A5>㊥

### 10.1 謚€譛ｯ謖<EFBDAF><E8AC96><EFBFBD>ｼ<EFBFBD>2.0譖ｴ譁ｰ<EFBFBD>?
| 謖<><E8AC96><EFBFBD> | 蠖灘燕蛟ｼ<E89B9F>亥<EFBFBD>蟄假ｼ?| 逶ｮ譬<EFBDAE>€ｼ<C280><EFBDBC>edis<69>?| 陦｡驥乗婿豕<E5A9BF> |
|------|---------------|----------------|---------|
| **郛灘ｭ俶戟荵<E6889F><E88DB5>?* | 笶?螳樔ｾ矩㍾蜷ｯ荳｢螟ｱ | 笨?謖∽ｹ<E288BD>喧菫晏ｭ?| 驥榊星蜷惹ｻ崎<EFBDBB>隸ｻ蜿?|
| **螟壼ｮ樔ｾ句<EFBDBE>莠?* | 笶?蜷<>ｮ樔ｾ狗峡遶?| 笨?蜈ｨ螻€蜈ｱ莠ｫ | 螳樔ｾ帰蜀呻ｼ悟ｮ樔ｾ毅閭ｽ隸ｻ |
| **LLM API驥榊､崎ｰ<E5B48E>畑** | <20>閥 鬮?| <20>泙 菴?| 蜷御ｸ€PDF蜿ｪ隹<EFBDAA><E99AB9>?谺?|
| **郛灘ｭ伜多荳ｭ邇?* | N/A | > 60% | 逶第而譌･蠢礼ｻ溯ｮ｡ |
| **莉ｻ蜉｡謖∽ｹ<E288BD><EFBDB9>?* | 笶?螳樔ｾ矩楳豈∽ｸ｢螟?| 笨?莉ｻ蜉｡扈ｧ扈ｭ | <20>閥 **譁ｰ蠅<EFBDB0>** |
| **髟ｿ莉ｻ蜉｡謌仙粥邇<E7B2A5>** | 10-30% | > 99% | <20>閥 **蜈ｳ髞ｮ謖<EFBDAE><E8AC96><EFBFBD>** |
| **邉ｻ扈溷庄逕ｨ諤?* | 99% | 99.9% | 髯咲ｺｧ遲也払菫晞囿 |

### 10.2 荳壼苅謖<E88B85><E8AC96><EFBFBD>ｼ<EFBFBD>2.0譖ｴ譁ｰ<EFBFBD>?
| 謖<><E8AC96><EFBFBD> | 謾ｹ騾<EFBDB9>蜑<EFBFBD> | 謾ｹ騾<EFBDB9>蜷<EFBFBD> | 陦｡驥乗婿豕<E5A9BF> |
|------|--------|--------|---------|
| **LLM API謌先悽** | ﾂ･X/譛?| 髯堺ｽ<E5A0BA>40-60% | 蟇ｹ豈碑ｴｦ蜊<EFBDA6> |
| **莉ｻ蜉｡荳｢螟ｱ邇?* | <20>閥 70-95% | < 1% | <20>閥 **譛€驥崎ｦ<E5B48E>** |
| **莉ｻ蜉｡螳梧<E89EB3>譌ｶ髣ｴ** | 荳咲｡ｮ螳?| 遞ｳ螳<EFBDB3> | 逶第而譌･蠢<EFBDA5> |
| **逕ｨ謌ｷ驥榊､肴署莠､谺｡謨ｰ** | 蟷ｳ蝮<EFBDB3>3谺?| 蜃<>荵惹ｸ? | 逕ｨ謌ｷ陦御ｸｺ蛻<EFBDBA>梵 |
| **逕ｨ謌ｷ貊｡諢丞ｺ?* | 蝓ｺ郤ｿ | 譏ｾ闡玲署蜊<E7BDB2> | 髣ｮ蜊ｷ隹<EFBDB7>衍 |

### 10.3 鬪梧噺譬<E599BA>㊥<EFBFBD><E38AA5>2.0譖ｴ譁ｰ<EFBFBD>?
#### **Redis郛灘ｭ倬ｪ梧噺**
```bash
笨?謇€譛臥ｼ灘ｭ伜黒蜈<E9BB92>ｵ玖ｯ暮€夊ｿ<E5A48A>
笨?HealthCheckService郛灘ｭ伜多荳ｭ豬玖ｯ暮€夊ｿ<E5A48A>
笨?LLM12FieldsService郛灘ｭ伜多荳ｭ豬玖ｯ暮€夊ｿ<E5A48A>
笨?螳樔ｾ矩㍾蜷ｯ蜷守ｼ灘ｭ倅ｻ榊ｭ伜惠
笨?郛灘ｭ伜多荳ｭ邇?> 60%
笨?LLM API隹<49>畑谺｡謨ｰ荳矩剄 > 40%
```

#### **Redis髦溷<E9ABA6>鬪梧噺** <20>閥 **譁ｰ蠅槫<E8A085>髞ｮ鬘?*
```bash
笨?Redis髦溷<E9ABA6>蜊募<E89C8A>豬玖ｯ暮€夊ｿ<E5A48A>
笨?髟ｿ莉ｻ蜉｡<E89C89><EFBDA1>2蟆乗慮<E4B997>画ｵ玖ｯ暮€夊ｿ<E5A48A>
笨?螳樔ｾ矩㍾蜷ｯ蜷惹ｻｻ蜉｡閾ｪ蜉ｨ諱｢螟?笨?莉ｻ蜉｡螟ｱ雍･閾ｪ蜉ｨ驥崎ｯ包ｼ?谺｡<E8B0BA><EFBDA1>
笨?1000遽<30>枚迪ｮ遲幃€画<C280>蜉溽紫 > 99%
笨?譌<>逕ｨ謌ｷ謚戊ｯ我ｻｻ蜉｡荳｢螟?笨?霑帛ｺｦ螳樊慮譖ｴ譁ｰ豁｣蟶ｸ
```

#### **謨<>囿諱｢螟肴ｵ玖ｯ<E78E96>** <20>閥 **驥崎ｦ<E5B48E>**
```bash
笨?讓｡諡溷ｮ樔ｾ矩楳豈?竊?莉ｻ蜉｡閾ｪ蜉ｨ諱｢螟<EFBDA2>
笨?讓｡諡欒edis螳墓惻 竊?邉ｻ扈滄剄郤ｧ霑占｡<E58DA0>
笨?讓｡諡溽ｽ醍ｻ懷ｻｶ霑<EFBDB6> 竊?莉ｻ蜉｡豁｣蟶ｸ螳梧<E89EB3>
笨?讓｡諡溷ｹｶ蜿台ｻｻ蜉｡ 竊?豁｣遑ｮ蛻<EFBDAE><E89BBB>螟<EFBFBD>炊
```

#### **逕滉ｺｧ邇ｯ蠅<EFBDAF>ｪ梧噺**
```bash
笨?逕滉ｺｧ邇ｯ蠅<EFBDAF>ｿ占｡<E58DA0>48蟆乗慮譌<E685AE>髞呵ｯ?笨?2荳ｪ螳梧紛逧<E7B49B>1000遽<30>枚迪ｮ遲幃€我ｻｻ蜉｡謌仙<E8AC8C>?笨?逶第而謖<E8808C><E8AC96><EFBFBD>ｭ｣蟶ｸ<E89FB6>亥<EFBFBD>蟄倥€∬ｿ樊磁謨ｰ縲＿PS<50>?笨?譌<>逕ｨ謌ｷ謚戊ｯ?```

---

## 11. FAQ

### Q1<51>壼ｦよ棡Redis蝨ｨ蜊雁､懃ｪ∫┯謖ゆｺ<E38286>€惹ｹ亥萱<E4BAA5><E890B1>
**A1**<2A>夂ｳｻ扈滉ｼ夊<EFBDBC>蜉ｨ髯咲ｺｧ蛻ｰ蜀<EFBDB0>ｭ倡ｼ灘ｭ假ｼ悟ｺ皮畑扈ｧ扈ｭ霑占｡後€らｬｬ莠悟､ｩ霑千ｻｴ譽€譟･蟷ｶ諱｢螟抗edis縲?
### Q2<51>?56MB螟溽畑蜷暦ｼ滉ｻ€荵域慮蛟咎怙隕∝合驟搾ｼ<E690BE>
**A2**<2A>?- 蠖灘燕鬚<E78795>ｼｰ<EFBDBC>? 50% 菴ｿ逕ｨ邇?- 隗ｦ蜿大合驟堺ｿ｡蜿ｷ<E89CBF>?  - 蜀<>ｭ倅ｽｿ逕ｨ > 80%
  - 鬚醍ｹ∬ｧｦ蜿銑RU鬩ｱ騾?  - 逶第而蜻願ｭｦ
- 蜊<><E89C8A>譁ｹ蠑擾ｼ夐仭驥御ｺ第而蛻ｶ蜿ｰ荳€髞ｮ蜊<EFBDAE>ｺｧ<EFBDBA>梧裏髴€驥榊星

### Q3<51>啌edis莨壼ｽｱ蜩咲ｳｻ扈滓€ｧ閭ｽ蜷暦ｼ<E69AA6>
**A3**<2A>?- 譛ｬ蝨ｰ蜀<EFBDB0>ｭ假ｼ? 0.1ms
- 譛ｬ蝨ｰRedis<69>嘸1ms
- 髦ｿ驥御ｺ然edis<69>亥酔蝨ｰ蝓滂ｼ会ｼ嘸2-5ms
- 蠖ｱ蜩榊庄蠢ｽ逡･<E980A1>御ｸ疲怏謇ｹ驥乗桃菴應ｼ伜喧

### Q4<51>壼ｦよ棡蜿醍鴫Redis荳埼€ょ粋<E38287>瑚<EFBFBD>蝗樣€€蛻ｰ蜀<EFBDB0>ｭ倡ｼ灘ｭ伜雛<E4BC9C>?**A4**<2A>壼庄莉･<E88E89>∽ｿｮ謾ｹ `CACHE_TYPE=memory` 蜊ｳ蜿ｯ<E89CBF>御ｻ｣遐∵髪謖∫Ο蛻<CE9F>困縲?
### Q5<51>夐怙隕∝ｭｦ荵<EFBDA6>Redis蜻ｽ莉､蜷暦ｼ<E69AA6>
**A5**<2A>?- 蠑€蜿托ｼ壻ｸ埼怙隕<E68099>ｼ御ｻ｣遐∝ｷｲ蟆∬｣?- 霑千ｻｴ<EFBDBB>壼ｻｺ隶ｮ蟄ｦ荵?荳ｪ蝓ｺ遑€蜻ｽ莉､<E88E89><EFBDA4>ET/SET/KEYS/TTL/INFO<46>?
---

## 12. 逶ｸ蜈ｳ譁<EFBDB3>｡｣

- [莠大次逕溷ｼ€蜿題ｧ<E9A18C>激](../04-蠑€蜿題ｧ<E9A18C><EFBDA7>?08-莠大次逕溷ｼ€蜿題ｧ<E9A18C><EFBDA7>?md)
- [SAE驛ｨ鄂ｲ螳悟<E89EB3>謖<EFBFBD>漉](./02-SAE驛ｨ鄂ｲ螳悟<E89EB3>謖<EFBFBD>漉(莠ｧ蜩∫ｻ冗炊迚?.md)
- [SAE邇ｯ蠅<EFBDAF>序驥城<E9A9A5>鄂ｮ謖<EFBDAE>漉](./03-SAE邇ｯ蠅<EFBDAF>序驥城<E9A9A5>鄂ｮ謖<EFBDAE>漉.md)
- [Redis螳俶婿譁<E5A9BF>｡｣](https://redis.io/docs/)
- [ioredis譁<73>｡｣](https://github.com/redis/ioredis)
- [髦ｿ驥御ｺ然edis譁<73>｡｣](https://help.aliyun.com/product/26340.html)

---

## 13. 髯<>ｽ<EFBFBD>

### 髯<>ｽ柊<EFBDBD>壼ｮ梧紛逧<E7B49B>.env驟咲ｽｮ讓｡譚ｿ

```env
# ==================== 謨ｰ謐ｮ蠎?====================
DATABASE_URL=postgresql://postgres:password@localhost:5432/ai_clinical_research

# ==================== Redis驟咲ｽｮ ====================
CACHE_TYPE=redis
REDIS_HOST=localhost
REDIS_PORT=6379
REDIS_PASSWORD=
REDIS_DB=0
# 謌紋ｽｿ逕ｨ霑樊磁蟄礼ｬｦ荳ｲ
# REDIS_URL=redis://localhost:6379

# ==================== 髦溷<E9ABA6>驟咲ｽｮ ====================
QUEUE_TYPE=memory  # 隨ｬ荳€髦ｶ谿ｵ逕ｨmemory<72>檎ｬｬ莠碁亳谿ｵ謾ｹ荳ｺredis

# ==================== JWT ====================
JWT_SECRET=your-secret-key-change-in-production
JWT_EXPIRES_IN=7d

# ==================== LLM API ====================
DEEPSEEK_API_KEY=sk-xxxxxxxxxxxxxx
DASHSCOPE_API_KEY=sk-xxxxxxxxxxxxxx
CLOSEAI_API_KEY=sk-xxxxxxxxxxxxxx
CLOSEAI_OPENAI_BASE_URL=https://api.openai-proxy.org/v1
CLOSEAI_CLAUDE_BASE_URL=https://api.openai-proxy.org/anthropic

# ==================== Dify ====================
DIFY_API_URL=http://localhost/v1
DIFY_API_KEY=dataset-xxxxxxxxxxxxxx

# ==================== Server ====================
PORT=3001
NODE_ENV=development

# ==================== 蟄伜お驟咲ｽｮ ====================
STORAGE_TYPE=local
LOCAL_STORAGE_DIR=uploads
LOCAL_STORAGE_URL=http://localhost:3001/uploads

# ==================== CORS驟咲ｽｮ ====================
CORS_ORIGIN=http://localhost:5173

# ==================== 譌･蠢鈴<E8A0A2>鄂ｮ ====================
LOG_LEVEL=debug
```

### 髯<>ｽ稗<EFBDBD>啌edis蜀<73>ｭ倩ｮ｡邂怜<E98282>?
```
蜊穂ｸｪLLM扈捺棡郛灘ｭ假ｼ嘸50KB
蜊穂ｸｪ蛛･蠎ｷ譽€譟･郛灘ｭ假ｼ嘸5KB

鬚<EFBFBD>ｼｰ螳ｹ驥擾ｼ?- 1000荳ｪLLM扈捺棡 = 50MB
- 1000荳ｪ蛛･蠎ｷ譽€譟?= 5MB
- 邉ｻ扈溷ｼ€髞€ = 20MB
-----------------------------
諤ｻ隶｡ = 75MB / 256MB = 29% 菴ｿ逕ｨ邇?```

### 髯<>ｽ匹<EFBDBD>壽腐髫懈ｼ皮ｻ<E79AAE><EFBDBB>譛?
```bash
#!/bin/bash
# 譁<>ｻｶ<EFBDBB>喘ackend/scripts/disaster-recovery-drill.sh

echo "<22>圷 Redis謨<73>囿貍皮ｻ<E79AAE>ｼ€蟋?.."

# 1. 蛛懈ｭ｢Redis
echo "1. 蛛懈ｭ｢Redis..."
docker stop ai-clinical-redis
sleep 2

# 2. 豬玖ｯ募ｺ皮畑譏ｯ蜷ｦ豁｣蟶ｸ
echo "2. 豬玖ｯ募ｺ皮畑蛛･蠎ｷ譽€譟?.."
response=$(curl -s http://localhost:3001/api/health)
echo "蜩榊ｺ<E6A68A>: $response"

if [[ $response == *"memory"* ]]; then
  echo "笨?髯咲ｺｧ謌仙粥<E4BB99>御ｽｿ逕ｨ蜀<EFBDA8>ｭ倡ｼ灘ｭ?
else
  echo "笶?髯咲ｺｧ螟ｱ雍･"
  exit 1
fi

# 3. 諱｢螟抗edis
echo "3. 諱｢螟抗edis..."
docker start ai-clinical-redis
sleep 5

# 4. 豬玖ｯ紐edis諱｢螟<EFBDA2>
echo "4. 豬玖ｯ紐edis諱｢螟<EFBDA2>..."
response=$(curl -s http://localhost:3001/api/health)
echo "蜩榊ｺ<E6A68A>: $response"

if [[ $response == *"redis"* ]]; then
  echo "笨?Redis諱｢螟肴<E89E9F>蜉<EFBFBD>"
else
  echo "笞<><E7AC9E><EFBFBD> Redis譛ｪ諱｢螟搾ｼ御ｻ堺ｽｿ逕ｨ蜀<EFBDA8>ｭ倡ｼ灘ｭ?
fi

echo "<22>脂 謨<>囿貍皮ｻ<E79AAE>ｮ梧<EFBDAE><E6A2A7>?
```

---

**譁<>｡｣扈ｴ謚､閠<EFBDA4>ｼ<EFBFBD>** 謚€譛ｯ蝗｢髦? 
**譛€蜷取峩譁ｰ<E8AD81><EFBDB0>** 2025-12-12  
**譁<>｡｣迥ｶ諤<EFBDB6>ｼ<EFBFBD>** 笨?蠕<>ｮ｡譬? 
**荳区ｬ｡譖ｴ譁ｰ<E8AD81>?* 謾ｹ騾<EFBDB9>螳梧<E89EB3>蜷取€ｻ扈鍋ｻ城ｪ梧蕗隶ｭ

---

## 笨?謾ｹ騾<EFBDB9>螳梧<E89EB3>譽€譟･貂<EFBDA5><E8B282>?
蝨ｨ螳梧<EFBFBD>Redis謾ｹ騾<EFBFBD>蜷趣ｼ瑚ｯｷ騾宣｡ｹ譽€譟･<EFBFBD><EFBFBD>

### 莉｣遐∝ｱる擇
- [ ] `ioredis` 蟾ｲ螳芽｣?- [ ] `RedisCacheAdapter` 蟾ｲ螳樒<E89EB3>?- [ ] `CacheFactory` 蟾ｲ豺ｻ蜉<EFBDBB>髯咲ｺｧ騾ｻ霎<EFBDBB>
- [ ] `.env` 驟咲ｽｮ蟾ｲ譖ｴ譁?- [ ] 謇€譛我ｽｿ逕?`cache.set()` 逧<>慍譁ｹ驛ｽ隶ｾ鄂ｮ莠<EFBDAE>TL

### 豬玖ｯ募ｱる擇
- [ ] 蜊募<E89C8A>豬玖ｯ募<EFBDAF>驛ｨ騾夊ｿ<E5A48A>
- [ ] 髮<><E9ABAE>豬玖ｯ募<EFBDAF>驛ｨ騾夊ｿ<E5A48A>
- [ ] 蜴句鴨豬玖ｯ戊ｾｾ譬<EFBDBE>
- [ ] 謨<>囿讓｡諡滓ｵ玖ｯ暮€夊ｿ<E5A48A>

### 驛ｨ鄂ｲ螻る擇
- [ ] 髦ｿ驥御ｺ然edis蟾ｲ雍ｭ荵?- [ ] 逋ｽ蜷榊黒蟾ｲ驟咲ｽｮ
- [ ] SAE邇ｯ蠅<EFBDAF>序驥丞ｷｲ驟咲ｽ?- [ ] 逕滉ｺｧ邇ｯ蠅<EFBDAF>ｷｲ鬪瑚ｯ?
### 譁<>｡｣螻る擇
- [ ] 謾ｹ騾<EFBDB9>譁<EFBFBD>｡｣蟾ｲ譖ｴ譁ｰ
- [ ] 霑千ｻｴ譁<EFBDB4>｡｣蟾ｲ陦･蜈?- [ ] 逶第而謖<E8808C><E8AC96><EFBFBD>ｷｲ隶ｰ蠖?- [ ] 扈城ｪ梧蕗隶ｭ蟾ｲ諤ｻ扈<EFBDBB>

---

**逾晄隼騾<E99ABC>鬘ｺ蛻ｩ<E89BBB>∝ｦよ怏髣ｮ鬚假ｼ瑚ｯｷ蜿頑慮豐滄€壹€?* <20>噫