|
@@ -18,30 +18,30 @@ Draft
|
|
|
|
|
|
|
|
## Tasks / Subtasks
|
|
## Tasks / Subtasks
|
|
|
- [ ] 扩展系统配置服务添加Redis缓存方法 (AC: 1, 2)
|
|
- [ ] 扩展系统配置服务添加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配置 (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)
|
|
- [ ] 实现缓存失效机制 (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)
|
|
- [ ] 实现缓存穿透保护 (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)
|
|
- [ ] 创建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)
|
|
- [ ] 验证现有功能无回归 (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
|
|
## Dev Notes
|
|
|
|
|
|
|
@@ -68,6 +68,7 @@ Draft
|
|
|
- **租户配置**: 通过tenantOptions配置租户隔离
|
|
- **租户配置**: 通过tenantOptions配置租户隔离
|
|
|
- **用户跟踪**: 通过userTracking配置用户跟踪
|
|
- **用户跟踪**: 通过userTracking配置用户跟踪
|
|
|
- **自定义方法**: getConfigByKey, getConfigsByKeys, setConfig, deleteConfig等
|
|
- **自定义方法**: 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]
|
|
- **缓存键格式**: `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]
|
|
#### 测试标准 [Source: architecture/testing-strategy.md]
|
|
@@ -110,6 +118,7 @@ Draft
|
|
|
| Date | Version | Description | Author |
|
|
| Date | Version | Description | Author |
|
|
|
|------|---------|-------------|--------|
|
|
|------|---------|-------------|--------|
|
|
|
| 2025-11-20 | 1.0 | 初始故事创建 | Bob (Scrum Master) |
|
|
| 2025-11-20 | 1.0 | 初始故事创建 | Bob (Scrum Master) |
|
|
|
|
|
+| 2025-11-20 | 1.1 | 为任务列表标注参考文件路径 | Claude Code |
|
|
|
|
|
|
|
|
## Dev Agent Record
|
|
## Dev Agent Record
|
|
|
|
|
|