How roop-teja/aws_project works
This is a serverless backend for publishing and listing college notifications. The main workflow accepts a publish request, validates it, calculates the matching subscriber queues, publishes through SNS, stores a notification record in DynamoDB, and returns a response; listing reads notification history from the store. The README also documents SNS subscription queues and an API Gateway/Lambda deployment, while the source shows an Express local adapter. AWS-side delivery beyond SNS publication is documented, not implemented in the sampled backend code.
Main entry points: notificationHandler.ts Notification handlers · app.ts Express adapter · snsPublisherService.ts SNS publisher service · dynamoService.ts DynamoDB service
Components 17
Request entry
- Local server
src/localServer.ts - Express adapter
src/app.ts
Notification workflow
- Notification handlers
src/handlers/notificationHandler.ts - Request validation
src/validation/notificationSchema.ts - Queue calculation
src/utils/queueCalculator.ts - Notification data types
src/types/notification.ts
AWS integrations
- SNS publisher service
src/services/snsPublisherService.ts - SNS topic
- Student queue
- Faculty queue
- Placement queue
- DynamoDB service
src/services/dynamoService.ts - Notifications table
Shared support
- Environment config
src/config/env.ts - API responses
src/utils/response.ts
Other components
- Notification publisher
- API Gateway
Connections 15
- Notification publisher → API Gateway: submits requests
README.md - API Gateway → Notification handlers: routes requests
README.md - Local server → Express adapter: starts
src/localServer.ts - Express adapter → Notification handlers: adapts and invokes
src/app.ts - Notification handlers → Request validation: validates with
src/handlers/notificationHandler.ts - Notification handlers → Queue calculation: calculates targets
src/handlers/notificationHandler.ts - Notification handlers → SNS publisher service: publishes through
src/handlers/notificationHandler.ts - SNS publisher service → SNS topic: publishes message
src/services/snsPublisherService.ts - SNS topic → Student queue: filters to
README.md - SNS topic → Faculty queue: filters to
README.md - SNS topic → Placement queue: filters to
README.md - Notification handlers → DynamoDB service: saves and lists
src/handlers/notificationHandler.ts - DynamoDB service → Notifications table: reads and writes
src/services/dynamoService.ts - Notification handlers → Environment config: loads settings
src/handlers/notificationHandler.ts - Notification handlers → API responses: formats results
src/handlers/notificationHandler.ts