|
1 | | -# NHS.UK prototype kit |
| 1 | +# NHS Screening event management prototype |
2 | 2 |
|
3 | | -Visit the <a href="https://prototype-kit.service-manual.nhs.uk">NHS.UK prototype kit site</a> to download the latest version and read the documentation. |
| 3 | +A prototype for managing breast screening clinics and participants, built using the [NHS.UK prototype kit](https://prototype-kit.service.manual.nhs.uk). |
4 | 4 |
|
5 | | -## About the NHS.UK prototype kit |
| 5 | +## About this prototype |
6 | 6 |
|
7 | | -The NHS.UK prototype kit enables you to make interactive prototypes that will look like pages on NHS.UK. The prototypes you make are a great way to show ideas to others and for conducting user research. |
| 7 | +This prototype demonstrates a system for managing breast screening clinics, including: |
| 8 | +- Viewing and managing daily clinic lists |
| 9 | +- Tracking participants through their screening journey |
| 10 | +- Managing participant information and status |
8 | 11 |
|
9 | | -## Security |
10 | | - |
11 | | -If you publish your prototypes online, they must be protected by a <a href="https://prototype-kit.service-manual.nhs.uk/how-tos/publish-your-prototype-online">username and password</a>. This is to prevent members of the public finding prototypes and thinking they are real services. |
12 | | - |
13 | | -You must protect user privacy at all times, even when using prototypes. Prototypes made with the kit look like NHS.UK, but do not have the same security provisions. Always make sure you are handling user data appropriately. |
14 | | - |
15 | | -## Installation instructions |
16 | | - |
17 | | -- <a href="https://prototype-kit.service-manual.nhs.uk/install/simple">Install guide (non technical)</a> |
18 | | -- <a href="https://prototype-kit.service-manual.nhs.uk/install/advanced">Developer friendly install guide (technical)</a> |
19 | | - |
20 | | -### Running the kit |
21 | | - |
22 | | -Start the kit with `npm run watch`. |
23 | | - |
24 | | -## Contribute |
25 | | - |
26 | | -If you want to contribute to the NHS.UK prototype kit, by reporting bugs, fixing bugs, suggesting new features or writing documentation, then read our [contributing guidelines](CONTRIBUTING.md). |
| 12 | +The prototype includes auto-generated example data to demonstrate the interactions and user journeys. |
27 | 13 |
|
28 | | -## Development environment |
| 14 | +## Installation |
29 | 15 |
|
30 | | -Before running Gitpod, you must <a href="https://github.com/apps/gitpod-io/installations/new">install the Gitpod.io application on your GitHub account</a>. |
| 16 | +1. Follow the [NHS.UK prototype kit installation guide](https://prototype-kit.service.manual.nhs.uk/install/simple) |
| 17 | +2. Clone this repository |
| 18 | +3. Run `npm install` |
| 19 | +4. Run `npm run watch` |
31 | 20 |
|
32 | | -Gitpod also requires access to public repositories. Enable this via <a href="https://gitpod.io/integrations">Gitpod integrations</a>. (Click on the 3 dots to edit permissions for your GitHub account. Gitpod may pre-select permissions. You need read/write access to code in the repos.) |
| 21 | +The prototype will generate example data on first run. |
33 | 22 |
|
34 | | -Using your own GitHub credentials you can create, change, commit and push to branches on our Gitpod container via the "ready to code" button below. |
| 23 | +## Features |
35 | 24 |
|
36 | | -[](https://gitpod.io/#https://github.com/nhsuk/nhsuk-prototype-kit) |
| 25 | +- View all clinics or today's clinics |
| 26 | +- View clinic details and participant lists |
| 27 | +- Track participant status through their screening journey |
| 28 | +- View participant details within clinic context |
37 | 29 |
|
38 | | -Read an <a href="https://www.gitpod.io/docs">introduction to Gitpod (on Gitpod's website)</a>. |
| 30 | +## Development notes |
39 | 31 |
|
40 | | -## Release lifecycle |
| 32 | +- Example data is auto-generated in `app/data/generated` |
| 33 | +- Delete the generated folder to regenerate fresh example data |
| 34 | +- You can also run the generator directly with `node app/lib/generate-seed-data.js` |
| 35 | +- Uses NHS.UK design system components and patterns |
41 | 36 |
|
42 | | -> The below is only for maintainers of the prototype kit source code - these instructions aren't relevant if you're building your own prototype using the kit. |
43 | | -
|
44 | | -### Testing |
45 | | - |
46 | | -Run unit tests locally with `npm run test`. |
47 | | - |
48 | | -### Environments |
49 | | - |
50 | | -### Versioning and releasing |
51 | | - |
52 | | -- Merge required changes via PR into `main` branch |
53 | | - - Ensure the version number in `package.json` and `CHANGELOG.md` match, with a summary of the changes included in the changelog |
54 | | -- Pull down merged `main` branch to your local repository |
55 | | -- Create a tag with the version number from the latest commit on `main` |
56 | | - - If the latest version you're looking to push is version "1.2.3", you can do this on the command line with |
57 | | - - `git tag v1.2.3` |
58 | | - - `git push --tags` |
59 | | -- [Github actions](https://github.com/nhsuk/nhsuk-prototype-kit/actions/workflows/release.yml) will spring to life and create a release which will be visible on the [releases tab](https://github.com/nhsuk/nhsuk-prototype-kit/releases) of the repository. |
60 | | -- Finally, edit the description of the release to match the content entered into the changelog. |
61 | | -- To deploy the changes to Live, the promotion to Live from the Preview environment must have the appropriate approval in Azure. |
62 | | - |
63 | | -### Code Analysis |
64 | | - |
65 | | -Code analysis results can be found in [SonarQube](https://sonar.nhswebsite.nhs.uk/dashboard?id=nhsuk-prototype-kit). |
| 37 | +## Security |
66 | 38 |
|
67 | | -## Support |
| 39 | +As with all prototypes made with the NHS.UK prototype kit, this is for research and testing only. Do not use real participant data. |
68 | 40 |
|
69 | | -The NHS.UK prototype kit is maintained by NHS England. [Email us](mailto:[email protected]), open a [Github issue](https://github.com/nhsuk/nhsuk-prototype-kit/issues/new) or get in touch on the [NHS digital service manual Slack workspace](https://join.slack.com/t/nhs-service-manual/shared_invite/enQtNTIyOTEyNjU3NDkyLTk4NDQ3YzkwYzk1Njk5YjAxYTI5YTVkZmUxMGQ0ZjA3NjMyM2ZkNjBlMWMxODVjZjYzNzg1ZmU4MWY1NmE2YzE). |
| 41 | +If you publish your prototypes online, they must be protected by a username and password. This is to prevent members of the public finding prototypes and thinking they are real services. |
0 commit comments