https://github.com/uwon0625/nbagames
NBA live score and alerts
https://github.com/uwon0625/nbagames
aws cloudformation dynamodb eventbridge express iac jest lambda nestjs nextjs powershell reactjs redis restful-api storybook tailwindcss terraform typescript unittest websocket
Last synced: about 2 months ago
JSON representation
NBA live score and alerts
- Host: GitHub
- URL: https://github.com/uwon0625/nbagames
- Owner: uwon0625
- Created: 2025-01-02T21:23:26.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-01-20T21:30:24.000Z (3 months ago)
- Last Synced: 2025-03-01T19:16:32.519Z (about 2 months ago)
- Topics: aws, cloudformation, dynamodb, eventbridge, express, iac, jest, lambda, nestjs, nextjs, powershell, reactjs, redis, restful-api, storybook, tailwindcss, terraform, typescript, unittest, websocket
- Language: TypeScript
- Homepage:
- Size: 78.2 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# NBAgames
NBA live score and alerts, it pulls most recent/scheduled games, with box score for the games. It also provides live updates.
# System Diagram
```mermaid
%%{init: {'flowchart': {'width': 600}}}%%
flowchart LR
NBA["NBA API"]
Poller["Lambda Poller"]
EventBridge["EventBridge\n(CloudWatch Events)"]
SQS["Message Queue\n(Kafka)"]
Lambda["Lambda Functions\n(Game Updates & Box Scores)"]
DynamoDB["DynamoDB"]
Redis["Redis Cache"]
WebSocket["WebSocket API"]
Client["Frontend Clients"]
NBA --> Poller
EventBridge --> Lambda
SQS --> Lambda
Lambda --> DynamoDB
Lambda --> WebSocket
DynamoDB --> Redis
WebSocket --> Client
Redis --> Frontend
%% Styling
classDef aws fill:#FF9900,stroke:#232F3E,stroke-width:2px,color:white;
classDef client fill:#36B37E,stroke:#172B4D,stroke-width:2px,color:white;
classDef external fill:#4A90E2,stroke:#2171C7,stroke-width:2px,color:white;
class NBA external
class Poller,EventBridge,Lambda,DynamoDB,Redis,WebSocket aws
class Client client,Frontend
```
# Technology Stack
- frontend: Next.js v14.1.0(React v18.2.0), TypeScript, Tailwind CSS, Storybook v7.6.17.
- backend: Terraform, Docker, SQS, Kafka, NestJS, Express, CORS, WebSocket, Redis,ElastiCache, AWS SDK V3, AWS DynamoDB, Lambda, EventBridge, CloudWatch, Restful API.
- infrastructure: AWS CDK(IAM, CloudFormation, DynamoDB).
- unit testing: Jest v29.7.0.
# Note
- to lower the cost of development and testing, use local Redis cache and Kafka(vs AWS MSK and ElastiCache Clusters, for production), the application has configurations in backend .env(refer to backend\.env.example, and backend\infrastructure\terraform\terraform.tfvars - please make sure the settings are consistent) to decide the facilities:
- Cost control for dev environment
* msk_instance_type = "kafka.t3.small" # Instead of larger instances
* redis_node_type = "cache.t3.micro" # Smallest Redis instance
- Development environment settings
* use_local_services = true # Use Docker Compose services
* use_msk = false # Don't deploy MSK
* use_elasticache = false # Don't deploy ElastiCache
* use_sqs_instead_of_msk = true # Don't use SQS in development
# Instructions
- clone the repo.
- frontend
* cd frontend
* yarn install
* yarn test # run unit tests
* yarn dev
- backend
* cd backend
* yarn install
* docker-compose up -d # start the kafka and redis services locally
* yarn test # run unit tests
* cd infrastructure/terraform
* terraform init
* terraform plan -out=tfplan
* terraform plan -destroy -out=tfdestroyplan
* cd ../../ # back to backend
* ./infrastructure/scripts/deploy.ps1 # include packaging lambda functions & terraform apply
* yarn dev #wait a few moments to have Redis ready
- Useful tips:
* example for SQS triggered lambda function invocation: aws sqs send-message --queue-url 'https://sqs.us-east-1.amazonaws.com/{account-id}/nba-live-updates-dev.fifo' --message-body '{"gameId":"0022400599","gameStatus":1,"homeTeam":{"teamId":"1610612766"},"awayTeam":{"teamId":"1610612742"}}' --message-group-id "game0022400599"
* check AWS resources: backend/infrastructure/scripts/check-tf-resources.ps1
* check lambda functions logs:
* aws logs tail "/aws/lambda/nba-live-game-update-dev"
* aws logs tail "/aws/lambda/nba-live-box-score-dev"
* cleanup: terraform destroy