How kavinkumarandroiddev/waroracle works
WarOracle is a Spring backend for forecasting Clash of Clans wars and producing tactical attack assignments. The main workflow accepts REST requests, gathers live war/player history, builds performance models, runs a Monte Carlo forecast, and returns predictions; a separate strategy workflow computes assignments and contingency briefings. Feedback and persistence are supporting capabilities. The README documents several architecture links; sampled source confirms key modeling, simulation, API-client, and persistence behavior, but strategy implementation and some service wiring were not excerpted.
Main entry points: WarOracleService.java War Orchestrator · PerformanceModelingService.java Performance Modeling · WarStrategyServiceImpl.java Strategy Planner · ClashApiClient.java Clash API Client
Components 24
REST API
- Player API
src/main/java/com/kkdev/waroracle/controller/PlayerController.java - Strategy API
src/main/java/com/kkdev/waroracle/controller/WarStrategyController.java - Feedback API
src/main/java/com/kkdev/waroracle/controller/FeedbackController.java - Feedback Service
src/main/java/com/kkdev/waroracle/service/impl/FeedbackServiceImpl.java - Feedback DTOs
src/main/java/com/kkdev/waroracle/dto/feedback
War Analytics
- War Orchestrator
src/main/java/com/kkdev/waroracle/service/WarOracleService.java - Performance Modeling
src/main/java/com/kkdev/waroracle/service/PerformanceModelingService.java - Hero Equipment Power
src/main/java/com/kkdev/waroracle/service/HeroEquipmentPowerCalculator.java - Prior Calibration
src/main/java/com/kkdev/waroracle/service/EmpiricalPriorCalibrationService.java - Monte Carlo Engine
src/main/java/com/kkdev/waroracle/service/MonteCarloSimulationService.java - Performance Models
src/main/java/com/kkdev/waroracle/dto/model - Simulation Results
src/main/java/com/kkdev/waroracle/dto/simulation
Strategy Planning
- Strategy Planner
src/main/java/com/kkdev/waroracle/service/strategy/WarStrategyServiceImpl.java - Assignment Optimizer
src/main/java/com/kkdev/waroracle/service/strategy/KuhnBipartiteOptimizer.java - Strategy Briefings
src/main/java/com/kkdev/waroracle/dto/strategy
Data and Integrations
- Player Data Service
src/main/java/com/kkdev/waroracle/service/PlayerService.java - Clan Data Service
src/main/java/com/kkdev/waroracle/service/ClanService.java - Clash API Client
src/main/java/com/kkdev/waroracle/client/ClashApiClient.java - API Cache
src/main/java/com/kkdev/waroracle/service/ClashApiCacheService.java - War Persistence
src/main/java/com/kkdev/waroracle/service/WarPersistenceService.java - JPA Repositories
src/main/java/com/kkdev/waroracle/repository
Other components
- REST Client
- Supercell Clash API
- MySQL Store
Connections 25
- REST Client → Player API: requests
src/main/java/com/kkdev/waroracle/controller/PlayerController.java - REST Client → Strategy API: requests
src/main/java/com/kkdev/waroracle/controller/WarStrategyController.java - REST Client → Feedback API: submits
src/main/java/com/kkdev/waroracle/controller/FeedbackController.java - Player API → War Orchestrator: delegates
src/main/java/com/kkdev/waroracle/controller/PlayerController.java - Strategy API → Strategy Planner: delegates
src/main/java/com/kkdev/waroracle/controller/WarStrategyController.java - Feedback API → Feedback Service: delegates
src/main/java/com/kkdev/waroracle/controller/FeedbackController.java - Feedback API → Feedback DTOs: accepts and returns
src/main/java/com/kkdev/waroracle/controller/FeedbackController.java - War Orchestrator → Performance Modeling: builds models
README.md - Performance Modeling → Hero Equipment Power: uses
src/main/java/com/kkdev/waroracle/service/PerformanceModelingService.java - Performance Modeling → Prior Calibration: gets priors
src/main/java/com/kkdev/waroracle/service/PerformanceModelingService.java - Performance Modeling → Performance Models: produces
src/main/java/com/kkdev/waroracle/service/PerformanceModelingService.java - War Orchestrator → Monte Carlo Engine: runs forecast
README.md - Monte Carlo Engine → Simulation Results: returns predictions
src/main/java/com/kkdev/waroracle/service/MonteCarloSimulationService.java - War Orchestrator → Player Data Service: fetches player data
src/main/java/com/kkdev/waroracle/service/WarOracleService.java - War Orchestrator → Clan Data Service: fetches clan data
src/main/java/com/kkdev/waroracle/service/WarOracleService.java - War Orchestrator → War Persistence: persists war data
src/main/java/com/kkdev/waroracle/service/WarOracleService.java - War Orchestrator → Strategy Planner: coordinates planning
src/main/java/com/kkdev/waroracle/service/strategy/WarStrategyServiceImpl.java - Strategy Planner → Assignment Optimizer: optimizes assignments
README.md - Strategy Planner → Strategy Briefings: returns plan
src/main/java/com/kkdev/waroracle/service/strategy/WarStrategyServiceImpl.java - Player Data Service → Clash API Client: requests data
src/main/java/com/kkdev/waroracle/service/PlayerService.java - Clan Data Service → Clash API Client: requests data
src/main/java/com/kkdev/waroracle/service/ClanService.java - Clash API Client → API Cache: reads and writes
src/main/java/com/kkdev/waroracle/client/ClashApiClient.java - Clash API Client → Supercell Clash API: calls
src/main/java/com/kkdev/waroracle/client/ClashApiClient.java - War Persistence → JPA Repositories: reads and writes
src/main/java/com/kkdev/waroracle/service/WarPersistenceService.java - JPA Repositories → MySQL Store: stores records