more features checks. setup improvements

This commit is contained in:
master
2026-02-13 02:04:55 +02:00
parent 9911b7d73c
commit 9ca2de05df
675 changed files with 37550 additions and 1826 deletions

View File

@@ -0,0 +1,27 @@
# Valkey Advisory Cache Service
## Module
Concelier
## Status
IMPLEMENTED
## Description
Valkey (Redis-compatible) caching layer for canonical advisories with TTL policies based on interest score, PURL index lookups, hot set ranking, and p99 < 20ms read target. Includes cache warmup, metrics, and fallback mode.
## Implementation Details
- **Modules**: `src/Concelier/__Libraries/StellaOps.Concelier.Cache.Valkey/`
- **Key Classes**:
- `ValkeyAdvisoryCacheService` (`src/Concelier/__Libraries/StellaOps.Concelier.Cache.Valkey/ValkeyAdvisoryCacheService.cs`) - Valkey-backed cache with TTL policies, PURL index, and hot set ranking
- `AdvisoryCacheKeys` (`src/Concelier/__Libraries/StellaOps.Concelier.Cache.Valkey/AdvisoryCacheKeys.cs`) - deterministic cache key generation for advisory lookups
- `CachingCanonicalAdvisoryService` (`src/Concelier/__Libraries/StellaOps.Concelier.Core/Canonical/CachingCanonicalAdvisoryService.cs`) - caching decorator wrapping the canonical advisory service
- **Interfaces**: `IAdvisoryCacheService`
- **Source**: SPRINT_8200_0013_0001_GW_valkey_advisory_cache.md
## E2E Test Plan
- [ ] Store a canonical advisory in Valkey and retrieve it, verifying p99 read latency is < 20ms
- [ ] Verify TTL policy: high-interest advisories have longer TTLs than low-interest ones
- [ ] Verify PURL index lookup: query by PURL and verify matching advisories are returned from cache
- [ ] Verify hot set ranking: frequently accessed advisories are promoted in the hot set
- [ ] Verify cache warmup: on startup, verify high-interest advisories are pre-loaded into cache
- [ ] Verify fallback mode: disable Valkey and confirm the service falls back to direct PostgreSQL queries