Merge pull request #306 from developmentseed/develop

merging v1.7.0 ahead of v2 refactor

Author: kamicut

.circleci/config.yml

@@ -2,7 +2,7 @@ version: 2
 jobs:
   build:
     docker:
-      - image: circleci/node:12.16
+      - image: circleci/node:14
 
         environment:
             DATABASE_URL: postgres://postgres@localhost/osm-teams-test

.env.sample

@@ -1,3 +1,3 @@
 OSM_CONSUMER_KEY=<osm-consumer-key>
 OSM_CONSUMER_SECRET=<osm-consumer-secret>
-DSN=postgres://postgres@host.docker.internal/osm-teams?sslmode=disable
+DSN=postgres://postgres@dev-db/osm-teams?sslmode=disable

.gitignore

@@ -11,4 +11,5 @@ node_modules.nosync
 .idea
 hydra-config/prod/prod.yml
 .nyc_output
-coverage
+coverage
+docker-data/*

.nvmrc

@@ -1 +1 @@
-v12.16
+14

Dockerfile

@@ -1,4 +1,4 @@
-FROM node:lts
+FROM node:14
 
 # Create app directory
 WORKDIR /usr/src/app

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Development Seed
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -16,53 +16,30 @@
 Check the beta 👉 <!-- markdownlint-disable MD034 -->https://mapping.team
 <!-- markdownlint-enable MD034 -->
 
+## Development
 
-## Installation
+Install requirements:
 
-### Requirements
+- [nvm](https://github.com/creationix/nvm)
+- [Docker](https://www.docker.com)
 
-- [PostgreSQL](https://www.postgresql.org). On OS X, the easiest is to install [Postgres.app](https://postgresapp.com/).
-- [Node.js](https://nodejs.org) v12.16+
-- [Docker](https://www.docker.com/) & Docker Compose
+Visit your [OpenStreetMap settings](https://www.openstreetmap.org/account/edit) page and register an OAuth1 Client App:
 
-### Setting up Hydra
+![OSM Client App](oauth1-osm-client-app.png "OAuth1 page at OSM Website")
 
-1. Create the database for tokens
-
-    ```bash
-    createdb osm-teams
-    createdb osm-teams-test
-    ```
-
-    For the rest of this documentation, we will assume that the database location is `postgres://postgres@localhost/osm-teams?sslmode=disable` on your local machine. Inside docker, that location is `postgres://[email protected]/osm-teams?sslmode=disable`
-
-1. Create an `.env` file by copying `.env.sample` and replacing the values as needed. `OSM_CONSUMER_KEY` and `OSM_CONSUMER_SECRET` are values obtained by creating a new OAuth app on openstreetmap.org. The .env file can contain:
+Create an `.env` file by copying `.env.sample` and replacing the values as needed. `OSM_CONSUMER_KEY` and `OSM_CONSUMER_SECRET` are values available at the OAuth app page on openstreetmap.org. The .env file should contain:
 
     ```bash
     OSM_CONSUMER_KEY=<osm-teams-app>
     OSM_CONSUMER_SECRET=<osm-teams-app-secret>
-    DSN=postgres://[email protected]/osm-teams?sslmode=disable
-    ```
-
-1. Build the docker images:
-
-    ```bash
-    docker-compose -f compose.yml build
-    ```
-
-1. Start Hydra and the server
-
-    ```bash
-    docker-compose -f compose.yml -f compose.dev.yml up
+    DSN=postgres://postgres@dev-db/osm-teams?sslmode=disable
     ```
 
-⚠️ In development, `docker-compose -f compose.yml -f compose.dev.yml up` enables hot module reloading while you make modifications to the code. `docker-compose up` should be used for production/staging deployments.
-
-This will start hydra where the token issuer is at `http://localhost:4444` and the admin interface is at `http://localhost:4445`. This also sets up the consent and login interface at `http://localhost:8989` (where we will create a first-party oauth app)
+Start Hydra and PostgreSQL with Docker:
 
-### Setting up the OSM-teams app
+    docker-compose -f compose.dev.yml up --build
 
-Create the [first-party](https://auth0.com/docs/applications/concepts/app-types-first-third-party) "manage" app
+On a separate terminal, create the [first-party](https://auth0.com/docs/applications/concepts/app-types-first-third-party) "manage" app:
 
 ```bash
 docker-compose exec hydra hydra clients create --endpoint http://localhost:4445 \
@@ -74,6 +51,22 @@ docker-compose exec hydra hydra clients create --endpoint http://localhost:4445
   --callbacks http://localhost:8989/login/accept
 ```
 
+Install Node.js the required version (see [.nvmrc](.nvmrc) file):
+
+    nvm i
+
+Install Node.js modules:
+
+    yarn
+
+Migrate `dev-db` database:
+
+    yarn migrate
+
+Start development server:
+
+    yarn dev
+
 <!-- markdownlint-disable MD034 -->
 ✨ You can now login to the app at http://localhost:8989
 <!-- markdownlint-enable MD034 -->

app/db/knexfile.js

@@ -1,16 +1,12 @@
-let DATABASE_URL
+let DATABASE_URL = process.env.DSN || process.env.DATABASE_URL
 
-if (!process.env.NODE_ENV) {
-  process.env.NODE_ENV = 'development'
-}
-
-if (process.env.DSN) {
-  DATABASE_URL = process.env.DSN
-} else {
-  if (process.env.NODE_ENV === 'development') {
-    DATABASE_URL = 'postgres://postgres@localhost/osm-teams?sslmode=disable'
+// Apply defaults if no connection string is passed
+if (!DATABASE_URL) {
+  if (!process.env.NODE_ENV || process.env.NODE_ENV === 'development') {
+    DATABASE_URL =
+      'postgres://postgres:postgres@localhost:5433/osm-teams?sslmode=disable'
   } else if (process.env.NODE_ENV === 'test') {
-    DATABASE_URL = 'postgres://postgres@localhost/osm-teams-test?sslmode=disable'
+    DATABASE_URL = 'postgres://postgres:postgres@localhost:5434/osm-teams-test?sslmode=disable'
   }
 }
 

app/db/migrations/20220125220402_org-privacy-policy.js

@@ -0,0 +1,12 @@
+
+exports.up = async function (knex) {
+  await knex.schema.alterTable('organization', table => {
+    table.json('privacy_policy')
+  })
+}
+
+exports.down = async function (knex) {
+  await knex.schema.alterTable('organization', table => {
+    table.dropColumn('privacy_policy')
+  })
+}

app/db/migrations/20220222155039_add_badges.js

@@ -0,0 +1,16 @@
+exports.up = async function (knex) {
+  await knex.schema.createTable('organization_badge', (table) => {
+    table.increments('id')
+    table
+      .integer('organization_id')
+      .references('id')
+      .inTable('organization')
+      .onDelete('CASCADE')
+    table.string('name').notNullable()
+    table.string('color').notNullable()
+  })
+}
+
+exports.down = async function (knex) {
+  await knex.schema.dropTable('organization_badge')
+}