certificates.orders.web.ch.gov.uk

Certificate ordering web service integrating with the CH orders service

Contents

• Quick start
• Prerequisites
• Running the server
• Static assets
• Compiling the application
• Linting
• Testing
• Feature Flags

Quick start

If you are familiar with NodeJS development and already have it installed, simply run the init make task

make init

Carry out a build by running

make build

And then start the application

npm start

Then go to http://localhost:3000.

Prerequisites

You are going to need a few things to begin. Firstly, NodeJS. There are a few ways to install it.

• Official installer
• Node Version Manager
• Homebrew

Node version manager allows you to install multiple versions side by side on the host machine.

Once you have that installed, you will need to install the dependencies (locally) and GulpJS (globally). This task runner is used to compile the Sass used in the GovUK Frontend.

npm i
npm install gulp-cli -g

Running the server

There are two ways to run the server in development. You run it in normal mode;

npm start

Or, automatically reload the server once you make changes to source code;

npm start:watch

Static assets

Sass is used to compile the css from GovUK Frontend. The static gulp task will build the necessary files and output them to the dist folder.

gulp static

During development, static assets are served from this folder using the url prefix /static.

Compiling the application

TypeScript compiles down the JavaScript code that eventually gets run via NodeJS. The build npm task will write the JavaScript to the dist folder.

npm run build

It is this code that gets run in production.

Linting

ESLint is used to perform static analysis on code using a StandardJS ruleset as its base.

npm run lint

You can also autofix minor linting errors by running npm run lint:fix

Testing

Tests can be found in the directory src/test. The framework used is Jest along with Supertest to dispatch handlers that can have assertions made against the responses. Execute the following to run the tests;

npm t

Feature Flags

Use the following environment variables to enable / disable dynamic certificate ordering features.

Variable	Description	Value	Default
DYNAMIC_LP_CERTIFICATE_ORDERS_ENABLED	Limited Partnership certificates	true | false	false
DYNAMIC_LLP_CERTIFICATE_ORDERS_ENABLED	Limited Liability Partnership certificates	true | false	false

Health check endpoint

Path	Method	Description
/certificates-orders-web/health	GET	Returns HTTP OK (200) to indicate a healthy application instance.

Health check implementation note

• The healthcheck endpoint uses the express-actuator package. This means the app also provides /certificates-orders-web/info and /certificates-orders-web/metrics endpoints. These should probably not be exposed.