Setup backend DB and add example service

api/README.md

@@ -0,0 +1,56 @@
+# Closegap API
+
+This folder contains the backend api of the application.
+
+## Setup DB
+
+### Install PostgreSQL
+
+#### macOS
+
+1. Install [Homebrew](https://brew.sh).
+
+2. Install postgresql via Homebrew.
+
+   `$ brew install postgresql`
+
+3. Start postgresql and register it to launch on system start.
+
+   `$ brew services start postgresql`
+
+#### Windows Subsystem for Linux (WSL)
+
+1. [Install postgresql.](https://github.com/michaeltreat/Windows-Subsystem-For-Linux-Setup-Guide/blob/master/readmes/installs/PostgreSQL.md)
+
+2. Start postgresql.
+
+   `$ sudo service postgresql start `
+
+### Create database
+
+Run setup script. Enter `n` if you do not wish to seed with initial data.
+
+```
+$ infra/setup_dev_db.sh
+Seed database with initial data? [Y/n] y
+...
+```
+
+## Configure App
+
+```
+$ cp config/dev.env.default config/dev.env
+```
+
+## Install & Run
+
+```bash
+yarn && yarn start
+```
+
+## Test DB access
+
+```
+$ curl http://localhost:5000/students/1
+{"data":{"id":"1","user_id":"1","first_name":"Ipsum1","middle_name":"Lorem1","last_name":"Dolor1","birthdate":"2010-11-14T06:00:00.000Z","homeroom_teacher":"Amet1","grade":"1st","gender":"male","created_at":"2020-10-01T09:31:50.910Z","updated_at":"2020-10-01T09:31:50.976Z","school_name":"some school name"}}%
+```

api/config/dev.env.default

@@ -0,0 +1,10 @@
+# PostgreSQL DB Configuration
+
+PGDATABASE=closegap-api_development
+
+PGHOST=localhost
+
+PGUSER=closegap-api
+PGPASSWORD=closegap-api
+
+PGPORT=5432

api/infra/setup_dev_db.sh

@@ -0,0 +1,20 @@
+#!/usr/bin/env bash
+
+ROOT=$(git rev-parse --show-toplevel)
+
+while true; do
+    read -p "Seed database with initial data? [Y/n] " yn
+    case $yn in
+        "" | [Yy]* ) SUFFIX="_seeded"; break;;
+        [Nn]* ) SUFFIX=""; break;;
+        * ) echo "Please answer y or n.";;
+    esac
+done
+
+createuser -d closegap-api
+
+createdb -U closegap-api closegap-api_development
+createdb -U closegap-api closegap-api_test
+
+psql closegap-api_development < ${ROOT}/api/schema/db/development${SUFFIX}.sql
+psql closegap-api_test < ${ROOT}/api/schema/db/test${SUFFIX}.sql

api/package.json

@@ -7,16 +7,21 @@
     "format:check": "prettier --check \"./**/*.{js,jsx,json,md}\"",
     "lint": "eslint \"./**/*.js\"",
     "lint:fix": "eslint --fix \"./**/*.js\"",
-    "start": "nodemon ./src/bin/www"
+    "start": "yarn start:dev",
+    "start:dev": "NODE_ENV=dev nodemon ./src/bin/www"
   },
   "dependencies": {
     "cookie-parser": "~1.4.4",
     "cors": "^2.8.5",
     "debug": "~2.6.9",
+    "dotenv": "^8.2.0",
     "express": "~4.16.1",
     "http-errors": "~1.6.3",
+    "http-status-codes": "^2.1.4",
     "morgan": "~1.9.1",
-    "nodemon": "^2.0.4"
+    "nodemon": "^2.0.4",
+    "pg": "^8.3.3",
+    "pg-promise": "^10.6.1"
   },
   "devDependencies": {
     "@h4iuiuc/eslint-plugin": "^1.0.12",