Files

HaHafeng 1b53ab9d52 feat(aia): Complete AIA V2.0 with universal streaming capabilities

Major Changes:
- Add StreamingService with OpenAI Compatible format
- Upgrade Chat component V2 with Ant Design X integration
- Implement AIA module with 12 intelligent agents
- Update API routes to unified /api/v1 prefix
- Update system documentation

Backend (~1300 lines):
- common/streaming: OpenAI Compatible adapter
- modules/aia: 12 agents, conversation service, streaming integration
- Update route versions (RVW, PKB to v1)

Frontend (~3500 lines):
- modules/aia: AgentHub + ChatWorkspace (100% prototype restoration)
- shared/Chat: AIStreamChat, ThinkingBlock, useAIStream Hook
- Update API endpoints to v1

Documentation:
- AIA module status guide
- Universal capabilities catalog
- System overview updates
- All module documentation sync

Tested: Stream response verified, authentication working
Status: AIA V2.0 core completed (85%)

2026-01-14 19:15:01 +08:00

51 KiB

Raw Blame History

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

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

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

扈剰ｿ<EFBFBD>ｷｱ蜈･蛻<EFBFBD>梵<EFBFBD>軍edis髦溷<EFBFBD>荳肴弍蜿ｯ騾蛾｡ｹ<EFBFBD>瑚梧弍譬ｸ蠢<EFBFBD>粥閭ｽ逧<EFBFBD>ｿ<EFBFBD>｡ｻ鬘ｹ<EFBFBD>?

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

<EFBFBD>搭逶ｮ蠖<EFBDAE>

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

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

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

蠖灘燕髣ｮ鬚<EFBFBD><EFBFBD>?1. 笶?**霑晏渚莠大次逕溯ｧ<E6BAAF><EFBDA7>?*<2A>夂ｳｻ扈滉ｽｿ逕ｨ蜀<EFBDA8>ｭ倡ｼ灘ｭ假ｼ瑚ｿ晏渚閾ｪ蟾ｱ蛻ｶ螳夂噪莠大次逕溷ｼ蜿題ｧ<E9A18C><EFBDA7>?2. 笶?LLM謌先悽螟ｱ謗ｧ<EFBFBD>夂ｼ灘ｭ倅ｸ肴戟荵<EFBFBD>喧<EFBFBD>悟ｯｼ閾ｴ驥榊､崎ｰ<EFBFBD>畑DeepSeek/Qwen API

笶?髟ｿ莉ｻ蜉｡荳榊庄髱<EFBFBD><EFBFBD>?0-60蛻<30>帖逧<E5B896>枚迪ｮ遲幃我ｻｻ蜉｡<E89C89>郡AE螳樔ｾ矩㍾蜷ｯ蜷惹ｸ｢螟?4. 笶?螟壼ｮ樔ｾ倶ｸ榊酔豁･<EFBFBD>售AE謇ｩ螳ｹ蜷趣ｼ悟推螳樔ｾ狗ｼ灘ｭ倅ｸ榊<EFBFBD>莠ｫ
笶?Serverless荳埼る<EFBFBD><EFBFBD>壼<EFBFBD>蟄倡憾諤∝惠Serverless邇ｯ蠅<EFBFBD>ｸ倶ｸ榊庄髱<EFBFBD>

**謾ｹ騾<EFBDB9>逶ｮ譬?*<2A>?- 笨?隨ｦ蜷域楔譫<EFBFBD>ｧ<EFBFBD>激<EFBFBD>壻ｽｿ逕ｨ蛻<EFBFBD>ｸ<EFBFBD>ｼ冗ｼ灘ｭ假ｼ<EFBFBD>edis<EFBFBD>?- 笨?髯堺ｽ拶PI謌先悽<EFBFBD>哭LM扈捺棡郛灘ｭ俶戟荵<EFBFBD>喧<EFBFBD>碁∩蜈埼㍾螟崎ｰ<EFBFBD>畑

