Skip to content

Java Backend API for Renergy Hub, An innovative Cleantech web platform designed to address Nigeria’s persistent electric power challenges by empowering users to optimize renewable energy consumption.

Notifications You must be signed in to change notification settings

InternPulse/renergy-hub-java-backend

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

25 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Renergy Hub Java Backend API

Project Overview

Live link: is at https://renergy-hub-java-backend-9.onrender.com/

Doc link: https://internpulse-9255.postman.co/workspace/Internpulse-Workspace~17f09322-7b62-4b07-8443-636ef5919382/folder/36548151-f463f13d-b2ef-4492-b271-6ce736b0b8d4?action=share&creator=39966806&ctx=documentation

Installation Instructions

Prerequisites

Before setting up the project locally, ensure you have the following prerequisites installed:

  • Node.js (>=20.14.0).
  • A Database System PostgreSQL)

How to run API Locally

  1. Clone the repository:
git clone https://github.com/InternPulse/renergy-hub-java-backend
  1. Change into the parent directory:
cd property-hive-backend-two
  1. Set appropriate values for the following Compulsory Environment Variables:
# Postgres connection string
POSTGRES_DSN=""
# Secret key for signing JWTs
JWTKEY=""
# API Port
PORT=5000
  1. Install the App dependencies:
npm install
  1. Start the App:
npm run start-server

The API should now be running locally at http://localhost:5000/.

Commit Standards

Branches

  • dev -> pr this branch for everything backend related
  • main -> dont touch this branch, this is what is running in production!

Contributions

property-hive-backend-two is open to contributions, but I recommend creating an issue or replying in a comment to let us know what you are working on first that way we don't overwrite each other.

Contribution Guidelines

  1. Clone the repo git clone https://github.com/InternPulse/property-hive-backend-two.git.
  2. Open your terminal & set the origin branch: git remote add origin https://github.com/InternPulse/property-hive-backend-two.git
  3. Pull origin git pull origin dev
  4. Create a new branch for the task you were assigned to, eg TicketNumber/(Feat/Bug/Fix/Chore)/Ticket-title : git checkout -b BA-001/Feat/Sign-Up-from
  5. After making changes, do git add .
  6. Commit your changes with a descriptive commit message : git commit -m "your commit message".
  7. To make sure there are no conflicts, run git pull origin dev.
  8. Push changes to your new branch, run git push -u origin feat-csv-parser.
  9. Create a pull request to the dev branch not main.
  10. Ensure to describe your pull request.
  11. If you've added code that should be tested, add some test examples.

Merging

Under any circumstances should you merge a pull request on a specific branch to the dev or main branch

Commit CheatSheet

Type Description
feat Features A new feature
fix Bug Fixes A bug fix
docs Documentation Documentation only changes
style Styles Changes that do not affect the meaning of the code (white-space, formatting, missing semi-colons, etc.)
refactor Code Refactoring A code change that neither fixes a bug nor adds a feature
perf Performance Improvements A code change that improves performance
test Tests Adding missing tests or correcting existing tests
build Builds Changes that affect the build system or external dependencies (example scopes: gulp, broccoli, npm)
ci Continuous Integrations Changes to our CI configuration files and scripts (example scopes: Travis, Circle, BrowserStack, SauceLabs)
chore Chores Other changes that don't modify, backend or test files
revert Reverts Reverts a previous commit

Sample Commit Messages

  • chore: Updated README file:= chore is used because the commit didn't make any changes to the backend or test folders in any way.
  • feat: Added plugin info endpoints:= feat is used here because the feature was non-existent before the commit.

About

Java Backend API for Renergy Hub, An innovative Cleantech web platform designed to address Nigeria’s persistent electric power challenges by empowering users to optimize renewable energy consumption.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published