felixmpa / fullstack-challenge

Menulabs - Fullstack Challenge

Fullstack Challenge

Instructions

Using Laravel and VueJS, create an application which shows the weather for a set of users.

• Create a fork of this repository.
• Once completed, send link to interviewer and let them know how long the excercise took.
• Update landing page to show a list of users and their current weather.
• Clicking a user row opens a modal or screen which shows that users detailed weather report.
• Weather update should be no older than 1 hour.
• Internal API request(s) to retrieve weather data should take no longer than 500ms. Consider that external APIs could and will take longer than this from time to time and should be accounted for.
• We are looking for attention to detail!
• Instructions are purposely left somewhat open-ended to allow the developer to make some of their own decisions on implementation and design. To note, this is not a designer test so this does not have to look "good".

Things to consider:

• Chose your own weather api such as https://openweathermap.org/api, https://www.weather.gov/documentation/services-web-api etc
• Testability
• Best practices
• Design patterns
• Availability of external APIs is not guaranteed and should not cause page to crash
• Twenty randomized users are added via the seeder process, each having their own unique location (longitude and latitude)
• Anything else you want to do to show off your coding chops!
• Redis is available (Docker service) if you wish to use it

To run the local dev environment:

API

• Navigate to /api folder
• Ensure version docker installed is active on host
• Copy .env.example: cp .env.example .env
• Start docker containers docker compose up (add -d to run detached)
• Connect to container to run commands: docker exec -it fullstack-challenge-app-1 bash
  • Make sure you are in the /var/www/html path
  • Install php dependencies: composer install
  • Setup app key: php artisan key:generate
  • Migrate database: php artisan migrate
  • Seed database: php artisan db:seed
  • Run tests: php artisan test
• Visit api: http://localhost

Frontend

• Navigate to /frontend folder
• Ensure nodejs v18 is active on host
• Install javascript dependencies: npm install
• Run frontend: npm run dev
• Visit frontend: http://localhost:5173