Bashmufol/EvoCharge

Spring Boot REST API for EV charging in Nigeria. Brings station data from multiple operators into one backend, ranks chargers with EvoScore, streams live status updates, serves network analytics, and powers a natural-language charging advisor with Amazon Bedrock. # EvoCharge API REST API and AWS infrastructure for EvoCharge, a charging intelligence platform for Nigeria. The service aggregates station data from multiple operators into one normalized schema, exposes discovery and analytics endpoints, ranks stations with EvoScore, streams live status updates, and powers a natural-language charging advisor through Amazon Bedrock. ## Overview EvoCharge sits between operator data sources and client applications. Locally it loads seed JSON into in-memory stores. In AWS it uses DynamoDB tables defined in CDK. Seed data includes 48 stations across Lagos, Abuja, and Port Harcourt, representing three operator profiles: EVNetwork NG, ChargePro Africa, and VoltLane. ## API Capabilities | Area | Description | |------|-------------| | Operators and stations | List, filter, search, and fetch station detail by city, operator, status, and connector | | Nearby search | Find stations within a radius of a latitude and longitude | | EvoScore | Rank stations by distance, availability, wait time, reliability, and connector match | | Network Pulse | Server-sent events for live status changes; scheduled pulse via EventBridge and Lambda | | Analytics | Network summary KPIs and demand-by-area aggregates | | AI advisor | Natural-language queries via Bedrock, with Mistral API fallback and template fallback | | Health | Liveness endpoint for load balancer checks | Full endpoint reference: docs/api-contract.md. ## Tech Stack | Layer | Technology | |-------|------------| | API | Java 21, Spring Boot 4.0.6 | | Infrastructure | AWS CDK (Java) | | Compute | Amazon ECS on Fargate, Application Load Balancer | | Data | Amazon DynamoDB, Amazon S3 | | AI | Amazon Bedrock | | Events | Amazon EventBridge, AWS Lambda | | Networking | Amazon VPC, NAT Gateway | | Edge | Amazon CloudFront (API path proxy via Web stack) | ## Project Structure ``` EvoCharge/ ├── backend/api/ # Spring Boot application ├── infra/cdk/ # AWS CDK stacks (Network, Data, …