Skip to content

Conversation

@Vox-Ben
Copy link
Contributor

@Vox-Ben Vox-Ben commented Jan 7, 2026

Description

Creates the PDS access module pursuant to https://nhsd-jira.digital.nhs.uk/browse/GPCAPIM-247. Also creates the stub PDS class so that tests can be run against it and adds the stubs directory to the python environment for the dev container.

Context

PDS access module is an integral part of the clinical gateway system, required to call out to PDS in order to obtain the ODS code for the patient's current GP. The stub is required to permit testing so that we don't have to call the actual PDS system in unit tests.

Type of changes

  • Refactoring (non-breaking change)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would change existing functionality)
  • Bug fix (non-breaking change which fixes an issue)

Checklist

  • I have followed the code style of the project
  • I have added tests to cover my changes
  • I have updated the documentation accordingly
  • This PR is a result of pair or mob programming
  • Exceptions/Exclusions to coding standards (e.g. #noqa or #NOSONAR) are included within this Pull Request.

Sensitive Information Declaration

To ensure the utmost confidentiality and protect your and others privacy, we kindly ask you to NOT including PII (Personal Identifiable Information) / PID (Personal Identifiable Data) or any other sensitive data in this PR (Pull Request) and the codebase changes. We will remove any PR that do contain any sensitive information. We really appreciate your cooperation in this matter.

  • I confirm that neither PII/PID nor sensitive data are included in this PR and the codebase changes.

@Vox-Ben Vox-Ben requested a review from a team as a code owner January 7, 2026 15:57
Copy link

@davidhamill1-nhs davidhamill1-nhs left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Given this is an MVP, the only real blocker of concern is that PDS retrievals (Get a patient's record) do not return a Bundle, but rather a Patient resource.

It doesn't look like there are coding standards yet laid out for this project, but personally I lean away from comments and towards code that explains itself, saving docstrings, etc. to only explain the why not the what. And given this is only a starting point for the stub, they would quickly need updating or more likely go out of date.

With that said, most of my comments are nit picks, and given I am new to the team, I am happy to cede to the group's opinion.

Happy to have a chat through any of it tomorrow afternoon.

@Vox-Ben
Copy link
Contributor Author

Vox-Ben commented Jan 8, 2026

@davidhamill1-nhs It's funny you should say that, I was having a conversation with @DWolfsNHS about comments vs. "the code is the documentation" just yesterday. My own (quite strong) preference is for having docstrings on everything as a bare minimum and then adding more comments in the actual code, because I've been bitten more than once by code that was supposedly self-explanatory that actually was just an excuse for the person who wrote it not to have to write documentation. My feeling is that if code were self-explanatory there wouldn't have been so many mechanisms invented for documenting and explaining it. 😆

That said, I'm fine with going along with the majority if the rest of the team disagrees!

@Vox-Ben Vox-Ben force-pushed the feature/GCPAPIM-247_pds_access_module branch from b34ead8 to d6bbf8b Compare January 8, 2026 18:42
@Vox-Ben
Copy link
Contributor Author

Vox-Ben commented Jan 8, 2026

@davidhamill1-nhs @DWolfsNHS Review comments addressed, if I could get a 👍 so I can merge it please?

(@davidhamill1-nhs do you have write access yet? If you don't then your 👍 is welcome but I'll also need one from someone else!)

@Vox-Ben
Copy link
Contributor Author

Vox-Ben commented Jan 9, 2026

Right, Sonar placated (also coverage fixed). @DWolfsNHS Any chance of a 👍 please?

@Vox-Ben Vox-Ben requested a review from DWolfsNHS January 9, 2026 10:51
DWolfsNHS
DWolfsNHS previously approved these changes Jan 9, 2026
@Vox-Ben Vox-Ben force-pushed the feature/GCPAPIM-247_pds_access_module branch from 329f532 to 29cd915 Compare January 9, 2026 17:18
@sonarqubecloud
Copy link

@Vox-Ben
Copy link
Contributor Author

Vox-Ben commented Jan 12, 2026

Right, think I'm there now. @DWolfsNHS Could I get a (hopefully final) 👍 please? @BJSS-russell-pollock it looks to be there from a testing perspective as well, please do satisfy yourself of that!

@Vox-Ben
Copy link
Contributor Author

Vox-Ben commented Jan 13, 2026

QA pass from @BJSS-russell-pollock
{9976CBE4-B50A-45DB-9792-54635E4A55D3}

@Vox-Ben Vox-Ben merged commit 5fba05d into main Jan 13, 2026
53 checks passed
@Vox-Ben Vox-Ben deleted the feature/GCPAPIM-247_pds_access_module branch January 13, 2026 10:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants