Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/vijethph/placementcell

A MERN Stack App that provides a company recruitment preparation portal for students.
https://github.com/vijethph/placementcell

express mongodb nodejs react typescript vitejs

Last synced: 11 days ago
JSON representation

A MERN Stack App that provides a company recruitment preparation portal for students.

Awesome Lists containing this project

README

        

[![Status](https://img.shields.io/badge/status-active-success.svg?style=flat-square&logo=react)]()
[![GitHub issues](https://img.shields.io/github/issues/vijethph/PlacementCell?style=flat-square)](https://github.com/vijethph/PlacementCell/issues)
[![Contributors](https://img.shields.io/github/contributors/vijethph/PlacementCell?style=flat-square)](https://github.com/vijethph/PlacementCell/graphs/contributors)
[![GitHub forks](https://img.shields.io/github/forks/vijethph/PlacementCell?color=blue&style=flat-square)](https://github.com/vijethph/PlacementCell/network)
[![GitHub stars](https://img.shields.io/github/stars/vijethph/PlacementCell?color=yellow&style=flat-square)](https://github.com/vijethph/PlacementCell/stargazers)
[![GitHub license](https://img.shields.io/github/license/vijethph/PlacementCell?style=flat-square)](https://github.com/vijethph/PlacementCell/blob/master/LICENSE)
[![made-with-react](https://img.shields.io/badge/made%20with-react-143d59.svg?style=for-the-badge&labelColor=f4b41a&logo=react)](https://reactjs.org)
[![forthebadge](https://forthebadge.com/images/badges/fo-real.svg)](https://forthebadge.com)
[![forthebadge](https://forthebadge.com/images/badges/powered-by-energy-drinks.svg)](https://forthebadge.com)
[![Deploy to Render](https://render.com/images/deploy-to-render-button.svg)](https://render.com/deploy?repo=https://github.com/vijethph/PlacementCell)





Logo

Placement Cell


A MERN Stack App that provides a recruitment preparation portal for students.




Report Bug
ยท
Request Feature
.
Send a Pull Request

## Table of Contents

- [About the Project](#about-the-project)
- [Built With](#built-with)
- [Getting Started](#getting-started)
- [Prerequisites](#prerequisites)
- [Installation](#installation)
- [Usage](#usage)
- [Contributing](#contributing)
- [License](#license)
- [Contact](#contact)
- [Acknowledgements](#acknowledgements)

## About The Project

Aptitude Practice Videos Page Discussion Forum Page
Quiz Page Code Compiler Page

This is React app that uses [MongoDB](https://www.mongodb.com), [Express Framework](https://expressjs.com), [Node.js](https://nodejs.org/en) and [React Framework](https://reactjs.org) to provide a company recruitment preparation platform for students. It has features like discussion forum, quiz portal, aptitude practice videos and dashboard for latest placement updates from companies, to help students prepare for company recruitment drives. It also makes use of [HackerEarth API](https://www.hackerearth.com/docs/wiki/developers/v3/) to simulate a functional online code compiler with support for C, C++, Java and Python Languages.

### Built With

This project is entirely built with the following components and languages:

- [MongoDB](https://www.mongodb.com)
- [Express Framework](https://expressjs.com/)
- [React Framework](https://reactjs.org)
- [Node.js Runtime](https://nodejs.org/en)
- [TypeScript](https://www.typescriptlang.org/)
- [HackerEarth API](https://www.hackerearth.com/docs/wiki/developers/v3/)

## Getting Started

Follow these instructions in order to get a copy of the project up and running on your local machine for development and testing purposes.

### Prerequisites

Node.js>=10 and MongoDB>=4.2 should be installed. After installation, check Node.js version, and MongoDB daemon status using

```sh
node --version
service mongod status
```

### Installation

1. Clone the repo

```git
git clone https://github.com/vijethph/PlacementCell.git
```

2. Open the downloaded folder

```sh
cd PlacementCell
```

3. Modify the MongoDB URI in `server.ts` file inside `src` folder as per your DB configuration. Sign up for HackerEarth, retrieve an API key, and put it in `codes.ts` file inside `src/routes` folder. Then import the required dependencies in both of these folders: `src` and `client`, using

```sh
npm install
```

4. Run the program using

```sh
npm run dev
```

The app should be running in `http://localhost:3000` in your browser.

Another way to install this app is to use Docker Compose. Run this command to start the app:
```
docker-compose up
```
This will run the app at http://localhost:3000, which can be seen in your browser.

## Usage

Once the app starts, you can create an account in `Register` page, and then login as student to find the various features of this project. Optionally, you can import the companies details using the MongoDB init script named `mongoDBSetup.js` in project folder, using the command `mongo MONGODB_URI mongoDBSetup.js`. You can watch practice videos, have some discussion with your peers, and test yourself in quiz.

You can also use the code compiler and try to improve your programming skills. You can view the recruitment updates of companies in `Companies` dashboard.

## Contributing [![contributions welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat-square)](https://github.com/vijethph/PlacementCell/pulls)

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are **greatly appreciated**.

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

## License

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

## Contact

Vijeth P H - [@vijethph](https://github.com/vijethph)

Sathya M - [@sathya5278](https://github.com/sathya5278)

Project Link: [https://github.com/vijethph/PlacementCell](https://github.com/vijethph/PlacementCell)

## Thank You!

[![forthebadge](https://forthebadge.com/images/badges/built-with-love.svg)](https://forthebadge.com)

If you like this project, please โญ this repo and share it with others ๐Ÿ‘

## Acknowledgements

- [MongoDB Docs](https://docs.mongodb.com/)
- [React Framework Docs](https://reactjs.org)
- [Express Framework Docs](https://expressjs.com)
- [HackerEarth API Docs](https://www.hackerearth.com/docs/wiki/developers/v3/)