Express & Mongo Eval

.gitignore

@@ -0,0 +1,67 @@
+# ----------------------
+# GENERAL IGNORE RULES
+# ----------------------
+
+# Dependencies
+node_modules/
+frontend/node_modules/
+backend/node_modules/
+.pnp
+.pnp.*
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/versions
+
+# Testing
+coverage/
+
+# Logs
+logs/
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+# ----------------------
+# NEXT.JS FRONTEND
+# ----------------------
+
+# Next.js build output
+frontend/.next/
+frontend/out/
+
+# Production build
+frontend/build/
+
+# Next.js env files (opt-in if needed)
+frontend/.env*
+
+# Next.js specific files
+frontend/.vercel
+frontend/next-env.d.ts
+frontend/*.tsbuildinfo
+
+# ----------------------
+# EXPRESS BACKEND
+# ----------------------
+
+# Build output
+backend/dist/
+backend/build/
+
+# Backend env files
+backend/.env
+
+# Debugging
+backend/debug.log
+backend/.eslintcache
+
+# ----------------------
+# MISC
+# ----------------------
+
+.DS_Store
+*.pem

README.md

@@ -1,6 +1,55 @@
 ## Product List
 
+This project was created by a student at Parsity, an online software engineering course. The work in this repository is wholly the student's, based on a sample starter project that can be accessed by viewing the repository this project was forked from.
 
-This project has been created by a student at Parsity, an online software engineering course. The work in this repository is wholly of the student based on a sample starter project that can be accessed by looking at the repository that this project forks.
+If you have any questions about this project or the program, visit [parsity.io](https://parsity.io/) or email hello@parsity.io.
 
-If you have any questions about this project or the program in general, visit [parsity.io](https://parsity.io/) or email hello@parsity.io.
+---
+
+**Product List** is a basic mock e-commerce webpage for displaying and filtering available products for purchase. The backend server supports `GET`, `POST`, and `DELETE` requests for products and reviews. (Note: the frontend currently only makes use of the `GET /products` route.)
+
+This project uses **MongoDB** for data storage, with **Mongoose** to interact with the database on the backend. The frontend is built using **React** and **Next.js**.
+
+---
+
+### Getting Started
+
+1. **Install MongoDB** to host a local database.  
+   [MongoDB Installation Guide](https://www.mongodb.com/docs/manual/installation/)
+
+2. **Start the backend server** from the root directory:
+
+```bash
+node backend/server.js
+```
+
+3. Populate your database by sending a GET request to:
+
+```bash
+http://localhost:8000/generate-fake-data?number=<your-number>
+```
+
+If no number is provided, the server will default to generating 100 products.
+
+4. Start the frontend development server. From the /frontend directory, run:
+
+```bash
+npm run dev
+# or
+yarn dev
+# or
+pnpm dev
+# or
+bun dev
+```
+
+5. Navigate to '<your-frontend-development-server>/products — this will automatically route to '/products?page=1'.
+
+Products are displayed 9 at a time, with pagination at the bottom of the page. You can search by name, filter by category, and sort by highest or lowest price.
+
+Tech Stack
+
+- MongoDB + Mongoose
+- Node.js + Express
+- React + Next.js
+- Tailwind CSS

backend/middleware/validatePageFormat.js

@@ -0,0 +1,18 @@
+const validatePageFormat = (req, res, next) => {
+  // If no page parameter is provided, ignore the page property
+  if (!req.query.page) {
+    req.page = null;
+    return next();
+  }
+
+  const page = parseInt(req.query.page);
+
+  if (isNaN(page) || page < 1) {
+    return res.status(400).json({ message: "Valid 'page' parameter required" });
+  }
+
+  req.page = page;
+  next();
+};
+
+export default validatePageFormat;

backend/middleware/validateProduct.js

@@ -0,0 +1,19 @@
+import { Product } from "../models/product.js";
+import mongoose from "mongoose";
+
+// Middlware for routes that need to get a specific product
+const validateProduct = async (req, res, next) => {
+  const { productId } = req.params;
+  if (!mongoose.Types.ObjectId.isValid(productId)) {
+    return res.status(400).json({ message: "Invalid product ID format" });
+  }
+
+  const product = await Product.findById(req.params.productId);
+
+  if (!product) return res.status(404).json({ message: "Product not found" });
+
+  req.product = product;
+  next();
+};
+
+export default validateProduct;

backend/models/product.js

@@ -0,0 +1,19 @@
+import mongoose from "mongoose";
+
+const productSchema = new mongoose.Schema({
+  category: { type: String, required: true },
+  name: { type: String, required: true },
+  price: { type: Number, required: true },
+  image: String,
+  reviews: [{ type: mongoose.Schema.Types.ObjectId, ref: "Review" }],
+});
+
+const reviewSchema = new mongoose.Schema({
+  userName: String,
+  product: { type: mongoose.Schema.Types.ObjectId, ref: "Product" },
+  text: String,
+});
+
+export const Product = mongoose.model("Product", productSchema);
+
+export const Review = mongoose.model("Review", reviewSchema);