Hello! This is my formal application and practical test as part for my job Application with Frogmi
-
Ruby on Rails framework
-
SQL
This project was developed using Ruby on WSL. It is recommended to have your ruby installation managed in WSL.
The setups steps expect following tools installed on the system.
-
Git
-
Ruby 3.0.2
-
Rails 7.1.3.2
To run this project, you should consider the following:
- If running locally, the project will have NO DATA whatsoever. There is no database included with the project (duh). You will need to create / populate the database yourself. You can do this by running the following command:
rails db:create db:migrateFor the data population, there is a task configured using whenever, however, as this utilises a cronjob to run, it is recommended to execute the task manually to force the database to populate. You can do it by running the following command:
rake seismic_data:fetchThis may take a while, as the task will fetch the data from the USGS API and populate the database with the data. Please be patient. (You may also want to test if the task also checks for duplicates and does not populate the database with the same data over and over again wink wink)
When ready to execute the project. You may use the following command:
rails sNOTE: The project will run on port 3000 by default. If you wish to run on a different port, you may use the -p flag followed by the port number. This is NECESSARY if you´re running the companion front-end project, as that runs by default on port 3000.
The frontend project can be found here. (The frontend project is not required tun run this project, but it is recommended to run both projects together to see the full functionality of the technical test)
Also, if running the frontend project, you should know that by default, it expects to find the API on located on http://localhost:8000. You can run the project on port 8000 by using the following command:
rails s -p 8000