{"id":26380696,"url":"https://github.com/nramc/journey-api","last_synced_at":"2026-02-18T22:03:42.096Z","repository":{"id":226670948,"uuid":"768832317","full_name":"nramc/journey-api","owner":"nramc","description":"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.","archived":false,"fork":false,"pushed_at":"2026-01-30T13:28:02.000Z","size":2342,"stargazers_count":2,"open_issues_count":15,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-01-31T04:16:35.041Z","etag":null,"topics":["fortheloveofcode","geojson","java","journey","mongodb-atlas","open-rewrite","renovate-enabled","rest-api","spring-boot"],"latest_commit_sha":null,"homepage":"https://journey-api.codewithram.dev","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nramc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-03-07T20:20:28.000Z","updated_at":"2026-01-30T13:25:24.000Z","dependencies_parsed_at":"2024-04-15T21:25:16.466Z","dependency_job_id":"496f612b-ad43-484e-a575-68fb04317b94","html_url":"https://github.com/nramc/journey-api","commit_stats":null,"previous_names":["nramc/journey-api"],"tags_count":79,"template":false,"template_full_name":null,"purl":"pkg:github/nramc/journey-api","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nramc%2Fjourney-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nramc%2Fjourney-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nramc%2Fjourney-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nramc%2Fjourney-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nramc","download_url":"https://codeload.github.com/nramc/journey-api/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nramc%2Fjourney-api/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29596341,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-18T20:59:56.587Z","status":"ssl_error","status_checked_at":"2026-02-18T20:58:41.434Z","response_time":162,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["fortheloveofcode","geojson","java","journey","mongodb-atlas","open-rewrite","renovate-enabled","rest-api","spring-boot"],"created_at":"2025-03-17T05:32:57.280Z","updated_at":"2026-02-18T22:03:42.079Z","avatar_url":"https://github.com/nramc.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/nramc/journey-api/ci-build-workflow.yml?branch=main\u0026style=flat\u0026logoColor=ff0)\n[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=nramc_journey-api\u0026metric=alert_status)](https://sonarcloud.io/summary/new_code?id=nramc_journey-api)\n[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=nramc_journey-api\u0026metric=coverage)](https://sonarcloud.io/summary/new_code?id=nramc_journey-api)\n[![Release](https://img.shields.io/github/release/nramc/journey-api.svg?style=for-the-badge?logoColor=fff\u0026style=flat)](https://github.com/nramc/journey-api/releases)\n[![Documentation](https://img.shields.io/badge/Swagger-85EA2D?style=for-the-badge\u0026logo=Swagger\u0026logoColor=black\u0026style=for-the-badge)](https://journey-api.codewithram.dev/doc/swagger-ui.html)\n[![Docker](https://img.shields.io/badge/Docker-2CA5E0?logo=docker\u0026logoColor=white\u0026style=flat)](https://hub.docker.com/r/codewithram/journey-api)\n[![Badge](https://img.shields.io/badge/-LinkedIn-black.svg?style=for-the-badge\u0026logo=linkedin\u0026colorB=159\u0026style=flat)](https://www.linkedin.com/in/ramachandran-nellaiyappan/)\n\n# Journey Rest API\n\n\u003chr /\u003e\n\nThis **Java-based Backend For Frontend (BFF)** service is designed to seamlessly integrate with\nthe [Journeys](https://journey.codewithram.dev) Single Page\nApplication (SPA), offering robust backend support for frontend operations.\n\nBuilt using the powerful [Spring Framework](https://spring.io/), this service handles complex request processing with a\nfocus on geographical data management. Key features include:\n\n- Scalable Data Persistence: Leveraging [MongoDB Atlas](https://www.mongodb.com/products/platform/atlas-database), the\n  service ensures reliable and scalable data storage.\n- Geospatial Support: With geographical information at its core, the service\n  utilizes [GeoJSON](https://datatracker.ietf.org/doc/html/rfc7946) data format, made simple\n  through the [Commons GeoJson](https://github.com/nramc/commons) library, for accurate and efficient handling of\n  location-based data.\n\n## Helpful Links\n\n- [Journeys Application](https://journey.codewithram.dev)\n- [REST API Documentation](https://journey-api.codewithram.dev/doc/swagger-ui.html)\n- [REST Open API YML Configuration](https://journey-api.codewithram.dev/doc/openapi)\n\n## Getting Started\n\nPlease find below steps to setup and run application in your workstation.\n\n### Prerequisites\n\nThe service uses MongoDB for persistence.\nFor Local development, Local MongoDB instance created with help of Docker CLI.\nSo make sure you have installed Docker CLI or any other docker container tool.\n\n### Installation\n\n1. Download Repository\n   ```sh\n   git clone https://github.com/nramc/journey-api.git \n   ```\n2. Run Application with spring profile `dev`\n   ```sh\n   mvn spring-boot:run -Dspring-boot.run.profiles=dev\n   ```\n3. Local MongoDB can be accessed in [http://localhost:9090/](http://localhost:9090/) with help\n   of [Mongo Express](https://github.com/mongo-express/mongo-express)\n4. To test REST resource,\n   use [IntelJ Http Client](https://www.jetbrains.com/help/idea/http-client-in-product-code-editor.html) scripts\n   available in ``src/test/resources/http-scripts/`` directory.\n\n### Contributing\n\nAny contributions you make are **greatly appreciated**.\n\nIf you like the project and have a suggestion that would make this better, please fork the repo and create a pull\nrequest.\nYou can also simply open an issue with the tag \"enhancement\".\n\n1. Fork the Project\n2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your Changes (`git commit -m 'feat: Add the AmazingFeature'`)\n4. Push to the Branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n### Release new version\n\n1. Manually\n   run [Prepare Release Workflow](https://github.com/nramc/journey-api/blob/main/.github/workflows/prepare-release.yml)\n   with release version \"MAJOR.MINOR.PATCH\" e.g. 0.0.1\n2. The Workflow flow creates a new tag with provided release version vMAJOR.MINOR.PATCH e.g. v0.0.1\n3. The Workflow creates [Release](https://github.com/nramc/journey-api/releases) as well with release notes and make the\n   release as latest\n4. As soon as new `Release` created, which\n   triggers [Release Workflow](https://github.com/nramc/journey-api/blob/main/.github/workflows/release-workflow.yml)\n   with release event\n5. The `Release` workflow build \u0026 test project after checkout\n6. When build successful, creates Docker image and publish it to [Docker Hub](https://hub.docker.com/)\n7. Finally triggers [Render](https://dashboard.render.com/) webhook for deployment\n\n## Contact\n\n[Ramachandran Nellaiyappan](https://myprofile.codewithram.dev/contact.html)\n\n## Credits\n\nSincere Thanks to following open source community for their wonderful efforts to make our life much easier.\n\n- [Spring IO](https://spring.io/) - Java Web Framework\n- [MongoDB](https://www.mongodb.com/) - Persistence Layer\n- [Spring Rest Doc](https://springdoc.org) - Spring REST Doc with Open API support for Swagger UI\n- [OpenRewrite](https://docs.openrewrite.org/) - Automated source code refactoring\n- [Docker](https://www.docker.com/) - Containerization\n- [Testcontainers](https://testcontainers.com/) - Run containers on-demand for development and testing\n\n## Show your support\n\nGive a ⭐️ if you like this project!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnramc%2Fjourney-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnramc%2Fjourney-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnramc%2Fjourney-api/lists"}