How niiiizzz/cache_shift works
CacheLab combines a thread-safe LRU/LFU cache library with a workload-simulation server and a live comparison dashboard. Users configure a run or LRU-vs-LFU comparison, the server generates a workload trace and executes it against caches, and the UI receives samples to show rates, counters, progress, charts, and a comparison verdict. The graph preserves the documented workload, TTL, streaming, and dashboard capabilities. Some subsystem links rely on README documentation because their source was not sampled.
Main entry points: App.tsx Dashboard App · Cache.java Cache Container · Run.java Simulation Run · RunManager.java Run Manager
Components 25
Cache Library
- Cache Container
cache-core/src/main/java/com/cachelab/core/Cache.java - Cache Builder
cache-core/src/main/java/com/cachelab/core/CacheBuilder.java - Cache Entry
cache-core/src/main/java/com/cachelab/core/Entry.java - Cache Statistics
cache-core/src/main/java/com/cachelab/core/CacheStats.java - Eviction Contract
cache-core/src/main/java/com/cachelab/core/policy/EvictionPolicy.java - LRU Policy
cache-core/src/main/java/com/cachelab/core/policy/LruPolicy.java - LFU Policy
cache-core/src/main/java/com/cachelab/core/policy/LfuPolicy.java
Simulation Server
- Run Controller
cache-server/src/main/java/com/cachelab/server/controller/RunController.java - Run Manager
cache-server/src/main/java/com/cachelab/server/service/RunManager.java - Trace Generator
cache-server/src/main/java/com/cachelab/server/service/TraceGenerator.java - Simulation Run
cache-server/src/main/java/com/cachelab/server/service/Run.java - Run Configuration
cache-server/src/main/java/com/cachelab/server/model/RunConfig.java - Workload Patterns
cache-server/src/main/java/com/cachelab/server/model/Pattern.java - Metric Sample
cache-server/src/main/java/com/cachelab/server/model/Sample.java - Error Handling
cache-server/src/main/java/com/cachelab/server/exception/GlobalExceptionHandler.java
Dashboard
- Dashboard App
cache-ui/src/App.tsx - Run Configuration
cache-ui/src/components/ConfigPanel.tsx - Workload Presets
cache-ui/src/components/PresetRow.tsx - Run API Client
cache-ui/src/api/runApi.ts - Sample Stream Hook
cache-ui/src/hooks/useRunStream.ts - Metrics Views
cache-ui/src/components/HitRateChart.tsx - Compare Verdict
cache-ui/src/components/VerdictBanner.tsx - API Types
cache-ui/src/types/api.ts
Other components
- Dashboard User
- Browser
Connections 31
- Dashboard User → Dashboard App: configures and starts
README.md - Dashboard App → Run Configuration: renders
cache-ui/src/App.tsx - Dashboard App → Workload Presets: renders
cache-ui/src/App.tsx - Dashboard App → Run API Client: starts or stops
cache-ui/src/App.tsx - Dashboard App → Sample Stream Hook: subscribes to
cache-ui/src/App.tsx - Dashboard App → Metrics Views: renders metrics
cache-ui/src/App.tsx - Dashboard App → Compare Verdict: renders comparison
cache-ui/src/App.tsx - Dashboard App → API Types: uses types
cache-ui/src/App.tsx - Run API Client → Browser: sends REST requests
README.md - Sample Stream Hook → Run API Client: polls latest sample
cache-ui/src/hooks/useRunStream.ts - Sample Stream Hook → Browser: opens SSE stream
cache-ui/src/hooks/useRunStream.ts - Browser → Run Controller: calls REST endpoints
cache-server/src/main/java/com/cachelab/server/controller/RunController.java - Run Controller → Run Manager: starts, stops, retrieves
cache-server/src/main/java/com/cachelab/server/controller/RunController.java - Run Controller → Simulation Run: registers stream
cache-server/src/main/java/com/cachelab/server/controller/RunController.java - Run Manager → Trace Generator: generates workload
cache-server/src/main/java/com/cachelab/server/service/RunManager.java - Run Manager → Simulation Run: creates and starts
cache-server/src/main/java/com/cachelab/server/service/RunManager.java - Run Manager → Run Configuration: constructs configurations
cache-server/src/main/java/com/cachelab/server/service/RunManager.java - Run Manager → Workload Patterns: configures trace
cache-server/src/main/java/com/cachelab/server/service/RunManager.java - Simulation Run → Cache Container: executes operations
cache-server/src/main/java/com/cachelab/server/service/Run.java - Simulation Run → Cache Statistics: samples counters
cache-server/src/main/java/com/cachelab/server/service/Run.java - Simulation Run → Metric Sample: publishes metrics
README.md - Simulation Run → Browser: streams samples by SSE
README.md - Run Controller → Error Handling: maps request errors
- Cache Container → Cache Builder: creates
cache-core/src/main/java/com/cachelab/core/Cache.java - Cache Container → Cache Entry: stores and expires
cache-core/src/main/java/com/cachelab/core/Cache.java - Cache Container → Cache Statistics: updates counters
cache-core/src/main/java/com/cachelab/core/Cache.java - Cache Container → Eviction Contract: delegates eviction
cache-core/src/main/java/com/cachelab/core/Cache.java - LRU Policy → Eviction Contract: implements
cache-core/src/main/java/com/cachelab/core/policy/LruPolicy.java - LFU Policy → Eviction Contract: implements
cache-core/src/main/java/com/cachelab/core/policy/LfuPolicy.java - Cache Container → LRU Policy: selects by policy
cache-core/src/main/java/com/cachelab/core/Cache.java - Cache Container → LFU Policy: selects by policy
cache-core/src/main/java/com/cachelab/core/Cache.java