Controlled Substance Licence (CSL)

Controlled Substance Licence (CSL) allows the public to register and apply for a license to handle controlled substances. The CSL includes a suite of four forms: Registration, Low THC Cannabis, Controlled Drugs, and Precursor Chemicals.

Description

• The form facilitates the upload of required documents, such as the company registration certificate, certificate of good conduct.
• The user is able to review all the answers provided to confirm their details prior to submission.

Getting Started

• Install & run locally
• Install & run locally with Docker Compose
• Install & run locally with VS Code Devcontainers

Dependencies

• This form is built using the HOF framework
• Gov.uk Notify to send notification emails
• File Vault to store and retrieve uploaded files

Install & Run the Application locally

Prerequisites

• Node.js - v.20.18.0
• Redis server running on default port 6379
• File Vault Service - running port 3000

Setup

1. Create a .env file in the root directory and populate it with all the required environment variables for the project.
2. Install dependencies using the command yarn.
3. Start the service in development mode using yarn run start:dev.

Install & Run the Application locally with Docker Compose

You can containerise the application using Docker. The .devcontainer directory includes a docker-compose.dev.yml file for orchestrating multi-container application.

Prerequisites

• Docker

Setup

By following these steps, you should be able to install and run your application using a Docker Compose. This provides a consistent development environment across different machines and ensures that all required dependencies are available.

1. Make sure you have Docker installed and running on your machine. Docker is needed to create and manage your containers.

2. To configure your dev environment, copy /.devcontainer/devcontainer.env.sample to devcontainer.env in the same directory and fill in the necessary values. This ensures your development container is set up with the required environment variables.

3. Open a terminal, navigate to the project directory and run: docker compose -f .devcontainer/docker-compose.dev.yml up -d

4. Once the containers are built and started, you can go inside the app container: docker exec -it devcontainer-hof-csl-app-1 sh (note: Docker containers may be named differently)

5. Run the necessary commands to install dependencies yarn and yarn start:dev to start your application.

Install & Run the Application locally with VS Code Dev Containers

Alternatively, if you are using Visual Studio Code (VS Code), you can run the application with a VS Code Dev Containers.

The .devcontainer folder contains the necessary configuration files for the devcontainer.

Prerequisites

• Docker
• VS Code Dev Containers extention

Setup

By following these steps, you should be able to run your application using a devcontainer in VS Code. The Dev Containers extension lets you use a Docker container as a full-featured development environment. This provides a consistent development environment across different machines and ensures that all required dependencies are available. A devcontainer.json file in this project tells VS Code how to access (or create) a development container with a well-defined tool and runtime stack.

1. Make sure you have Docker installed and running on your machine. Docker is needed to create and manage your containers.

2. Install the Dev Containers extention in VS Code. This extension allows you to develop inside a containerised environment.

3. To configure your dev environment, copy /.devcontainer/devcontainer.env.sample to devcontainer.env in the same directory and fill in the necessary values. This ensures your development container is set up with the required environment variables.

4. Run the Dev Containers: Open Folder in Container... command from the Command Palette (F1) or click on the Remote Indicator (≶) in the status bar. This command will build and start the devcontainer based on the configuration files in the .devcontainer folder.

5. Once the devcontainer is built and started, you will be inside the containerised environment. You can now work on your project as if you were working locally, but with all the necessary dependencies and tools installed within the container.

6. To start the application, open a terminal within VS Code by going to View -> Terminal or by pressing Ctrl+backtick. In the terminal, navigate to the project directory if you're not already there.

7. Run the necessary commands to install dependencies yarn and yarn start:dev to start your application.

Testing

Linting Tests

$ yarn test:lint

Unit Tests

$ yarn test:unit

Deployment

This application is containerised and ready for deployment on Kubernetes. Refer to the kube/ directory for Kubernetes deployment scripts.