initial openapi file (#481)

* initial openapi file

* fix docs

* website url

* tweaking docs

* filling in api docs

* prototyping openapi docs

* restore changes

* heavy update to openapi spec

* finished draft of docs + minor grooming to standardize

* I think docs are ready

* updates from code review

Author: amites

package.json

@@ -83,7 +83,8 @@
     "build:local-packages": "yarn workspace @upswyng/types build && yarn workspace @upswyng/common build",
     "build:server": "yarn build:local-packages && yarn workspace @upswyng/server build",
     "build:web": "yarn build:local-packages && yarn workspace @upswyng/web build",
-    "build:local-db": "docker compose up --build -d && mongorestore --port 27018 --username upswyng-dev-user --password upswyng123 -d upswyng-dev ./packages/server/localdb/mongodump",
+    "build:local-db": "docker-compose up --build -d && npm run restore:db",
+    "restore:db": "mongorestore --port 27018 --username upswyng-dev-user --password upswyng123 -d upswyng-dev ./packages/server/localdb/mongodump",
     "clean": "node clean.js",
     "reset": "node clean.js --reset && docker compose down -v",
     "heroku-postbuild": "yarn build:web && yarn build:server",