Journey Rest API

This Java-based Backend For Frontend (BFF) service is designed to seamlessly integrate with the Journeys Single Page Application (SPA), offering robust backend support for frontend operations.

Built using the powerful Spring Framework, this service handles complex request processing with a focus on geographical data management. Key features include:

• Scalable Data Persistence: Leveraging MongoDB Atlas, the service ensures reliable and scalable data storage.
• Geospatial Support: With geographical information at its core, the service utilizes GeoJSON data format, made simple through the Commons GeoJson library, for accurate and efficient handling of location-based data.

Helpful Links

• Journeys Application
• REST API Documentation
• REST Open API YML Configuration

Getting Started

Please find below steps to setup and run application in your workstation.

Prerequisites

The service uses MongoDB for persistence. For Local development, Local MongoDB instance created with help of Docker CLI. So make sure you have installed Docker CLI or any other docker container tool.

Installation

1. Download Repository

   git clone https://github.com/nramc/journey-api.git 

2. Run Application with spring profile dev

   mvn spring-boot:run -Dspring-boot.run.profiles=dev

3. Local MongoDB can be accessed in http://localhost:9090/ with help of Mongo Express
4. To test REST resource, use IntelJ Http Client scripts available in src/test/resources/http-scripts/ directory.

Contributing

Any contributions you make are greatly appreciated.

If you like the project and have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'feat: Add the AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Release new version

1. Manually run Prepare Release Workflow with release version "MAJOR.MINOR.PATCH" e.g. 0.0.1
2. The Workflow flow creates a new tag with provided release version vMAJOR.MINOR.PATCH e.g. v0.0.1
3. The Workflow creates Release as well with release notes and make the release as latest
4. As soon as new Release created, which triggers Release Workflow with release event
5. The Release workflow build & test project after checkout
6. When build successful, creates Docker image and publish it to Docker Hub
7. Finally triggers Render webhook for deployment

Contact

Ramachandran Nellaiyappan Website | Twitter | E-Mail

Credits

Sincere Thanks to following open source community for their wonderful efforts to make our life much easier.

• Spring IO - Java Web Framework
• MongoDB - Persistence Layer
• Spring Rest Doc - Spring REST Doc with Open API support for Swagger UI
• OpenRewrite - Automated source code refactoring
• Docker - Containerization
• Testcontainers - Run containers on-demand for development and testing

Show your support

Give a ⭐️ if you like this project!