sdkevorkian / cruddy-board-games-db

Cruddy Board Games Database

This will expand on the Cruddy Board Games project. You can copy your solution into this new repository, or you can copy this completed solution and begin from there.

We will be replacing the games.json "database" with an actual database. We will use PostgreSQL and Sequelize.

Full RESTful Routing (for reference)

Verb	Path	Action	Used for
GET	/games	index	display a list of all games
GET	/games/new	new	return an HTML form for creating a new game
POST	/games	create	create a new game (using form data from /games/new)
GET	/games/:name	show	display a specific game
GET	/games/:name/edit	edit	return an HTML form for editing a game
PUT	/games/:name	update	update a specific game (using form data from /games/:name/edit)
DELETE	/games/:name	destroy	deletes a specific game

Task

Set up sequelize

Refer to sequelize cheatsheet

1. Install the modules we need.

   • npm install --save pg pg-hstore sequelize

2. Create the database.

   • createdb cruddy_board_games_db

3. Initialize.

• sequelize init

4. Configure your config.json file.

Create table and model

1. Use the sequelize command line tool to create a game table in our database.

• sequelize model:create --name game --attributes ...
• What columns should be on game?

2. Run the migrations.

• sequelize db:migrate

3. On the top of app.js file, require the models

• var db = require("./models");

4. Delete games.json, getGames(), and saveGames(). Replace calls to those functions with appropriate usages of db.game.

Example, for the game indexing route:

app.get('/games', function(req, res) {
    var games = getGames();

    res.render('games-index', { games: games });
});

turns into

app.get('/games', function(req, res) {
    db.game.findAll().then(function(games) {
        res.render('games-index', { games: games });
    }).catch(function(error) {
        res.status(404).send(error);
    });
});

Add a column

Add numberOfPlayers to the game model.

sequelize migration:create --name add-number-of-players-to-game

Refer to Sequelize migration documentation.

Edit the new migration file migrations/xxxxxxxxxxx-add-number-of-players-to-game.js.

1. In the up function, use addColumn
2. In the down function, use removeColumn
3. Migrate! sequelize db:migrate
4. Update the model file models/game.js. Add the property: numberOfPlayers: DataTypes.INTEGER

Make sure you also update the show, new game, and edit game pages to use the new numberOfPlayers property.

Validations

Add some validations to our data. For example: num players should be at least 1. Game name should be at least X characters long, etc ...

Refer to the git note book and sequelize's documentation.

Licensing

All content is licensed under a CC­BY­NC­SA 4.0 license. All software code is licensed under GNU GPLv3. For commercial use or alternative licensing, please contact [email protected].