Adds schemas for documentation and narrows the friends from the db

.gitignore

@@ -18,4 +18,8 @@ dev/.DS_Store
 figwheel_server.log
 .rebel_readline_history
 resources/public/js
-bin/set-env-variables.sh
+bin/set-env-variables.sh
+
+# IntelliJ files
+.idea/*
+*.iml

Procfile

@@ -1 +1 @@
-web: java $JVM_OPTS -jar target/smallworld.jar -m smallworld.web
+web: java -Xmx300M -Xss512k -XX:CICompilerCount=2 -Dfile.encoding=UTF-8 -jar target/smallworld.jar -m smallworld.web

README.md

@@ -10,15 +10,16 @@ https://smallworld.kiwi
   - [update code running in the repl](#update-code-running-in-the-repl)
   - [deploy to Heroku](#deploy-to-heroku)
 - [initial designs](#initial-designs)
-- [emails & scheduled jobs](#emails--scheduled-jobs)
+- [emails](#emails)
 - [sql cheatsheet](#sql-cheatsheet)
+- [misc commands cheatsheet](#misc-commands-cheatsheet)
 
 ## run, build, & deploy
 ### local setup
 
 1. `lein install`
 2. install postgres: https://postgresapp.com (database)
-3. create local postgres db called `smallworld-local`
+3. run `bin/setup` to create a local postgres db called `smallworld-local`
 ### local development
 1. run `bin/start-dev.sh`
    - sets the environment variables
@@ -84,11 +85,9 @@ bin/make-and-deploy.sh
 | -                                 | -                                                | -                                         |
 |                                   |                                                  |                                           |
 
-## emails & scheduled jobs
+## emails
 - the server sends emails via SendGrid.  view/edit the templates here:
 https://mc.sendgrid.com/dynamic-templates
-- jobs are scheduled through the Heroku Scheduler:
-https://dashboard.heroku.com/apps/small-world-friends/scheduler
 
 ## sql cheatsheet
 
@@ -114,8 +113,7 @@ https://dashboard.heroku.com/apps/small-world-friends/scheduler
 - make a user go through welcome flow again:
 
    ```sql
-   update settings
-   set    welcome_flow_complete = false
+   update settings set    welcome_flow_complete = false
    where  screen_name           = 'devon_dos';
    ```
 
@@ -142,3 +140,18 @@ https://dashboard.heroku.com/apps/small-world-friends/scheduler
    ALTER TABLE "settings" ADD COLUMN locations jsonb;
    ```
 
+## misc commands cheatsheet
+
+- run command line inside of Heroku:
+   ```
+   heroku ps:exec --app=small-world-friends
+   ```
+- view environment variables for process with pid 4:
+   ```
+   cat /proc/4/environ | tr '\0' '\n'
+   ```
+- run prod jar locally:
+  ```sh
+  lein uberjar # builds the jar
+  java -Xmx300m -Xss512k -XX:CICompilerCount=2 -Dfile.encoding=UTF-8 -jar target/smallworld.jar -m smallworld.web
+  ```

bin/open-local-db.sh

@@ -0,0 +1 @@
+/Applications/Postgres.app/Contents/Versions/14/bin/psql -p5432 "devonzuegel"

bin/open-prod-db.sh

@@ -0,0 +1 @@
+heroku pg:psql postgresql-fluffy-56995 --app small-world-friends

bin/set-env-variables TEMPLATE.sh

@@ -6,4 +6,5 @@ export BING_MAPS_API_KEY=get from Bing Developer
 export COOKIE_STORE_SECRET_KEY=generate a 16-char random string
 export DATABASE_URL=set up in Heroku
 export LEIN_JVM_OPTS="-XX:TieredStopAtLevel=1" # suppresses OpenJDK 64-Bit Server VM warning: https://stackoverflow.com/a/67695691/2639250
+export JAVA_OPTS="-Xmx300m -Xss512k -XX:CICompilerCount=2 -Dfile.encoding=UTF-8" # match the max heap/stack size set by Heroku
 export SENDGRID_API_KEY=get from https://sendgrid.com

bin/setup

@@ -0,0 +1,3 @@
+#!/usr/bin/env bash
+
+psql -U postgres -c "CREATE DATABASE \"smallworld-local\""

dev/dev/repl.clj

@@ -9,13 +9,14 @@
 
 #_{:clj-kondo/ignore [:clojure-lsp/unused-public-var]}
 (defn restart-server []
-  (use 'smallworld.web :reload)
   (backend/stop!)
-  (backend/start! PORT))
+  (use 'smallworld.web :reload)
+  (println "\nrestarting server......\n")
+  (backend/-main))
 
 (defn initialize-repl []
   (println (str "\n\n🌎 starting the small world server (backend): http://localhost:" PORT " 🌍\n"))
-  (backend/start! 3001)
+  (backend/-main)
 
   (println "\n\n🎨 starting the Figwheel server (frontend hot-reloading) 🎨\n")
   (repl-api/start-figwheel!)

project.clj

@@ -14,6 +14,7 @@
                  [twttr "3.2.3"]
                  [cheshire "5.10.1"]
                  [oauth-clj "0.1.16"]
+                 [metosin/reitit "0.5.18"]
                  [cljsjs/mapbox "0.46.0-0"]
                  [ring/ring-jetty-adapter "1.9.5"]
                  [ring/ring-ssl "0.3.0"]
@@ -44,12 +45,10 @@
                                          :source-paths ["src"]
                                          :figwheel true
                                          :compiler {:main "smallworld.frontend"
-                                                    ;; :preloads [devtools.preload]
                                                     :asset-path "js/out"
                                                     :output-to "resources/public/js/main.js"
                                                     :output-dir "resources/public/js/out"
                                                     :optimizations :none
-                                                    ;; :recompile-dependents true
                                                     :source-map true}}]}}
              :uberjar {:env {:production true}
                        :source-paths ["src"]