The main aim of “GreenCity” project is to teach people in a playful and challenging way to have an eco-friendly lifestyle. A user can view on the map places that have some eco-initiatives or suggest discounts for being environmentally aware (for instance, coffee shops that give a discount if a customer comes with their own cup). А user can start doing an environment-friendly habit and track their progress with a habit tracker. "GreenCityUBS" is a microservice which contains garbage collection service.
Here is the front-end part of our project: https://github.com/ita-social-projects/GreenCityClient.
dev
branch of the back-end corresponds to dev
branch on the front-end. The same thing with master
branches.
You're encouraged to contribute to our project if you've found any issues or missing functionality that you would want to see. Here you can see the list of issues and here you can create a new issue.
Before sending any pull request, please discuss requirements/changes to be implemented using an existing issue or by creating a new one. All pull requests should be done into dev
branch.
Though there are four GitHub projects (GreenCity, GreenCityUser and GreenCityUBS for back-end part and GreenCityClient for front-end part) all the issues are listed in the first one - GreenCity.
NOTE: make sure that your code passes checkstyle. Otherwise, your pull request will be declined. See paragraph Setup Checkstyle.
- Java 21
- PostgreSQL 9.5 or higher
-
You should open in IntelliJ IDEA File ->
New Project
->Project From Version Control
->Repository URL
->URL
(https://github.com/ita-social-projects/GreenCityUBS.git) ->Clone
. -
Open
Terminal
writegit checkout -b dev
(this creates new local branch "dev"). -
After this
git pull origin dev
(for update last version from branch dev). -
Create new database in Postgres (
greencityubs
). -
Add Configuration
->+
->Application
.
Name
:UbsApplication
.Use classpath of modules
:core
JRE
:21
.
Enviroment variables
:
Add also this fields inti User environment variables, ask in GreenCity group, properties to these fields.
-
Run UbsApplication
-
If you did everything correctly, you should be able to access swagger by this URL: http://localhost:8050/swagger-ui.html#/
-
You can insert data into your database for this you should run file insert.sql
Also, all these variables you can set in Intellij Idea. For instance:
spring.datasource.url=${DATASOURCE_URL}
spring.datasource.username=${DATASOURCE_USER}
spring.datasource.password=${DATASOURCE_PASSWORD}
spring.mail.username=${EMAIL_ADDRESS}
spring.mail.password=${EMAIL_PASSWORD}
cloud.name=${CLOUD_NAME}
api.key=${API_KEY}
api.secret=${API_SECRET}
google.clientId=${GOOGLE_CLIENT_ID}
spring.rabbitmq.host=${RABBITMQ_HOST}
spring.rabbitmq.password=${RABBITMQ_PASSWORD}
spring.rabbitmq.username=${RABBITMQ_USERNAME}
bucketName=${BUCKET_NAME}
staticUrl=${STATIC_URL}
spring.social.facebook.app-id=${FACEBOOK_APP_ID}
spring.social.facebook.app-secret=${FACEBOOK_APP_SECRET}
greencity.server.address = ${GREENCITY_SERVER_ADDRESS}
- You can find a quick instruction here: https://www.youtube.com/watch?v=_ORUSRJGXmk&list=PLcaYXHLmxz8nJByvtOoIBr8FnSS9CY1JD&index=23&t=37s
-
Run GreenCityUBS project (look up paragraph How to run).
-
Run GreenCityUser project (look up paragraph How to run).
-
Use the following link to open Swagger UI: http://localhost:8060/swagger-ui.html#/
-
Use POST method with
/ownSecurity/signUp
to create an account. If you set a valid email credentials, you should receive an email with verification link. Verify the registration by following that link. We highly recommend to use gmail, it's free of charge and easy to get going: how to allow email sending from gmail, Google client id. Alternatively you can drop a record inverify_email
table on your local database. First you should update user role :UPDATE users SET role = 1 WHERE id = your_user_id;
. After thisDELETE FROM verify_emails WHERE user_id = your_user_id;
-
Use POST method with
/ownSecurity/signIn
to sign in. After entering the credentials you should receive access and refresh tokens. -
Copy the given access token and put it into GreenCityUBS(http://localhost:8050/swagger-ui.html#/) Authentication Header. Press Authorize button.
Insert the given token into input field. The scheme should be like this
<given_token>
. Press Authorize button. -
Now you can use swagger UI to test REST API. Some controllers require ADMIN role. By default, new registered users have role USER. To overcome this you need to update record that corresponds to your user in the local database. For example,
UPDATE users SET role = 1 WHERE id = <your_user_id>
.
There is no special configurations required. Just clone GreenCityClient and run it. If you want to sign in with Google account, it's mandatory to set google.clientId
. Read more about how to obtain Google client id, it's free.
Here you can read more about how to set up checkstyle;
Here you can read more about SonarLint;