Architecture Visual
Complete production architecture for FIFA Neon Soccer, covering frontend delivery, identity, gameplay APIs, compute logic, and real-time score persistence.
Delivery and Frontend

Player Browser
Loads neon game UI and client logic
→

CloudFront CDN
Global delivery at app.joesparkman.com/fifa
→

S3 Static Hosting
index, app.js, style, audio assets
Auth and API Routing

Amazon Cognito
Hosted UI + PKCE + access tokens
→

API Gateway HTTP API
leaderboard, profile, telemetry routes
→

Lambda (Node/Python)
route validation and score handlers
Gameplay Data and Persistence

Game Telemetry Events
match events and timing snapshots
↔

Lambda Runtime
score calculation and write orchestration
→

DynamoDB Tables
player profiles, scores, telemetry
Infrastructure as Code

Terraform
Provisions all AWS resources from HCL config
→

S3 Remote State
fifa-neon-tfstate bucket stores tfstate
→

GitHub Actions CI/CD
terraform plan on PR · apply on push to main
Protected endpoints use Cognito JWT bearer tokens. CloudFront + S3 handle static delivery while API Gateway + Lambda process gameplay requests and persist leaderboard state. All infrastructure is provisioned and versioned via Terraform with automated CI/CD.
Hosting layer: CloudFront serves the game globally while S3 stores static frontend files and media assets.
Auth layer: Cognito handles sign-in and token issuance for secured player actions and account-specific views.
Compute layer: API Gateway forwards requests to Lambda for game data validation and score updates.
Data layer: DynamoDB stores leaderboard entries and player-linked telemetry records.
Security posture: Tokens and IAM controls protect write operations and keep privileged logic server-side.
Scalability: Serverless components scale with traffic spikes during gameplay and events.
IaC layer: Terraform manages all AWS resources with remote state in S3 and automated deploys via GitHub Actions.