Skip to content

System for managing water abstraction licences, including alerts, returns and billing

License

Notifications You must be signed in to change notification settings

DEFRA/water-abstraction-system

Repository files navigation

Water Abstraction System

Build Status Maintainability Rating Coverage Known Vulnerabilities Licence

This API provides an interface for calculating charges, queuing transactions and generating transaction files used to produce invoices.

Prerequisites

Make sure you already have:

Installation

First clone the repository and then drop into your new local repo:

git clone https://github.com/DEFRA/water-abstraction-system.git && cd water-abstraction-system

Create the databases:

npm run create-db
npm run create-test-db

Our preference is to run the database and API within Docker, so install Docker if you don't already have it.

Configuration

Any configuration is expected to be driven by environment variables when the service is run in production as per 12 factor app.

However when running locally in development mode or in test it makes use of the Dotenv package. This is a shim that will load values stored in a .env file into the environment which the service will then pick up as though they were there all along.

Check out .env.example for details of the required things you'll need in your .env file.

Refer to the config files for details of all the configuration used.

Contributing to this project

If you have an idea you'd like to contribute please log an issue.

All contributions should be submitted via a pull request.

License

THIS INFORMATION IS LICENSED UNDER THE CONDITIONS OF THE OPEN GOVERNMENT LICENCE found at:

http://www.nationalarchives.gov.uk/doc/open-government-licence/version/3

The following attribution statement MUST be cited in your products and applications when using this information.

Contains public sector information licensed under the Open Government license v3

About the license

The Open Government Licence (OGL) was developed by the Controller of Her Majesty's Stationery Office (HMSO) to enable information providers in the public sector to license the use and re-use of their information under a common open licence.

It is designed to encourage use and re-use of information freely and flexibly, with only a few conditions.