System Overview
High-level service map, data flow, and integration boundaries.
This page provides a high-level view of the system architecture and how services interact.
Service map
| Service | Responsibility | Owner |
|---|---|---|
| Web Portal | User-facing Next.js app | Frontend |
| Admin Console | Internal Angular admin | Internal Tools |
| Backend API | REST API, business logic | Platform |
| Worker Service | Background jobs, queues | Platform |
| Mobile App | React Native iOS/Android | Mobile |
Data flow
- Clients (web, mobile, admin) authenticate via Cognito
- API Gateway routes requests to backend services
- Backend API handles business logic, reads/writes PostgreSQL
- Worker Service processes async jobs from Redis queues
- Integrations connect to Stripe, analytics, and external APIs
Media upload path
- Client requests signed URL from API
- API validates user permissions and file policy
- Client uploads directly to object storage
- Worker scans media for viruses and optimizes
- CDN publishes the optimized asset
Infrastructure
- Compute — AWS ECS (Fargate) behind Application Load Balancer
- Database — PostgreSQL (RDS) with read replicas
- Cache — Redis (ElastiCache)
- Storage — S3 with CloudFront CDN
- Notifications — FCM (push), AWS SES / SendGrid / Brevo (email)
- CI/CD — GitHub Actions → ECR → ECS (Alpha → Beta → Prod)
- Monitoring — OpenTelemetry, Sentry, Axiom