Mongo Eval

README.md

@@ -1,5 +1,80 @@
-## Product List
+# Product List
 
+This project is a full-stack e-commerce site built using MongoDB, Node.js, React, and Redux.
+
+## Data
+
+The data was generated using [faker](https://fakerjs.dev/) and is stored locally using MongoDB Community
+
+## Server
+
+The following routes are supported:
+
+```
+GET /products
+GET /products/count
+GET /products/:productId
+GET /products/:productId/reviews
+POST /products
+POST /products/:productId/reviews
+DELETE /products/:productId
+DELETE /reviews/:reviewId
+```
+
+## Frontend
+
+The frontend currently supports the /products route, which includes options for filtering, sorting, and searching products.
+
+## Getting Started
+
+### Prerequisites
+
+- Node.js (version 14 or above)
+- npm
+- MongoDB Community Edition - follow installation guidelines for your system [here](https://www.mongodb.com/docs/manual/administration/install-community/#std-label-install-mdb-community-edition)
+- MongoDB Compass GUI - follow download instructions [here](https://www.mongodb.com/docs/compass/current/install/)
+
+### Installation
+
+1. Clone the repository:
+
+   ```bash
+   git clone https://github.com/acl13/product-list.git
+   cd product-list
+   ```
+
+2. Install dependencies:
+
+   ```bash
+   npm install
+   ```
+
+### Starting the Server & Populating Data
+
+Start the server and connect to MongoDB
+
+```bash
+ node server.js
+```
+
+- Ensure connection string in server.js matches the connection string in MongoDB Compass
+- Navigate to localhost:8000/generate-fake-data to populate the database
+  (This will add 90 random products to the database - it is recommended to only complete this step once or twice)
+- Use MongoDB Compass to check that your data is populating correctly
+
+### Displaying Frontend
+
+While the server is running, open a separate command line tab and run the following code to view the frontend
+
+```bash
+ cd frontend/product-list
+ npm run build
+ npm run start
+```
+
+Navigate to http://localhost:3000 to view in browser
+
+---
 
 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.
 

frontend/product-list/.gitignore

@@ -0,0 +1,41 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.*
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/versions
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# env files (can opt-in for committing if needed)
+.env*
+
+# vercel
+.vercel
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts

frontend/product-list/README.md

@@ -0,0 +1,36 @@
+This is a [Next.js](https://nextjs.org) project bootstrapped with [`create-next-app`](https://nextjs.org/docs/app/api-reference/cli/create-next-app).
+
+## Getting Started
+
+First, run the development server:
+
+```bash
+npm run dev
+# or
+yarn dev
+# or
+pnpm dev
+# or
+bun dev
+```
+
+Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
+
+You can start editing the page by modifying `app/page.js`. The page auto-updates as you edit the file.
+
+This project uses [`next/font`](https://nextjs.org/docs/app/building-your-application/optimizing/fonts) to automatically optimize and load [Geist](https://vercel.com/font), a new font family for Vercel.
+
+## Learn More
+
+To learn more about Next.js, take a look at the following resources:
+
+- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
+- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
+
+You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js) - your feedback and contributions are welcome!
+
+## Deploy on Vercel
+
+The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.
+
+Check out our [Next.js deployment documentation](https://nextjs.org/docs/app/building-your-application/deploying) for more details.

frontend/product-list/app/components/ProductCard.js

@@ -0,0 +1,26 @@
+"use client";
+import Image from "next/image";
+
+const ProductCard = ({ category, name, price, image }) => {
+  return (
+    <div className="border p-5 m-2">
+      <div className="d-flex justify-content-between">
+        <div>Category: {category}</div>
+        <div>{price}</div>
+      </div>
+      <div className="d-flex flex-column align-items-center">
+        <Image
+          src={image}
+          alt="Product Placeholder Image"
+          width={200}
+          height={300}
+          unoptimized
+          onError={(e) => (e.target.src = "https://prd.place/400")}
+        />
+        <h1>{name}</h1>
+      </div>
+    </div>
+  );
+};
+
+export default ProductCard;

frontend/product-list/app/components/SearchBar.js

@@ -0,0 +1,21 @@
+const SearchBar = ({ onChange, onSearch }) => {
+  return (
+    <>
+      <input
+        type="text"
+        placeholder="Search products..."
+        className="form-control my-2"
+        onChange={(event) => onChange(event.target.value)}
+      ></input>
+      <button
+        type="button"
+        className="btn btn-outline-primary m-2"
+        onClick={onSearch}
+      >
+        Search
+      </button>
+    </>
+  );
+};
+
+export default SearchBar;

frontend/product-list/app/components/SortDropdown.js

@@ -0,0 +1,20 @@
+const SortDropdown = ({ name, id, options, onChange }) => {
+  return (
+    <select
+      name={name}
+      id={id}
+      className="form-control form-select w-15 m-2"
+      onChange={(event) => onChange(event.target.value)}
+    >
+      {options.map((option) => {
+        return (
+          <option value={option.value} key={option.value}>
+            {option.label}
+          </option>
+        );
+      })}
+    </select>
+  );
+};
+
+export default SortDropdown;

frontend/product-list/app/globals.css

@@ -0,0 +1,42 @@
+:root {
+  --background: #ffffff;
+  --foreground: #171717;
+}
+
+@media (prefers-color-scheme: dark) {
+  :root {
+    --background: #0a0a0a;
+    --foreground: #ededed;
+  }
+}
+
+html,
+body {
+  max-width: 100vw;
+  overflow-x: hidden;
+}
+
+body {
+  color: var(--foreground);
+  background: var(--background);
+  font-family: Arial, Helvetica, sans-serif;
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+}
+
+* {
+  box-sizing: border-box;
+  padding: 0;
+  margin: 0;
+}
+
+a {
+  color: inherit;
+  text-decoration: none;
+}
+
+@media (prefers-color-scheme: dark) {
+  html {
+    color-scheme: dark;
+  }
+}

frontend/product-list/app/layout.js

@@ -0,0 +1,26 @@
+"use client";
+import { Geist, Geist_Mono } from "next/font/google";
+import "./globals.css";
+import "bootstrap/dist/css/bootstrap.css";
+import { Provider } from "react-redux";
+import store from "./store/configureStore";
+
+const geistSans = Geist({
+  variable: "--font-geist-sans",
+  subsets: ["latin"],
+});
+
+const geistMono = Geist_Mono({
+  variable: "--font-geist-mono",
+  subsets: ["latin"],
+});
+
+export default function RootLayout({ children }) {
+  return (
+    <html lang="en">
+      <body className={`${geistSans.variable} ${geistMono.variable}`}>
+        <Provider store={store}>{children}</Provider>
+      </body>
+    </html>
+  );
+}