Computer hardware e-commerce platform featuring virtual PC assembly simulation 🪛

• About The Project
  • Showcase
  • Features
  • Built With
• Getting Started
  • Folder Structure
  • Pre-requisites
  • Installation
  • Setting Up
• Roadmap
• Contributing
• License
• Acknowledgements

PCBUILD3R aims to elevate hardware proficiency through 3D simulation and comprehensive guideline on PC building. It offers features such as 3D simulation, hardware browsing, rewards redemption, inventory management and more. Disclaimer: This is a website used for the purpose of Final Year Project (FYP). This project was generated with Angular CLI version 17.0.8.

Homepage	Simulation Intro	Simulation	Shop

Product Detail	Shopping Cart	Admin Dashboard	Manage Inventory

• Stey By Step Virtual PC Assembling Simulation
• Rewards Redemption
• Hardware Product Browsing
• Manage Shopping Cart
• View Order History & Leave Product Rating
• Inventory Management

To get started, you first need to understand the project folder structure for installations.

├── DB Dump                      # MongoDB Dummy Schema Document
├── backend                      # Node JS, MongoDB and Express JS server folder
├── src                          # Angular website folder with 3D model and image assets
├── .editorconfig
├── .gitignore
├── README.md
└── LICENSE

Make sure that you have the following prerequisites installed

• MongoDB Compass
• Node.js

1. Create an free API Key at Resend
2. Clone the repo and install dependencies for front end (angular project)

   git clone https://github.com/Vincexodus/PCBuild3R.git && cd PCBUILD3R && npm install

3. Locate to backend directory and install dependencies

   cd backend
   npm i # /backend

4. Replace your resend API key in .env.local of /backend directory. Rename the file to .env

   const RESEND_API_KEY='your_resend_api_key';

1. In root directory, run ng serve, navigate to http://localhost:4200/. The application will automatically reload if you change any of the source files.
2. Open a new IDE window, locate to backend directory and run nodemon app.js. Backend is ready when Connected to MongoDB successfully... is shown in terminal.
3. Open MongoDB Compass and navigate to users collection of PCBUILD3R database to import data. In users collection, add data >> Import JSON or CSV file >> PCBUILD3R.users.json. The json file is located in /DB Dump.
4. Imported admin email admin@gmail.com, password admin123. Customer email customer1@gmail.com, password customer1. Repeat Step 3 for productCategory and product collection.

• Implement wishlist feature

See the open issues for a full list of proposed features (and known issues).

Any contributions are greatly appreciated. If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/newFeature)
3. Commit your Changes (git commit -m 'Add some newFeature')
4. Push to the Branch (git push origin feature/newFeature)
5. Open a Pull Request

Distributed under the MIT License. See LICENSE for more information.

I've included a few materials that have helped me complete this project

• Build a Task Manager Application From Scratch
• 3D Models From SketchFab
• Click and Drag 3d models in ThreeJS
• Best-README-Template