Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nhsuk/connecting-to-services
Find a pharmacy
https://github.com/nhsuk/connecting-to-services
c2s connecting-to-services docker-image
Last synced: about 3 hours ago
JSON representation
Find a pharmacy
- Host: GitHub
- URL: https://github.com/nhsuk/connecting-to-services
- Owner: nhsuk
- License: mit
- Created: 2016-09-07T11:27:48.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2022-12-10T16:53:48.000Z (almost 2 years ago)
- Last Synced: 2023-03-11T18:27:16.670Z (over 1 year ago)
- Topics: c2s, connecting-to-services, docker-image
- Language: JavaScript
- Homepage: https://www.nhs.uk/service-search/find-a-pharmacy/
- Size: 11.1 MB
- Stars: 2
- Watchers: 10
- Forks: 9
- Open Issues: 47
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Connecting to services
[](https://github.com/nhsuk/connecting-to-services/releases/latest/)
[](https://greenkeeper.io/)
[](https://travis-ci.org/nhsuk/connecting-to-services)
[](https://coveralls.io/github/nhsuk/connecting-to-services?branch=master)
> A service to help people connect to pharmacy services.
## Installation
Clone the repo: `git clone https://github.com/nhsuk/connecting-to-services.git`
and review the [`scripts`](scripts) to get up and running.
## Changing the date and time
The application will display a message for each open pharmacy on a bank holiday.
In order to test this functionality the date can be set when the application
starts. In order to do this the environment variable, `DATETIME` needs to be
set. For example, if the date wanted to be to set to Christmas day 2017 the
following can be run on the command line
`DATETIME=2017-12-25T12:00:00 ./scripts/start`.
## Testing
The application uses [Docker](https://www.docker.com/) to run in containers.
Development is typically done on the host machine. Files are loaded into the
container and changes are automatically updated.
Use the `test` script for continuous testing during development.
## Test environments
As the application is being developed, every Pull Request has its own test
environment automatically built and deployed to.
Every environment apart from the one we want the public to access requires
basic authentication to access. The username and password are not secret, in
fact they are included within environment variable table below.
The intention with the authentication challenge is to prevent people whom may
stumble across the site and not realise it is for testing, it also prevents
access by search engines and other bots.
## BackstopJS tests
There are some BackstopJS UI tests located in [backstop-tests](backstop-tests).
These can be run in Docker using the following instructions:
* From the project root directory run `./scripts/backstop`
* An html report will be generated. It will be accessible at
`./backstop-tests/backstop_data/html_report/index.html`
## Environment variables
Environment variables are expected to be managed by the environment in which
the application is being run. This is best practice as described by
[twelve-factor](https://12factor.net/config).
In order to protect the application from starting up without the required
env vars in place
[require-environment-variables](https://www.npmjs.com/package/require-environment-variables)
is used to check for the env vars that are required for the application to run
successfully.
This happens during the application start-up. If an env var is not found the
application will fail to start and an appropriate message will be displayed.
Environment variables are used to set application level settings for each
environment.
| Variable | Description | Default | Required |
| :--------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------- | :-------- |
| `ADOBE_TRACKING_URL` | [Adobe Analytics](https://www.adobe.com/analytics/adobe-analytics.html) Dynamic Tag Management URL | | No |
| `BACKSTOP_TEST_URL` | The fully qualified domain against which the BackstopJS UI tests will be run e.g. `http://beta.nhs.uk` | http://beta.nhs.uk | Yes |
| `BASIC_AUTH` | An MD5 encrypted [htpasswd](https://httpd.apache.org/docs/2.4/misc/password_encryptions.html) | See value set in Vault for `BASIC_AUTH` in defaults | |
| `BUSINESS_HOURS_START_HOUR` | Business hours start hour | 8 | No |
| `BUSINESS_HOURS_START_MINUTE` | Business hours start minute | 0 | No |
| `BUSINESS_HOURS_END_HOUR` | Business hours end hour | 18 | No |
| `BUSINESS_HOURS_END_MINUTE` | Business hours end minute | 0 | No |
| `COOKIEBOT_SCRIPT_URL` | The URL for the in-house implementation of Cookiebot | //assets.nhs.uk/scripts/cookie-consent.js | |
| `DATETIME` | The initial display of results is determined by the time of the search. Bank holiday messaging is determined by the date of the search | | No |
| `HOTJAR_ANALYTICS_TRACKING_ID` | [Hotjar](https://www.hotjar.com/) tracking id | | No |
| `LOG_LEVEL` | Numeric [log level](https://github.com/trentm/node-bunyan#levels) | Depends on `NODE_ENV` | |
| `NODE_ENV` | Node environment | development | |
| `PORT` | Server port | 3000 | |
| `SEARCH_API_HOST` | Hostname for Organisation Search API | api.nhs.uk | No |
| `SEARCH_API_KEY ` | Access key for Organisation Search API | | Yes |
| `SEARCH_API_VERSION` | Organisation Search API version number | 1 | No |
## FAQ
* Is the application failing to start?
* Ensure all expected environment variables are available within the environment
* If set, `LOG_LEVEL` must be a number and one of the defined [log levels](https://github.com/trentm/node-bunyan#levels)
* Check for messages in the logs
## Architecture Decision Records
This repo uses
[Architecture Decision Records](http://thinkrelevance.com/blog/2011/11/15/documenting-architecture-decisions)
to record architectural decisions for this project.
They are stored in [doc/adr](doc/adr).