Update README

Add README for both applications.

Run integration & e2e tests in band to avoid state leak.

README.md

@@ -10,3 +10,33 @@
 ## Description
 
 TBD
+
+## Application
+
+- [AuthZ](./apps/authz-node/README.md)
+- [Orchestration](./apps/orchestration/README.md)
+
+## Docker
+
+We use Docker & `docker-compose` to run the application's dependencies.
+
+```bash
+make docker/up
+make docker/stop
+```
+
+## Formatting
+
+We use [Prettier](https://prettier.io/) and [ESLint](https://eslint.org/) to
+ensure code consistency. You can run the following commands to format and lint
+the whole code base.
+
+```bash
+# Format and lint all the code.
+make format
+make lint
+
+# Check for formatting and linting errors without fixing them.
+make format/check
+make lint/check
+```

apps/authz-node/Makefile

@@ -1,6 +1,9 @@
 AUTHZ_PROJECT_NAME := apps/authz-node
 AUTHZ_PROJECT_DIR := ./apps/authz-node
 
+authz/copy-default-env:
+	cp ${AUTHZ_PROJECT_DIR}/.env.default ${AUTHZ_PROJECT_DIR}/.env
+
 authz/test/copy-default-env:
 	cp ${AUTHZ_PROJECT_DIR}/.env.test.default ${AUTHZ_PROJECT_DIR}/.env.test
 

apps/authz-node/README.md

@@ -0,0 +1,3 @@
+# AuthZ
+
+TBD

apps/authz-node/project.json

@@ -55,21 +55,26 @@
       "executor": "@nx/jest:jest",
       "outputs": ["{workspaceRoot}/coverage/{projectRoot}"],
       "options": {
-        "jestConfig": "apps/authz-node/jest.unit.ts"
+        "jestConfig": "apps/authz-node/jest.unit.ts",
+        "verbose": true
       }
     },
     "test:integration": {
       "executor": "@nx/jest:jest",
       "outputs": ["{workspaceRoot}/coverage/{projectRoot}"],
       "options": {
-        "jestConfig": "apps/authz-node/jest.integration.ts"
+        "jestConfig": "apps/authz-node/jest.integration.ts",
+        "verbose": true,
+        "runInBand": true
       }
     },
     "test:e2e": {
       "executor": "@nx/jest:jest",
       "outputs": ["{workspaceRoot}/coverage/{projectRoot}"],
       "options": {
-        "jestConfig": "apps/authz-node/jest.e2e.ts"
+        "jestConfig": "apps/authz-node/jest.e2e.ts",
+        "verbose": true,
+        "runInBand": true
       }
     }
   },

apps/orchestration/Makefile

@@ -2,6 +2,9 @@ ORCHESTRATION_PROJECT_NAME := apps/orchestration
 ORCHESTRATION_PROJECT_DIR := ./apps/orchestration
 ORCHESTRATION_DATABASE_SCHEMA := ${ORCHESTRATION_PROJECT_DIR}/src/persistence/schema/schema.prisma
 
+orchestration/copy-default-env:
+	cp ${ORCHESTRATION_PROJECT_DIR}/.env.default ${ORCHESTRATION_PROJECT_DIR}/.env
+
 orchestration/db/generate-types:
 	npx prisma generate \
 		--schema ${ORCHESTRATION_DATABASE_SCHEMA}

apps/orchestration/README.md

@@ -0,0 +1,22 @@
+# Orchestration
+
+## Getting started
+
+```bash
+# Boot PostgreSQL and Redis
+make docker/up 
+make orchestration/copy-default-env
+make orchestration/db/migrate
+```
+
+## Testing
+
+Firs time? Run `orchestration/test/copy-default-env` and `make
+orchestration/test/db/setup` to setup the test database.
+
+```bash
+make orchestration/test/type
+make orchestration/test/unit
+make orchestration/test/integration
+make orchestration/test/e2e
+```

apps/orchestration/project.json

@@ -54,21 +54,26 @@
       "executor": "@nx/jest:jest",
       "outputs": ["{workspaceRoot}/coverage/{projectRoot}"],
       "options": {
-        "jestConfig": "apps/orchestration/jest.unit.ts"
+        "jestConfig": "apps/orchestration/jest.unit.ts",
+        "verbose": true
       }
     },
     "test:integration": {
       "executor": "@nx/jest:jest",
       "outputs": ["{workspaceRoot}/coverage/{projectRoot}"],
       "options": {
-        "jestConfig": "apps/orchestration/jest.integration.ts"
+        "jestConfig": "apps/orchestration/jest.integration.ts",
+        "verbose": true,
+        "runInBand": true
       }
     },
     "test:e2e": {
       "executor": "@nx/jest:jest",
       "outputs": ["{workspaceRoot}/coverage/{projectRoot}"],
       "options": {
-        "jestConfig": "apps/orchestration/jest.e2e.ts"
+        "jestConfig": "apps/orchestration/jest.e2e.ts",
+        "verbose": true,
+        "runInBand": true
       }
     }
   },