EcommerceHub-Pro

A professional full-stack e-commerce platform with stunning animations, real-time inventory management, advanced admin panel, and local database integration. Features product management, order processing, payment integration, and secure authentication.

🌟 Features

Customer Features

• ✅ Professional Animated UI - Modern, responsive design with smooth animations
• ✅ Product Browsing - Browse, search, and filter products efficiently
• ✅ Shopping Cart - Add/remove items with persistent storage
• ✅ Checkout System - Secure order placement
• ✅ User Accounts - Register, login, and manage profile
• ✅ Order Tracking - Track order status in real-time
• ✅ Product Reviews - Leave ratings and reviews
• ✅ Wishlist - Save favorite products

Admin Features

• ✅ Dashboard - Key metrics and analytics at a glance
• ✅ Product Management - Create, edit, delete products
• ✅ Order Management - Track and manage orders
• ✅ Customer Management - View and manage customers
• ✅ Inventory Tracking - Monitor stock levels
• ✅ Sales Analytics - Revenue and sales reports
• ✅ User Roles - Role-based access control

🚀 Quick Start

Localhost URLs

Store:  http://localhost:3000
Admin:  http://localhost:3000/admin.html
API:    http://localhost:3000/api

Prerequisites

• Node.js v14+
• npm v6+
• SQLite3 (included with Node)
• MongoDB (optional)

Installation

# Clone repository
git clone https://github.com/DHANUSHGCODE/EcommerceHub-Pro.git
cd EcommerceHub-Pro

# Install dependencies
npm install

# Setup environment
cp .env.example .env

# Initialize database
node database.js

# Start development server
npm start

Server runs on http://localhost:3000

📖 Documentation

• SETUP.md - Complete setup guide with all URLs and API documentation
• API Documentation - Endpoint reference
• Database Setup - Database configuration

🏗️ Project Structure

EcommerceHub-Pro/
├── public/
│   ├── index.html              # Main store page
│   ├── admin.html              # Admin dashboard  
│   ├── styles/
│   │   ├── main.css            # Animated styles
│   │   └── js/
│   │       ├── main.js         # Store functionality
│   │       └── admin.js        # Admin functionality
│   └── images/                 # Product images
├── database.js                 # Database config
├── package.json                # Dependencies
├── .env.example                # Environment template
├── README.md                   # This file
└── SETUP.md                    # Detailed setup guide

💻 Technology Stack

Frontend

• HTML5
• CSS3 (with animations)
• JavaScript ES6+
• Responsive Design

Backend

• Node.js
• Express.js
• RESTful API
• JWT Authentication

Database

• SQLite (local)
• MongoDB (cloud - optional)
• Mongoose ODM

Tools & Services

• Git & GitHub
• npm
• Postman

🔐 Security Features

• ✅ JWT Token Authentication
• ✅ Password Hashing (bcrypt)
• ✅ CORS Protection
• ✅ SQL Injection Prevention
• ✅ XSS Protection
• ✅ HTTPS Ready
• ✅ Rate Limiting

👤 Admin Login

Email:    admin@ecommercehub.com
Password: admin123

📊 API Endpoints

Products

GET    /api/products           # Get all products
GET    /api/products/:id       # Get single product
POST   /api/products           # Create product (admin)
PUT    /api/products/:id       # Update product (admin)
DELETE /api/products/:id       # Delete product (admin)

Cart

GET    /api/cart               # Get cart
POST   /api/cart               # Add to cart
PUT    /api/cart/:id           # Update item quantity
DELETE /api/cart/:id           # Remove from cart

Orders

GET    /api/orders             # Get orders (admin)
POST   /api/orders             # Create order
GET    /api/orders/:id         # Get order details

🎯 Key Files

File	Purpose
public/index.html	Main store page with responsive layout
public/admin.html	Professional admin dashboard
public/styles/main.css	Global styles with animations
public/styles/js/main.js	EcommerceApp class (product & cart management)
public/styles/js/admin.js	AdminPanel class (admin functionality)
database.js	Database configuration & initialization
package.json	Project dependencies

📈 Performance

• Optimized animations
• Lazy loading
• Local storage caching
• Minified assets (production)
• GZIP compression ready

🐛 Troubleshooting

Port Already in Use

# Change port in .env
PORT=3001

Database Connection Error

rm data/ecommerce.db
node database.js

Missing Dependencies

npm install
npm audit fix

For detailed troubleshooting, see SETUP.md

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

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

📄 License

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

👨‍💼 Author

DHANUSHGCODE

• GitHub: @DHANUSHGCODE
• Email: your-email@example.com

🙏 Acknowledgments

• Professional animated UI design
• RESTful API architecture
• Security best practices
• Database optimization

📞 Support

For support, email support@ecommercehub.com or open an issue

🔗 Links

• GitHub Repository
• Issues
• Setup Guide
• License

---

Last Updated: December 13, 2025 Version: 1.0.0 Status: ✅ Production Ready