feat: flesh in api router (#806)

Signed-off-by: hxtree <[email protected]>

README.md

@@ -52,16 +52,6 @@ Github Codespaces.
 Alternatively, git clone the repo and build, test, and deploy apps locally using
 the [devcontainer](.devcontainer/README.md).
 
-## Architecture
-
-This repository houses a collection of event-driven microservices, built on a
-powerful Platform as a Service (PaaS) foundation. The integration of
-Infrastructure as Code (IaC) ensures a streamlined DevOps pipeline for
-continuous integration and continuous deployment (CI/CD) leveraging the power of
-AWS.
-
-![Flow Chart](docs/flow-chart.drawio.svg)
-
 ### Pull Request Lifecycle (~5 mins)
 
 1. Checkout a new branch from main using git.
@@ -102,12 +92,56 @@ AWS.
    git push
    ```
 
+## Infrastructure
+
+### Architecture
+
+This repository houses a collection of event-driven microservices, built on a
+powerful Platform as a Service (PaaS) foundation. The integration of
+Infrastructure as Code (IaC) ensures a streamlined DevOps pipeline for
+continuous integration and continuous deployment (CI/CD) leveraging the power of
+AWS.
+
+![Flow Chart](docs/flow-chart.drawio.svg)
+
+## Provisioning
+
+1. Setup [AWS Org Formation](/platform/aws-org-formation/README.md).
+
+2. Login via SSO, bootstrap deployments, deploy platform, deploy services, and
+   then deploy clients.
+
+   ```bash
+   rush sso
+   rush cdk:bootstrap
+   rush cdk:deploy --to tag:deploy-platform
+   rush cdk:deploy --to tag:services
+   rush cdk:deploy --to tag:clients
+   ```
+
+3. Login via SSO to tools account and then deploy tools.
+
+   ```bash
+   rush sso -p tools
+   rush cdk:bootstrap
+   rush cdk:deploy --to tag:deploy-tools
+   ```
+
 ## Documentation
 
 See [Documentation](docs/index.md).
 
 > **Note** Use `rush help` for information on builtin commands.
 
+### Third Party Documentation
+
+- [AWS CLI](https://docs.aws.amazon.com/cdk/v2/guide/cli.html)
+- [Typescript](https://www.typescriptlang.org/docs/)
+- [Jest](https://jestjs.io/)
+- [RushJS](https://rushjs.io)
+  - [Selecting Subsets](https://rushjs.io/pages/developer/selecting_subsets/)
+- [Rushstack](https://github.com/microsoft/rushstack)
+
 ## Contributing
 
 [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](http://makeapullrequest.com)

clients/admin-client/src/App.tsx

@@ -17,6 +17,7 @@ function App() {
           {url: `https://jukebox.${parentDomainName}`, label: 'Jukebox'},
           {url: `https://design.${parentDomainName}`, label: 'Design System'},
           {url: `https://api.${parentDomainName}`, label: 'Developer API'},
+          {url: 'https://nekosgate.awsapps.com/mail', 'label': 'WorkMail'}
       ]}/>
     </>
   );

clients/design-system/README.md

@@ -3,8 +3,6 @@
 [![Storybook](https://cdn.jsdelivr.net/gh/storybookjs/brand@main/badge/badge-storybook.svg)](link
 to site)
 
-![CloudFormation Diagram](tree-designer.png)
-
 This
 [design system](https://storybook.js.org/tutorials/design-systems-for-developers/)
 contains common components for use in other front end applications. It contains

clients/design-system/stacks/design-system.stack.ts

@@ -29,6 +29,7 @@ export class DesignSystemStack extends cdk.Stack {
       bucketName: `${awsAccountId}-${stageName}-design-system-bucket`,
       accessControl: BucketAccessControl.PRIVATE,
       removalPolicy: RemovalPolicy.DESTROY,
+      autoDeleteObjects: true,
     });
 
     const originAccessIdentity = new OriginAccessIdentity(

services/jukebox/README.md → clients/jukebox/README.md

@@ -3,8 +3,6 @@
 ![TypeScript](https://shields.io/badge/TypeScript-3178C6?logo=TypeScript&logoColor=FFF&style=flat-square)
 [![GitHub Stars](https://img.shields.io/github/stars/hxtree/cats-cradle?style=social)](https://github.com/hxtree/cats-cradle/stargazers)
 
-![CloudFormation Diagram](tree-designer.png)
-
 This services plays only retro music -- so turn up the volume to 11. We're
 talking Impulse Tracker (\*.it) files.
 

commitlint.config.js

@@ -1,3 +1,7 @@
+/**
+ * Commits to source control MUST adhere to the Conventional Commits standard.
+ * {@link https://www.conventionalcommits.org/en/v1.0.0/}
+ */
 module.exports = {
   extends: ['@commitlint/config-conventional'],
   rules: {