Explorar o código

📝 docs(story): 为Redis缓存任务添加文件路径引用

- 为SystemConfigServiceMt相关任务添加文件路径引用
- 为RedisUtil相关任务添加文件路径引用
- 为集成测试相关任务添加文件路径引用
- 添加关键参考文件路径章节
- 更新版本历史记录,记录文件路径标注变更
yourname hai 1 mes
pai
achega
1385392905
Modificáronse 1 ficheiros con 28 adicións e 19 borrados
  1. 28 19
      docs/stories/010.002.system-config-redis-cache.story.md

+ 28 - 19
docs/stories/010.002.system-config-redis-cache.story.md

@@ -18,30 +18,30 @@ Draft
 
 ## Tasks / Subtasks
 - [ ] 扩展系统配置服务添加Redis缓存方法 (AC: 1, 2)
-  - [ ] 在SystemConfigServiceMt中添加RedisUtil依赖
-  - [ ] 实现带缓存的getConfigByKey方法
-  - [ ] 实现带缓存的getConfigsByKeys方法
-  - [ ] 实现缓存清除方法
+  - [ ] 在SystemConfigServiceMt中添加RedisUtil依赖 [packages/core-module-mt/system-config-module-mt/src/services/system-config.service.mt.ts](packages/core-module-mt/system-config-module-mt/src/services/system-config.service.mt.ts)
+  - [ ] 实现带缓存的getConfigByKey方法 [packages/core-module-mt/system-config-module-mt/src/services/system-config.service.mt.ts:23-31](packages/core-module-mt/system-config-module-mt/src/services/system-config.service.mt.ts#L23-L31)
+  - [ ] 实现带缓存的getConfigsByKeys方法 [packages/core-module-mt/system-config-module-mt/src/services/system-config.service.mt.ts:44-58](packages/core-module-mt/system-config-module-mt/src/services/system-config.service.mt.ts#L44-L58)
+  - [ ] 实现缓存清除方法 [packages/shared-utils/src/utils/redis.util.ts](packages/shared-utils/src/utils/redis.util.ts)
 - [ ] 实现缓存策略和TTL配置 (AC: 3)
-  - [ ] 配置默认TTL为1小时
-  - [ ] 实现可配置的TTL参数
-  - [ ] 添加缓存键格式化工具方法
+  - [ ] 配置默认TTL为1小时 [packages/shared-utils/src/utils/redis.util.ts:38-44](packages/shared-utils/src/utils/redis.util.ts#L38-L44)
+  - [ ] 实现可配置的TTL参数 [packages/shared-utils/src/utils/redis.util.ts](packages/shared-utils/src/utils/redis.util.ts)
+  - [ ] 添加缓存键格式化工具方法 [packages/shared-utils/src/utils/redis.util.ts:40](packages/shared-utils/src/utils/redis.util.ts#L40)
 - [ ] 实现缓存失效机制 (AC: 4)
-  - [ ] 在setConfig方法中添加缓存清除逻辑
-  - [ ] 在deleteConfig方法中添加缓存清除逻辑
-  - [ ] 在update方法中添加缓存清除逻辑
+  - [ ] 在setConfig方法中添加缓存清除逻辑 [packages/core-module-mt/system-config-module-mt/src/services/system-config.service.mt.ts:63-88](packages/core-module-mt/system-config-module-mt/src/services/system-config.service.mt.ts#L63-L88)
+  - [ ] 在deleteConfig方法中添加缓存清除逻辑 [packages/core-module-mt/system-config-module-mt/src/services/system-config.service.mt.ts:105-118](packages/core-module-mt/system-config-module-mt/src/services/system-config.service.mt.ts#L105-L118)
+  - [ ] 在update方法中添加缓存清除逻辑 [packages/core-module-mt/system-config-module-mt/src/services/system-config.service.mt.ts:73-77](packages/core-module-mt/system-config-module-mt/src/services/system-config.service.mt.ts#L73-L77)
 - [ ] 实现缓存穿透保护 (AC: 5)
-  - [ ] 添加空值缓存机制
-  - [ ] 实现短TTL的空值缓存
-  - [ ] 添加缓存预热机制
+  - [ ] 添加空值缓存机制 [packages/shared-utils/src/utils/redis.util.ts](packages/shared-utils/src/utils/redis.util.ts)
+  - [ ] 实现短TTL的空值缓存 [packages/shared-utils/src/utils/redis.util.ts](packages/shared-utils/src/utils/redis.util.ts)
+  - [ ] 添加缓存预热机制 [packages/core-module-mt/system-config-module-mt/src/services/system-config.service.mt.ts](packages/core-module-mt/system-config-module-mt/src/services/system-config.service.mt.ts)
 - [ ] 创建Redis缓存集成测试 (AC: 6)
-  - [ ] 创建缓存功能集成测试
-  - [ ] 测试缓存命中场景
-  - [ ] 测试缓存失效场景
-  - [ ] 测试缓存穿透保护
+  - [ ] 创建缓存功能集成测试 [packages/core-module-mt/system-config-module-mt/tests/integration/system-config.routes.integration.test.ts](packages/core-module-mt/system-config-module-mt/tests/integration/system-config.routes.integration.test.ts)
+  - [ ] 测试缓存命中场景 [packages/core-module-mt/system-config-module-mt/tests/integration/system-config.routes.integration.test.ts](packages/core-module-mt/system-config-module-mt/tests/integration/system-config.routes.integration.test.ts)
+  - [ ] 测试缓存失效场景 [packages/core-module-mt/system-config-module-mt/tests/integration/system-config.routes.integration.test.ts](packages/core-module-mt/system-config-module-mt/tests/integration/system-config.routes.integration.test.ts)
+  - [ ] 测试缓存穿透保护 [packages/core-module-mt/system-config-module-mt/tests/integration/system-config.routes.integration.test.ts](packages/core-module-mt/system-config-module-mt/tests/integration/system-config.routes.integration.test.ts)
 - [ ] 验证现有功能无回归 (AC: 6)
-  - [ ] 运行现有系统配置测试
-  - [ ] 验证共享CRUD包集成正常
+  - [ ] 运行现有系统配置测试 [packages/core-module-mt/system-config-module-mt/tests/integration/system-config.routes.integration.test.ts](packages/core-module-mt/system-config-module-mt/tests/integration/system-config.routes.integration.test.ts)
+  - [ ] 验证共享CRUD包集成正常 [packages/core-module-mt/system-config-module-mt/src/services/system-config.service.mt.ts](packages/core-module-mt/system-config-module-mt/src/services/system-config.service.mt.ts)
 
 ## Dev Notes
 
@@ -68,6 +68,7 @@ Draft
 - **租户配置**: 通过tenantOptions配置租户隔离
 - **用户跟踪**: 通过userTracking配置用户跟踪
 - **自定义方法**: getConfigByKey, getConfigsByKeys, setConfig, deleteConfig等
+- **参考文件**: [packages/core-module-mt/system-config-module-mt/src/services/system-config.service.mt.ts](packages/core-module-mt/system-config-module-mt/src/services/system-config.service.mt.ts)
 
 ### 缓存策略设计
 - **缓存键格式**: `system_config:{tenantId}:{configKey}` [参考: docs/epic-010-system-config-multi-tenant.md]
@@ -81,6 +82,13 @@ Draft
 - **写穿透**: 数据更新时同步更新缓存
 - **缓存清除**: 配置更新时清除相关缓存
 
+### 关键参考文件路径
+- **系统配置服务**: [packages/core-module-mt/system-config-module-mt/src/services/system-config.service.mt.ts](packages/core-module-mt/system-config-module-mt/src/services/system-config.service.mt.ts)
+- **Redis工具类**: [packages/shared-utils/src/utils/redis.util.ts](packages/shared-utils/src/utils/redis.util.ts)
+- **集成测试**: [packages/core-module-mt/system-config-module-mt/tests/integration/system-config.routes.integration.test.ts](packages/core-module-mt/system-config-module-mt/tests/integration/system-config.routes.integration.test.ts)
+- **系统配置实体**: [packages/core-module-mt/system-config-module-mt/src/entities/system-config.entity.mt.ts](packages/core-module-mt/system-config-module-mt/src/entities/system-config.entity.mt.ts)
+- **系统配置路由**: [packages/core-module-mt/system-config-module-mt/src/routes/system-config.routes.mt.ts](packages/core-module-mt/system-config-module-mt/src/routes/system-config.routes.mt.ts)
+
 ### 测试
 
 #### 测试标准 [Source: architecture/testing-strategy.md]
@@ -110,6 +118,7 @@ Draft
 | Date | Version | Description | Author |
 |------|---------|-------------|--------|
 | 2025-11-20 | 1.0 | 初始故事创建 | Bob (Scrum Master) |
+| 2025-11-20 | 1.1 | 为任务列表标注参考文件路径 | Claude Code |
 
 ## Dev Agent Record