🛒 Cart Service

📌 Overview

The Cart Service is a backend microservice designed to handle shopping cart operations using AWS DynamoDB as a NoSQL database. It provides functionalities to add and remove items, manage user carts, and ensure a seamless shopping experience.

🚀 Features

• Add Item to Cart – Add a product to a user's cart.
• Create a New Cart – Initialize a new cart for a user.
• Delete Item from Cart – Remove a specific item from a cart.
• Delete Cart – Remove all items from a user's cart.
• AWS DynamoDB Integration – Ensures high availability and scalability.
• RESTful API – Exposes endpoints for easy integration with frontend applications.

🏗️ Project Structure

local-dev/
├── aws/
│   ├── init-aws.sh                   # Script to create DynamoDB tables
├── docker-compose.yml                 # LocalStack setup for local AWS services

src/
│── main/
│   ├── java/com/lesleyzh/dynamodb_cart_service/
│   │   ├── Configuration/
│   │   │   ├── DynamodbConfig.java     # Configures AWS DynamoDB client
│   │   ├── controller/
│   │   │   ├── CartServiceController.java  # REST API for managing carts
│   │   ├── domain/
│   │   │   ├── Cart.java               # Entity representing a cart
│   │   │   ├── CartItem.java            # Entity representing a cart item
│   │   ├── repository/
│   │   │   ├── CartRepository.java      # Handles database interactions
│   │   ├── service/
│   │   │   ├── CartService.java         # Business logic for carts
│   │   ├── DynamoDbCartServiceApplication.java  # Main Spring Boot entry point
│── resources/
│   ├── application.yml                  # Spring Boot configuration

🔧 Technologies Used

• Java (Spring Boot) – Core backend framework.
• AWS DynamoDB – NoSQL database for scalable storage.
• AWS SDK for Java – To interact with DynamoDB.
• Gradle Kotlin DSL (gradle.kts) – Build automation.
• Docker – Containerized deployment.
• REST API – Communication layer.

🛠️ Setup Instructions

Prerequisites

• Java 11+
• Gradle (Kotlin DSL - gradle.kts)
• AWS DynamoDB (Local or Cloud)
• Docker (optional)

Steps to Run Locally

1. Clone the repository

   git clone https://github.com/lesleyzhao/DynamoDB-Cart-Service.git
   cd DynamoDB-Cart-Service

2. Build the project

   ./gradlew build

3. Configure aws local-stack environment using Docker

   docker-compose up -d

4. Run locally using Gradle

   ./gradlew bootRun

📖 Notes

• Ensure AWS credentials are configured for DynamoDB access.
• Set up CORS policies if integrating with a frontend.

🤝 Contributing

Contributions are welcome! Please create an issue or submit a pull request.

📜 License

This project is licensed under the MIT License.

---

Maintained by Lesley ZH & Team 🚀