Shop Application - Spring Boot, Angular, MongoDB, Redis, Docker

Project overview

Monolithic e-commerce application with payment processing via Stripe.

• Backend: Spring Boot (RESTful API)
• Frontend: Angular with Bootstrap
• Database: MongoDB (primary data store)
• Cache/State: Redis (token management & shopping cart)
• Containerization: Docker Compose

Customer Functionality

✅ User registration & authentication (JWT tokens)
✅ Product catalog with filtering
✅ Shopping cart persistence (Redis)
✅ Order placement with status tracking
✅ Order history with simulated status transitions

Admin Functionality

🛠️ Product management (availability toggle)
🛠️ Customer order viewing/refunding

Payment Processing

💰 Stripe Integration

• Secure credit card payments
• Automated payment confirmation via webhooks
• Support for payment retries
• Order status synchronization (Created (Before payment) → Processing (After successful payment))

Development Setup

Get Stripe Test Keys

• Register at Stripe Dashboard
• Set keys in .env file

Test Cards

• Success: 4242 4242 4242 4242
• Decline: 4000 0000 0000 0002

Technology Stack

Component	Technology
Backend	Java 17, Spring Boot 3.4.3
Security	JWT (Access + Refresh tokens)
Database	MongoDB (document storage)
Cache	Redis (tokens, cart & theme)
Frontend	Angular 19, Bootstrap 5
Containerization	Docker + Docker Compose
Build Tools	Gradle (backend), npm (frontend)

System Architecture

┌─────────────┐    ┌─────────────┐    ┌────────────────────┐
│ Angular     │ ←→ │ Spring Boot │ ←→ │ MongoDB            │
│ Frontend    │    │ (REST API)  │    │(Primary Database)  │
└─────────────┘    └─────────────┘    └────────────────────┘
                        ↑                        ↑
                        │                        │
                        ↓                        │
                        ┌────────────────┐       │
                        │ Redis          │ ←─────┘
                        │ (Tokens +      │
                        │ Shopping Cart) │
                        └────────────────┘

Installation & Setup

Prerequisites

• Docker 20.10+
• Docker Compose 2.0+
• JDK 17 (for local development)
• Node.js 22+ (for frontend development)

Quick Start with Docker

1. Clone the repository:
   • git clone https://github.com/your-repo/shop-app.git
   • cd sportstore
2. Set up .env:

  # Secret key used for generating and verifying JWT tokens
JWT_SECRET=your_jwt_secret_key

  # Email credentials for sending messages
FORUM_MAIL_USERNAME=your_email@example.com
FORUM_MAIL_PASSWORD=your_email_password

  # Stripe API secret key for handling payments
STRIPE_SECRET=your_stripe_secret_key

  # Webhook key for verifying Stripe events
WEBHOOK_KEY=your_webhook_secret_key

3. Build backend:

./gradlew clean build

4. Start all services:

docker-compose up -d --build

API Documentation

http://localhost:8080/swagger-ui/index.html

Project Structure

shop-app/              # Spring Boot application
├── src/main/java/org/shop/sortwebstore
│   ├── config/        # Security & application config
│   ├── controller/    # REST controllers
│   ├── model/         # Data models (Product, User, Order)
│   ├── repository/    # MongoDB repositories
│   ├── service/       # Business logic
│   └── exception/     # Custom exception handler
├── Dockerfile
└── build.gradle
│
├── frontend/                # Angular application
│   ├── public/
│   ├── src/
│   │   ├── app/ 
│   │   │    ├── routes      # Main router
│   │   │    ├── components/ # Angular components
│   │   │    └── services/   # Api services communication
│   │   ├── styles.css       # Main style
│   │   └── index.html       # Main index
│   ├── Dockerfile
│   └── package.json
│
├── compose.yml              # Orchestration config
└── README.md                # This file