39647-vm/backend

Mom's Web - Backend Setup Guide

Project Structure

backend/
├── models/              # Database models (User, Product, Order, etc.)
├── routes/              # API route definitions
├── controllers/         # Business logic and request handlers
├── config/              # Configuration files (database, payment gateways)
├── middleware/          # Custom middleware (auth, validation, error handling)
├── package.json         # Node.js dependencies
├── server.js            # Main server entry point
├── .env.example         # Environment variables template
└── README.md            # This file

Getting Started

1. Prerequisites

• Node.js (v14 or higher)
• npm or yarn
• MongoDB or PostgreSQL

2. Installation

# Navigate to backend directory
cd backend

# Install dependencies
npm install

3. Environment Setup

# Copy the example .env file
cp .env.example .env

# Edit .env and add your configuration:
# - Database URL
# - JWT Secret
# - Email credentials
# - Payment gateway keys

4. Run the Server

# Development (with auto-reload using nodemon)
npm run dev

# Production
npm start

The server will start on http://localhost:5000

Website Sections Overview

This backend supports all 12 sections of the website design:

1. Project Setup ✓ (Current)
2. User Authentication & Authorization
3. User Management
4. Product/Service Management
5. Shopping Cart & Checkout
6. Payment Processing
7. Order Management
8. Email & Notifications
9. Admin Dashboard
10. Search & Filtering
11. Reviews & Ratings
12. API Documentation & Security

API Endpoints (To be implemented)

Authentication

• POST /api/auth/register - Register new user
• POST /api/auth/login - User login
• POST /api/auth/logout - User logout
• POST /api/auth/refresh-token - Refresh JWT token

Users

• GET /api/users/:id - Get user profile
• PUT /api/users/:id - Update user profile
• DELETE /api/users/:id - Delete user account

Products

• GET /api/products - Get all products
• GET /api/products/:id - Get product details
• POST /api/products - Create product (Admin)
• PUT /api/products/:id - Update product (Admin)
• DELETE /api/products/:id - Delete product (Admin)

Orders

• GET /api/orders - Get user orders
• POST /api/orders - Create order
• GET /api/orders/:id - Get order details
• PUT /api/orders/:id - Update order status (Admin)

Cart

• GET /api/cart - Get cart
• POST /api/cart/add - Add item to cart
• PUT /api/cart/update - Update cart item
• DELETE /api/cart/remove/:id - Remove item from cart

Reviews

• GET /api/reviews/:productId - Get product reviews
• POST /api/reviews - Create review
• DELETE /api/reviews/:id - Delete review

Next Steps

1. Connect to database (MongoDB or PostgreSQL)
2. Implement user authentication models and routes
3. Create product management system
4. Set up payment gateway integration
5. Implement order management
6. Add email notification service
7. Create admin dashboard endpoints
8. Set up search and filtering
9. Implement reviews and ratings
10. Add comprehensive API documentation
11. Implement security measures (rate limiting, input validation)
12. Deploy to production

Troubleshooting

Port already in use

Change the PORT in .env file

Database connection error

Check DATABASE_URL in .env and ensure MongoDB/PostgreSQL is running

Module not found error

Run npm install again

Support

For issues or questions, refer to the main WEBSITE_DESIGN.md file in the root directory.