-
Notifications
You must be signed in to change notification settings - Fork 50
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
9647020
commit 27b6ce2
Showing
1 changed file
with
73 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,73 @@ | ||
# Project Overview | ||
|
||
Welcome to the Learn.md guide for the project! In this guide, we will provide an overview of how the project is built and the key functionalities it offers. Let's dive in! | ||
|
||
## Project Description | ||
|
||
The project is an automated system for requesting and approving no-due certificates for students at the end of each semester. It is designed for colleges and universities to streamline the process of issuing no-due certificates to students. The system consists of the following components: | ||
|
||
1. Admin Dashboard: Each department has an admin who is responsible for managing student, faculty, and course information for a particular year and semester. The admin credentials are generated by the developers and provided to the respective department admin. | ||
|
||
2. Student Dashboard: Students can log in to the system using their credentials. Once logged in, they can access their dashboard, which displays a list of their subjects and the handling faculty for each subject. Students can request no-due certificates by clicking on the "Request No Due" button. This action creates a new entry in the requests collection. | ||
|
||
3. Faculty Dashboard: Faculty members can log in to the system using their credentials. In their dashboard, they can view the requests made by students under their name. Faculty members have the authority to approve or decline the requests based on the student's eligibility. | ||
|
||
4. No Due Certificate Generation: Once all the requests of a student are approved by the respective faculty members, the student becomes eligible to download the PDF of the no-due certificate. | ||
|
||
## Technology Stack | ||
|
||
The project is built using the MEAN (MongoDB, Express.js, AngularJS, and Node.js) stack. Here is an overview of the technologies used: | ||
|
||
- MongoDB: A NoSQL database used to store and manage the application's data. | ||
|
||
- Express.js: A web application framework for Node.js used to handle server-side routing and API development. | ||
|
||
- Angular 15: A JavaScript-based framework used to build the frontend user interface and handle client-side interactions. | ||
|
||
- Node.js: A runtime environment for executing JavaScript code on the server-side. | ||
|
||
## Development Setup | ||
|
||
To set up the project locally and start contributing, follow these steps: | ||
|
||
1. Clone the project repository from GitHub: `git clone https://github.com/GVishndhasan/NoDueProject` | ||
|
||
2. Install the necessary dependencies by running the following command in the project root directory: | ||
|
||
``` | ||
npm install | ||
``` | ||
|
||
3. Configure the database connection by providing the MongoDB connection URL and other required parameters in the project's configuration files. | ||
|
||
4. Start the development server by running the following command: | ||
|
||
``` | ||
npm run dev | ||
``` | ||
|
||
5. Access the application by opening a web browser and navigating to the specified URL (e.g., http://localhost:8080). | ||
|
||
## Contribution Guidelines | ||
|
||
Contributions to the project are welcome! If you would like to contribute, please follow these guidelines: | ||
|
||
1. Fork the project repository to your own GitHub account. | ||
|
||
2. Create a new branch for your changes and switch to that branch. | ||
|
||
3. Make your changes and test them thoroughly. | ||
|
||
4. Commit your changes with descriptive commit messages. | ||
|
||
5. Push your changes to your forked repository. | ||
|
||
6. Create a pull request (PR) from your branch to the original repository. Provide a clear and detailed description of your changes in the PR. | ||
|
||
7. Your PR will be reviewed by the project maintainers, and feedback or changes may be requested. | ||
|
||
8. Once your changes are approved, they will be merged into the main project repository. | ||
|
||
Thank you for your interest in contributing to the project! Your contributions will be valuable in improving the functionality and usability of the system. | ||
|
||
[repository-url]: https://github.com/GVishndhasan/NoDueProject |