A full-featured e-commerce platform built with Java, JSP, Servlets, and MySQL. Supports customer shopping, product management, order processing, and admin controls.

Managing an online electronics store requires a robust system to handle:

• Product Catalog Management - Add, update, and remove products with images
• Shopping Cart Operations - Add/remove items, manage quantities
• Order Processing - Create orders, track shipments, manage transactions
• User Authentication - Secure login/registration for customers and admins
• Inventory Management - Track stock levels and demand

This project provides a complete solution for these requirements.

• User Management

  • Customer registration and login
  • Admin authentication
  • Session-based security
  • Password encryption

• Product Management

  • Browse all products with search functionality
  • Filter products by category/type
  • Product images and details
  • Admin product CRUD operations
  • Stock management

• Shopping Cart

  • Add/remove items from cart
  • Update quantities
  • Real-time cart calculations
  • Persistent cart storage

• Order Management

  • Create and process orders
  • Order tracking and history
  • Shipment management
  • Transaction records

• Admin Dashboard

  • View all products
  • Manage inventory
  • Process orders
  • Track shipments

• Email Notifications

  • Order confirmation emails
  • Shipment notifications
  • User registration confirmation

• Java 8+ installed
• Maven 3.6+ installed
• MySQL 8.0+ running
• Tomcat 9+ (or any servlet container)

git clone https://github.com/yourusername/ajt-ecommerce.git cd AJT_E-commerce

1. Create a MySQL database:

CREATE DATABASE `shopping-cart`;

2. Import the database schema:

mysql -u root -p shopping-cart < databases/schema.sql

1. Copy .env.example to .env:

cp .env.example .env

2. Edit .env with your database and email credentials:

DB_CONNECTION_STRING=jdbc:mysql://localhost:3306/shopping-cart DB_USERNAME=root DB_PASSWORD=your_password MAILER_EMAIL=your-email@gmail.com MAILER_PASSWORD=your-app-specific-password

mvn clean install

1. Copy the generated WAR file to Tomcat's webapps directory:

cp target/shopping-cart.war $CATALINA_HOME/webapps/

2. Start Tomcat:

$CATALINA_HOME/bin/startup.sh

3. Access the application:

http://localhost:8080/shopping-cart 

1. Register - Create a new account
2. Browse Products - Search or filter by category
3. Add to Cart - Select items and quantities
4. Checkout - Review cart and place order
5. Track Order - View order status and shipment

1. Login - Access admin dashboard
2. Manage Products - Add/edit/delete products
3. View Orders - Process customer orders
4. Update Shipments - Track and update delivery status
5. View Analytics - Monitor sales and inventory

All documentation is organized in the docs/ folder:

• QUICKSTART.md - 5-minute setup guide
• ARCHITECTURE.md - System design and architecture
• DEPLOYMENT.md - Deployment procedures
• CONTRIBUTING.md - Developer guidelines
• SECURITY.md - Security policies
• FAQ.md - Frequently asked questions
• CHANGELOG.md - Version history
• DOCS_INDEX.md - Documentation index

• POST /shopping-cart/login - User login
• POST /shopping-cart/register - User registration
• GET /shopping-cart/logout - User logout

• GET /shopping-cart/index.jsp - View all products
• GET /shopping-cart/index.jsp?search=keyword - Search products
• GET /shopping-cart/index.jsp?type=category - Filter by category
• POST /shopping-cart/AddProductSrv - Add product (Admin)
• POST /shopping-cart/UpdateProductSrv - Update product (Admin)
• POST /shopping-cart/RemoveProductSrv - Delete product (Admin)

• POST /shopping-cart/AddtoCart - Add item to cart
• GET /shopping-cart/cartDetails.jsp - View cart
• POST /shopping-cart/UpdateToCart - Update cart item

• POST /shopping-cart/OrderServlet - Create order
• POST /shopping-cart/ShipmentServlet - Update shipment

• GET /shopping-cart/ShowImage?id=productId - Retrieve product image

AJT_E-commerce/ ├── src/ │ └── com/shashi/ │ ├── beans/ # Data models (ProductBean, UserBean, etc.) │ ├── service/ # Service interfaces │ ├── service/impl/ # Service implementations │ ├── srv/ # Servlet controllers │ ├── utility/ # Utility classes (DBUtil, MailUtil, etc.) │ └── constants/ # Application constants ├── WebContent/ │ ├── css/ # Stylesheets │ ├── js/ # JavaScript files │ ├── images/ # Product images │ ├── WEB-INF/ │ │ ├── web.xml # Servlet configuration │ │ └── lib/ # JAR dependencies │ ├── index.jsp # Home page │ ├── header.jsp # Header component │ ├── footer.html # Footer component │ ├── cartDetails.jsp # Shopping cart │ ├── adminHome.jsp # Admin dashboard │ └── ... # Other JSP pages ├── databases/ │ └── schema.sql # Database schema ├── pom.xml # Maven configuration ├── .env.example # Environment variables template ├── .gitignore # Git ignore rules ├── .gitattributes # Git attributes ├── LICENSE # MIT License └── README.md # This file 

Edit src/application.properties:

db.driverName=com.mysql.cj.jdbc.Driver db.connectionString=jdbc:mysql://localhost:3306/shopping-cart db.username=root db.password=your_password

Update mailer credentials in src/application.properties:

mailer.email=your-email@gmail.com mailer.password=your-app-specific-password

Note: For Gmail, use an App-Specific Password.

mvn clean test

mvn clean install # Deploy to Tomcat as described in Installation section

• ✅ Password encryption using Apache Commons Codec
• ✅ Session-based authentication
• ✅ SQL injection prevention with PreparedStatements
• ⚠️ TODO: Add CSRF tokens
• ⚠️ TODO: Implement HTTPS enforcement
• ⚠️ TODO: Add input validation framework

• Payment Gateway Integration - Stripe/PayPal integration
• Advanced Search - Elasticsearch integration
• User Reviews & Ratings - Product feedback system
• Wishlist Feature - Save favorite products
• Recommendation Engine - ML-based product suggestions
• Mobile App - React Native mobile client
• API Modernization - RESTful API with Spring Boot
• Analytics Dashboard - Sales and traffic analytics
• Multi-language Support - i18n implementation
• Performance Optimization - Caching and CDN integration

Contributions are welcome! Please follow these steps:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

See docs/CONTRIBUTING.md for detailed guidelines.

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

• Shashi Kumar - Initial development
• Contributors - See CONTRIBUTING.md

For support, email support@ellison-electronics.com or open an issue on GitHub.

java e-commerce, shopping cart application, jsp servlet project, mysql database, java web application, e-commerce platform github, shopping cart github, java project example, servlet tutorial, jsp tutorial, maven project, tomcat deployment, java backend, web development java, full-stack java, electronics store, online shopping, inventory management, order processing, user authentication java

Last Updated: December 2024
Version: 1.0.0