How niranjan123-k/rateguard works
RateGuard is a Spring Boot rate-limiting API with a React monitoring dashboard. A client calls an annotated endpoint; the AOP aspect applies a per-IP fixed-window limit, records allowed or blocked events, and lets allowed calls proceed. Events are published for live monitoring and logs support history analytics. The README documents the MySQL and WebSocket capabilities; some frontend network wiring and configuration details were not excerpted, so those links rely on documented architecture rather than inspected implementation.
Main entry points: RateLimitAspect.java Limit enforcement · DemoController.java Demo endpoints · RequestLogRepository.java Request log repository · App.jsx Dashboard UI
Components 15
API and enforcement
- Demo endpoints
rateguard/src/main/java/com/guard/api/controller/DemoController.java - Rate limit policy
rateguard/src/main/java/com/guard/api/annotation/RateLimit.java - Limit enforcement
rateguard/src/main/java/com/guard/api/aspect/RateLimitAspect.java - Limit exception
rateguard/src/main/java/com/guard/api/exception/RateLimitExceededException.java - HTTP error mapping
rateguard/src/main/java/com/guard/api/exception/GlobalExceptionHandler.java
Monitoring and analytics
- History API
rateguard/src/main/java/com/guard/api/controller/AnalyticsController.java - Request log repository
rateguard/src/main/java/com/guard/api/repository/RequestLogRepository.java - Request log record
rateguard/src/main/java/com/guard/api/entity/RequestLog.java - Live request event
rateguard/src/main/java/com/guard/api/dto/RequestEvent.java - WebSocket delivery
rateguard/src/main/java/com/guard/api/config/WebSocketConfig.java - MySQL
Dashboard
- Dashboard UI
frontend/src/App.jsx - React entry point
frontend/src/main.jsx
Other components
- API client
- Dashboard user
Connections 17
- API client → Demo endpoints: calls API
README.md - Demo endpoints → Limit enforcement: intercepted by
rateguard/src/main/java/com/guard/api/aspect/RateLimitAspect.java - Demo endpoints → Rate limit policy: configures
rateguard/src/main/java/com/guard/api/controller/DemoController.java - Limit enforcement → Rate limit policy: reads policy
rateguard/src/main/java/com/guard/api/aspect/RateLimitAspect.java - Limit enforcement → Demo endpoints: proceeds to
rateguard/src/main/java/com/guard/api/aspect/RateLimitAspect.java - Limit enforcement → Limit exception: throws when blocked
rateguard/src/main/java/com/guard/api/aspect/RateLimitAspect.java - HTTP error mapping → Limit exception: handles
rateguard/src/main/java/com/guard/api/exception/GlobalExceptionHandler.java - Limit enforcement → Request log repository: saves logs
rateguard/src/main/java/com/guard/api/aspect/RateLimitAspect.java - Request log repository → Request log record: persists entity
rateguard/src/main/java/com/guard/api/repository/RequestLogRepository.java - Request log repository → MySQL: stores logs
README.md - History API → Request log repository: reads history
rateguard/src/main/java/com/guard/api/controller/AnalyticsController.java - Limit enforcement → Live request event: creates event
rateguard/src/main/java/com/guard/api/aspect/RateLimitAspect.java - Limit enforcement → WebSocket delivery: publishes event
rateguard/src/main/java/com/guard/api/aspect/RateLimitAspect.java - WebSocket delivery → Dashboard UI: streams updates
README.md - Dashboard UI → History API: requests history
README.md - Dashboard user → React entry point: opens dashboard
frontend/src/main.jsx - React entry point → Dashboard UI: renders
frontend/src/main.jsx