https://github.com/otaviojava/filtering_matches
https://github.com/otaviojava/filtering_matches
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/otaviojava/filtering_matches
- Owner: otaviojava
- Created: 2019-04-03T10:06:22.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2019-04-05T01:04:53.000Z (almost 7 years ago)
- Last Synced: 2024-12-30T05:29:27.209Z (about 1 year ago)
- Language: Java
- Size: 36.1 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
## Filtering Matches
This exercise requires a little bit more back end and a little bit less front end.
Please provide some code which allows you to filter on a prebuilt set of filters (using server side filtering)
If you're stronger on the frontend, that's fine to concentrate on that more - just let us know in the notes you've done so.
Please, however, ensure both the client and server side is *well tested* and *clean code* and that the code works before you submit your code.
### Filtering Details
| Filter | Details |
|--------|---------|
| Has photo | Boolean yes / no filter |
| In contact | Boolean yes / no filter |
| Favourite | Boolean yes / no filter |
| Compatibility Score | range: from 1% to 99% |
| age | range: from 18 years old until > 95 years old |
| height | range: from 135cm to > 210cm |
| distance in km | single selection: lower bound < 30 km, upper bound > 300 km |
### Server side
The server side can be in whatever language you are strong with.
We mainly use js, java, and a little bit of php and go, so please try to use one of them that you're stronger with.
There is a small json file provided [database/matches.json](./database/matches.json).
Please use this data as the basis for your service.
If you opt to use a db, please import this data as your starting point, and ensure you provide full setup script or instructions for the db.
You can use whatever storage you think fits the problem.
### Client side
The client side can be either web or app.
If it's web, please ensure it can be used on multiple devices.
Completely up to you what frameworks you use; on our own code we use angular 2 or react for web, and all the usual libs for android and iOS that allows MVVM, MVP, and easier testing.
##### Web Requirements
Please provide an initial list view with all existing matches provided in the [database/matches.json](./database/matches.json) file.
You should also have a number of filters available, as listed above.
If you use range sliders or any components where you have dragging actions etc, please ensure ensure they are cross device compatible
Note - for filtering "distance in km" assume that the user has logged in as one of the users in matches.json file, and use their "city" property. You don't need to ask location from their browser
##### App Requirements
Please provide an initial list view of all existing matches and a number of filters, as listed above.
The resulting app should handle rotation and scale for tablets as well as phones.
Note - for filtering "distance in km" assume that the user has logged in as one of the users in matches.json file. Ask for the users location in the app first. If the user does not supply it, use their "city" property from their profile
## Running the App
1. `mvn clean install`
1. `start a MongoDB instance`
1. `java -jar target/filtering-matches-1.0-SNAPSHOT-spring-boot.jar`
### MongoDB instance is required
**Mongodb**: MongoDB is a free and open-source cross-platform document-oriented database program. Classified as a NoSQL database program, MongoDB uses JSON-like documents with schemas.
To run this project a MongoDB instance is required, so you can use either a local instalation or using Docker.
## Manual installation
Follow the instructions in: https://docs.mongodb.com/manual/installation/
## Using Docker
1. Install docker: https://www.docker.com/
1. https://store.docker.com/images/mongo
1. Run MondoDB: verify MongoDB image name with the command `docker images`, it can be mongodb or mongo, and then execute this command `docker run -d --name mongodb-instance -p 27017:27017 mongo`
### Front-End
* Unfortunately, I did not implement it.
* I know that there are several that make the developer life more comfortable such as NPM; however, I did not create a new one from scratch.
* A fast solution that I could do would be a front-end technology friendly to a back-end such as Spring MVC or JSF.
### The possible next features:
* Documentation using Swagger
* Authentication
* Improves new filters such as religion