{"id":23421170,"url":"https://github.com/nhsdigital/dtos-cohort-manager","last_synced_at":"2025-07-27T00:34:04.400Z","repository":{"id":227243072,"uuid":"763989451","full_name":"NHSDigital/dtos-cohort-manager","owner":"NHSDigital","description":null,"archived":false,"fork":false,"pushed_at":"2024-10-29T12:33:03.000Z","size":3569,"stargazers_count":6,"open_issues_count":5,"forks_count":1,"subscribers_count":8,"default_branch":"main","last_synced_at":"2024-10-29T13:30:29.728Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TSQL","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/NHSDigital.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":".github/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-02-27T09:28:21.000Z","updated_at":"2024-10-29T11:48:25.000Z","dependencies_parsed_at":"2024-04-02T09:56:31.536Z","dependency_job_id":"389478ef-cd86-44af-a37e-63012d3839ef","html_url":"https://github.com/NHSDigital/dtos-cohort-manager","commit_stats":null,"previous_names":["nhsdigital/dtos-landing-zone","nhsdigital/dtos-cohort-manager"],"tags_count":1,"template":false,"template_full_name":"nhs-england-tools/repository-template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NHSDigital%2Fdtos-cohort-manager","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NHSDigital%2Fdtos-cohort-manager/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NHSDigital%2Fdtos-cohort-manager/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NHSDigital%2Fdtos-cohort-manager/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NHSDigital","download_url":"https://codeload.github.com/NHSDigital/dtos-cohort-manager/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248016377,"owners_count":21033965,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-12-23T02:14:17.546Z","updated_at":"2025-07-27T00:34:04.394Z","avatar_url":"https://github.com/NHSDigital.png","language":"TSQL","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Cohort Manager\n\n[![CI/CD Pull Request](https://github.com/nhs-england-tools/repository-template/actions/workflows/cicd-1-pull-request.yaml/badge.svg)](https://github.com/nhs-england-tools/repository-template/actions/workflows/cicd-1-pull-request.yaml)\n[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=repository-template\u0026metric=alert_status)](https://sonarcloud.io/summary/new_code?id=repository-template)\n\nA service for identifying and managing cohorts of citizens. Users can select individuals to be part of a cohort, based on rules which are set by central bodies,\\\n or they can select individuals on an ad-hoc basis when planning their capacity. Rules for selecting individuals can be based on both demographic and medical criteria.  \n\n## Table of Contents\n\n- [Cohort Manager](#cohort-manager)\n  - [Set-up](#set-up)\n    - [Prerequisites](#prerequisites)\n    - [Configuration](#configuration)\n  - [Usage](#usage)\n    - [Testing](#testing)\n  - [Contributing](#contributing)\n  - [Contacts](#contacts)\n  - [Licence](#licence)\n\n## Set-up\n\n### Prerequisites\n\n- Visual Studio Code\n- Git\n- HomeBrew (Mac Only): \\\n    `/bin/bash -c \"$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)\"`\n- [.NET SDK (8.0)](https://dotnet.microsoft.com/en-us/download/dotnet/8.0)\n- Signed Git commits (if you would like to contribute): \\\n    [Using 1Password](https://developer.1password.com/docs/ssh/git-commit-signing/) is the easiest option if you have it, otherwise use the below link for instructions \\\n    \u003chttps://github.com/NHSDigital/software-engineering-quality-framework/blob/main/practices/guides/commit-signing.md\u003e\n- Added the git submodule:\n  `git submodule update --init --recursive`\n\n### 1. Import the NHS DToS Profile\n\nTo easily install the required extensions and settings/configuration for VS Code, you can import the profile located in `Set-up/NHS_DToS.code-profile`\n\nOn the top toolbar of Visual Studio Code go to *Code \u003e Settings \u003e Profiles \u003e Import Profile \u003e click on Select File...* and select the file **NHS_DToS.code-profile**\n\n### 2. Azure Data Studio \u0026 Storage Explorer\n\nAzure Data Studio \u0026 Storage Explorer are the GUI tools we are using to manually interact with the database \u0026 Azure Storage respectively.\n\n- Install [Azure Data Studio](https://learn.microsoft.com/en-us/azure-data-studio/download-azure-data-studio?tabs=wi[…]all%2Credhat-install%2Cwindows-uninstall%2Credhat-uninstall)\n- (Optional) Install [Azure Storage Explorer](https://azure.microsoft.com/en-gb/products/storage/storage-explorer)\n\nUse the **Intel Chip/ x64** installer if you have and Intel Chip in your Mac. Otherwise, use the **Apple Silicon/ ARM64** installer.\n\n*Note: to check which version you are using, you can click on the Apple icon of your machine \u003e About this Mac and a new window will appear. You can see the Chip your machine. Intel will have Intel in it, Apple Silicon will have something like Apple M1.*\n\n### 3. Download Docker/ Podman\n\nIf you are on Windows, install Docker Engine using [these instructions](https://medium.com/@rom.bruyere/docker-and-wsl2-without-docker-desktop-f529d15d9398)\n\nIf you are on Mac, install Podman by running:\n\n```bash\nbrew install --cask podman\nbrew install podman-compose\n\n# Allocate sufficient resources to Podman:\npodman machine stop\npodman machine set --cpus=6 --memory=12288 --disk-size=125\npodman machine start\n```\n\n### 4. Optional: Azure Functions Core Tools\n\nInstall only if you plan on running the functions outside of Docker/ Podman\n\nAzure Function Core Tools lets you develop and test your functions on your local computer. To install, press `ctrl/ command + shift + P` and enter `Azure Functions: Install or Update Azure Functions Core Tools`\n\n### Configuration\n\nCopy the .env.example file, rename it to just \".env\", and follow the instructions inside the file to add the variables.\n\n\u003e **Note:** For existing users, make sure you replace where it says 127.0.0.1 in the azurite connection string and replace it with \"azurite\"\n\n## Usage\n\nAfter a successful installation, please follow this [User Guide](./docs/user-guides/user_guide.md) to use the application.\n\n### Testing\n\nUnit tests can be run from the Functions directory with `dotnet test`\n\nTo run the end-to-end tests, follow the [instructions in the playwright-tests directory](tests/playwright-tests/README.md)\n\n## Contributing\n\nTo contribute, follow the instructions in the [contributing.md](CONTRIBUTING.md)\n\n## Contacts\n\nProvide a way to contact the owners of this project. It can be a team, an individual or information on the means of getting in touch via active communication channels, e.g. opening a GitHub discussion, raising an issue, etc.\n\n## Licence\n\n\u003e The [LICENCE.md](./LICENCE.md) file will need to be updated with the correct year and owner\n\nUnless stated otherwise, the codebase is released under the MIT License. This covers both the codebase and any sample code in the documentation.\n\nAny HTML or Markdown documentation is [© Crown Copyright](https://www.nationalarchives.gov.uk/information-management/re-using-public-sector-information/uk-government-licensing-framework/crown-copyright/) and available under the terms of the [Open Government Licence v3.0](https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnhsdigital%2Fdtos-cohort-manager","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnhsdigital%2Fdtos-cohort-manager","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnhsdigital%2Fdtos-cohort-manager/lists"}