Skip to content

Latest commit

 

History

History
85 lines (56 loc) · 5.67 KB

README.md

File metadata and controls

85 lines (56 loc) · 5.67 KB

TCET ERP System

TCET ERP System is a project that aims to simplify and automate daily operations in TCET.

This ERP system will be used to manage various aspects of the operations of colleges, including admissions, registration, student records, financial aid, course scheduling, and fees. The ERP system would typically consist of multiple integrated modules that support these functions.

  • Technology stack: We will be using node.js and express for the backend along with NoSQL, that is, MongoDB as the database due to the modular nature of this project.

Hacktoberfest

Powered by:

mlh-logo-color

How to contribute

Read our workflow guide, and have a look at issues marked with the Hacktoberfest tag on it. Do not forget to read the rest of the README. For serious doubts, contact the project maintainers on our discord server.

Dependencies

All the dependencies used in this project will be listed in the package.json file from the root directory.

Installation

To start working on this project first you need to create .env file. This .env file will contain:

PORT You can set it on any port number you want. eg: 4000

TOKEN_SECRET which you will get by running following line in terminal

node -e "console.log(require('crypto').randomBytes(256).toString('base64'));

ENVIRONMENT Set this on 'local'

DB_URL For this parameter, you will need to open your account on MongoDB Atlas, don't forget to note down your account password, then create new cluster and through that you will get your connection string which will be your DB_URL in .env, make sure instead of "password" in connection string, you enter your own account password.

EMAIL_HOST, EMAIL_PORT, EMAIL_USER, EMAIL_PASS

For these above parameters, first you need to open an account on any SMTP server, we use mailtrap, then start testing where you will see show credentials in which you will get all the values we need which are host, port, username and password.

You don't need to assign values to these parameters in double or single quotes, just write directly, .env automatically converts it into quoted string.

Once you are done with this, install the packages through npm ci which stands for clean install. Also you need to run the following command to check for you eslint and jest testcases:

npm run prepare

And finally, run the server with npm run serverstart or npm run serverstartWin depending on your operating system.

How to Contribute

  1. Choose an issue, bug, exploit, or feature to work on: Start by identifying an issue or feature in the repository that you would like to work on. If you can't find an existing issue or feature, you can create a new one.

  2. Fork the repository: Once you have identified an issue or feature to work on, you will need to fork the repository. This creates a copy of the repository in your own GitHub account.

  3. Clone the repository: Next, you will need to clone the repository to your local machine. You can do this by using the git clone command and specifying the URL of the repository.

  4. Create a new branch: Before making any changes, you should create a new branch in your local repository. This will keep your changes separate from the main branch of the repository and make it easier to submit a pull request later on.

  5. Make your changes: Now you can make your changes to the code in your local branch. Be sure to follow the project's coding style and conventions.

  6. Test your changes: Once you have made your changes, be sure to test them thoroughly to ensure that they work as intended and do not introduce new issues or bugs.

  7. Commit your changes: Once you are satisfied with your changes, commit them to your local branch using the git commit command.

  8. Push your changes: Once you have committed your changes, push them to your forked repository on GitHub using the git push command.

  9. Open a pull request: Finally, open a pull request to merge your changes into the main branch of the repository. Be sure to describe your changes and explain why they are necessary or beneficial. Note that the project maintainers may request changes or reject your pull request, so your first pull request is not guaranteed to be accepted.

It's also worth noting that you should communicate with the project maintainers and other contributors to ensure that your changes align with the project's goals and direction.

Connect with us

Twitter     Instagram     Discord     Gmail     LinkedIn