Ecommerce Platform

A modern, scalable ecommerce platform built with Spring Boot, featuring a RESTful API backend and a responsive frontend. This platform provides comprehensive product management, shopping cart functionality, and checkout processes.

🚀 Features

• Product Management: Full CRUD operations for products with categories and inventory tracking
• Shopping Cart: Persistent cart functionality with item management
• User Management: Secure user authentication and authorization
• Checkout Process: Complete order processing workflow
• RESTful API: Well-documented REST endpoints for easy integration
• Database Initialization: Automatic sample data population for development
• Security: Spring Security integration with password encryption
• Frontend: Modern TypeScript-based web interface

🛠️ Technology Stack

Backend

• Java 17 - Modern Java features and performance
• Spring Boot 3.2.0 - Rapid application development framework
• Spring Data JPA - Data access layer with Hibernate
• Spring Security - Authentication and authorization
• H2 Database - In-memory database for development
• Maven - Dependency management and build tool
• Lombok - Reduces boilerplate code

Frontend

• TypeScript - Type-safe JavaScript development
• HTML5/CSS3 - Modern web standards
• Vanilla JavaScript - No framework dependencies

📋 Prerequisites

• Java 17 or higher
• Maven 3.6 or higher
• Node.js 16 or higher (for TypeScript compilation)

🚀 Quick Start

1. Clone the Repository

git clone https://github.com/your-username/ecommerce-platform-spring-boot.git
cd ecommerce-platform

2. Build the Project

mvn clean compile

3. Run the Application

mvn spring-boot:run

The application will start on http://localhost:8086

4. Access the Application

• Main Application: http://localhost:8086
• H2 Database Console: http://localhost:8086/h2-console
• API Base URL: http://localhost:8086/api

🗄️ Database Configuration

The application uses H2 in-memory database with the following configuration:

# Database
spring.datasource.url=jdbc:h2:mem:ecommercedb
spring.datasource.username=SA
spring.datasource.password=

# H2 Console
spring.h2.console.enabled=true
spring.h2.console.path=/h2-console

# JPA
spring.jpa.database-platform=org.hibernate.dialect.H2Dialect
spring.jpa.hibernate.ddl-auto=create-drop

🔐 Default Credentials

Admin User:

• Username: admin
• Password: admin123
• Email: admin@shophub.com

📚 API Endpoints

Products

• GET /api/products - Retrieve all products
• GET /api/products/{id} - Retrieve product by ID

Cart

• GET /api/cart - Get current cart
• POST /api/cart/add - Add item to cart
• PUT /api/cart/update - Update cart item quantity
• DELETE /api/cart/remove/{itemId} - Remove item from cart

Checkout

• POST /api/checkout/process - Process checkout and create order

🏗️ Project Structure

ecommerce-platform/
├── src/
│   ├── main/
│   │   ├── java/com/ecommerce/platform/
│   │   │   ├── config/           # Configuration classes
│   │   │   ├── controller/       # REST controllers
│   │   │   ├── dto/             # Data Transfer Objects
│   │   │   ├── entity/          # JPA entities
│   │   │   ├── repository/      # Data access layer
│   │   │   ├── service/         # Business logic
│   │   │   └── EcommercePlatformApplication.java
│   │   └── resources/
│   │       ├── static/          # Frontend assets
│   │       └── application.properties
│   └── test/                    # Test resources
├── pom.xml                      # Maven configuration
├── tsconfig.json               # TypeScript configuration
└── README.md                   # This file

🔧 Development

Adding New Features

1. Create Entity: Add JPA entity in entity/ package
2. Create Repository: Extend JpaRepository in repository/ package
3. Create Service: Implement business logic in service/ package
4. Create Controller: Add REST endpoints in controller/ package
5. Update Tests: Add corresponding test cases

Code Style

• Follow Java naming conventions
• Use meaningful variable and method names
• Add comprehensive JavaDoc comments
• Implement proper error handling
• Use logging for debugging and monitoring

🧪 Testing

Backend Testing

# Run all tests
mvn test

# Run specific test class
mvn test -Dtest=ProductControllerTest

# Run with coverage
mvn jacoco:report

Frontend Testing

# Compile TypeScript
npx tsc

# Run in browser
# Open src/main/resources/static/index.html

🚀 Deployment

Production Build

mvn clean package -DskipTests

Docker Deployment

FROM openjdk:17-jre-slim
COPY target/ecommerce-platform-*.jar app.jar
EXPOSE 8086
ENTRYPOINT ["java", "-jar", "/app.jar"]

📊 Sample Data

The application automatically populates the database with:

• 20 Sample Products across multiple categories:

  • Electronics (10 products)
  • Clothing (3 products)
  • Sports (3 products)
  • Home & Garden (1 product)
  • Beauty & Health (2 products)
  • Books (1 product)

• Default Admin User for system administration

🔍 Troubleshooting

Common Issues

1. Port Already in Use

   • Change port in application.properties
   • Kill existing process: netstat -ano | findstr :8086

2. Database Connection Issues

   • Verify H2 console is accessible
   • Check application logs for errors

3. Compilation Errors

   • Ensure Java 17 is installed: java -version
   • Clean and rebuild: mvn clean compile

Logs

Application logs are displayed in the console. Key log levels:

• INFO: General application flow
• DEBUG: Detailed debugging information
• ERROR: Error conditions and exceptions

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests for new functionality
5. Submit a pull request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

📞 Support

For questions and support:

• Create an issue in the repository
• Check the documentation

---

Built with ❤️ using Spring Boot and modern web technologies