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

https://github.com/hmasum52/blooddonors-backend

This is our level 2 term 2 database course project on blood management system backend build with node js and oracle database
https://github.com/hmasum52/blooddonors-backend

Last synced: 3 months ago
JSON representation

This is our level 2 term 2 database course project on blood management system backend build with node js and oracle database

Awesome Lists containing this project

README

        

Welcome to BloodDonors Backend 👋

🚧 Blood donors backend project in development... 🚧

> A project to help you connect with blood donors and people who need blood.
> Front end link: - [https://github.com/AshfaqRahman/BloodDonors-frontend](https://github.com/AshfaqRahman/BloodDonors-frontend)

### 🔖 Table Of Contents

- 🤔 [How To Run This Project In Your PC](#how-to-run)
- 🚀 [Technologies](#technologies)
- 🌱 [Minimal Requirements](#minimal-requirements)
- 🎊 [Features](#features)
- 🎇 [Finished](#features-finished)
- 💡 [How To Contribute](#how-to-contribute)
- 🤗 [Authors and Contributors](#contributors)
- 👤 [Supervisor](#supervisor)
- 🔏 [License](#license)

---

🤔 How To Run This Project In Your PC

### 💻 Step-1: Clone the project in your pc

```sh
git clone https://github.com/hmasum52/BloodDonors-backend.git
```
or if you use ssh link
```sh
git clone [email protected]:hmasum52/BloodDonors-backend.git
```

### Step-2: Get the denpendencies

```sh
npm install
```

### Step-3: Setting up the database

- Login in to your sqlplus as "system" user

- Then create a user and grant dba to that user.

```sql
create user c## identified by ;
grant dba to c##;
```
- After connecting the user to navicate or datagrip Run dump file in [sql/dump.sql](./sql/dump.sql) to create the database.

- Run the following command to see the triggers
```sql
SELECT * FROM USER_TRIGGERS;
```
### Step-4: Setting up the enviroment variables
Create create a new file .env in the root directory. And the file should have the followings

```
DB_USERNAME=c##
DB_PASSWORD=
DB_CONNECTION_STRING=localhost/orcl
JWT_SECRET=
PORT=
```

Example
```
DB_USERNAME=c##blood_donors
DB_PASSWORD=blood_donors
DB_CONNECTION_STRING=localhost/orcl
JWT_SECRET=hack_me_if_you_can
PORT=3000
```

### Step-5: Run the project

```
npm start
```

or

```
npm run dev
```

### Step-6: Now you are ready to run the frontend

- [BloodDonors-frontend](https://github.com/AshfaqRahman/BloodDonors-frontend)

[Back To The Top](#title)

---

🚀 Technologies

- Node
- Javascript
- Express
- Oracle

[Back To The Top](#title)

---

🌱 Minimal Requirements

- NodeJs - v14.18.1+
- Oracle 19c

[Back To The Top](#title)

---

🎊 Features

🎇 Finished

- [✔️] Authentication
- [✔️] APIs
- [✔️] Oracle connection

[Back To The Top](#title)

---

💡 How To Contribute

- Make a fork of this repository
- Clone to you machine and entry on respective paste
- Create a branch with your resource: `git checkout -b my-feature`
- Commit your changes: `git commit -m 'feat: My new feature'`
- Push your branch: `git push origin my-feature`
- A green button will appear at the beginning of this repository
- Click to open and fill in the pull request information


Contributions, issues and features requests are welcome!

📮 Submit PRs to help solve issues or add features

🐛 Find and report issues

🌟 Star the project

[Back To The Top](#title)

---

👤 Author And Contributors


Hasan Masum


Ashfaq Rahman

[Back To The Top](#title)

---

👨‍💻 Supervisor

- [Mohammad Tawhidul Hasan Bhuiyan](https://cse.buet.ac.bd/faculty/facdetail.php?id=tawhid), Lecturer, Department of Computer Science and Engineering Bangladesh University of Engineering and Technology Dhaka-1000, Bangladesh

[Back To The Top](#title)

---

🔏 License

Copyright © 2022 BloodDonors

This project is licensed by [MIT License](https://api.github.com/licenses/mit).

[Back To The Top](#title)

---