笨?**莉ｻ蜉｡謖∽ｹ<E288BD><EFBDB9>?<EFBFBD>夐柄譌ｶ髣ｴ莉ｻ蜉｡荳榊屏螳樔ｾ矩㍾蜷ｯ閠御ｸ｢螟?- 笨?**謾ｯ謖∝､壼ｮ樔ｾ?<EFBFBD>夂ｼ灘ｭ伜惠螟壼ｮ樔ｾ矩龍蜈ｱ莠ｫ
笨?蟷ｳ貊題ｿ<EFBFBD>ｸ｡<EFBFBD>壻ｿ晉蕗髯咲ｺｧ譁ｹ譯茨ｼ檎｡ｮ菫晉ｳｻ扈溽ｨｳ螳<EFBFBD>

2. 蠖灘燕邉ｻ扈溽憾諤∝<E8ABA4>譫?

2.1 蟾ｲ菴ｿ逕ｨ郛灘ｭ倡噪菴咲ｽｮ

菴咲ｽｮ1<EFBFBD>唏ealthCheckService.ts

// 譁<>ｻｶ<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蟆乗慮

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

菴咲ｽｮ2<EFBFBD>哭LM12FieldsService.ts

// 譁<>ｻｶ<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蟆乗慮

**逕ｨ騾?<EFBFBD>哭LM 12蟄玲ｮｵ謠仙叙扈捺棡郛灘ｭ<E78198>
**驥崎ｦ∵?<EFBFBD>夸沐?鬮假ｼ育峩謗･蠖ｱ蜩喉PI謌先悽<E58588>? **謨ｰ謐ｮ驥?*<2A>嘸50KB/鬘? 謌先悽蠖ｱ蜩<EFBFBD><EFBFBD>?``` 蜊墓ｬ｡謠仙叙謌先悽<E58588>嘸ﾂ･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);

髣ｮ鬚<EFBFBD><EFBFBD>?- 199遽<39>枚迪ｮ髴隕?33-66蛻<36>帖

蠖灘燕菴ｿ逕ｨ蜀<EFBFBD>ｭ倬弌蛻暦ｼ<EFBFBD>emoryQueue<EFBFBD>?- SAE螳樔ｾ矩㍾蜷ｯ/郛ｩ螳ｹ譌ｶ莉ｻ蜉｡荳｢螟? 蠖ｱ蜩<EFBFBD><EFBFBD>?- 逕ｨ謌ｷ菴馴ｪ梧栫蟾ｮ<E89FBE>井ｻｻ蜉｡遯∫┯豸亥､ｱ<EFBDA4><EFBDB1>
蟾ｲ螟<EFBFBD>炊扈捺棡荳｢螟ｱ<EFBFBD>梧ｵｪ雍ｹAPI雍ｹ逕ｨ
譌<EFBFBD>豕戊ｿｽ貅ｯ莉ｻ蜉｡迥ｶ諤?

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

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

3. Redis驟咲ｽｮ菫｡諱ｯ

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

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

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>郁ｴｭ荵ｰ蜷手執蜿厄ｼ?

# 髦ｿ驥御ｺ第而蛻ｶ蜿ｰ 竊?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>ｾ晁ｵ?*

cd backend
npm install ioredis --save
npm install @types/ioredis --save-dev

豁･鬪､1.2<EFBFBD>夐<EFBFBD>鄂ｮ譛ｬ蝨ｰRedis

# 遑ｮ隶､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

# 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

// 譁<>ｻｶ<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霑樊磁驥崎ｯ<E5B48E> ${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>

// 譁<>ｻｶ<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霑樊磁螟ｱ雍･<EFBFBD>悟ｷｲ髯咲ｺｧ蛻ｰ蜀<EFBFBD>ｭ倡ｼ灘ｭ?);
          this.fallbackToMemory = true;
        }
      }).catch((error) => {
        logger.error('[CacheFactory] 笶?Redis霑樊磁蠑ょｸｸ<EFBDB8>悟ｷｲ髯咲ｺｧ蛻ｰ蜀<EFBDB0>ｭ倡ｼ灘ｭ?, { error });
        this.fallbackToMemory = true;
      });

      return redisCache;
    } catch (error) {
      logger.error('[CacheFactory] 笶?Redis蛻晏ｧ句喧螟ｱ雍･<EFBFBD>碁剄郤ｧ蛻ｰ蜀<EFBFBD>ｭ倡ｼ灘ｭ?, { 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驟咲ｽｮ

// 譁<>ｻｶ<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>譛ｬ

// 譁<>ｻｶ<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>壽鴬陦梧ｵ玖ｯ?*

cd backend

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

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

鬚<EFBFBD>悄霎灘<EFBFBD><EFBFBD>?``` <0A>ｧｪ蠑蟋区ｵ玖ｯ紐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>壽ｵ玖ｯ穂ｸ壼苅莉｣遐?*

