Vacation Now

The image gallery of a webapp for users to post listings of places to stay for vacation.

Related Projects

• https://github.com/HRR47-SDC-Burke/booking-service
• https://github.com/HRR47-SDC-Burke/reviews-service
• https://github.com/HRR47-SDC-Burke/moreplacestostay-service

Table of Contents

1. Usage
2. Requirements
3. Development

Usage

This module builds a simple interactive photo gallery. It takes a numeric location ID from the URL and fetches images associated with that location.

Requirements

An nvmrc file is included if using nvm.

• Node 6.13.0
• Express 4.17.1
• Axios 0.19.2
• React 16.13.1
• mySQL 2.18.1

Dev:

• Babel 7.11.1
• Webpack 4.44.1
• Jest 26.2.2
• Enzyme 3.11.0
• Amazon S3

Development

Installing Dependencies

From within the root directory:

npm install -g webpack
npm install

Running The Module

Make sure all dependencies are installed. In the db config file, ensure correct username and password for your mySQL. Then, once your mySQL server is up and running, run the carousel.sql file to implement schema for table images. Then, from the command line, run the following:

npm run seed

This will seed the database with 100 primary records with location IDs spanning 1-100 and anywhere between 4 and 29 images per location. The images themselves are stored in an Amazon S3 bucket with numeric names between 1 and 50. The image selection per location is random.

Once this is done, run:

npm start
npm run build

Direct your browser to localhost:3001/:id, and you should see the gallery module populated with images from your database. To specify a different location, change the id (anywhere between 1 and 100, inclusive).

Testing

To run tests:

npm test

Testing is implemented with Jest and Enzyme. Should you update the components in a way that changes the snapshot against which the tests are compared, run the following up update all snapshots:

npm test -- -u

CRUD Routes

GET:

/api/images/:id

Gets the images corresponding to a given ID.

POST:

/api/images

Creates a new listing ID and assigns it new images.

PUT:

/api/images/:id

Adds more images to the given ID.

DELETE:

/api/images/:id

Deletes all images assigned to the given ID.

Generating CSV Data

To generate 10 million listings in CSV form:

npm run csvgen

Artillery Testing

Before testing Artillery, make sure you've installed it globally:

npm install -g artillery

To test GET requests in Artillery, while the server is running:

artillery run server/spec/artillery.get.yml

To test POST requests in Artillery, while the server is running:

artillery run server/spec/artillery.post.yml