https://github.com/venkat-gorla/smartmeal-serverless
SmartMeal — A meal-sharing platform featuring image uploads, real-time voting, and notifications. Built with Node.js microservices on AWS using event-driven architecture (SNS, EventBridge, DynamoDB), and deployed with fully managed serverless infrastructure.
https://github.com/venkat-gorla/smartmeal-serverless
aws aws-cognito aws-dynamodb aws-eventbridge aws-lambda aws-opensearch aws-s3 cqrs-pattern event-driven-architecture
Last synced: about 2 months ago
JSON representation
SmartMeal — A meal-sharing platform featuring image uploads, real-time voting, and notifications. Built with Node.js microservices on AWS using event-driven architecture (SNS, EventBridge, DynamoDB), and deployed with fully managed serverless infrastructure.
- Host: GitHub
- URL: https://github.com/venkat-gorla/smartmeal-serverless
- Owner: Venkat-Gorla
- License: mit
- Created: 2025-04-30T10:43:18.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-07-06T10:18:52.000Z (3 months ago)
- Last Synced: 2025-07-13T23:19:00.890Z (3 months ago)
- Topics: aws, aws-cognito, aws-dynamodb, aws-eventbridge, aws-lambda, aws-opensearch, aws-s3, cqrs-pattern, event-driven-architecture
- Language: JavaScript
- Homepage: https://smartmeal-preview.netlify.app/
- Size: 4.13 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 26
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🍱 Smart Meals Platform
A personal project to design and prototype a full-stack meals application — built for learning, and future extensibility.
**SmartMeal** — A meal-sharing platform featuring image uploads, real-time voting, and notifications. Built with Node.js microservices on AWS using event-driven architecture (SNS, EventBridge, DynamoDB), and deployed with fully managed serverless infrastructure.
## 📑 Table of Contents
- [Architecture](#-architecture)
- [🎯 Highlights](#-highlights)
- [✅ MVP Scope](#-mvp-scope)
- [🚧 Not Yet Implemented (Planned Work)](#-not-yet-implemented-planned-work)
- [💻 Frontend Preview](#-frontend-preview)
- [📁 Services Overview](#-services-overview)
- [🧪 Testing](#-testing)
- [🧱 Unit Tests in Action](#-unit-tests-in-action)
- [📚 Motivation](#-motivation)
- [🚀 License](#-license)
## 📐 Architecture
This project follows a **CQRS architecture** and leverages:
- 🟦 Microservices (Node.js + Lambda)
- 🟩 AWS-native services: S3, DynamoDB, EventBridge, SNS, Cognito, OpenSearch, API Gateway
- 📨 Event-driven communication for **loose coupling** (pub-sub pattern)
- 🔀 Separation of write and read planes (Command-Query Responsibility Segregation)
> The full proposed design is represented in the system diagram.
> Not everything is implemented for the MVP.
## 🎯 Highlights
- ⚙️ Node.js + AWS Lambda
- 🌐 React-based frontend (standalone, no backend wiring yet)
- 📬 API Gateway secured with **Amazon Cognito**
- 🔄 EventBridge & DynamoDB Streams used for inter-service events
- 🧠 Designed for learning and growth
## ✅ MVP Scope
The following are fully implemented and tested:
- All backend services
- End-to-end infrastructure for write and read planes
- Event-driven communication across services
### 🚧 Not Yet Implemented (Planned Work)
- **Upload & Authentication Integration** (Cognito token validation → API Gateway)
- **Like Meal Flow** (API → DynamoDB → deduplication → EventBridge)
## 💻 Frontend Preview
- **Live Preview**: [Try it!](https://smartmeal-preview.netlify.app/)
- **Source**: [`/react-client`](./react-client/)
## 📁 Services Overview
Each service is documented with its own detailed README:
- [`/auth`](./services/auth)
- [`/upload`](./services/upload-meal)
- [`/dynamodb`](./services/get-meals/events)
- [`/indexer-opensearch`](./services/get-meals/elastic-search)
## 🧪 Testing
✅ Rigorous test coverage across all services and frontend:
- **Unit Testing**: [Vitest](https://vitest.dev/) for logic
- **UI Testing**: [React Testing Library](https://testing-library.com/docs/react-testing-library/intro/)
- **Integration & Contract Tests**
### 🧱 Unit Tests in Action
## 📚 Motivation
> This project is a deep dive into:
>
> - Event-driven architecture
> - AWS serverless design patterns
> - Real-world system design for interviews
All code is open-sourced and maintained here on GitHub.
## 🚀 License
MIT License © 2025 VG — open to contributions, if you find it useful.