🎧 Audify

Premium Audio E-Commerce Platform

Overview • Architecture • Tech Stack • Features • Structure • Configuration

📖 Overview

Audify is a full-featured e-commerce platform specialized in premium audio products. Built with modern web technologies, it provides a seamless shopping experience with robust authentication, dynamic product management, and secure payment integration.

✨ Key Highlights

Multi-Role Access: Separate interfaces for administrators and customers with role-based access control
Secure Authentication: Google OAuth2 integration with traditional email/password authentication
Advanced Shopping Cart: Real-time cart management with discount calculations
Flexible Payment Options: Razorpay integration, Wallet, and Cash on Delivery (COD)
Smart Promotions: Dynamic coupon and offer management system
Digital Wallet: Built-in wallet system with transaction history
Comprehensive Admin Panel: Product, category, order, user, and sales management

🏛 Architecture

Audify follows a Layered MVC Architecture with clear separation of concerns, ensuring maintainability and scalability.

graph TD
    %% Client Layer
    Client[🌐 Client Browser] -->|HTTP Requests| Router[Express Router]

    %% Routing Layer
    Router --> UserRoutes[User Routes]
    Router --> AdminRoutes[Admin Routes]
    Router --> ShopRoutes[Shop Routes]
    Router --> CheckoutRoutes[Checkout Routes]

    %% Middleware Layer
    subgraph Middleware ["🛡️ Middleware Layer"]
        direction TB
        Auth[Authentication]
        RateLimit[Rate Limiting]
        Validation[Request Validation]
        ErrorHandler[Error Handler]
        XSS[XSS Protection]
    end

    UserRoutes --> Middleware
    AdminRoutes --> Middleware
    ShopRoutes --> Middleware
    CheckoutRoutes --> Middleware

    %% Controller Layer
    subgraph Controllers ["🎮 Controller Layer"]
        direction TB
        AuthCtrl[Auth Controller]
        ProductCtrl[Product Controller]
        CartCtrl[Cart Controller]
        OrderCtrl[Order Controller]
        CouponCtrl[Coupon Controller]
        PaymentCtrl[Payment Controller]
        AdminCtrl[Admin Controllers]
    end

    Middleware --> Controllers

    %% Service Layer
    subgraph Services ["⚙️ Service Layer"]
        direction TB
        AuthService[Auth Service]
        ProductService[Product Service]
        CartService[Cart Service]
        OrderService[Order Service]
        CouponService[Coupon Service]
        PaymentService[Payment Service]
        UploadService[Upload Service]
    end

    Controllers --> Services

    %% Data Layer
    subgraph DataLayer ["💾 Data Access Layer"]
        direction TB
        UserModel[(User Model)]
        ProductModel[(Product Model)]
        OrderModel[(Order Model)]
        CartModel[(Cart Model)]
        CouponModel[(Coupon Model)]
    end

    Services --> DataLayer

    %% External Services
    subgraph External ["🔌 External Services"]
        direction TB
        MongoDB[(MongoDB Database)]
        Cloudinary[Cloudinary CDN]
        Razorpay[Razorpay Gateway]
        GoogleAuth[Google OAuth2]
        EmailService[Nodemailer]
    end

    DataLayer --> MongoDB
    UploadService -.->|Image Upload| Cloudinary
    PaymentService -.->|Payment| Razorpay
    AuthService -.->|OAuth| GoogleAuth
    AuthService -.->|Notifications| EmailService

    %% Styling
    classDef default fill:none,stroke:#30363d,stroke-width:1px,color:#c9d1d9;
    classDef client fill:#388bfd26,stroke:#388bfd,stroke-width:2px,color:#c9d1d9,rx:5,ry:5;
    classDef routing fill:#388bfd26,stroke:#388bfd,stroke-width:2px,color:#c9d1d9,rx:5,ry:5;
    classDef controller fill:#2386362e,stroke:#2ea043,stroke-width:2px,color:#c9d1d9,rx:5,ry:5;
    classDef service fill:#d2992226,stroke:#d29922,stroke-width:2px,color:#c9d1d9,rx:5,ry:5;
    classDef data fill:#f8514926,stroke:#f85149,stroke-width:2px,color:#c9d1d9,rx:5,ry:5;
    classDef external fill:#9e6a0326,stroke:#9e6a03,stroke-width:2px,color:#c9d1d9,rx:5,ry:5;

    class Client client;
    class Router,UserRoutes,AdminRoutes,ShopRoutes,CheckoutRoutes routing;
    class AuthCtrl,ProductCtrl,CartCtrl,OrderCtrl,CouponCtrl,PaymentCtrl,AdminCtrl controller;
    class AuthService,ProductService,CartService,OrderService,CouponService,PaymentService,UploadService service;
    class UserModel,ProductModel,OrderModel,CartModel,CouponModel data;
    class MongoDB,Cloudinary,Razorpay,GoogleAuth,EmailService external;

    style Middleware fill:#1b1e23ff,stroke:#388bfd,stroke-width:2px,rx:10,ry:10
    style Controllers fill:#1b1e23ff,stroke:#2ea043,stroke-width:2px,rx:10,ry:10
    style Services fill:#1b1e23ff,stroke:#d29922,stroke-width:2px,rx:10,ry:10
    style DataLayer fill:#1b1e23ff,stroke:#f85149,stroke-width:2px,rx:10,ry:10
    style External fill:#1b1e23ff,stroke:#9e6a03,stroke-width:2px,rx:10,ry:10

