{"id":22622544,"url":"https://github.com/gaelfoppolo/locomotor","last_synced_at":"2026-05-03T04:37:01.174Z","repository":{"id":86689341,"uuid":"72990308","full_name":"gaelfoppolo/locomotor","owner":"gaelfoppolo","description":"Locomotor is a real and fictional vehicles comparator.","archived":false,"fork":false,"pushed_at":"2017-02-11T16:37:30.000Z","size":25583,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-03T12:50:38.992Z","etag":null,"topics":["comparator","criteria","flexibility","java8","javafx","vehicle"],"latest_commit_sha":null,"homepage":"https://gaelfoppolo.github.io/locomotor/presentation/","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gaelfoppolo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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}},"created_at":"2016-11-06T12:51:32.000Z","updated_at":"2017-02-11T16:55:26.000Z","dependencies_parsed_at":null,"dependency_job_id":"5123699d-3042-4fa6-8339-73d52c0c7ea5","html_url":"https://github.com/gaelfoppolo/locomotor","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gaelfoppolo%2Flocomotor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gaelfoppolo%2Flocomotor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gaelfoppolo%2Flocomotor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gaelfoppolo%2Flocomotor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gaelfoppolo","download_url":"https://codeload.github.com/gaelfoppolo/locomotor/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246131241,"owners_count":20728299,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["comparator","criteria","flexibility","java8","javafx","vehicle"],"created_at":"2024-12-08T23:16:34.795Z","updated_at":"2026-05-03T04:37:01.106Z","avatar_url":"https://github.com/gaelfoppolo.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Locomotor\n\nLocomotor is a real and fictional vehicles comparator. It is based on predefined criterias that the user can select. It outputs a list of the vehicles that fit \"the most\" the user's query. The comparator works in a client/server design, allowing multiple users to use the same dataset at the same time.\n\n![Search results](https://raw.githubusercontent.com/gaelfoppolo/locomotor/master/screenshot_results.png)\n\n![Criterias selection](https://raw.githubusercontent.com/gaelfoppolo/locomotor/master/screenshot_selection.png)\n\nThe project offers 2 clients: \n\n- the first one is an administation interface which allow the user to modify the dataset.\n- the other is an easy to use interface enabling the user to search for a vehicle and retrieve his booking.\n\n#### A presentation of the project is available in [French](http://gaelfoppolo.github.io/locomotor/presentation/).\n\n## Getting Started\n\nThese instructions will get you a copy of the project up and running on your local machine.\n\n#### [A wiki is also available, and give and more technical insight of the project: architecture, API, comparison algorithms, etc.](https://github.com/gaelfoppolo/locomotor/wiki)\n\n*Note: this project does not compile under Windows environment.*\n\n### Prerequisites\n\nTo run this project, you will need :\n\n- [OpenJDK](http://openjdk.java.net/) 8+ (JDK and JRE)\n- [OpenJFX](https://wiki.openjdk.java.net/display/OpenJFX/Main) 8+\n- [MongoDB](https://www.mongodb.com/) 3.4+ installed and running\n\n### Installing\n\nTo build this project, simply clone this repository and build the project.\n\n```shell\ngit clone https://github.com/gaelfoppolo/locomotor\ncd locomotor\nmake all\n```\n\nTo run the application, you need to start the core first.\n\n```shell\nmake run-core\n```\n\nThen, you can choose the interface to use:\n\n|         User          |            Admin             |\n| :-------------------: | :--------------------------: |\n| `make run-front-user` | `make run-front-user —admin` |\n\n### Fill the database\n\nIf you want to use a prefilled database, use the ones in the `data` directory.\n\nTo import use:\n\n```shell\nmake import-database\n```\n\nThe images of the vehicles are not provided, but you can easily find them on the Internet.\n\n## Running the tests\n\nTo check that your code is compliant with our coding convention without having to compile the project, use:\n\n```shell\nmake linter\n```\n\n## Building documentation\n\nA [documentation](http://gaelfoppolo.github.io/locomotor/) is also available, with graph to a better understanding of our process.\n\nYou can also build it on your own, just make sure you have installed [Doxygen](http://www.stack.nl/%7Edimitri/doxygen/) and [Graphviz](http://www.graphviz.org/).\n\nThen browse to the root of the project folder and run:\n\n```shell\nmake doc\n```\n\n#### See [makefile](https://github.com/gaelfoppolo/locomotor/blob/master/makefile) for further explanations.\n\n## Authors\n\n* **Bastien Philip** - *Initial work* - [ebatsin](https://github.com/ebatsin)\n* **Gaël Foppolo** - *Initial work* - [gaelfoppolo](https://github.com/gaelfoppolo)\n\n## License\n\nThis project is licensed under the GPLv3 license, see [LICENSE.md](https://raw.githubusercontent.com/gaelfoppolo/locomotor/master/LICENSE.md).","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgaelfoppolo%2Flocomotor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgaelfoppolo%2Flocomotor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgaelfoppolo%2Flocomotor/lists"}