national-document-repository

Links

• Lambda function README.md.
• React User Interface README.md.
• E2E test README.md (we have E2E tests for our FHIR endpoints and APIM setup).

Running Locally

The dev container option standardises tools for both python (via poetry) and node via asdf.

Warning

Once you have the dev container running, you will need to install your git credentials for signing your commits.

If the dev container build errors on docker, check your config at ~/.docker/config.json, which should have something similar to:

{
    "auths": {}
}

Remove any lines that mention desktop.

Pre-requisites

The following tools are required for all options:

• Git
• Docker (e.g. via Brew)

Method 1 - Dev container within VS Code (recommended)

Important

This will not work within a VS Code Workspace.

1. Install the Dev Containers VSCode extension.
2. Press Ctrl+Shift+P.
3. Select Dev Containers: Rebuild and Reopen in Container.

Method 2 - Dev container (not using VS Code)

If you don't use VSCode, run the following commands:

npm install -g @devcontainers/cli
devcontainer build --workspace-folder .
devcontainer up --workspace-folder .
devcontainer exec --workspace-folder . bash
devcontainer exec --workspace-folder . nvim .

Inside the container you can run the following.

nvim
tmux
lazygit

Method 3 - Manual installation

• Terraform
• docker-compose
• AWS CLI
• Awsume
• ruff
• Node@24
• [email protected]

Monitoring

We have configured AWS CloudWatch to provide alarm notifications whenever one of a number of metrics exceeds its normal state. Currently, the only way to receive these notifications is by subscribing to an SNS topic using an email. You can subscribe to the SNS topic once you have assumed an appropriate role using the AWS CLI. This is the command:

aws sns subscribe --topic-arn [topic-arn] --protocol email --notification-endpoint [your NHS email]

You will receive a confirmation email with a link allowing you to confirm the subscription. We are also subscribing to the SNS topic using email addresses that are provided for Microsoft Teams channels.