🧠 Design Patterns

MVC Architecture: Clear separation between Models, Views, and Controllers
Service Layer Pattern: Business logic encapsulated in reusable service classes
Middleware Pattern: Request processing pipeline for authentication, validation, and error handling
Repository Pattern: Data access abstraction through Mongoose models

🛠 Technology Stack

Backend

Category	Technology	Description
Runtime		JavaScript runtime environment
Framework		Fast, minimalist web framework for Node.js
Database		NoSQL document database
ODM	Mongoose	Elegant MongoDB object modeling for Node.js
Template Engine		Embedded JavaScript templating
Authentication	Passport.js + Google OAuth2	Authentication middleware with OAuth support
Session	express-session	Session management middleware
Security	bcrypt + xss-clean	Password hashing and XSS protection

Third-Party Integrations

Service	Technology	Purpose
Payment Gateway		Secure online payment processing
Cloud Storage		Image upload and CDN
Email Service	Nodemailer	Transactional email delivery
PDF Generation	PDFKit + jsPDF	Invoice and report generation

Development Tools

Tool	Technology	Purpose
Linter	ESLint	Code quality and style checking
Formatter	Prettier	Code formatting
Development Server	Nodemon	Auto-restart on file changes
Logger	Winston	Application logging
Validation	express-validator	Request data validation
Rate Limiting	express-rate-limit	API rate limiting protection
Git Hooks	Husky	Automated pre-commit checks
Staged Linting	lint-staged	Run linters on staged files only

✨ Features

🛒 Customer Features

Authentication & Account Management

✅ User registration with email/password
✅ Google OAuth2 social login
✅ Secure password hashing with bcrypt
✅ Session-based authentication
✅ Account status management (Active/Inactive)
✅ Profile management with personal details

Shopping Experience

✅ Product Browse & Search: Explore audio products with detailed descriptions
✅ Product Filtering: Filter by category, price, and availability
✅ Wishlist Management: Save products for later
✅ Shopping Cart: Real-time cart updates with quantity management
✅ Multiple Addresses: Save and manage multiple delivery addresses
✅ Stock Validation: Real-time stock availability checks

Checkout & Payments

✅ Multiple Payment Methods:
- Razorpay online payment gateway
- Digital wallet
- Cash on Delivery (COD)
✅ Coupon System: Apply discount coupons at checkout
✅ Dynamic Pricing: Automatic discount and offer calculations
✅ Order Confirmation: Email notifications on successful order placement

Digital Wallet

✅ Wallet balance management
✅ Credit/Debit transaction tracking
✅ Transaction history with descriptions

Order Management

✅ Order tracking with status updates
✅ Order history with detailed information
✅ Order cancellation with automatic refunds to wallet
✅ Invoice generation (PDF download)

🔐 Admin Features

Dashboard & Analytics

✅ Sales Dashboard: Visual sales analytics with Chart.js
✅ Sales Reports: Generate reports by day, week, month, year, or custom date range
✅ Report Export: Download reports as PDF or Excel
✅ Revenue Tracking: Monitor total revenue and order statistics

Product Management

✅ CRUD Operations: Create, Read, Update, Delete products
✅ Image Management: Upload product images via Cloudinary
✅ Stock Management: Track and update product inventory
✅ Product Activation: Enable/disable product visibility
✅ Category Association: Link products to specific categories

Category Management

✅ Category CRUD: Full category lifecycle management
✅ Category-based Organization: Organize products by audio categories

Order Management

✅ Order Overview: View all customer orders
✅ Status Updates: Update order status (Pending → Processed → Shipped → Delivered)
✅ Order Cancellation: Process order cancellations

User Management

✅ User Listing: View all registered customers
✅ Account Control: Block/Unblock user accounts
✅ User Activity Monitoring: Track user status and activity

Promotions & Marketing

