Skip to content

Website for NICE Clinical Knowledge Summaries (CKS) built with Gatsby and using the NICE Design System

License

Notifications You must be signed in to change notification settings

nice-digital/cks-gatsby

Repository files navigation

NICE Clinical Knowledge Summaries (CKS)

Website for NICE Clinical Knowledge Summaries (CKS). Provides summaries of current evidence, and practical guidance, for primary care practitioners

🚀 Jump straight to getting started

Table of contents

What is it?

CKS is a microsite providing summaries of current evidence and practical guidance. It presents over 300+ topics (e.g. cough, food allergy or infertility) grouped across 25+ specialities (e.g. allergies or musculoskeletal).

It's mainly aimed at GPs, nurses, pharmacists and other primary care practitioners. CKS is used by around 450,000 users a month (as of February 2020) and is NICE's third most used service.

The content is provided by a third party, Clarity, commissioned by NICE. We receive the content via a JSON API provided by Clarity and use this to generate the site every month.

Project structure

Folder Purpose
fake-api A local, fake API with limited content for faster local development
gatsby Static site built with React and Gatsby
web-app Web application that wraps the static site and provides the search results endpoint
functional-tests Browser-based functional tests in WebdriverIO

Note: Each of these folders has its own readme with detailed setup steps etc

Stack

This is the high level stack. Each of the sub-projects (gatsby, web-app and functional-tests) has its own readme with more detailed stack.

Software

Architecture

CKS is a static site, generated once per month. This is because the content feed gets updated monthly and includes the What's New section, to show users what has changed month on month. Generating a static site also has the benefit of being able to generate the HTML upfront and just serve the content, without runtime processing resulting in a faster website.

The static site is generated with Gatsby, which also has the benefit of Hot Module Replacement (HMR) for faster local development.

The resulting HTML built by the static site generator is packaged and deployed within the .NET Core web application. This web app contains server side C# .NET code to handle the search API endpoint, and uses the Search Client to talk to ElasticSearch.

There are tests for the static site, the search .NET project, and browser-based, functional tests that run via WebDriverIO.

Search

The cks-gatsby webapp uses the NICE.Search Nuget package to query the CKS ElasticSearch index.

The NICE.Search Nuget packages uses .Net Standard and is configured in the appsettings.json.

Search results come from ElasticSearch (ES), provided by the SearchClient NuGet package. They are served to the front-end as a JSON response at the api/search endpoint via an MVC controller in the web-app project. SearchController references and calls the SearchClient NuGet package internally. The search results page is then rendered client-side, hence the results being at /search?q=....

You can see the JSON response that's used for client-side rendering by visiting https://localhost:5000/api/search?q=test in your browser.

ElasticSearch

There are two ES instances available, one on the NHSEVIRT domain and one in AWS.

  • You will only be able to verify search functionality if you are connected to either the pink cable, the IM&T wi-fi or have a local elastic search instance set up.

  • You may need to add dev.es.nice.org.uk to your hosts file if you are unable to resolve the ES server using DNS

  • Make the following changes in \cks-gatsby\web-app\CKS.Web\appsettings.json (don't check in!):

    • set https://test-search-api.nice.org.uk for SearchApiUrl whilst developing
    • set https://search-api.nice.org.uk for SearchApiUrl for deploying to live servers at AWS.

    If you are not on the pink cable or NICE network see this document for setting up local elasticsearch indexes for the searchclient nuget to use. Also there are snapshots available to use.

🚀 Set up

The easiest way to get the project running is:

  1. Install Node 10+ (latest LTS version)
  2. Clone this repository
  3. Open the root of the repository in VS Code
    1. Install recommended extensions when prompted
  4. Install dependencies:
    1. Open the command palette (Ctrl+Shift+P) in VS Code, then:
    2. Run 'npm: Install Dependencies' (and choose 'Run all commands listed below')
    3. Run '.NET: Restore Project' for CKS.Web
  5. Go to the 'Run and Debug' panel (Ctrl+Shift+D) in VS Code
  6. Run Launch CKS

Launching the app via Launch CKS does the following:

  1. http://localhost:5000/ - Builds and runs the .NET core web app in the background
  2. http://localhost:8001/ - Creates a local, fake CKS api
  3. http://localhost:8000/ - Builds the Gatsby static site then launches it in Chrome once it's built
  4. Proxies http://localhost:8000/api/search (in the Gatsby site) to http://localhost:5000/api/search (in the .NET core app)

It also attached debuggers so you can add break points in VS Code for the Gatsby Node processes, the Gatsby React components, the fake API and the .NET web app classes.

Note: there are more granular ways to run each part of the project, either via an IDE or via the command line. See each sub-folders's readme for more details.

Good to know

Further info

See the CKS Sharepoint site

Environments

Environment URL
Local https://local-cks.nice.org.uk
Live https://cks.nice.org.uk/

Top 5 common issues affecting users

An explanation of the top 5 common issues (if applicable) that we as a development team might encounter with this project

Regenerate the Table of Contents

For further information about the recommended ReadMe structure plus a 'how to' for regenerating the table of contents, follow the instructions in DIT Engineering - ReadMes