# 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>

# 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> 竊?逋ｽ蜷榊黒隶ｾ鄂? 豺ｻ蜉<EFBDBB><E89C89>?1. 譛ｬ蝨ｰ蠑蜿選P<E981B8>育畑莠取悽蝨ｰ豬玖ｯ包ｼ<E58C85>

菴<EFBFBD>逧<EFBFBD><EFBFBD>鄂選P/32

SAE蠎皮畑IP<EFBFBD>育函莠ｧ邇ｯ蠅<EFBFBD>ｼ<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

遶ｯ蜿｣<EFBFBD>?379
螳樔ｾ紀D<EFBFBD>嗷-xxxxxxxxxxxx
蟇<EFBFBD><EFBFBD><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

// 譁<>ｻｶ<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] 蠑蟋句､<EFBFBD>炊莉ｻ蜉｡`, { 
            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] 莉ｻ蜉｡螟<EFBFBD>炊謌仙粥`, { 
              type, 
              jobId: job.id,
              duration: `${duration}ms`
            });
            
            return result;
          } catch (error) {
            const duration = Date.now() - startTime;
            logger.error(`[RedisQueue] 莉ｻ蜉｡螟<EFBFBD>炊螟ｱ雍･`, { 
              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] 笨?莉ｻ蜉｡螳梧<EFBFBD>`, { 
          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] 莉ｻ蜉｡荳榊ｭ伜惠<EFBFBD>梧裏豕募叙豸<EFBFBD>, { 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] 莉ｻ蜉｡荳榊ｭ伜惠<EFBFBD>梧裏豕暮㍾隸描, { 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>

// 譁<>ｻｶ<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髦溷<EFBFBD>...');
      
      const redisQueue = new RedisQueue();
      
      logger.info('[JobFactory] 笨?Redis髦溷<EFBFBD>蛻晏ｧ句喧謌仙<EFBFBD>?);
      return redisQueue;
      
    } catch (error) {
      logger.error('[JobFactory] 笶?Redis髦溷<E9ABA6>蛻晏ｧ句喧螟ｱ雍･<E99B8D>碁剄郤ｧ蛻ｰ蜀<EFBDB0>ｭ倬弌蛻?, { error });
      return this.createMemoryQueue();
    }
  }

  private static createMemoryQueue(): MemoryQueue {
    logger.info('[JobFactory] 菴ｿ逕ｨ蜀<EFBFBD>ｭ倬弌蛻<EFBFBD>')
    
    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>?*

// 遉ｺ萓具ｼ哂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('蠑蟋句､<EFBFBD>炊遲幃我ｻｻ蜉?, { 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驟咲ｽｮ

# 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>

# 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>

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

6. 鬟朱勦隸<E58BA6>ｼｰ荳守ｼ楢ｧ?

6.1 鬟朱勦遏ｩ髦ｵ

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

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

**郛楢ｧ｣謗ｪ譁ｽ1<EFBFBD>夐剄郤ｧ遲也払<EFBFBD>亥ｿ<EFBFBD>｡ｻ<EFBFBD>?* 笨?```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<EFBFBD>壼<EFBFBD>蟄倡尅謗ｧ<EFBFBD>域耳闕撰ｼ?* 竢?```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荳雁壕	譛ｬ蝨ｰ蠑蜿醍識蠅<EFBFBD>㊥螟?	蠑蜿?	筮?蠕<>ｼ蟋?
Phase 2	Day 1荳句壕	螳樒鴫RedisCacheAdapter	蠑蜿?	筮?蠕<>ｼ蟋?
Phase 3	Day 2蜈ｨ螟ｩ	Redis郛灘ｭ俶悽蝨ｰ豬玖ｯ<EFBFBD>	蠑蜿?豬玖ｯ<E78E96>	筮?蠕<>ｼ蟋?
Phase 4	Day 3荳雁壕	髦ｿ驥御ｺ然edis雍ｭ荵ｰ&驟咲ｽｮ	霑千ｻｴ	筮?蠕<>ｼ蟋?
Phase 5	Day 3荳句壕-Day 5	<EFBFBD>閥螳樒鴫RedisQueue<75>亥ｿ<E4BAA5>｡ｻ<EFBDA1>榎蠑蜿?	筮?蠕<>ｼ蟋?
Phase 6	Day 6蜈ｨ螟ｩ	Redis髦溷<EFBFBD>譛ｬ蝨ｰ豬玖ｯ<EFBFBD> + 荳壼苅髮<E88B85><E9ABAE>	蠑蜿?豬玖ｯ<E78E96>	筮?蠕<>ｼ蟋?
Phase 7	Day 7荳雁壕	SAE豬玖ｯ慕識蠅<EFBFBD>ｪ瑚ｯ<EFBFBD>	蠑蜿?豬玖ｯ<E78E96>	筮?蠕<>ｼ蟋?
Phase 8	Day 7荳句壕	逕滉ｺｧ邇ｯ蠅<EFBFBD>ｸ顔ｺｿ	蜈ｨ蜻<EFBFBD>	筮?蠕<>ｼ蟋?
Phase 9	Day 7譎?	逶第而隗ょｯ滂ｼ?4蟆乗慮<E4B997>?	霑千ｻｴ	筮?蠕<>ｼ蟋?

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

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

**Step 1<>壼書蟶<E69BB8>燕譽譟･<E8AD9F><EFBDA5>15蛻<35>帖<EFBFBD>?*

笨?莉｣遐∝ｷｲ謠蝉ｺ､Git
笨?譛ｬ蝨ｰ豬玖ｯ募<EFBDAF>驛ｨ騾夊ｿ<E5A48A>
笨?髦ｿ驥御ｺ然edis蟾ｲ蟆ｱ扈?笨?SAE邇ｯ蠅<EFBDAF>序驥丞ｷｲ驟咲ｽ?笨?蝗樊ｻ壽婿譯亥ｷｲ蜃<EFBDB2>､?笨?逶第而蟾ｲ蟆ｱ扈?```

#### **Step 2<>夂<EFBFBD>蠎ｦ蜿大ｸ<E5A4A7>ｼ<EFBFBD>30蛻<30>帖<EFBFBD>?*

SAE謗ｧ蛻ｶ蜿?竊?騾画叫蠎皮畑
蠎皮畑驛ｨ鄂ｲ竊?蛻<>音蜿大ｸ<E5A4A7>
隨?謇ｹ<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<EFBFBD>啌edis霑樊磁螟ｱ雍･<EFBFBD>悟ｺ皮畑譌<EFBFBD>豕募星蜉?*

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

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

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

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

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

蝨ｺ譎ｯ3<EFBFBD>啌edis蜀<EFBFBD>ｭ俶ｻ｡<EFBFBD>梧裏豕募<EFBFBD>蜈･

# 譁ｹ豕<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>?

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

9. 逶第而荳手ｿ千ｻ?

9.1 逶第而謖<E8808C><E8AC96><EFBFBD>

Redis謖<EFBFBD><EFBFBD><EFBFBD>ｼ磯仭驥御ｺ第而蛻ｶ蜿ｰ<EFBFBD><EFBFBD>

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

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

# 譟･謇ｾ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蜻ｽ莉､

# 霑樊磁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

蜀<EFBFBD>ｭ伜<EFBFBD>譫<EFBFBD>

# 譟･謇ｾ螟ｧ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髦溷<EFBFBD>鬪梧噺 <20>閥 **譁ｰ蠅槫<EFBFBD>髞ｮ鬘?*

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

謨<EFBFBD>囿諱｢螟肴ｵ玖ｯ<EFBFBD> <20>閥驥崎ｦ<EFBFBD>

笨?讓｡諡溷ｮ樔ｾ矩楳豈?竊?莉ｻ蜉｡閾ｪ蜉ｨ諱｢螟<EFBDA2>
笨?讓｡諡欒edis螳墓惻 竊?邉ｻ扈滄剄郤ｧ霑占｡<E58DA0>
笨?讓｡諡溽ｽ醍ｻ懷ｻｶ霑<EFBDB6> 竊?莉ｻ蜉｡豁｣蟶ｸ螳梧<E89EB3>
笨?讓｡諡溷ｹｶ蜿台ｻｻ蜉｡ 竊?豁｣遑ｮ蛻<EFBDAE><E89BBB>螟<EFBFBD>炊

逕滉ｺｧ邇ｯ蠅<EFBFBD>ｪ梧噺

笨?逕滉ｺｧ邇ｯ蠅<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>｡｣

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

髯<EFBFBD>ｽ稗<EFBFBD>啌edis蜀<EFBFBD>ｭ倩ｮ｡邂怜<EFBFBD>?

蜊穂ｸｪLLM扈捺棡郛灘ｭ假ｼ嘸50KB
蜊穂ｸｪ蛛･蠎ｷ譽譟･郛灘ｭ假ｼ嘸5KB

鬚<>ｼｰ螳ｹ驥擾ｼ?- 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>?

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

笨?謾ｹ騾<EFBDB9>螳梧<E89EB3>譽譟･貂<EFBDA5><E8B282>?

蝨ｨ螳梧<EFBFBD>Redis謾ｹ騾<EFBFBD>蜷趣ｼ瑚ｯｷ騾宣｡ｹ譽譟･<EFBFBD><EFBFBD>

莉｣遐∝ｱる擇

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

豬玖ｯ募ｱる擇

蜊募<EFBFBD>豬玖ｯ募<EFBFBD>驛ｨ騾夊ｿ<EFBFBD>
髮<EFBFBD><EFBFBD>豬玖ｯ募<EFBFBD>驛ｨ騾夊ｿ<EFBFBD>
蜴句鴨豬玖ｯ戊ｾｾ譬<EFBFBD>
謨<EFBFBD>囿讓｡諡滓ｵ玖ｯ暮夊ｿ<EFBFBD>

驛ｨ鄂ｲ螻る擇

髦ｿ驥御ｺ然edis蟾ｲ雍ｭ荵?- [ ] 逋ｽ蜷榊黒蟾ｲ驟咲ｽｮ
SAE邇ｯ蠅<EFBFBD>序驥丞ｷｲ驟咲ｽ?- [ ] 逕滉ｺｧ邇ｯ蠅<EFBDAF>ｷｲ鬪瑚ｯ?

譁<EFBFBD>｡｣螻る擇

謾ｹ騾<EFBFBD>譁<EFBFBD>｡｣蟾ｲ譖ｴ譁ｰ
霑千ｻｴ譁<EFBFBD>｡｣蟾ｲ陦･蜈?- [ ] 逶第而謖<E8808C><E8AC96><EFBFBD>ｷｲ隶ｰ蠖?- [ ] 扈城ｪ梧蕗隶ｭ蟾ｲ諤ｻ扈<EFBDBB>

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

51 KiB Raw Blame History Unescape Escape