✅ Coupon Management:
- Create discount coupons (percentage or fixed amount)
- Set minimum cart value requirements
- Define validity periods
- Usage limit controls
- Track coupon usage by users
✅ Offer Management:
- Product-specific offers
- Category-wide offers
- Referral bonuses
- Dynamic discount calculations

🛡️ Security Features

✅ XSS Protection: Input sanitization with xss-clean
✅ Rate Limiting: Protection against brute-force attacks
✅ Secure Sessions: HTTP-only cookies with secure flags
✅ Password Security: bcrypt hashing with salt rounds
✅ Input Validation: express-validator for request validation
✅ Error Handling: Centralized error handling middleware

📂 Project Structure

audify-ejs/
├── src/
│   ├── config/               # ⚙️ Configuration files
│   │   ├── cloudinary.js     # Cloudinary setup
│   │   ├── database.js       # MongoDB connection
│   │   ├── logger.js         # Winston logger configuration
│   │   └── razorpay.js       # Razorpay payment gateway
│   │
│   ├── constants/            # 📌 Application constants
│   │   └── statusCodes.js    # HTTP status code constants
│   │
│   ├── controllers/          # 🎮 Route handlers
│   │   ├── admin/            # Admin-specific controllers
│   │   │   ├── adminAuthController.js
│   │   │   ├── couponManagementController.js
│   │   │   ├── offerManagementController.js
│   │   │   ├── orderManagementController.js
│   │   │   ├── salesReportController.js
│   │   │   └── userManagementController.js
│   │   ├── accountController.js
│   │   ├── authController.js
│   │   ├── cartController.js
│   │   ├── categoryController.js
│   │   ├── checkoutController.js
│   │   ├── couponController.js
│   │   ├── orderController.js
│   │   ├── paymentController.js
│   │   ├── productController.js
│   │   └── shopController.js
│   │
│   ├── middleware/           # 🛡️ Custom middleware
│   │   ├── validators/       # Validation schemas
│   │   ├── adminAuth.js      # Admin authentication
│   │   ├── errorHandler.js   # Error handling
│   │   ├── multer.js         # File upload configuration
│   │   ├── rateLimiter.js    # Rate limiting rules
│   │   ├── requestLogger.js  # Request logging
│   │   └── userAuth.js       # User authentication
│   │
│   ├── models/               # 🗄️ Mongoose schemas
│   │   ├── address.js        # Address schema
│   │   ├── adminModel.js     # Admin user schema
│   │   ├── cart.js           # Shopping cart schema
│   │   ├── categories.js     # Category schema
│   │   ├── coupon.js         # Coupon schema
│   │   ├── offer.js          # Offer schema
│   │   ├── order.js          # Order schema
│   │   ├── orderItem.js      # Order item schema
│   │   ├── products.js       # Product schema
│   │   └── userModel.js      # User schema
│   │
│   ├── routes/               # 🛣️ API route definitions
│   │   ├── accountRoutes.js  # User account routes
│   │   ├── adminRoutes.js    # Admin panel routes
│   │   ├── categoryRoutes.js # Category routes
│   │   ├── checkoutRoutes.js # Checkout flow routes
│   │   ├── index.js          # Main router
│   │   ├── productRoutes.js  # Product routes
│   │   ├── shopRoutes.js     # Shopping routes
│   │   └── userRoutes.js     # User authentication routes
│   │
│   ├── services/             # 🧠 Business logic layer
│   │   ├── accountService.js # Account operations
│   │   ├── authService.js    # Authentication logic
│   │   ├── cartService.js    # Cart operations
│   │   ├── categoryService.js# Category operations
│   │   ├── couponService.js  # Coupon validation & application
│   │   ├── offerService.js   # Offer calculations
│   │   ├── orderService.js   # Order processing
│   │   ├── passport.js       # Passport strategy configuration
│   │   ├── paymentService.js # Payment processing
│   │   ├── productService.js # Product operations
│   │   └── uploadService.js  # Cloudinary image uploads
│   │
│   ├── views/                # 🎨 EJS templates
│   │   ├── admin/            # Admin panel views
│   │   ├── user/             # Customer-facing views
│   │   └── partials/         # Reusable view components
│   │
│   ├── public/               # 📁 Static assets
│   │   ├── css/              # Stylesheets
│   │   ├── js/               # Client-side JavaScript
│   │   └── images/           # Static images
│   │
│   ├── app.js                # 🚀 Express app configuration
│   └── server.js             # 🏁 Server entry point
│
├── .env                      # 🔐 Environment variables (not in repo)
├── .env.example              # 📝 Environment template
├── .eslintrc.json            # ESLint configuration
├── .prettierrc               # Prettier configuration
├── .gitignore                # Git ignore rules
├── package.json              # Node.js dependencies
└── README.md                 # This file

⚙️ Configuration

📦 Installation

Clone the repository:

git clone https://github.com/ijas9118/audify-ejs.git
cd audify-ejs

Install dependencies:
```
npm install
```
Set up environment variables:
```
cp .env.example .env
```

🔑 Environment Variables

Copy .env.example to .env and configure the following variables:

Variable	Description	Example
`MONGO_URI`	MongoDB connection string	`mongodb://localhost:27017/audify`
`PORT`	Server port	`3000`
`SESSION_SECRET`	Secret key for session encryption	Generate with: `openssl rand -base64 32`
`NODE_ENV`	Application environment	`development` or `production`
`CLOUDINARY_CLOUD_NAME`	Cloudinary cloud name	Get from Cloudinary dashboard
`CLOUDINARY_API_KEY`	Cloudinary API key	Get from Cloudinary dashboard
`CLOUDINARY_API_SECRET`	Cloudinary API secret	Get from Cloudinary dashboard
`RAZORPAY_KEY_ID`	Razorpay key ID for payments	Get from Razorpay dashboard
`RAZORPAY_SECRET`	Razorpay secret key	Get from Razorpay dashboard
`GOOGLE_CLIENT_ID`	Google OAuth2 client ID	Get from Google Cloud Console
`GOOGLE_CLIENT_SECRET`	Google OAuth2 client secret	Get from Google Cloud Console
`EMAIL_USER`	Email address for Nodemailer	SMTP email address
`EMAIL_PASS`	Email password/app password	SMTP password

🚀 Running the Application

Development mode (with auto-restart):

npm run dev

Production mode:

npm start

Linting:

npm run lint        # Check for issues
npm run lint:fix    # Auto-fix issues

Code formatting:

npm run format

The application will be available at http://localhost:3000 (or your configured PORT).

🗺️ User Flows

Customer Journey

graph LR
    Start([Visit Site]) --> Browse[Browse Products]
    Browse --> Login{Logged In?}
    Login -->|No| Auth[Sign Up / Login]
    Login -->|Yes| Cart[Add to Cart]
    Auth --> Cart
    Cart --> Checkout[Checkout]
    Checkout --> Payment[Select Payment]
    Payment --> Order[Order Placed]
    Order --> Track[Track Order]

    style Start fill:#388bfd26,stroke:#388bfd
    style Auth fill:#d2992226,stroke:#d29922
    style Order fill:#2386362e,stroke:#2ea043
    style Track fill:#f8514926,stroke:#f85149

Admin Workflow

graph LR
    AdminLogin([Admin Login]) --> Dashboard[Dashboard]
    Dashboard --> Products[Manage Products]
    Dashboard --> Orders[Manage Orders]
    Dashboard --> Users[Manage Users]
    Dashboard --> Reports[Sales Reports]
    Dashboard --> Promotions[Coupons & Offers]

    Products --> CRUD[Create/Update/Delete]
    Orders --> Status[Update Status]
    Users --> Block[Block/Unblock]
    Reports --> Export[Export PDF/Excel]
    Promotions --> CreateOffer[Create Offers]

    style AdminLogin fill:#388bfd26,stroke:#388bfd
    style Dashboard fill:#2386362e,stroke:#2ea043
    style Reports fill:#d2992226,stroke:#d29922
    style Promotions fill:#f8514926,stroke:#f85149

📄 License

This project is licensed under the MIT License.

Made with ❤️ for audio enthusiasts

Name		Name	Last commit message	Last commit date
Latest commit History 138 Commits
.github/workflows		.github/workflows
src		src
.commitlintrc.json		.commitlintrc.json
.dockerignore		.dockerignore
.env.example		.env.example
.eslintignore		.eslintignore
.eslintrc.json		.eslintrc.json
.gitignore		.gitignore
.prettierignore		.prettierignore
.prettierrc		.prettierrc
Dockerfile		Dockerfile
LICENSE		LICENSE
README.md		README.md
package-lock.json		package-lock.json
package.json		package.json

Folders and files

Latest commit

History

Repository files navigation

🎧 Audify

📖 Overview

✨ Key Highlights

🏛 Architecture

🧠 Design Patterns

🛠 Technology Stack

Backend

Third-Party Integrations

Development Tools

✨ Features

🛒 Customer Features

Authentication & Account Management

Shopping Experience

Checkout & Payments

Digital Wallet

Order Management

🔐 Admin Features

Dashboard & Analytics

Product Management

Category Management

Order Management

User Management

Promotions & Marketing

🛡️ Security Features

📂 Project Structure

⚙️ Configuration

📦 Installation

🔑 Environment Variables

🚀 Running the Application

🗺️ User Flows

Customer Journey

Admin Workflow

📄 License

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Uh oh!

Contributors

Uh oh!

Languages